xshell 1.3.54 → 1.3.56

package/net.d.ts

@@ -116,7 +116,7 @@ export declare function request(url: string | URL, options: RequestOptions & {
 }): Promise<Buffer>;
 export declare function request(url: string | URL, options: RequestOptions): Promise<string>;
 /** 发起 http 请求并将响应体作为 json 解析 */
-export declare function request_json<T = any>(url: string | URL, options?: RequestOptions): Promise<T>;
+export declare function request_json<TReturn = any>(url: string | URL, options?: RequestOptions): Promise<TReturn>;
 export interface ConnectOptions {
     local_port?: number;
     timeout?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xshell",
-    "version": "1.3.54",
+    "version": "1.3.56",
     "type": "module",
     "main": "./index.js",
     "bin": {
@@ -55,9 +55,9 @@
         "@stylistic/eslint-plugin": "^5.10.0",
         "@svgr/webpack": "^8.1.0",
         "@types/sass-loader": "^8.0.10",
-        "@typescript-eslint/eslint-plugin": "^8.58.1",
-        "@typescript-eslint/parser": "^8.58.1",
-        "@typescript-eslint/utils": "^8.58.1",
+        "@typescript-eslint/eslint-plugin": "^8.58.2",
+        "@typescript-eslint/parser": "^8.58.2",
+        "@typescript-eslint/utils": "^8.58.2",
         "archiver": "^7.0.1",
         "chalk": "^5.6.2",
         "commander": "^14.0.3",
@@ -73,8 +73,8 @@
         "license-webpack-plugin": "^4.0.2",
         "mime-types": "^3.0.2",
         "p-map": "^7.0.4",
-        "react": "^19.2.4",
-        "react-i18next": "^17.0.2",
+        "react": "^19.2.5",
+        "react-i18next": "^17.0.3",
         "resolve-path": "^1.4.0",
         "sass": "^1.99.0",
         "sass-loader": "^16.0.7",
@@ -85,8 +85,8 @@
         "ts-loader": "^9.5.7",
         "tslib": "^2.8.1",
         "typescript": "^6.0.2",
-        "undici": "^8.0.2",
-        "webpack": "^5.105.4",
+        "undici": "^8.1.0",
+        "webpack": "^5.106.1",
         "webpack-bundle-analyzer": "^5.3.0",
         "ws": "^8.20.0"
     },
@@ -99,10 +99,10 @@
         "@types/koa": "^3.0.2",
         "@types/koa-compress": "^4.0.7",
         "@types/mime-types": "^3.0.1",
-        "@types/node": "^25.5.2",
+        "@types/node": "^25.6.0",
         "@types/react": "^19.2.14",
         "@types/tough-cookie": "^4.0.5",
-        "@types/vscode": "^1.110.0",
+        "@types/vscode": "^1.115.0",
         "@types/webpack-bundle-analyzer": "^4.7.0",
         "@types/ws": "^8.18.1"
     }

package/utils.common.d.ts

@@ -30,11 +30,11 @@ export declare function sort_keys<TObj>(obj: TObj): TObj;
 export declare function vercmp(l: string, r: string, loose?: boolean): number;
 /** 将 keys, values 数组按对应的顺序组合成一个对象 */
 export declare function zip_object<TValue>(keys: (string | number)[], values: TValue[]): Record<string, TValue>;
-/** 映射对象中的 keys, 返回新对象
-    - obj: 对象
+/** 映射数据对象 (或数组) 中的 keys, 返回新对象 (或数组)
+    - obj: 数据对象, 数据对象数组
     - mapper?: `to_snake_case` (key: string) => string 或者 Record<string, string> 一对一映射键
-    - overrider?: 添加一些键到返回的新对象上 */
-export declare function map_keys<TReturn>(obj: any, mapper?: ((key: string) => string) | Record<string, string>, overrider?: (mapped: any) => Partial<TReturn>): TReturn;
+    - overrider?: 添加一些键到返回的新对象上，只对顶层有效 */
+export declare function map_keys<TReturn = any>(obj: any, mapper?: ((key: string) => string) | Record<string, string>, overrider?: (mapped: any) => Partial<TReturn>, recursive?: boolean): TReturn;
 /** 返回一个映射对象 keys 的函数，通常和 .map 函数一起使用 */
 export declare function get_key_mapper<TReturn>(mapper?: ((key: string) => string) | Record<string, string>, overrider?: (mapped: any) => Partial<TReturn>): (obj: any) => TReturn;
 /** 映射对象中的 values, 返回新对象 */

package/utils.common.js

@@ -98,16 +98,24 @@ export function zip_object(keys, values) {
         return obj;
     }, {});
 }
-/** 映射对象中的 keys, 返回新对象
-    - obj: 对象
+/** 映射数据对象 (或数组) 中的 keys, 返回新对象 (或数组)
+    - obj: 数据对象, 数据对象数组
     - mapper?: `to_snake_case` (key: string) => string 或者 Record<string, string> 一对一映射键
-    - overrider?: 添加一些键到返回的新对象上 */
-export function map_keys(obj, mapper = to_snake_case, overrider) {
-    const obj_ = Object.fromEntries(Object.entries(obj)
-        .map(typeof mapper === 'function' ?
-        ([key, value]) => [mapper(key), value]
+    - overrider?: 添加一些键到返回的新对象上，只对顶层有效 */
+export function map_keys(obj, mapper = to_snake_case, overrider, recursive = false) {
+    if (Array.isArray(obj))
+        return obj.map(v => map_keys(v, mapper, overrider, recursive));
+    if (!obj || Object.prototype.toString.call(obj) !== '[object Object]')
+        return obj;
+    const map_key = typeof mapper === 'function' ?
+        mapper
         :
-            ([key, value]) => [mapper[key] || key, value]));
+            (key) => mapper[key] || key;
+    const obj_ = Object.fromEntries(Object.entries(obj)
+        .map(([key, value]) => [
+        map_key(key),
+        recursive ? map_keys(value, mapper, undefined, recursive) : value
+    ]));
     return (overrider ? { ...obj_, ...overrider(obj_) } : obj_);
 }
 /** 返回一个映射对象 keys 的函数，通常和 .map 函数一起使用 */

package/utils.d.ts

@@ -54,6 +54,8 @@ export declare class DecoderStream extends Transform {
     _transform(chunk: Uint8Array, encoding: BufferEncoding, callback: TransformCallback): void;
     _flush(callback: TransformCallback): void;
 }
+/** 返回一个 transform 流，来截取可读流的前 nbytes 字节 */
+export declare function slice_stream(nbytes: number): Transform;
 /** 根据 range 生成整数序列 (iterable)
     - range: 取值为逗号分割的多个可用值或值区间 (不能含有空格)，比如：`8321,8322,8300-8310,11000-11999`
     - reverse?: `false` 在 range 内从后往前生成 */

package/utils.js

@@ -3,7 +3,7 @@ import util from 'node:util';
 import ncrypto from 'node:crypto';
 import "./prototype.js";
 import "./platform.js";
-import { assert, decode, defer } from "./utils.common.js";
+import { assert, check, decode, defer } from "./utils.common.js";
 export * from "./utils.common.js";
 /** `180` 输出字符宽度 */
 export const output_width = 180;
@@ -137,6 +137,23 @@ export class DecoderStream extends Transform {
         callback();
     }
 }
+/** 返回一个 transform 流，来截取可读流的前 nbytes 字节 */
+export function slice_stream(nbytes) {
+    let remaining = nbytes;
+    return new Transform({
+        transform(chunk, encoding, callback) {
+            if (chunk.length < remaining) {
+                this.push(chunk);
+                remaining -= chunk.length;
+                callback();
+                return;
+            }
+            // 最后一块
+            check(chunk.length === remaining, '可读流最后一块大小应该不超过 remaining');
+            callback(null, chunk);
+        }
+    });
+}
 /** 根据 range 生成整数序列 (iterable)
     - range: 取值为逗号分割的多个可用值或值区间 (不能含有空格)，比如：`8321,8322,8300-8310,11000-11999`
     - reverse?: `false` 在 range 内从后往前生成 */