douyin-downloader 0.1.0

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

@@ -0,0 +1,160 @@
+"use strict";
+// Copied from src/download/error-handler.ts
+// Original file path: src/download/error-handler.ts
+/**
+ * 錯誤處理和重試機制
+ * 提供下載錯誤處理和智能重試邏輯
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadError = void 0;
+exports.downloadWithRetry = downloadWithRetry;
+exports.isRetryableError = isRetryableError;
+exports.getDownloadErrorMessage = getDownloadErrorMessage;
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+// No need to import withRetry here, it seems to be used elsewhere (e.g., video-downloader)
+/**
+ * 下載錯誤類型
+ */
+class DownloadError extends Error {
+    code;
+    retryable;
+    url;
+    constructor(message, url, code = 'DOWNLOAD_ERROR', retryable = true) {
+        super(message);
+        this.name = 'DownloadError';
+        this.code = code;
+        this.retryable = retryable;
+        this.url = url;
+    }
+    /**
+     * 判斷錯誤是否可重試
+     */
+    isRetryable() {
+        return this.retryable;
+    }
+}
+exports.DownloadError = DownloadError;
+/**
+ * 計算重試延遲時間
+ * 使用指數退避策略
+ * @param attempt 當前嘗試次數（從 1 開始）
+ * @param options 重試選項
+ * @returns 延遲時間（毫秒）
+ */
+function calculateDelay(attempt, options) {
+    const { minDelay = 1000, maxDelay = 30000, factor = 2 } = options;
+    // 指數退避: minDelay * (factor ^ (attempt - 1))
+    let delay = minDelay * Math.pow(factor, attempt - 1);
+    // 添加一些隨機性以避免 "雷暴" 效應
+    delay = delay * (0.8 + Math.random() * 0.4);
+    // 限制在最大延遲時間內
+    return Math.min(delay, maxDelay);
+}
+/**
+ * 帶重試機制的下載函數
+ * @param downloadFn 下載函數
+ * @param url 下載 URL
+ * @param options 重試選項
+ * @returns Promise<T> 下載結果
+ */
+async function downloadWithRetry(downloadFn, url, options) {
+    const { retries, onRetry, onProgress } = options;
+    let attempt = 0;
+    let lastError;
+    while (attempt <= retries) {
+        attempt++;
+        try {
+            // 執行下載函數
+            return await downloadFn(onProgress);
+        }
+        catch (error) {
+            // 轉換為 Error 對象
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // 檢查錯誤是否可重試
+            const isRetryable = error instanceof DownloadError
+                ? error.isRetryable()
+                : isRetryableError(lastError);
+            // 如果已達到最大重試次數或錯誤不可重試，拋出錯誤
+            if (attempt > retries || !isRetryable) {
+                logger_1.downloadLogger.error(`下載 ${url} 失敗，不再重試`, lastError);
+                throw lastError;
+            }
+            // 調用重試回調
+            if (onRetry) {
+                onRetry(lastError, attempt);
+            }
+            // 記錄日誌
+            logger_1.downloadLogger.warn(`下載 ${url} 失敗，準備重試 #${attempt}/${retries}:`, lastError.message);
+            // 計算延遲時間
+            const delay = calculateDelay(attempt, options);
+            // 等待後重試
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    // 理論上不應該執行到這裡
+    throw lastError;
+}
+/**
+ * 判斷錯誤是否可重試
+ * @param error 錯誤對象
+ * @returns 是否可重試
+ */
+function isRetryableError(error) {
+    const message = error.message.toLowerCase();
+    const name = error.name.toLowerCase();
+    // 網絡錯誤通常可重試
+    if (name.includes('network') ||
+        message.includes('network') ||
+        message.includes('connection') ||
+        message.includes('timeout') ||
+        message.includes('timed out') ||
+        message.includes('429') || // Too Many Requests
+        message.includes('503') || // Service Unavailable
+        message.includes('504') // Gateway Timeout
+    ) {
+        return true;
+    }
+    // 資源錯誤通常不可重試
+    if (message.includes('404') || // Not Found
+        message.includes('403') || // Forbidden
+        message.includes('401') || // Unauthorized
+        message.includes('400') || // Bad Request
+        message.includes('not found') ||
+        message.includes('forbidden') ||
+        message.includes('unauthorized') ||
+        message.includes('bad request') ||
+        message.includes('permission denied')) {
+        return false;
+    }
+    // 默認可重試
+    return true;
+}
+/**
+ * 處理下載錯誤並返回友好的錯誤消息
+ * @param error 原始錯誤
+ * @param url 下載 URL
+ * @returns 友好的錯誤消息
+ */
+function getDownloadErrorMessage(error, url) {
+    if (error instanceof DownloadError) {
+        return error.message;
+    }
+    const err = error instanceof Error ? error : new Error(String(error));
+    const message = err.message.toLowerCase();
+    // 常見錯誤類型的友好消息
+    if (message.includes('timeout') || message.includes('timed out')) {
+        return `下載超時，請檢查網絡連接或稍後再試`;
+    }
+    if (message.includes('404') || message.includes('not found')) {
+        return `影片資源不存在或已被移除`;
+    }
+    if (message.includes('403') || message.includes('forbidden')) {
+        return `無權訪問此影片資源，可能需要登入或權限`;
+    }
+    if (message.includes('429') || message.includes('too many requests')) {
+        return `下載請求過於頻繁，請稍後再試`;
+    }
+    // 其他錯誤使用原始消息
+    return `下載影片時發生錯誤: ${err.message}`;
+}
+//# sourceMappingURL=error-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../../../src/douyin/download/error-handler.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,oDAAoD;AACpD;;;GAGG;;;AAyEH,8CAmDC;AAOD,4CAmCC;AAQD,0DA2BC;AAvMD,+CAA8D,CAAC,sCAAsC;AACrG,2FAA2F;AAE3F;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtB,IAAI,CAAS;IACb,SAAS,CAAU;IACnB,GAAG,CAAS;IAE5B,YACE,OAAe,EACf,GAAW,EACX,OAAe,gBAAgB,EAC/B,YAAqB,IAAI;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,WAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAxBD,sCAwBC;AAcD;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,OAAe,EAAE,OAAqB;IAC5D,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAElE,4CAA4C;IAC5C,IAAI,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IAErD,qBAAqB;IACrB,KAAK,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAE5C,aAAa;IACb,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CACrC,UAAmE,EACnE,GAAW,EACX,OAAqB;IAErB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAEjD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAgB,CAAC;IAErB,OAAO,OAAO,IAAI,OAAO,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;QAEV,IAAI,CAAC;YACH,SAAS;YACT,OAAO,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtE,YAAY;YACZ,MAAM,WAAW,GACf,KAAK,YAAY,aAAa;gBAC5B,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE;gBACrB,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAElC,0BAA0B;YAC1B,IAAI,OAAO,GAAG,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtC,uBAAM,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,EAAE,SAAS,CAAC,CAAC;gBAC7C,MAAM,SAAS,CAAC;YAClB,CAAC;YAED,SAAS;YACT,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC9B,CAAC;YAED,OAAO;YACP,uBAAM,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa,OAAO,IAAI,OAAO,GAAG,EACrD,SAAS,CAAC,OAAO,CAAC,CAAC;YAErB,SAAS;YACT,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE/C,QAAQ;YACR,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,SAAU,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,KAAY;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAEtC,YAAY;IACZ,IACE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,oBAAoB;QAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,sBAAsB;QACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAI,kBAAkB;MAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;IACb,IACE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,YAAY;QACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,YAAY;QACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,eAAe;QAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,cAAc;QACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,QAAQ;IACR,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,KAAc,EAAE,GAAW;IACjE,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAE1C,cAAc;IACd,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjE,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7D,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7D,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACrE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,aAAa;IACb,OAAO,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * 影片下載模組
+ * 提供下載抖音影片的功能
+ */
+import { VideoInfo, DownloadOptions, DownloadResult as CommonDownloadResult } from '../../types';
+import { Page } from 'puppeteer';
+export * from './video-downloader';
+export * from './download-manager';
+export * from './path-formatter';
+export * from './error-handler';
+/**
+ * 下載多個抖音影片
+ * @param videoInfos 影片資訊陣列
+ * @param outputPath 輸出路徑
+ * @param options 下載選項
+ * @returns Promise<DownloadResult[]> 下載結果陣列
+ */
+export declare function downloadVideos(videoInfos: VideoInfo[], // Use common VideoInfo
+outputPath: string, options?: DownloadOptions): Promise<CommonDownloadResult[]>;
+/**
+ * 從 URL 陣列下載抖音影片
+ * @param videoUrls 影片 URL 陣列
+ * @param outputPath 輸出路徑
+ * @param cookie 有效的抖音 Cookie
+ * @param options 下載選項
+ * @returns Promise<string[]> 下載完成的檔案路徑陣列
+ */
+export declare function downloadVideosFromUrls(videoUrls: string[], outputPath: string, page: Page, // Changed: Accept Page object
+options?: DownloadOptions): Promise<string[]>;
+/**
+ * 從文本中解析抖音連結並下載影片
+ * @param text 包含抖音連結的文本
+ * @param outputPath 輸出路徑
+ * @param cookie 有效的抖音 Cookie
+ * @param options 下載選項
+ * @returns Promise<string[]> 下載完成的檔案路徑陣列
+ */
+export declare function downloadVideosFromText(text: string, outputPath: string, page: Page, // Changed: Accept Page object
+options?: DownloadOptions): Promise<string[]>;

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

@@ -0,0 +1,156 @@
+"use strict";
+// Copied from src/download/index.ts
+// Original file path: src/download/index.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 __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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadVideos = downloadVideos;
+exports.downloadVideosFromUrls = downloadVideosFromUrls;
+exports.downloadVideosFromText = downloadVideosFromText;
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+const info_1 = require("../info"); // Keep relative path within douyin
+const parser_1 = require("../parser"); // Keep relative path within douyin
+const download_manager_1 = require("./download-manager"); // Remove DownloadResult import
+// 重新導出子模組
+__exportStar(require("./video-downloader"), exports);
+__exportStar(require("./download-manager"), exports);
+__exportStar(require("./path-formatter"), exports);
+__exportStar(require("./error-handler"), exports);
+/**
+ * 下載多個抖音影片
+ * @param videoInfos 影片資訊陣列
+ * @param outputPath 輸出路徑
+ * @param options 下載選項
+ * @returns Promise<DownloadResult[]> 下載結果陣列
+ */
+async function downloadVideos(videoInfos, // Use common VideoInfo
+outputPath, options = {}) {
+    // Destructure all potential options from the input DownloadOptions
+    const { concurrency = 3, retries = 3, onProgress, timeout, 
+    // headers are not part of DownloadOptions in types.ts, but are in VideoDownloadOptions
+    // checkExisting is not part of DownloadOptions in types.ts, but are in VideoDownloadOptions
+    overwrite, useSubfolders, filenameTemplate } = options;
+    // 目錄確保邏輯已移至 CLI 或 downloadBatch/downloadVideo
+    // await ensureDirectoryExists(path.isAbsolute(outputPath)
+    //   ? outputPath
+    //   : path.resolve(process.cwd(), outputPath));
+    logger_1.downloadLogger.info(`開始下載 ${videoInfos.length} 個影片`);
+    // 使用下載批次處理器
+    // Explicitly construct the options object for downloadBatch using an intersection type
+    const batchOptions = {
+        concurrency,
+        retries, // Pass retries (should be valid via VideoDownloadOptions)
+        onBatchProgress: onProgress, // Map the batch progress callback
+        // Pass other relevant options inherited from VideoDownloadOptions
+        timeout: timeout,
+        // headers: headers, // headers not available in input options
+        // checkExisting: checkExisting, // checkExisting not available in input options
+        overwrite: overwrite,
+        useSubfolders: useSubfolders,
+        filenameTemplate: filenameTemplate
+    };
+    const results = await (0, download_manager_1.downloadBatch)(videoInfos, outputPath, batchOptions);
+    // 統計結果
+    const successCount = results.filter(r => r.success).length;
+    const failCount = results.filter(r => !r.success).length;
+    logger_1.downloadLogger.info(`下載完成，成功: ${successCount}/${videoInfos.length}，失敗: ${failCount}/${videoInfos.length}`);
+    return results;
+}
+/**
+ * 從 URL 陣列下載抖音影片
+ * @param videoUrls 影片 URL 陣列
+ * @param outputPath 輸出路徑
+ * @param cookie 有效的抖音 Cookie
+ * @param options 下載選項
+ * @returns Promise<string[]> 下載完成的檔案路徑陣列
+ */
+async function downloadVideosFromUrls(videoUrls, outputPath, page, // Changed: Accept Page object
+// cookie: string, // Removed
+options = {}) {
+    // 獲取影片資訊
+    logger_1.downloadLogger.info(`[downloadVideosFromUrls] 開始獲取 ${videoUrls.length} 個影片的資訊`);
+    // Pass page instead of cookie
+    const videoInfos = await (0, info_1.fetchVideosInfoUrls)(videoUrls, page, {
+        concurrency: options.concurrency,
+        onProgress: options.onProgress
+            ? (current, total, overallProgress) => options.onProgress(current, total, overallProgress !== undefined ? overallProgress * 0.2 : undefined) // Adjust progress, handle undefined
+            : undefined
+    });
+    if (videoInfos.length === 0) {
+        logger_1.downloadLogger.warn('[downloadVideosFromUrls] 未找到有效的影片資訊，無法下載');
+        return [];
+    }
+    logger_1.downloadLogger.info(`[downloadVideosFromUrls] 成功獲取 ${videoInfos.length} 個影片的資訊，開始下載`);
+    // 下載影片
+    const results = await downloadVideos(videoInfos, outputPath, {
+        ...options,
+        onProgress: options.onProgress
+            ? (current, total, overallProgress) => {
+                // 調整進度：資訊獲取 0-20%，下載 20-100%
+                const adjustedProgress = overallProgress !== undefined ? 20 + (overallProgress * 0.8) : undefined; // Adjust progress, handle undefined
+                options.onProgress(current, total, adjustedProgress);
+            }
+            : undefined
+    });
+    // 過濾出成功的結果，返回檔案路徑
+    return results
+        .filter(result => result.success && result.filePath)
+        .map(result => result.filePath);
+}
+/**
+ * 從文本中解析抖音連結並下載影片
+ * @param text 包含抖音連結的文本
+ * @param outputPath 輸出路徑
+ * @param cookie 有效的抖音 Cookie
+ * @param options 下載選項
+ * @returns Promise<string[]> 下載完成的檔案路徑陣列
+ */
+async function downloadVideosFromText(text, outputPath, page, // Changed: Accept Page object
+// cookie: string, // Removed
+options = {}) {
+    // 解析文本中的抖音連結
+    logger_1.downloadLogger.info('[downloadVideosFromText] 解析文本中的抖音連結');
+    const parseResults = await (0, parser_1.parseDouyinLinks)(text, {
+        concurrency: options.concurrency,
+        retries: options.retries,
+        onProgress: options.onProgress
+            ? (current, total, overallProgress) => options.onProgress(current, total, overallProgress !== undefined ? overallProgress * 0.1 : undefined) // Adjust progress, handle undefined
+            : undefined
+    });
+    if (parseResults.length === 0) {
+        logger_1.downloadLogger.warn('[downloadVideosFromText] 未找到有效的抖音影片連結');
+        return [];
+    }
+    // 獲取標準 URL 陣列
+    const videoUrls = parseResults.map((result) => result.standardUrl);
+    logger_1.downloadLogger.info(`[downloadVideosFromText] 找到 ${videoUrls.length} 個有效連結，開始獲取影片資訊`);
+    // 下載影片
+    // Pass page instead of cookie
+    return downloadVideosFromUrls(videoUrls, outputPath, page, {
+        ...options,
+        onProgress: options.onProgress
+            ? (current, total, overallProgress) => {
+                // 調整進度：解析連結 0-10%，下載 10-100%
+                const adjustedProgress = overallProgress !== undefined ? 10 + (overallProgress * 0.9) : undefined; // Adjust progress, handle undefined
+                options.onProgress(current, total, adjustedProgress);
+            }
+            : undefined
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/douyin/download/path-formatter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 檔名和路徑管理
+ * 提供格式化檔名和路徑的功能
+ */
+import { VideoInfo } from '../../types';
+/**
+ * 格式化輸出路徑選項
+ */
+export interface PathFormatterOptions {
+    useSubfolders?: boolean;
+    filenameTemplate?: string;
+    maxFilenameLength?: number;
+}
+/**
+ * 獲取安全的檔案名（替換非法字符）
+ * @param filename 原始檔案名
+ * @param maxLength 最大長度限制
+ * @returns 安全的檔案名
+ */
+/**
+ * 格式化日期字符串
+ * @param dateStr 日期字符串 (ISO 格式或 YYYY-MM-DD)
+ * @returns 格式化後的日期 (YYYYMMDD)
+ */
+export declare function formatDate(dateStr: string): string;
+/**
+ * 應用檔名模板
+ * @param template 模板字符串
+ * @param videoInfo 影片資訊
+ * @returns 應用模板後的字符串
+ */
+export declare function applyFilenameTemplate(template: string, videoInfo: VideoInfo): string;
+/**
+ * 格式化輸出路徑
+ * 根據影片資訊和選項，確定檔案的完整路徑
+ * @param videoInfo 影片資訊
+ * @param baseOutputPath 基本輸出路徑
+ * @param options 格式化選項
+ * @returns 格式化後的完整檔案路徑
+ */
+export declare function formatOutputPath(videoInfo: VideoInfo, // Use common VideoInfo
+baseOutputPath: string, options?: PathFormatterOptions): string;

package/dist/src/douyin/download/path-formatter.js

@@ -0,0 +1,107 @@
+"use strict";
+// Copied from src/download/path-formatter.ts
+// Original file path: src/download/path-formatter.ts
+/**
+ * 檔名和路徑管理
+ * 提供格式化檔名和路徑的功能
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = formatDate;
+exports.applyFilenameTemplate = applyFilenameTemplate;
+exports.formatOutputPath = formatOutputPath;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const file_1 = require("../../utils/file"); // Import from shared utils
+/**
+ * 獲取安全的檔案名（替換非法字符）
+ * @param filename 原始檔案名
+ * @param maxLength 最大長度限制
+ * @returns 安全的檔案名
+ */
+// Moved getSafeFilename to src/utils/file.ts
+/**
+ * 格式化日期字符串
+ * @param dateStr 日期字符串 (ISO 格式或 YYYY-MM-DD)
+ * @returns 格式化後的日期 (YYYYMMDD)
+ */
+function formatDate(dateStr) {
+    try {
+        const date = new Date(dateStr);
+        if (isNaN(date.getTime())) {
+            return new Date().toISOString().slice(0, 10).replace(/-/g, '');
+        }
+        return date.toISOString().slice(0, 10).replace(/-/g, '');
+    }
+    catch (error) {
+        // 如果解析失敗，使用當前日期
+        return new Date().toISOString().slice(0, 10).replace(/-/g, '');
+    }
+}
+/**
+ * 應用檔名模板
+ * @param template 模板字符串
+ * @param videoInfo 影片資訊
+ * @returns 應用模板後的字符串
+ */
+function applyFilenameTemplate(template, videoInfo // Use common VideoInfo
+) {
+    // 將可用的變數替換為實際值
+    return template
+        .replace(/{id}/g, videoInfo.id || 'unknown')
+        .replace(/{title}/g, videoInfo.title || 'untitled')
+        .replace(/{date}/g, formatDate(videoInfo.releaseDate || ''))
+        .replace(/{user}/g, videoInfo.userName || 'unknown_user');
+}
+/**
+ * 格式化輸出路徑
+ * 根據影片資訊和選項，確定檔案的完整路徑
+ * @param videoInfo 影片資訊
+ * @param baseOutputPath 基本輸出路徑
+ * @param options 格式化選項
+ * @returns 格式化後的完整檔案路徑
+ */
+function formatOutputPath(videoInfo, // Use common VideoInfo
+baseOutputPath, options = {}) {
+    const { useSubfolders = true, filenameTemplate = "{date}-{title}", maxFilenameLength = 200 } = options;
+    // 檢查基本路徑是否是目錄
+    let isDirectory = false;
+    try {
+        isDirectory = fs_extra_1.default.statSync(baseOutputPath).isDirectory();
+    }
+    catch (error) {
+        // 檢查路徑是否以目錄分隔符結尾
+        isDirectory = baseOutputPath.endsWith(path_1.default.sep) || baseOutputPath.endsWith('/');
+    }
+    // 如果是目錄，根據選項決定使用子資料夾
+    if (isDirectory) {
+        let targetDir = baseOutputPath;
+        // 如果使用子資料夾，則添加使用者名稱資料夾
+        if (useSubfolders && videoInfo.userName) {
+            const userDirName = (0, file_1.getSafeFilename)(videoInfo.userName || 'unknown_user'); // Remove second argument
+            targetDir = path_1.default.join(baseOutputPath, userDirName);
+        }
+        // 應用檔名模板並限制長度
+        // Apply template first, then sanitize the result using the single-argument getSafeFilename
+        const templateAppliedName = applyFilenameTemplate(filenameTemplate, videoInfo);
+        const filename = (0, file_1.getSafeFilename)(templateAppliedName); // Remove second argument
+        // 確保檔名有 .mp4 擴展名
+        const finalName = filename.toLowerCase().endsWith('.mp4')
+            ? filename
+            : `${filename}.mp4`;
+        return path_1.default.join(targetDir, finalName);
+    }
+    else {
+        // 如果不是目錄，則直接使用指定的檔案路徑
+        let finalPath = baseOutputPath;
+        // 確保檔案擴展名為 .mp4
+        if (!finalPath.toLowerCase().endsWith('.mp4')) {
+            finalPath += '.mp4';
+        }
+        return finalPath;
+    }
+}
+// Moved ensureDirectoryExists to src/utils/file.ts
+//# sourceMappingURL=path-formatter.js.map

package/dist/src/douyin/download/path-formatter.js.map

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

package/dist/src/douyin/download/video-downloader.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 影片下載核心功能
+ * 實現單個影片的下載邏輯
+ */
+import { VideoInfo } from '../../types';
+/**
+ * 下載選項
+ */
+export interface VideoDownloadOptions {
+    retries?: number;
+    timeout?: number;
+    headers?: Record<string, string>;
+    onProgress?: (progress: number) => void;
+    onFileProgress?: (progress: number) => void;
+    checkExisting?: boolean;
+    overwrite?: boolean;
+    useSubfolders?: boolean;
+    filenameTemplate?: string;
+}
+/**
+ * 下載單個抖音影片
+ * @param videoInfo 影片資訊
+ * @param destPath 目標路徑（檔案或目錄）
+ * @param options 下載選項
+ * @returns Promise<string> 下載完成的檔案路徑
+ */
+export declare function downloadVideo(videoInfo: VideoInfo, // Use common VideoInfo
+destPath: string, options?: VideoDownloadOptions, downloadUrls?: string[]): Promise<string>;
+/**
+ * 獲取影片的下載大小
+ * @param url 影片 URL
+ * @param headers 請求頭
+ * @returns Promise<number> 檔案大小（位元組）
+ */
+export declare function getVideoSize(url: string, headers?: Record<string, string>): Promise<number>;