douyin-downloader 0.1.0

package/dist/src/douyin/parser/link-patterns.js

@@ -0,0 +1,121 @@
+"use strict";
+// Copied from src/parser/link-patterns.ts
+// Original file path: src/parser/link-patterns.ts
+/**
+ * 抖音連結模式定義
+ * 定義各種抖音連結的正則表達式和處理方式
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOUYIN_LINK_PATTERNS = void 0;
+exports.createCombinedPattern = createCombinedPattern;
+exports.getLinkType = getLinkType;
+exports.extractVideoId = extractVideoId;
+const logger_1 = require("../../utils/logger"); // Corrected path
+/**
+ * 抖音連結模式陣列
+ * 包含各種可能的抖音連結格式
+ */
+exports.DOUYIN_LINK_PATTERNS = [
+    {
+        name: 'standard',
+        // 標準網頁連結，例如: https://www.douyin.com/video/7123456789
+        pattern: /https?:\/\/(?:www\.)?douyin\.com\/video\/(\d+)/,
+        needsRedirect: false
+    },
+    {
+        name: 'short',
+        // 短連結，例如: https://v.douyin.com/abc123/ 或 https://v.douyin.com/c-mY7xDr-qA/
+        pattern: /https?:\/\/v\.douyin\.com\/([a-zA-Z0-9-]+)\/?/,
+        needsRedirect: true
+    },
+    {
+        name: 'mobile',
+        // 移動端分享連結，例如: https://www.douyin.com/share/video/123456789
+        pattern: /https?:\/\/(?:www\.)?douyin\.com\/share\/video\/(\d+)/,
+        needsRedirect: true
+    },
+    {
+        name: 'note',
+        // 筆記類型連結，例如: https://www.douyin.com/note/123456789
+        pattern: /https?:\/\/(?:www\.)?douyin\.com\/note\/(\d+)/,
+        needsRedirect: true
+    },
+    {
+        name: 'discover',
+        // 發現頁連結，例如: https://www.douyin.com/discover?modal_id=7123456789
+        pattern: /https?:\/\/(?:www\.)?douyin\.com\/discover\?.*modal_id=(\d+)/,
+        needsRedirect: true
+    },
+    {
+        name: 'webapp',
+        // WebApp 連結，例如: https://www.douyin.com/webapp/7123456789
+        pattern: /https?:\/\/(?:www\.)?douyin\.com\/webapp\/(\d+)/,
+        needsRedirect: true
+    },
+    {
+        name: 'mobile-param',
+        // 帶參數的移動端連結，例如: https://www.iesdouyin.com/share/video/xxx/?region=CN&...
+        pattern: /https?:\/\/(?:www\.)?(?:douyin|iesdouyin)\.com\/.*\/.*\?.*(?:video_id|vid)=([^&]+)/,
+        needsRedirect: true
+    }
+];
+/**
+ * 創建用於在文本中查找所有抖音連結的正則表達式
+ * @returns RegExp 可以匹配任何抖音連結的正則表達式
+ */
+function createCombinedPattern() {
+    // 將所有模式的正則表達式合併為一個，使用 | 作為分隔符
+    const patternStrings = exports.DOUYIN_LINK_PATTERNS.map(pattern => {
+        // 移除 ^ 和 $ 錨點，因為我們要在文本中查找，而不是匹配整個字符串
+        return pattern.pattern.source.replace(/^\^|\$$/g, '');
+    });
+    // 建立一個新的正則表達式，使用 g 標誌進行全局匹配
+    const combinedPattern = new RegExp(patternStrings.join('|'), 'g');
+    logger_1.parserLogger.debug(`創建合併正則表達式: ${combinedPattern}`);
+    return combinedPattern;
+}
+/**
+ * 獲取抖音連結的類型
+ * @param url 抖音連結
+ * @returns LinkPattern | null 連結類型或 null (如果不匹配任何類型)
+ */
+function getLinkType(url) {
+    for (const pattern of exports.DOUYIN_LINK_PATTERNS) {
+        if (pattern.pattern.test(url)) {
+            logger_1.parserLogger.debug(`連結 ${url} 匹配類型: ${pattern.name}`);
+            return pattern;
+        }
+    }
+    logger_1.parserLogger.debug(`連結 ${url} 不匹配任何已知類型`);
+    return null;
+}
+/**
+ * 從 URL 中提取影片 ID (如果可能)
+ * @param url 抖音連結
+ * @returns string | null 影片 ID 或 null (如果無法提取)
+ */
+function extractVideoId(url) {
+    for (const pattern of exports.DOUYIN_LINK_PATTERNS) {
+        const match = url.match(pattern.pattern);
+        if (match && match[1]) {
+            const videoId = match[1];
+            logger_1.parserLogger.debug(`從連結 ${url} 提取到影片 ID: ${videoId}`);
+            return videoId;
+        }
+    }
+    // 嘗試從 URL 參數中提取 vid
+    try {
+        const urlObj = new URL(url);
+        const videoId = urlObj.searchParams.get('vid');
+        if (videoId) {
+            logger_1.parserLogger.debug(`從連結參數提取到影片 ID: ${videoId}`);
+            return videoId;
+        }
+    }
+    catch (error) {
+        logger_1.parserLogger.debug(`URL 解析失敗: ${error}`);
+    }
+    logger_1.parserLogger.debug(`無法從連結 ${url} 提取影片 ID`);
+    return null;
+}
+//# sourceMappingURL=link-patterns.js.map

package/dist/src/douyin/parser/link-patterns.js.map

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

package/dist/src/douyin/parser/parse-batch.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 批量解析模組
+ * 並行處理多個抖音連結的解析
+ */
+import { ParseResult, ParseOptions } from '../../types';
+/**
+ * 批量解析抖音連結
+ * @param urls 抖音連結陣列
+ * @param options 解析選項
+ * @returns Promise<ParseResult[]> 解析結果陣列
+ */
+export declare function parseBatch(urls: string[], options?: ParseOptions): Promise<ParseResult[]>;
+/**
+ * 批量解析抖音連結，包含更詳細的進度和結果信息
+ * @param urls 抖音連結陣列
+ * @param options 解析選項
+ * @returns Promise<{ results: ParseResult[], stats: { total: number, success: number, failed: number } }>
+ */
+export declare function parseBatchWithStats(urls: string[], options?: ParseOptions): Promise<{
+    results: ParseResult[];
+    stats: {
+        total: number;
+        success: number;
+        failed: number;
+    };
+}>;

package/dist/src/douyin/parser/parse-batch.js

@@ -0,0 +1,67 @@
+"use strict";
+// Copied from src/parser/parse-batch.ts
+// Original file path: src/parser/parse-batch.ts
+/**
+ * 批量解析模組
+ * 並行處理多個抖音連結的解析
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBatch = parseBatch;
+exports.parseBatchWithStats = parseBatchWithStats;
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+const retry_1 = require("../../utils/retry"); // Updated path to shared utils
+const resolve_links_1 = require("./resolve-links");
+/**
+ * 批量解析抖音連結
+ * @param urls 抖音連結陣列
+ * @param options 解析選項
+ * @returns Promise<ParseResult[]> 解析結果陣列
+ */
+async function parseBatch(urls, options = {}) {
+    // 設置默認選項
+    const { concurrency = 3, retries = 3, userAgent, onProgress } = options;
+    logger_1.parserLogger.info(`開始批量解析 ${urls.length} 個抖音連結，並行數: ${concurrency}`);
+    if (urls.length === 0) {
+        logger_1.parserLogger.debug('沒有連結需要解析');
+        return [];
+    }
+    // 使用 withConcurrency 並行處理所有連結
+    const resolveOptions = { userAgent, retries };
+    // processBatch returns { results, errors }
+    const batchOutcome = await (0, retry_1.processBatch)(urls, async (url, index) => {
+        logger_1.parserLogger.debug(`解析連結 #${index + 1}/${urls.length}: ${url}`);
+        // resolveLink might return null on failure
+        return await (0, resolve_links_1.resolveLink)(url, resolveOptions);
+    }, {
+        concurrency,
+        retries,
+        // Pass the onProgress callback correctly to processBatch options
+        onProgress: onProgress ? (completed, total, errors) => onProgress(completed, total) : undefined
+    });
+    // Extract results and handle errors
+    const successfulResults = batchOutcome.results.filter((r) => r !== null); // Filter out nulls
+    const errors = batchOutcome.errors;
+    logger_1.parserLogger.info(`批量解析完成，成功解析 ${successfulResults.length}/${urls.length} 個連結`);
+    if (errors.length > 0) {
+        logger_1.parserLogger.warn(`解析過程中發生 ${errors.length} 個錯誤`);
+    }
+    return successfulResults;
+}
+/**
+ * 批量解析抖音連結，包含更詳細的進度和結果信息
+ * @param urls 抖音連結陣列
+ * @param options 解析選項
+ * @returns Promise<{ results: ParseResult[], stats: { total: number, success: number, failed: number } }>
+ */
+async function parseBatchWithStats(urls, options = {}) {
+    const results = await parseBatch(urls, options);
+    return {
+        results,
+        stats: {
+            total: urls.length,
+            success: results.length,
+            failed: urls.length - results.length
+        }
+    };
+}
+//# sourceMappingURL=parse-batch.js.map

package/dist/src/douyin/parser/parse-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-batch.js","sourceRoot":"","sources":["../../../../src/douyin/parser/parse-batch.ts"],"names":[],"mappings":";AAAA,wCAAwC;AACxC,gDAAgD;AAChD;;;GAGG;;AAaH,gCA0CC;AAQD,kDAqBC;AAlFD,+CAA4D,CAAC,sCAAsC;AACnG,6CAAiD,CAAC,+BAA+B;AAEjF,mDAA8C;AAE9C;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAC9B,IAAc,EACd,UAAwB,EAAE;IAE1B,SAAS;IACT,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAExE,qBAAM,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,eAAe,WAAW,EAAE,CAAC,CAAC;IAE/D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,qBAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,8BAA8B;IAC9B,MAAM,cAAc,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAC9C,2CAA2C;IAC3C,MAAM,YAAY,GAAG,MAAM,IAAA,oBAAY,EACrC,IAAI,EACJ,KAAK,EAAE,GAAW,EAAE,KAAa,EAA+B,EAAE;QAChE,qBAAM,CAAC,KAAK,CAAC,SAAS,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC;QAC1D,2CAA2C;QAC3C,OAAO,MAAM,IAAA,2BAAW,EAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC,EACD;QACE,WAAW;QACX,OAAO;QACP,iEAAiE;QACjE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KAChG,CACF,CAAC;IAEF,oCAAoC;IACpC,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB;IAC/G,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IAEnC,qBAAM,CAAC,IAAI,CAAC,eAAe,iBAAiB,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,MAAM,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,qBAAM,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,mBAAmB,CACvC,IAAc,EACd,UAAwB,EAAE;IAS1B,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEhD,OAAO;QACL,OAAO;QACP,KAAK,EAAE;YACL,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;SACrC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/douyin/parser/parseDouyinLinks.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 抖音連結解析模組
+ * 從文本中解析抖音連結，支援多種格式並將其標準化
+ *
+ * @remarks
+ * 參考來源：此功能改寫自原本存放於 src/parser/resolve-links.ts 和 src/parser/parse-batch.ts 的功能
+ * 需要驗證：URL 處理邏輯是否與最新抖音 API 兼容
+ */
+import { ParseResult, ParseOptions } from '../../types';
+/**
+ * 從文本中解析抖音連結，支援多種格式（標準URL、短連結、移動端分享連結等），並將其標準化
+ * @param text 包含一個或多個抖音連結的文本字串
+ * @param options 解析選項
+ * @returns 解析結果陣列
+ *
+ * @remarks
+ * 改寫自原本存放於 src/parser/index.ts 的 parseDouyinLinks 功能
+ * 但實現方式不同，此處使用了批量處理和並發控制
+ */
+export declare function parseDouyinLinks(text: string, options?: ParseOptions): Promise<ParseResult[]>;
+/**
+ * 解析並標準化抖音連結
+ * @param url 抖音連結
+ * @returns 標準化後的解析結果
+ *
+ * @remarks
+ * 改寫自原本存放於 src/parser/resolve-links.ts 的功能
+ * 處理不同格式的抖音 URL 並解析 video ID
+ */
+export declare function resolveAndStandardizeDouyinLink(url: string): Promise<ParseResult | null>;

package/dist/src/douyin/parser/parseDouyinLinks.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * 抖音連結解析模組
+ * 從文本中解析抖音連結，支援多種格式並將其標準化
+ *
+ * @remarks
+ * 參考來源：此功能改寫自原本存放於 src/parser/resolve-links.ts 和 src/parser/parse-batch.ts 的功能
+ * 需要驗證：URL 處理邏輯是否與最新抖音 API 兼容
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDouyinLinks = parseDouyinLinks;
+exports.resolveAndStandardizeDouyinLink = resolveAndStandardizeDouyinLink;
+const extractDouyinLinks_1 = require("./extractDouyinLinks");
+/**
+ * 從文本中解析抖音連結，支援多種格式（標準URL、短連結、移動端分享連結等），並將其標準化
+ * @param text 包含一個或多個抖音連結的文本字串
+ * @param options 解析選項
+ * @returns 解析結果陣列
+ *
+ * @remarks
+ * 改寫自原本存放於 src/parser/index.ts 的 parseDouyinLinks 功能
+ * 但實現方式不同，此處使用了批量處理和並發控制
+ */
+async function parseDouyinLinks(text, options = {}) {
+    // 提取所有抖音連結
+    const links = (0, extractDouyinLinks_1.extractDouyinLinks)(text);
+    if (links.length === 0) {
+        return [];
+    }
+    const { concurrency = 3, onProgress } = options;
+    const results = [];
+    const total = links.length;
+    let processed = 0;
+    // 分批處理連結，避免同時發送過多請求
+    for (let i = 0; i < links.length; i += concurrency) {
+        const batch = links.slice(i, i + concurrency);
+        const batchResults = await Promise.all(batch.map(async (link) => {
+            try {
+                return await resolveAndStandardizeDouyinLink(link);
+            }
+            catch (error) {
+                console.error(`解析連結失敗: ${link}`, error);
+                return null;
+            }
+            finally {
+                processed++;
+                if (onProgress) {
+                    onProgress(processed, total);
+                }
+            }
+        }));
+        // 過濾掉 null 結果並添加到結果集
+        results.push(...batchResults.filter((r) => r !== null));
+    }
+    return results;
+}
+/**
+ * 解析並標準化抖音連結
+ * @param url 抖音連結
+ * @returns 標準化後的解析結果
+ *
+ * @remarks
+ * 改寫自原本存放於 src/parser/resolve-links.ts 的功能
+ * 處理不同格式的抖音 URL 並解析 video ID
+ */
+async function resolveAndStandardizeDouyinLink(url) {
+    try {
+        // 處理短連結
+        let expandedUrl = url;
+        if (url.includes('v.douyin.com') || url.includes('iesdouyin.com')) {
+            const resolvedUrl = await expandShortUrl(url);
+            // 如果展開成功，使用展開後的 URL
+            if (resolvedUrl) {
+                expandedUrl = resolvedUrl;
+            }
+        }
+        // 提取影片 ID
+        const id = extractVideoId(expandedUrl);
+        if (!id) {
+            console.warn(`無法從連結提取影片 ID: ${url}`);
+            return null;
+        }
+        // 創建標準 URL
+        const standardUrl = createStandardUrl(id);
+        return {
+            id,
+            standardUrl,
+            originalUrl: url,
+            type: 'video'
+        };
+    }
+    catch (error) {
+        console.error(`標準化連結失敗: ${url}`, error);
+        return null;
+    }
+}
+/**
+ * 展開抖音短連結
+ * @param shortUrl 抖音短連結
+ * @returns 展開後的完整 URL
+ *
+ * @remarks
+ * 改寫自原本存放於 src/parser/resolve-links.ts 的功能
+ * 處理抖音短網址重定向
+ */
+async function expandShortUrl(shortUrl) {
+    try {
+        const response = await fetch(shortUrl, { method: 'HEAD', redirect: 'follow' });
+        return response.url || null;
+    }
+    catch (error) {
+        console.error(`展開短連結失敗: ${shortUrl}`, error);
+        return null;
+    }
+}
+/**
+ * 從抖音 URL 中提取影片 ID
+ * @param url 抖音 URL
+ * @returns 影片 ID
+ *
+ * @remarks
+ * 改寫自原本存放於 src/parser/link-patterns.ts 的功能
+ */
+function extractVideoId(url) {
+    // 標準網頁 URL
+    const videoIdMatch = url.match(/douyin\.com\/video\/(\d+)/i);
+    if (videoIdMatch && videoIdMatch[1]) {
+        return videoIdMatch[1];
+    }
+    // 筆記連結
+    const noteMatch = url.match(/douyin\.com\/note\/(\d+)/i);
+    if (noteMatch && noteMatch[1]) {
+        return noteMatch[1];
+    }
+    // 分享連結
+    const shareMatch = url.match(/douyin\.com\/share\/video\/(\d+)/i);
+    if (shareMatch && shareMatch[1]) {
+        return shareMatch[1];
+    }
+    // 嘗試從 URL 參數中提取
+    try {
+        const url_obj = new URL(url);
+        const videoId = url_obj.searchParams.get('video_id') || url_obj.searchParams.get('vid');
+        if (videoId) {
+            return videoId;
+        }
+    }
+    catch (e) {
+        // URL 解析失敗，忽略錯誤
+    }
+    return null;
+}
+/**
+ * 根據影片 ID 創建標準抖音 URL
+ * @param id 影片 ID
+ * @returns 標準抖音 URL
+ *
+ * @remarks
+ * 改寫自原本存放於 src/parser/resolve-links.ts 的功能
+ */
+function createStandardUrl(id) {
+    return `https://www.douyin.com/video/${id}`;
+}
+//# sourceMappingURL=parseDouyinLinks.js.map

package/dist/src/douyin/parser/parseDouyinLinks.js.map

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

package/dist/src/douyin/parser/resolve-links.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 連結解析與標準化模組
+ * 解析抖音連結並將其標準化
+ */
+import { ParseResult, ParseOptions } from '../../types';
+/**
+ * 標準化抖音影片 URL
+ * @param videoId 影片 ID
+ * @returns 標準化後的抖音影片 URL
+ */
+export declare function createStandardUrl(videoId: string): string;
+/**
+ * 解析抖音短連結並獲取標準 URL
+ * @param shortUrl 抖音短連結
+ * @param options 解析選項
+ * @returns Promise<string | null> 標準抖音影片 URL 或 null
+ */
+export declare function resolveShortUrl(shortUrl: string, options?: Pick<ParseOptions, 'userAgent' | 'retries'>): Promise<string | null>;
+/**
+ * 解析單個抖音連結
+ * @param url 抖音連結
+ * @param options 解析選項
+ * @returns Promise<ParseResult | null> 解析結果或 null
+ */
+export declare function resolveLink(url: string, options?: Pick<ParseOptions, 'userAgent' | 'retries'>): Promise<ParseResult | null>;

package/dist/src/douyin/parser/resolve-links.js

@@ -0,0 +1,131 @@
+"use strict";
+// Copied from src/parser/resolve-links.ts
+// Original file path: src/parser/resolve-links.ts
+/**
+ * 連結解析與標準化模組
+ * 解析抖音連結並將其標準化
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStandardUrl = createStandardUrl;
+exports.resolveShortUrl = resolveShortUrl;
+exports.resolveLink = resolveLink;
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+const fetch_1 = require("../../utils/fetch"); // Updated path to shared utils
+const retry_1 = require("../../utils/retry"); // Updated path to shared utils
+const link_patterns_1 = require("./link-patterns");
+/**
+ * 標準化抖音影片 URL
+ * @param videoId 影片 ID
+ * @returns 標準化後的抖音影片 URL
+ */
+function createStandardUrl(videoId) {
+    return `https://www.douyin.com/video/${videoId}`;
+}
+/**
+ * 解析抖音短連結並獲取標準 URL
+ * @param shortUrl 抖音短連結
+ * @param options 解析選項
+ * @returns Promise<string | null> 標準抖音影片 URL 或 null
+ */
+async function resolveShortUrl(shortUrl, options = {}) {
+    const { userAgent, retries = 3 } = options;
+    try {
+        logger_1.parserLogger.debug(`解析短連結: ${shortUrl}`);
+        // 使用 withRetry 包裝請求，以便在失敗時自動重試
+        const finalUrl = await (0, retry_1.withRetry)(async () => {
+            const response = await (0, fetch_1.enhancedFetch)(shortUrl, {
+                redirect: 'follow', // 自動跟隨重定向
+                headers: {
+                    'User-Agent': userAgent || 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36'
+                }
+            });
+            return response.url; // 返回最終 URL
+        }, { retries });
+        logger_1.parserLogger.debug(`解析後的最終 URL: ${finalUrl}`);
+        // 嘗試從最終 URL 中提取影片 ID
+        const videoId = (0, link_patterns_1.extractVideoId)(finalUrl);
+        if (videoId) {
+            const standardUrl = createStandardUrl(videoId);
+            logger_1.parserLogger.debug(`已提取標準 URL: ${standardUrl}`);
+            return standardUrl;
+        }
+        if (finalUrl.startsWith('https://www.iesdouyin.com/share/video/')) {
+            const response = await (0, fetch_1.enhancedFetch)(shortUrl, {
+                redirect: 'follow', // 自動跟隨重定向
+                headers: {
+                    'User-Agent': userAgent || 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36'
+                }
+            });
+            return response.url;
+        }
+        logger_1.parserLogger.warn(`無法從 URL (${finalUrl}) 提取影片 ID`);
+        return null;
+    }
+    catch (error) {
+        logger_1.parserLogger.error(`解析短連結 ${shortUrl} 失敗:`, error instanceof Error ? error : new Error(String(error)));
+        return null;
+    }
+}
+/**
+ * 解析單個抖音連結
+ * @param url 抖音連結
+ * @param options 解析選項
+ * @returns Promise<ParseResult | null> 解析結果或 null
+ */
+async function resolveLink(url, options = {}) {
+    try {
+        // 獲取連結類型
+        const linkType = (0, link_patterns_1.getLinkType)(url);
+        // 如果連結類型未知，則返回 null
+        if (!linkType) {
+            logger_1.parserLogger.warn(`未知的連結類型: ${url}`);
+            return null;
+        }
+        // 處理不同類型的連結
+        if (linkType.needsRedirect) {
+            // 需要跟隨重定向的連結
+            const standardUrl = await resolveShortUrl(url, options);
+            if (!standardUrl) {
+                return null;
+            }
+            // 從標準 URL 提取影片 ID
+            const videoId = (0, link_patterns_1.extractVideoId)(standardUrl);
+            if (!videoId) {
+                return null;
+            }
+            // Determine link type from the resolved standard URL
+            const finalLinkType = (0, link_patterns_1.getLinkType)(standardUrl);
+            logger_1.parserLogger.debug(`標準化連結 (重定向後): ${standardUrl} (類型: ${finalLinkType?.name || 'unknown'})`); // Use name property
+            return {
+                id: videoId,
+                standardUrl,
+                originalUrl: url,
+                type: finalLinkType?.name === 'standard' ? 'video' : (finalLinkType?.name ? 'unknown' : 'unknown') // Map name to ParseResult type
+                // TODO: Need a better mapping if user links are introduced
+            };
+        }
+        else {
+            // 已經是標準連結，直接提取影片 ID
+            const videoId = (0, link_patterns_1.extractVideoId)(url);
+            if (!videoId) {
+                return null;
+            }
+            const standardUrl = createStandardUrl(videoId);
+            // Determine link type from the standard URL
+            const finalLinkType = (0, link_patterns_1.getLinkType)(standardUrl);
+            logger_1.parserLogger.debug(`標準化連結 (直接): ${standardUrl} (類型: ${finalLinkType?.name || 'unknown'})`); // Use name property
+            return {
+                id: videoId,
+                standardUrl,
+                originalUrl: url,
+                type: finalLinkType?.name === 'standard' ? 'video' : (finalLinkType?.name ? 'unknown' : 'unknown') // Map name to ParseResult type
+                // TODO: Need a better mapping if user links are introduced
+            };
+        }
+    }
+    catch (error) {
+        logger_1.parserLogger.error(`解析連結 ${url} 失敗:`, error instanceof Error ? error : new Error(String(error)));
+        return null;
+    }
+}
+//# sourceMappingURL=resolve-links.js.map

package/dist/src/douyin/parser/resolve-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-links.js","sourceRoot":"","sources":["../../../../src/douyin/parser/resolve-links.ts"],"names":[],"mappings":";AAAA,0CAA0C;AAC1C,kDAAkD;AAClD;;;GAGG;;AAaH,8CAEC;AAQD,0CA4CC;AAQD,kCA+DC;AAxID,+CAA4D,CAAC,sCAAsC;AACnG,6CAAkD,CAAC,+BAA+B;AAClF,6CAA8C,CAAC,+BAA+B;AAE9E,mDAA8D;AAE9D;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,gCAAgC,OAAO,EAAE,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,UAAuD,EAAE;IAEzD,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAE3C,IAAI,CAAC;QACH,qBAAM,CAAC,KAAK,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;QAEnC,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAA,iBAAS,EAAC,KAAK,IAAI,EAAE;YAC1C,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAa,EAAC,QAAQ,EAAE;gBAC7C,QAAQ,EAAE,QAAQ,EAAE,UAAU;gBAC9B,OAAO,EAAE;oBACP,YAAY,EAAE,SAAS,IAAI,iHAAiH;iBAC7I;aACF,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW;QAClC,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAEhB,qBAAM,CAAC,KAAK,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;QAExC,qBAAqB;QACrB,MAAM,OAAO,GAAG,IAAA,8BAAc,EAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC/C,qBAAM,CAAC,KAAK,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC;YAC1C,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,CAAC,wCAAwC,CAAC,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAa,EAAC,QAAQ,EAAE;gBAC7C,QAAQ,EAAE,QAAQ,EAAE,UAAU;gBAC9B,OAAO,EAAE;oBACP,YAAY,EAAE,SAAS,IAAI,iHAAiH;iBAC7I;aACF,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,GAAG,CAAC;QACtB,CAAC;QACD,qBAAM,CAAC,IAAI,CAAC,YAAY,QAAQ,WAAW,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qBAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjG,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,UAAuD,EAAE;IAEzD,IAAI,CAAC;QACH,SAAS;QACT,MAAM,QAAQ,GAAG,IAAA,2BAAW,EAAC,GAAG,CAAC,CAAC;QAElC,oBAAoB;QACpB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,qBAAM,CAAC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,YAAY;QACZ,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC3B,aAAa;YACb,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACxD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,kBAAkB;YAClB,MAAM,OAAO,GAAG,IAAA,8BAAc,EAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC;YACd,CAAC;YAED,qDAAqD;YACrD,MAAM,aAAa,GAAG,IAAA,2BAAW,EAAC,WAAW,CAAC,CAAC;YAC/C,qBAAM,CAAC,KAAK,CAAC,iBAAiB,WAAW,SAAS,aAAa,EAAE,IAAI,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,oBAAoB;YAE5G,OAAO;gBACL,EAAE,EAAE,OAAO;gBACX,WAAW;gBACX,WAAW,EAAE,GAAG;gBAChB,IAAI,EAAE,aAAa,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,+BAA+B;gBAClI,2DAA2D;aAC5D,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,oBAAoB;YACpB,MAAM,OAAO,GAAG,IAAA,8BAAc,EAAC,GAAG,CAAC,CAAC;YACpC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC/C,4CAA4C;YAC5C,MAAM,aAAa,GAAG,IAAA,2BAAW,EAAC,WAAW,CAAC,CAAC;YAC/C,qBAAM,CAAC,KAAK,CAAC,eAAe,WAAW,SAAS,aAAa,EAAE,IAAI,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,oBAAoB;YAE1G,OAAO;gBACL,EAAE,EAAE,OAAO;gBACX,WAAW;gBACX,WAAW,EAAE,GAAG;gBAChB,IAAI,EAAE,aAAa,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,+BAA+B;gBAClI,2DAA2D;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qBAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 抖音影片解析與下載套件
+ *
+ * @packageDocumentation
+ *
+ * @remarks
+ * 免責聲明：本套件僅供學習和個人使用。請遵守抖音平台的服務條款和相關法規。
+ * 用戶須對使用本套件的行為負責，開發者不對任何濫用行為或因此產生的後果負責。
+ * 請尊重原創作者的著作權，不要未經授權分發下載的內容。
+ */
+export * from './types';
+export { AppError, ErrorCode } from './utils/error';
+export * as douyin from './douyin';
+export { Logger, LogLevel } from './utils/logger';
+export { PerformanceMonitor, timeAsync, time } from './utils/performance';
+export { browserManager, cleanupBrowser } from './utils/browser';