@lynker-desktop/electron-sdk 0.0.9-alpha.54 → 0.0.9-alpha.55

package/esm/main/resource-cache.d.ts

@@ -25,6 +25,8 @@ export declare class ResourceCache {
     private _cachedMatchFunction?;
     /** 缓存的来源校验函数（避免重复创建） */
     private _cachedOriginFunction?;
+    /** 正在下载的 URL 集合（避免重复下载） */
+    private _downloadingUrls;
     /**
      * 构造函数
      * @param session Electron session
@@ -69,19 +71,26 @@ export declare class ResourceCache {
      * 下载资源到本地缓存（异步版本，返回 Promise）
      * @param url 资源URL
      * @param filePath 本地缓存路径
+     * @param redirectCount 当前重定向次数（内部使用）
      * @returns Promise<void> 下载完成或失败
      */
-    downloadResourceAsync(url: string, filePath: string): Promise<void>;
+    downloadResourceAsync(url: string, filePath: string, redirectCount?: number): Promise<void>;
     /**
      * 下载资源到本地缓存（同步版本，不返回 Promise，用于拦截器）
      * @param url 资源URL
      * @param filePath 本地缓存路径
      */
     downloadResource(url: string, filePath: string): void;
+    /**
+     * 从文件扩展名获取 MIME 类型
+     * @param ext 文件扩展名（带或不带点）
+     * @returns MIME 类型
+     */
+    private _getMimeTypeFromExt;
     /**
      * 检测并处理 base64 data URL
      * @param url 资源URL
-     * @returns 如果是 base64 URL，返回 true 和文件扩展名；否则返回 false
+     * @returns 如果是 base64 URL，返回 true、文件扩展名、MIME 类型和数据；否则返回 false
      */
     private _isBase64DataUrl;
     /**
@@ -94,24 +103,28 @@ export declare class ResourceCache {
      * 手动缓存指定 URL 的资源
      * @param url 要缓存的资源 URL（支持普通 URL 和 base64 data URL）
      * @param force 是否强制重新下载，即使缓存有效（默认 false）
-     * @returns Promise<{ filePath: string, hostPath: string }> 返回缓存文件路径和主机路径
+     * @returns Promise<{ filePath: string, hostPath: string, mimeType: string, size: number }> 返回缓存文件路径、主机路径、MIME 类型和文件大小
      * @throws 如果 URL 不匹配缓存规则或来源不允许，会抛出错误
      */
     cacheUrl(url: string, force?: boolean, ignoreOrigin?: boolean): Promise<{
         filePath: string;
         hostPath: string;
+        mimeType: string;
+        size: number;
     }>;
     /**
      * 批量缓存多个 URL 的资源
      * @param urls 要缓存的资源 URL 数组
      * @param force 是否强制重新下载，即使缓存有效（默认 false）
-     * @returns Promise<Array<{ url: string, success: boolean, filePath?: string, hostPath?: string, error?: string }>> 返回每个 URL 的缓存结果
+     * @returns Promise<Array<{ url: string, success: boolean, filePath?: string, hostPath?: string, mimeType?: string, size?: number, error?: string }>> 返回每个 URL 的缓存结果
      */
     addCacheUrls(urls: string[], force?: boolean, ignoreOrigin?: boolean): Promise<Array<{
         url: string;
         success: boolean;
         filePath?: string;
         hostPath?: string;
+        mimeType?: string;
+        size?: number;
         error?: string;
     }>>;
     /**
@@ -148,7 +161,7 @@ export declare class ResourceCache {
      */
     private _cleanOldCache;
     /**
-     * 清理所有缓存文件
+     * 清理所有缓存文件（完全异步版本，性能更好）
      * @returns Promise<{ success: number, failed: number, totalSize: number }> 返回清理统计信息
      */
     clearCache(): Promise<{

package/esm/main/resource-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-cache.d.ts","sourceRoot":"","sources":["../../src/main/resource-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resource-cache.d.ts","sourceRoot":"","sources":["../../src/main/resource-cache.ts"],"names":[],"mappings":"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"}

package/esm/main/resource-cache.js

@@ -4,42 +4,24 @@ import http from 'node:http';
 import https from 'node:https';
 import md5 from 'md5';
 import ipc__default from '@lynker-desktop/electron-ipc/main';
+import mime from 'mime-types';
 
 /**
- * MIME 类型到文件扩展名的映射表
+ * HTTP 重定向状态码
  */
-const MIME_TO_EXT = {
-    'image/png': 'png',
-    'image/jpeg': 'jpeg',
-    'image/jpg': 'jpg',
-    'image/gif': 'gif',
-    'image/webp': 'webp',
-    'image/svg+xml': 'svg',
-    'image/x-icon': 'ico',
-    'image/bmp': 'bmp',
-    'image/avif': 'avif',
-    'image/heic': 'heic',
-    'image/heif': 'heif',
-    'image/tiff': 'tiff',
-    'font/woff': 'woff',
-    'font/woff2': 'woff2',
-    'font/ttf': 'ttf',
-    'font/otf': 'otf',
-    'application/font-woff': 'woff',
-    'application/font-woff2': 'woff2',
-    'video/mp4': 'mp4',
-    'video/webm': 'webm',
-    'video/ogg': 'ogg',
-    'audio/mpeg': 'mp3',
-    'audio/wav': 'wav',
-    'text/css': 'css',
-    'text/javascript': 'js',
-    'application/javascript': 'js',
-    'application/json': 'json',
-    'text/xml': 'xml',
-    'text/plain': 'txt',
-    'application/pdf': 'pdf',
-};
+const REDIRECT_STATUS_CODES = [301, 302, 307, 308];
+/**
+ * 默认文件扩展名
+ */
+const DEFAULT_EXT = '.res';
+/**
+ * 默认 MIME 类型
+ */
+const DEFAULT_MIME_TYPE = 'application/octet-stream';
+/**
+ * 最大重定向次数
+ */
+const MAX_REDIRECTS = 5;
 /**
  * 默认配置
  */
@@ -68,6 +50,8 @@ class ResourceCache {
      */
     constructor(session, options) {
         this.cacheHost = `${ResourceCache.scheme}://-`;
+        /** 正在下载的 URL 集合（避免重复下载） */
+        this._downloadingUrls = new Set();
         if (!session)
             throw new Error('ResourceCache: session is required');
         this.session = session;
@@ -94,29 +78,24 @@ class ResourceCache {
         });
         ipc__default.mainIPC.handleRenderer('core:cache', async (options) => {
             try {
-                if (options.method === 'clear') {
-                    return await this.clearCache();
-                }
-                if (options.method === 'add') {
-                    if (typeof options.urls === 'string') {
-                        const data = await this.addCacheUrls([options.urls], options.force ?? false, true);
-                        return data[0];
+                switch (options.method) {
+                    case 'clear':
+                        return await this.clearCache();
+                    case 'add': {
+                        const urls = Array.isArray(options.urls) ? options.urls : options.urls ? [options.urls] : [];
+                        const data = await this.addCacheUrls(urls, options.force ?? false, true);
+                        return Array.isArray(options.urls) ? data : data[0];
                     }
-                    const data = await this.addCacheUrls(options.urls ?? [], options.force ?? false, true);
-                    return data;
-                }
-                if (options.method === 'delete') {
-                    if (typeof options.urls === 'string') {
-                        const data = await this.deleteCacheUrls([options.urls]);
-                        return data[0];
+                    case 'delete': {
+                        const urls = Array.isArray(options.urls) ? options.urls : options.urls ? [options.urls] : [];
+                        const data = await this.deleteCacheUrls(urls);
+                        return Array.isArray(options.urls) ? data : data[0];
                     }
-                    const data = await this.deleteCacheUrls(options.urls ?? []);
-                    return data;
-                }
-                if (options.method === 'stats') {
-                    return await this.getCacheStats();
+                    case 'stats':
+                        return await this.getCacheStats();
+                    default:
+                        return undefined;
                 }
-                return undefined;
             }
             catch (error) {
                 return { success: false, error: error instanceof Error ? error.message : '未知错误' };
@@ -219,11 +198,11 @@ class ResourceCache {
             // 尝试从 URL 中提取扩展名
             try {
                 const urlObj = new URL(url);
-                ext = path.extname(urlObj.pathname) || '.res';
+                ext = path.extname(urlObj.pathname) || DEFAULT_EXT;
             }
             catch {
                 // 如果 URL 解析失败（可能是 base64 data URL），使用默认扩展名
-                ext = '.res';
+                ext = DEFAULT_EXT;
             }
         }
         return {
@@ -263,45 +242,53 @@ class ResourceCache {
      * 下载资源到本地缓存（异步版本，返回 Promise）
      * @param url 资源URL
      * @param filePath 本地缓存路径
+     * @param redirectCount 当前重定向次数（内部使用）
      * @returns Promise<void> 下载完成或失败
      */
-    downloadResourceAsync(url, filePath) {
+    downloadResourceAsync(url, filePath, redirectCount = 0) {
+        // 检查是否正在下载，避免重复下载
+        if (this._downloadingUrls.has(url)) {
+            return Promise.reject(new Error(`资源正在下载中: ${url}`));
+        }
+        // 检查重定向次数限制
+        if (redirectCount >= MAX_REDIRECTS) {
+            return Promise.reject(new Error(`重定向次数超过限制 (${MAX_REDIRECTS}): ${url}`));
+        }
+        this._downloadingUrls.add(url);
         return new Promise((resolve, reject) => {
             const tempFilePath = `${filePath}.cache`;
             const lib = url.startsWith('https') ? https : http;
             const file = fs.createWriteStream(tempFilePath);
             let request;
             const cleanupAndAbort = (errMsg, err) => {
-                if (err) {
-                    console.log(errMsg, err);
-                }
-                else {
-                    console.log(errMsg);
-                }
+                this._downloadingUrls.delete(url);
                 if (request) {
                     request.destroy();
                 }
                 file.close(() => {
-                    // 使用 existsSync 避免在文件不存在时 unlink 抛出错误
-                    if (fs.existsSync(tempFilePath)) {
-                        fs.unlink(tempFilePath, () => { });
-                    }
+                    // 异步删除临时文件，不阻塞
+                    fs.promises.unlink(tempFilePath).catch(() => {
+                        // 忽略删除失败
+                    });
                 });
-                reject(new Error(errMsg));
+                const error = err instanceof Error ? err : new Error(errMsg);
+                reject(error);
             };
             request = lib.get(url, (res) => {
                 // 处理重定向
-                if (res.statusCode === 301 || res.statusCode === 302 || res.statusCode === 307 || res.statusCode === 308) {
+                if (res.statusCode && REDIRECT_STATUS_CODES.includes(res.statusCode)) {
                     const location = res.headers.location;
                     if (location) {
                         request.destroy();
                         file.close(() => {
-                            if (fs.existsSync(tempFilePath)) {
-                                fs.unlink(tempFilePath, () => { });
-                            }
+                            // 异步删除临时文件，不阻塞
+                            fs.promises.unlink(tempFilePath).catch(() => {
+                                // 忽略删除失败
+                            });
                         });
-                        // 递归处理重定向
-                        this.downloadResourceAsync(location, filePath).then(resolve).catch(reject);
+                        this._downloadingUrls.delete(url);
+                        // 递归处理重定向，增加重定向计数
+                        this.downloadResourceAsync(location, filePath, redirectCount + 1).then(resolve).catch(reject);
                         return;
                     }
                     // 如果没有 location，继续处理为错误
@@ -319,6 +306,7 @@ class ResourceCache {
                         return cleanupAndAbort(`关闭临时文件流失败: ${tempFilePath}`, err);
                     }
                     fs.rename(tempFilePath, filePath, (renameErr) => {
+                        this._downloadingUrls.delete(url);
                         if (renameErr) {
                             cleanupAndAbort(`缓存文件重命名失败 from ${tempFilePath} to ${filePath}`, renameErr);
                         }
@@ -334,6 +322,13 @@ class ResourceCache {
             request.on('error', (err) => {
                 cleanupAndAbort(`下载资源请求失败: ${url}`, err);
             });
+            // 添加超时处理（30秒）
+            const timeout = setTimeout(() => {
+                cleanupAndAbort(`下载超时: ${url}`);
+            }, 30000);
+            request.on('close', () => {
+                clearTimeout(timeout);
+            });
         });
     }
     /**
@@ -343,14 +338,28 @@ class ResourceCache {
      */
     downloadResource(url, filePath) {
         // 异步执行，不等待完成
-        this.downloadResourceAsync(url, filePath).catch((err) => {
-            console.log('后台下载资源失败:', err);
+        // 如果正在下载，跳过（避免重复下载）
+        if (this._downloadingUrls.has(url)) {
+            return;
+        }
+        this.downloadResourceAsync(url, filePath).catch(() => {
+            // 静默处理错误，避免日志过多
         });
     }
+    /**
+     * 从文件扩展名获取 MIME 类型
+     * @param ext 文件扩展名（带或不带点）
+     * @returns MIME 类型
+     */
+    _getMimeTypeFromExt(ext) {
+        const cleanExt = ext.replace(/^\./, '').toLowerCase();
+        const mimeType = mime.lookup(cleanExt);
+        return mimeType || DEFAULT_MIME_TYPE;
+    }
     /**
      * 检测并处理 base64 data URL
      * @param url 资源URL
-     * @returns 如果是 base64 URL，返回 true 和文件扩展名；否则返回 false
+     * @returns 如果是 base64 URL，返回 true、文件扩展名、MIME 类型和数据；否则返回 false
      */
     _isBase64DataUrl(url) {
         if (!url.startsWith('data:')) {
@@ -368,16 +377,21 @@ class ResourceCache {
             if (!header.includes('base64')) {
                 return { isBase64: false };
             }
-            // 从 mediatype 中提取文件扩展名
-            // 例如：data:image/png;base64 -> png
-            // 例如：data:image/jpeg;base64 -> jpeg
-            let ext = 'res';
+            // 从 mediatype 中提取文件扩展名和 MIME 类型
+            // 例如：data:image/png;base64 -> png, image/png
+            // 例如：data:image/jpeg;base64 -> jpeg, image/jpeg
+            let ext = DEFAULT_EXT.replace(/^\./, '');
+            let mimeType = DEFAULT_MIME_TYPE;
             const mimeMatch = header.match(/data:([^;]+)/);
             if (mimeMatch && mimeMatch[1]) {
-                const mimeType = mimeMatch[1];
-                ext = MIME_TO_EXT[mimeType] || ext;
+                mimeType = mimeMatch[1];
+                // 使用 mime-types 包从 MIME 类型获取扩展名
+                const extension = mime.extension(mimeType);
+                if (extension) {
+                    ext = extension;
+                }
             }
-            return { isBase64: true, ext, data };
+            return { isBase64: true, ext, mimeType, data };
         }
         catch (error) {
             return { isBase64: false };
@@ -404,7 +418,7 @@ class ResourceCache {
      * 手动缓存指定 URL 的资源
      * @param url 要缓存的资源 URL（支持普通 URL 和 base64 data URL）
      * @param force 是否强制重新下载，即使缓存有效（默认 false）
-     * @returns Promise<{ filePath: string, hostPath: string }> 返回缓存文件路径和主机路径
+     * @returns Promise<{ filePath: string, hostPath: string, mimeType: string, size: number }> 返回缓存文件路径、主机路径、MIME 类型和文件大小
      * @throws 如果 URL 不匹配缓存规则或来源不允许，会抛出错误
      */
     async cacheUrl(url, force = false, ignoreOrigin = false) {
@@ -417,13 +431,25 @@ class ResourceCache {
             }
             // 获取缓存路径（使用检测到的扩展名）
             const cachePath = this.getCachedPath(url, base64Info.ext);
+            const mimeType = base64Info.mimeType || this._getMimeTypeFromExt(base64Info.ext);
             // 如果缓存有效且不强制重新下载，直接返回
             if (!force && await this.isCacheValidAsync(cachePath.filePath)) {
-                return cachePath;
+                const stats = await fs.promises.stat(cachePath.filePath);
+                return {
+                    ...cachePath,
+                    mimeType,
+                    size: stats.size
+                };
             }
             // 保存 base64 数据到文件
             await this._saveBase64ToFile(base64Info.data, cachePath.filePath);
-            return cachePath;
+            // 获取文件大小
+            const stats = await fs.promises.stat(cachePath.filePath);
+            return {
+                ...cachePath,
+                mimeType,
+                size: stats.size
+            };
         }
         // 处理普通 URL
         const shouldCache = this._getMatchFunction();
@@ -438,19 +464,33 @@ class ResourceCache {
         }
         // 获取缓存路径
         const cachePath = this.getCachedPath(url);
+        // 从文件扩展名获取 MIME 类型
+        const ext = path.extname(cachePath.filePath).replace(/^\./, '') || DEFAULT_EXT.replace(/^\./, '');
+        const mimeType = this._getMimeTypeFromExt(ext);
         // 如果缓存有效且不强制重新下载，直接返回
         if (!force && await this.isCacheValidAsync(cachePath.filePath)) {
-            return cachePath;
+            const stats = await fs.promises.stat(cachePath.filePath);
+            return {
+                ...cachePath,
+                mimeType,
+                size: stats.size
+            };
         }
         // 下载资源
         await this.downloadResourceAsync(url, cachePath.filePath);
-        return cachePath;
+        // 获取文件大小
+        const stats = await fs.promises.stat(cachePath.filePath);
+        return {
+            ...cachePath,
+            mimeType,
+            size: stats.size
+        };
     }
     /**
      * 批量缓存多个 URL 的资源
      * @param urls 要缓存的资源 URL 数组
      * @param force 是否强制重新下载，即使缓存有效（默认 false）
-     * @returns Promise<Array<{ url: string, success: boolean, filePath?: string, hostPath?: string, error?: string }>> 返回每个 URL 的缓存结果
+     * @returns Promise<Array<{ url: string, success: boolean, filePath?: string, hostPath?: string, mimeType?: string, size?: number, error?: string }>> 返回每个 URL 的缓存结果
      */
     async addCacheUrls(urls, force = false, ignoreOrigin = false) {
         const results = await Promise.allSettled(urls.map(url => this.cacheUrl(url, force, ignoreOrigin)));
@@ -461,7 +501,9 @@ class ResourceCache {
                     url,
                     success: true,
                     filePath: result.value.filePath,
-                    hostPath: result.value.hostPath
+                    hostPath: result.value.hostPath,
+                    mimeType: result.value.mimeType,
+                    size: result.value.size
                 };
             }
             else {
@@ -553,45 +595,44 @@ class ResourceCache {
         }
     }
     /**
-     * 清理所有缓存文件
+     * 清理所有缓存文件（完全异步版本，性能更好）
      * @returns Promise<{ success: number, failed: number, totalSize: number }> 返回清理统计信息
      */
     async clearCache() {
         try {
-            const files = fs.readdirSync(this.options.cacheDir);
+            const files = await fs.promises.readdir(this.options.cacheDir);
             if (files.length === 0) {
-                console.log('缓存目录为空，无需清理');
                 return { success: 0, failed: 0, totalSize: 0 };
             }
-            // 先统计所有文件大小（避免并行时的竞态条件）
-            const fileInfos = files.map((file) => {
+            // 并行获取所有文件信息（避免并行时的竞态条件）
+            const fileInfos = await Promise.allSettled(files.map(async (file) => {
                 const filePath = path.join(this.options.cacheDir, file);
                 try {
-                    const stats = fs.statSync(filePath);
+                    const stats = await fs.promises.stat(filePath);
                     return { file, filePath, size: stats.size };
                 }
                 catch (error) {
                     return { file, filePath, size: 0, error };
                 }
-            });
+            }));
+            const validInfos = fileInfos
+                .filter((r) => r.status === 'fulfilled')
+                .map(r => r.value);
             // 计算总大小
-            const totalSize = fileInfos.reduce((sum, info) => sum + info.size, 0);
+            const totalSize = validInfos.reduce((sum, info) => sum + info.size, 0);
             // 并行删除文件，提升性能
-            const deleteResults = await Promise.allSettled(fileInfos.map(async (info) => {
+            const deleteResults = await Promise.allSettled(validInfos.map(async (info) => {
                 try {
                     await fs.promises.unlink(info.filePath);
                     return { success: true, file: info.file };
                 }
                 catch (error) {
-                    console.log(`清理缓存文件失败: ${info.file}`, error);
                     throw error;
                 }
             }));
             // 统计成功和失败数量
             const success = deleteResults.filter(r => r.status === 'fulfilled').length;
             const failed = deleteResults.filter(r => r.status === 'rejected').length;
-            const sizeMB = (totalSize / (1024 * 1024)).toFixed(2);
-            console.log(`缓存清理完成: 成功 ${success} 个, 失败 ${failed} 个, 释放空间 ${sizeMB} MB`);
             return { success, failed, totalSize };
         }
         catch (error) {