xshell 1.0.79 → 1.0.80

package/file.d.ts

@@ -179,23 +179,26 @@ export interface ZipOptions {
         files: boolean;
     };
 }
-/** 将文件夹压缩为 zip
-    返回 fp_zip 或压缩包数据
+/** 将文件夹或文件列表压缩为 zip，返回生成的压缩包路径 (fp_zip)
     - data:
-        - 被压缩文件夹路径 (fpd_src: string) 或
-        - 文件索引对象 (entries: Record<压缩后相对路径, 原文件绝对路径 (string) | 数据 (Uint8Array)>)
-    - fp_zip?:
-        - 传压缩包完整路径时压缩到文件, 函数返回值为 Promise<zip 路径>
-        - 传 undefined 时压缩到内存, 函数返回值为 Promise<zip Uint8Array>
+        - fpd_src: 被压缩文件夹路径 (string) 或
+        - entries: 文件列表 (Record<压缩后相对路径, 原文件绝对路径 (string) | 数据 (Uint8Array)>)
+    - fp_zip: 生成的压缩包路径 (string)
     - options?:
         - dirname?: `fpd_src.fname` 传入 fpd_src 才生效，修改 zip 中顶层的文件夹的名字（需要以 / 结尾），如 'web/', 为空字符串时去掉顶层文件夹，不要多一个文件夹层级 (flat)
         - print?:
             - info?: `true` 开始压缩、压缩完成
             - files?: `true` 打印压缩文件列表 */
-export declare function fzip(entries: Record<string, string | Uint8Array>, fp_zip?: undefined, options?: ZipOptions): Promise<Uint8Array>;
-export declare function fzip(entries: Record<string, string | Uint8Array>, fp_zip: string, options?: ZipOptions): Promise<string>;
-export declare function fzip(fpd_src: string, fp_zip?: undefined, options?: ZipOptions): Promise<Uint8Array>;
-export declare function fzip(fpd_src: string, fp_zip: string, options?: ZipOptions): Promise<string>;
+export declare function fzip(data: string | Record<string, string | Uint8Array>, fp_zip: string, options?: ZipOptions): Promise<string>;
+/** 将文件夹或文件列表压缩为 zip，返回压缩包数据 (Uint8Array)
+    - data:
+        - fpd_src: 被压缩文件夹路径 (string) 或
+        - entries: 文件列表 (Record<压缩后相对路径, 原文件绝对路径 (string) | 数据 (Uint8Array)>)
+    - options?:
+        - print?:
+            - info?: `true` 开始压缩、压缩完成
+            - files?: `true` 打印压缩文件列表 */
+export declare function zip(data: string | Record<string, string | Uint8Array>, options?: ZipOptions): Promise<Buffer>;
 export declare let fwatchers: Record<string, fs.FSWatcher>;
 /** 跟踪文本文件追加的内容，类似 tail -f */
 export declare function ftail(fp: string, handler: (lines: string[]) => void | Promise<void>, { print }?: {

package/file.js

@@ -362,7 +362,31 @@ export async function flink(fp_real, fp_link, { junction = false, print = true }
     else
         fsp.symlink(fp_real, fp_link, is_fpd_real ? 'dir' : 'file');
 }
-export async function fzip(data, fp_zip, { dirname, print = { files: true, info: true } } = {}) {
+/** 将文件夹或文件列表压缩为 zip，返回生成的压缩包路径 (fp_zip)
+    - data:
+        - fpd_src: 被压缩文件夹路径 (string) 或
+        - entries: 文件列表 (Record<压缩后相对路径, 原文件绝对路径 (string) | 数据 (Uint8Array)>)
+    - fp_zip: 生成的压缩包路径 (string)
+    - options?:
+        - dirname?: `fpd_src.fname` 传入 fpd_src 才生效，修改 zip 中顶层的文件夹的名字（需要以 / 结尾），如 'web/', 为空字符串时去掉顶层文件夹，不要多一个文件夹层级 (flat)
+        - print?:
+            - info?: `true` 开始压缩、压缩完成
+            - files?: `true` 打印压缩文件列表 */
+export async function fzip(data, fp_zip, options) {
+    return _zip(data, fp_zip, options);
+}
+/** 将文件夹或文件列表压缩为 zip，返回压缩包数据 (Uint8Array)
+    - data:
+        - fpd_src: 被压缩文件夹路径 (string) 或
+        - entries: 文件列表 (Record<压缩后相对路径, 原文件绝对路径 (string) | 数据 (Uint8Array)>)
+    - options?:
+        - print?:
+            - info?: `true` 开始压缩、压缩完成
+            - files?: `true` 打印压缩文件列表 */
+export async function zip(data, options) {
+    return _zip(data, undefined, options);
+}
+async function _zip(data, fp_zip, { dirname, print = { files: true, info: true } } = {}) {
     let entries;
     let fpd_src;
     if (typeof data === 'string') {
@@ -376,12 +400,14 @@ export async function fzip(data, fp_zip, { dirname, print = { files: true, info:
         entries = Object.fromEntries((await flist(fpd_src, { print: false }))
             .map(fp => ([dirname + fp, fpd_src + fp])));
     }
-    else
+    else {
+        assert(!dirname, 'dirname 在传入 fpd_src 时才生效');
         entries = data;
+    }
     if (print.info)
         console.log(`开始压缩${fpd_src ? ` ${fpd_src}` : '文件索引'} -> ${fp_zip ? `${fp_zip}/${dirname || '{entries}'}` : '内存'}`);
     const { default: archiver } = await import('archiver');
-    let archive = archiver('zip', { zlib: { chunkSize: 16 * 2 ** 20 /* 16 MB */ } });
+    let archive = archiver('zip');
     let ostream = fp_zip ?
         fs.createWriteStream(fp_zip, { highWaterMark: 16 * 2 ** 20 /* 16 MB */ })
         :

package/net.js

@@ -43,15 +43,16 @@ async function request_retry(url, options, timeout, retries = 0, count = 0) {
         return await undici_request(url, options);
     }
     catch (error) {
-        if (count >= retries ||
-            error.name !== 'TimeoutError' && !['ECONNRESET', 'ETIMEDOUT', 'ESOCKETTIMEDOUT'].includes(error.cause?.code))
-            throw error;
-        else {
+        if (count < retries && (error.name === 'AbortError' || error.name === 'TimeoutError')) {
             const duration = 2 ** count;
             console.log(`${t('等待 {{duration}} 秒后重试 fetch ({{_count}}) …', { duration, _count: count }).yellow}  ${url.toString().blue.underline}`);
             await delay(1000 * duration);
             return request_retry(url, options, timeout, retries, count + 1);
         }
+        else if (error.name === 'AbortError' || error.name === 'TimeoutError')
+            throw Object.assign(new Error(`request 超时: ${url.toString()}`), { name: 'TimeoutError' });
+        else
+            throw error;
     }
 }
 export async function request(url, options = {}) {
@@ -118,6 +119,12 @@ export async function request(url, options = {}) {
         })(),
         // todo: 强制手动处理重定向，来正确处理 cookie ?
         maxRedirections: redirect === 'follow' ? 5 : 0,
+        // 下面这些 timeout 都不是总的时间，没法用
+        // headersTimeout: timeout - 1000,
+        // 从收完 headers 开始算
+        // bodyTimeout: timeout - 1000,
+        // @ts-ignore 没有类型声明，实际可用
+        // connectTimeout: timeout - 1000,
         headers,
         // --- body
         body: (() => {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xshell",
-    "version": "1.0.79",
+    "version": "1.0.80",
     "type": "module",
     "main": "./index.js",
     "bin": {

package/utils.browser.d.ts

@@ -56,7 +56,7 @@ export declare function encode(str: string): Uint8Array;
     在流式处理 (buffer 可能不完整) 时，应使用独立的 TextDecoder 实例调用 decode(buffer, { stream: true }) */
 export declare function decode(buffer: Uint8Array): string;
 /** 字符串字典序比较 */
-export declare function strcmp(l: string, r: string): 0 | 1 | -1;
+export declare function strcmp(l: string, r: string): 1 | 0 | -1;
 /** 比较 1.10.02 这种版本号 */
 export declare function vercmp(l: string, r: string): number;
 export declare function get<TReturn = any>(obj: any, keypath: string): TReturn;

package/utils.d.ts

@@ -32,7 +32,7 @@ export declare function map_values<TValue, TNewValue>(obj: {
 /** 映射对象中的 keys, 返回新对象 */
 export declare function filter_keys<TObj>(obj: TObj, filter: (key: string) => any): TObj;
 /** 字符串字典序比较 */
-export declare function strcmp(l: string, r: string): 0 | 1 | -1;
+export declare function strcmp(l: string, r: string): 1 | 0 | -1;
 /** 比较 1.10.02 这种版本号 */
 export declare function vercmp(l: string, r: string): number;
 export declare function get<TReturn = any>(obj: any, keypath: string): TReturn;