xshell 0.0.33 → 0.0.36

package/file.d.ts

@@ -8,7 +8,7 @@ declare module 'memfs' {
         is_mfs: true;
     }
 }
-export * from './ufs';
+export * from './ufs.js';
 export { MFS };
 export declare type Encoding = 'utf-8' | 'gb18030' | 'shift-jis' | 'binary';
 export declare function create_mfs(): MFS.IFs;
@@ -60,7 +60,7 @@ export declare function flist(fpd: string, { filter, deep, absolute, print }?: {
     deep?: boolean;
     absolute?: boolean;
     print?: boolean;
-}): Promise<any[]>;
+}): Promise<string[]>;
 /** delete file or directory (use rimraf to delete directory fast)
     - fp: path
     - options?:
@@ -107,7 +107,10 @@ export declare function fmkdir(fpd: string, options?: fs.MakeDirectoryOptions &
     print?: boolean;
     suppress_existence?: boolean;
 }): Promise<void>;
-/** - link: can be file path or directory path */
+/**
+    - fp_real: current real file path
+    - fp_link: file path or directory path
+*/
 export declare function flink(fp_real: string, fp_link: string, { junction, print }?: {
     junction?: boolean;
     print?: boolean;
@@ -124,14 +127,14 @@ export declare let fwatchers: Record<string, fs.FSWatcher>;
     save fs.FSWatcher in watchers, subsequent call will auto close existing watcher for the same fp
     
     https://nodejs.org/dist/latest-v15.x/docs/api/fs.html#fs_fs_watch_filename_options_listener
-    The listener callback gets two arguments (event, filename).
+    The listener callback gets two arguments (event, fname).
         event is either 'rename' or 'change', and filename is the name of the file which triggered the event.
         On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.
     
     The listener callback is attached to the 'change' event fired by fs.FSWatcher, but it is not the same thing as the 'change' value of event.
     
 */
-export declare function fwatch(fp: string, onchange: (event: string, filename: string) => any, { exec }?: {
+export declare function fwatch(fp: string, onchange: (event: string, fname: string) => any, { exec }?: {
     exec?: boolean;
 }): Promise<fs.FSWatcher>;
 /** open a file and replace certain pattern */

package/file.js

@@ -8,12 +8,12 @@ const iconv_lite_1 = tslib_1.__importDefault(require("iconv-lite"));
 const readdir_enhanced_1 = require("readdir-enhanced");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const rimraf_1 = tslib_1.__importDefault(require("rimraf"));
-const debounce_1 = tslib_1.__importDefault(require("lodash/debounce"));
+const debounce_js_1 = tslib_1.__importDefault(require("lodash/debounce.js"));
 const memfs_1 = tslib_1.__importDefault(require("memfs"));
 exports.MFS = memfs_1.default;
-const prototype_1 = require("./prototype");
-const utils_1 = require("./utils");
-tslib_1.__exportStar(require("./ufs"), exports);
+const prototype_js_1 = require("./prototype.js");
+const utils_js_1 = require("./utils.js");
+tslib_1.__exportStar(require("./ufs.js"), exports);
 function create_mfs() {
     exports.mfs = memfs_1.default.createFsFromVolume(new memfs_1.default.Volume());
     exports.mfs.join = upath_1.default.join.bind(upath_1.default);
@@ -25,7 +25,7 @@ async function fread(fp, { dir, encoding = 'utf-8', print = true } = {}) {
     if (dir)
         fp = upath_1.default.join(dir, fp);
     else if (!upath_1.default.isAbsolute(fp))
-        throw new Error('fp must be absolute path, or pass in "dir" parameter');
+        throw new Error('fp must be absolute path, or pass in \'dir\' parameter');
     if (print)
         console.log(`read: ${fp}`);
     const buffer = await fs_1.promises.readFile(fp);
@@ -61,7 +61,7 @@ async function fwrite(fp, data, { dir, encoding = 'utf-8', print = true } = {})
     if (encoding === 'gb18030')
         data = iconv_lite_1.default.encode(data, encoding);
     if (!Buffer.isBuffer(data) && typeof data !== 'string')
-        data = (0, prototype_1.to_json)(data);
+        data = (0, prototype_js_1.to_json)(data);
     await fs_1.promises.writeFile(fp, data);
 }
 exports.fwrite = fwrite;
@@ -209,7 +209,10 @@ async function fmkdir(fpd, options = {}) {
     await fs_1.promises.mkdir(fpd, { recursive: true });
 }
 exports.fmkdir = fmkdir;
-/** - link: can be file path or directory path */
+/**
+    - fp_real: current real file path
+    - fp_link: file path or directory path
+*/
 async function flink(fp_real, fp_link, { junction = false, print = true } = {}) {
     if (!upath_1.default.isAbsolute(fp_real) || !upath_1.default.isAbsolute(fp_link))
         throw new Error('fpd must be absolute path');
@@ -231,7 +234,7 @@ async function flink(fp_real, fp_link, { junction = false, print = true } = {})
 }
 exports.flink = flink;
 function link_shortcut(target, name, { args } = {}) {
-    const cmd = (0, utils_1.dedent) `
+    const cmd = (0, utils_js_1.dedent) `
         $wsh_shell                 = New-Object -comObject WScript.Shell
         $shortcut                  = $wsh_shell.CreateShortcut("d:/links/#{name}.lnk")
         $shortcut.TargetPath       = '${target}'
@@ -253,7 +256,7 @@ exports.fwatchers = {};
     save fs.FSWatcher in watchers, subsequent call will auto close existing watcher for the same fp
     
     https://nodejs.org/dist/latest-v15.x/docs/api/fs.html#fs_fs_watch_filename_options_listener
-    The listener callback gets two arguments (event, filename).
+    The listener callback gets two arguments (event, fname).
         event is either 'rename' or 'change', and filename is the name of the file which triggered the event.
         On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.
     
@@ -267,13 +270,15 @@ async function fwatch(fp, onchange, { exec = true } = {}) {
     if (_watcher)
         _watcher.close();
     if (exec)
-        await onchange('change', fp);
-    const debounced_onchange = (0, debounce_1.default)((event, filename) => {
-        console.log(`file changed (${event}): ${filename}`);
-        onchange(event, upath_1.default.normalize(filename));
+        await onchange('change', fp.fname);
+    const debounced_onchange = (0, debounce_js_1.default)((event, fname) => {
+        console.log(`file changed (${event}): ${fname}`);
+        onchange(event, upath_1.default.normalize(fname));
     }, 500, { leading: false, trailing: true });
-    const watcher = (0, fs_1.watch)(fp, debounced_onchange);
-    watcher.on('error', error => { console.error(error); });
+    let watcher = (0, fs_1.watch)(fp, debounced_onchange);
+    watcher.on('error', error => {
+        console.error(error);
+    });
     return exports.fwatchers[fp] = watcher;
 }
 exports.fwatch = fwatch;

package/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["file.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fsp, watch } from 'fs'\nimport type fs from 'fs'\n\nimport path from 'upath'\nimport iconv from 'iconv-lite'\nimport { readdirAsync } from 'readdir-enhanced'\nimport fse from 'fs-extra'\nimport rimraf from 'rimraf'\n\nimport debounce from 'lodash/debounce'\n\n\nimport MFS from 'memfs'\ndeclare module 'memfs' {\n    interface IFs {\n        join: typeof path.join\n        is_mfs: true\n    }\n}\n\nimport { to_json } from './prototype'\nimport { dedent } from './utils'\nexport * from './ufs'\n\nexport { MFS }\n\nexport type Encoding = 'utf-8' | 'gb18030' | 'shift-jis' | 'binary'\n\n\nexport function create_mfs () {\n    mfs = MFS.createFsFromVolume(\n        new MFS.Volume()\n    )\n    \n    mfs.join = path.join.bind(path)\n    mfs.is_mfs = true\n    \n    return mfs\n}\n\nexport let mfs: MFS.IFs\n\n\nexport async function fread (fp: string): Promise<string>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding: 'binary', print?: boolean }): Promise<Buffer>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding?: Encoding | 'auto', print?: boolean }): Promise<string>\nexport async function fread (fp: string, {\n    dir, \n    encoding = 'utf-8', \n    print = true\n}: {\n    dir?: string\n    encoding?: Encoding | 'auto'\n    print?: boolean } = { }\n) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log(`read: ${fp}`)\n        \n    const buffer = await fsp.readFile(fp)\n    \n    if (encoding === 'binary')\n        return buffer\n    \n    if (encoding === 'utf-8')\n        return buffer.toString('utf8')\n    \n    if (encoding === 'auto') {\n        const { detect } = await import('chardet')\n        encoding = detect(buffer) as any\n        if (print)\n            console.log(`${fp} probably has encoding: ${encoding.toLowerCase()}`)\n    }\n    \n    return iconv.decode(buffer, encoding)\n}\n\nexport async function fread_lines (fp: string, options: { dir?: string, encoding?: Exclude<Encoding, 'binary'> | 'auto', print?: boolean } = { }) {\n    return (await fread(fp, options))\n        .split_lines()\n}\n\nexport async function fread_json <T = any> (fp: string, options: { dir?: string, encoding?: Encoding, print?: boolean } = { }): Promise<T> {\n    return JSON.parse(\n        await fread(fp, options)\n    )\n}\n\n\nexport async function fwrite (fp: string, data: Buffer, options?: { dir?: string, print?: boolean }): Promise<void>\nexport async function fwrite (fp: string, data: any, options?: { dir?: string, encoding?: Encoding, print?: boolean }): Promise<void>\nexport async function fwrite (fp: string, data: any, { dir, encoding = 'utf-8', print = true }: { dir?: string, encoding?: Encoding, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log('write:', fp)\n    \n    if (encoding === 'gb18030')\n        data = iconv.encode(data, encoding)\n    \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        data = to_json(data)\n    \n    await fsp.writeFile(fp, data)\n}\n\nexport async function fappend (fp: string, data: any, { dir, print = true }: { dir?: string, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log('append:', fp)\n        \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        throw new Error('data is not Buffer or string')\n        \n    await fsp.appendFile(fp, data)\n}\n\n\n/**\n    - fpd: absolute path of directory\n    - optoins?:\n        - deep?: `false` recursively\n        - absolute?: `false` return absolute path\n        - print?: `true`\n        - filter?: `true`  RegExp | (fp: string) => any\n*/\nexport async function flist (fpd: string, {\n    filter, \n    deep = false, \n    absolute = false,\n    print = true\n}: {\n    filter?: RegExp | ((fp: string) => any)\n    deep?: boolean\n    absolute?: boolean\n    print?: boolean\n} = { }) {\n    if (!path.isAbsolute(fpd))\n        throw new Error('fpd must be absolute path')\n    \n    let fps = await readdirAsync(fpd, {\n        ...(absolute ? { basePath: fpd } : { }),\n        deep,\n        stats: false,\n    })\n    \n    let fps_ = [ ]\n    \n    const filter_regexp = filter instanceof RegExp\n    const filter_fn = Boolean(filter && !filter_regexp)\n    \n    for (let fp of fps) {\n        fp = path.normalize(fp)\n        \n        if (filter_regexp && !filter.test(fp))\n            continue\n            \n        if (filter_fn && !(filter as Function)(fp))\n            continue\n            \n        if (print)\n            console.log(fp)\n        \n        fps_.push(fp)\n    }\n    \n    return fps_\n}\n\n\n/** delete file or directory (use rimraf to delete directory fast)  \n    - fp: path\n    - options?:\n        - print?: `true` (effective only delete single file)\n*/\nexport async function fdelete (fp: string, { print = true, fast = false }: { print?: boolean, fast?: boolean } = { }) {\n    if (fp.length < 6) throw new Error(`${fp} too short`)\n    if (!path.isAbsolute(fp))\n        throw new Error('fpd must be absolute path')\n    \n    if (fp.is_dir) {\n        if (print)\n            console.log(`delete directory: ${fp}`.red)\n        await new Promise<void>((resolve, reject) => {\n            rimraf(fp, { glob: false, disableGlob: true }, error => {\n                if (error)\n                    reject(error)\n                else\n                    resolve()\n            })\n        })\n    } else {\n        if (print)\n            console.log('delete:', fp)\n        await fsp.unlink(fp)\n    }\n}\n\n\n/** copy file or direcotry\n    - src: src file/directory absolute path\n    - dst: dst file/directory absolute path\n    @example\n    fcopy('d:/temp/camera/', 'd:/camera/')\n*/\nexport async function fcopy (src: string, dst: string, {\n    print = true,\n    overwrite = true,\n}: {\n    print?: boolean\n    overwrite?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/')) throw new Error('src and dst must be both file path or directory path')\n    if (!path.isAbsolute(src) || !path.isAbsolute(dst)) throw new Error('src and dst must be absolute path')\n    if (print)\n        console.log(`copy: ${src} → ${dst}`)\n    await fse.copy(src, dst, { overwrite, errorOnExist: true })\n}\n\n\n/** move file or direcotry\n    - src: src file/directory absolute path\n    - dst: dst file/directory absolute path\n    @example\n    fmove('d:/temp/camera/', 'd:/camera/')\n*/\nexport async function fmove (src: string, dst: string, {\n    overwrite = false,\n    print = true\n}: {\n    overwrite?: boolean\n    print?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/')) throw new Error('src and dst must be both file path or directory path')\n    if (!path.isAbsolute(src) || !path.isAbsolute(dst)) throw new Error('src and dst must be absolute path')\n    if (print)\n        console.log(`move: ${src} → ${dst}`)\n    await fse.move(src, dst, { overwrite })\n}\n\n\n/** rename file  \n    - fp:  current filename/path\n    - fp_: new filename/path\n    - options?:\n        - fpd?: fp and fp_ is in same directory\n        - print?: `true`\n        - overwrite?: `true`  better performance without check\n */\nexport async function frename (\n    fp: string, \n    fp_: string,\n    {\n        fpd,\n        print = true,\n        overwrite = true\n    }: {\n        fpd?: string\n        print?: boolean\n        overwrite?: boolean\n    } = { }\n) {\n    if (fpd) {\n        fp = path.join(fpd, fp)\n        fp_ = path.join(fpd, fp_)\n    } else if (!path.isAbsolute(fp) || !path.isAbsolute(fp_))\n        throw new Error('fp and fp_ must be absolute path')\n    \n    if (print)\n        console.log('rename:', fp, '→', fp_)\n    \n    if (!overwrite && fp_.fexists)\n        throw new Error(`file already exists：${fp_}`)\n    \n    await fsp.rename(fp, fp_)\n}\n\n\nexport async function fmkdir (fpd: string, options: fs.MakeDirectoryOptions & { print?: boolean, suppress_existence?: boolean } = { }) {\n    if (!path.isAbsolute(fpd))\n        throw new Error('fpd must be absolute path')\n    \n    options.print ??= true\n    \n    if (fpd.fexists)\n        if (fpd.is_dir) {\n            if (options.print && !options.suppress_existence)\n                console.log('directory already exists:', fpd)\n            return\n        } else throw new Error(`file with same name already exists, cannot create directory: ${fpd}`)\n    else if (options.print)\n        console.log('mkdir:', fpd)\n    \n    await fsp.mkdir(fpd, { recursive: true })\n}\n\n\n/** - link: can be file path or directory path */\nexport async function flink (\n    fp_real: string, \n    fp_link: string, \n    {\n        junction = false,\n        print = true \n    }: { \n        junction?: boolean\n        print?: boolean\n} = { }) {\n    if (!path.isAbsolute(fp_real) || !path.isAbsolute(fp_link))\n        throw new Error('fpd must be absolute path')\n    \n    if (fp_link.fexists)\n        if (fp_link.is_dir)\n            fp_link = path.join(fp_link, fp_real.fname)\n        else if ( (await fsp.lstat(fp_link)).isSymbolicLink() ) {\n            console.log('link already exists:', fp_link)\n            return\n        } else\n            throw new Error('file with same name already exists, cannot create new link')\n        \n    \n    if (print)\n        console.log(`source file ${fp_real} linked to ${fp_link}`)\n    \n    if (junction)\n        fsp.symlink(fp_real, fp_link, 'junction')\n    else\n        fsp.symlink(fp_real, fp_link, fp_real.is_dir ? 'dir' : 'file')\n}\n\n\nexport function link_shortcut (target: string, name: string, { args }: { args?: string[] } = { }) {\n    const cmd = dedent`\n        $wsh_shell                 = New-Object -comObject WScript.Shell\n        $shortcut                  = $wsh_shell.CreateShortcut(\"d:/links/#{name}.lnk\")\n        $shortcut.TargetPath       = '${target}'\n        $shortcut.Arguments        = \"${args || ''}\"\n        $shortcut.WorkingDirectory = '${target.fdir}'\n        ${ target.is_dir ? '$shortcut.IconLocation = \"%SystemRoot%\\\\System32\\\\SHELL32.dll,3\"' : '' }\n        $shortcut.Save()\n    `\n    console.log(cmd)\n    // await psh(cmd)\n}\n\n\nexport let fwatchers: Record<string, fs.FSWatcher> = { }\n\n/**\n    - fp: path of file or directory\n    - callback: called when modified\n    - exec: call callback when watch is executed\n    \n    save fs.FSWatcher in watchers, subsequent call will auto close existing watcher for the same fp\n    \n    https://nodejs.org/dist/latest-v15.x/docs/api/fs.html#fs_fs_watch_filename_options_listener  \n    The listener callback gets two arguments (event, filename). \n        event is either 'rename' or 'change', and filename is the name of the file which triggered the event.\n        On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.\n    \n    The listener callback is attached to the 'change' event fired by fs.FSWatcher, but it is not the same thing as the 'change' value of event.  \n    \n*/\nexport async function fwatch (\n    fp: string, \n    onchange: (event: string, filename: string) => any,\n    { exec = true }: { exec?: boolean } = { }\n) {\n    if (!path.isAbsolute(fp)) throw new Error('fp must be absolute path')\n    \n    const _watcher = fwatchers[fp]\n    if (_watcher)\n        _watcher.close()\n    \n    if (exec)\n        await onchange('change', fp)\n    \n    const debounced_onchange = debounce((event, filename) => {\n        console.log(`file changed (${event}): ${filename}`)\n        onchange(event, path.normalize(filename))\n    }, 500, { leading: false, trailing: true })\n    const watcher = watch(fp, debounced_onchange)\n    watcher.on('error', error => { console.error(error) })\n    return fwatchers[fp] = watcher\n}\n\n\n/** open a file and replace certain pattern */\nexport async function freplace (fp: string, pattern: string | RegExp, replacement: string) {\n    await fwrite(\n        fp,\n        (await fread(fp))\n            .replaceAll(pattern, replacement)\n    )\n}\n\n/** convert file encoding to UTF-8\n    - fp: file absolute path\n    - options?:\n        - dryrun?: `true`\n        - encoding?: `'auto'`\n*/\nexport async function f2utf8 (fp: string, {\n    dryrun = true,\n    encoding = 'auto',\n}: {\n    dryrun?: boolean\n    encoding?: Encoding | 'auto'\n} = { }) {\n    const text = await fread(fp, { encoding })\n    if (dryrun) {\n        console.log(text.slice(0, 10000))\n        return\n    }\n    \n    const fp_bak = `${fp.fdir}${fp.fname.replace(/(.*?)(\\.[^.]+)?$/, '$1.bak$2')}`\n    if (!fp_bak.fexists)\n        await fcopy(fp, fp_bak)\n    \n    await fwrite(fp, text)\n}\n\n"]}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["file.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fsp, watch } from 'fs'\nimport type fs from 'fs'\n\nimport path from 'upath'\nimport iconv from 'iconv-lite'\nimport { readdirAsync } from 'readdir-enhanced'\nimport fse from 'fs-extra'\nimport rimraf from 'rimraf'\n\nimport debounce from 'lodash/debounce.js'\n\n\nimport MFS from 'memfs'\ndeclare module 'memfs' {\n    interface IFs {\n        join: typeof path.join\n        is_mfs: true\n    }\n}\n\nimport { to_json } from './prototype.js'\nimport { dedent } from './utils.js'\nexport * from './ufs.js'\n\n\nexport { MFS }\n\nexport type Encoding = 'utf-8' | 'gb18030' | 'shift-jis' | 'binary'\n\n\nexport function create_mfs () {\n    mfs = MFS.createFsFromVolume(\n        new MFS.Volume()\n    )\n    \n    mfs.join = path.join.bind(path)\n    mfs.is_mfs = true\n    \n    return mfs\n}\n\nexport let mfs: MFS.IFs\n\n\nexport async function fread (fp: string): Promise<string>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding: 'binary', print?: boolean }): Promise<Buffer>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding?: Encoding | 'auto', print?: boolean }): Promise<string>\nexport async function fread (fp: string, {\n    dir, \n    encoding = 'utf-8', \n    print = true\n}: {\n    dir?: string\n    encoding?: Encoding | 'auto'\n    print?: boolean } = { }\n) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \\'dir\\' parameter')\n    \n    if (print)\n        console.log(`read: ${fp}`)\n    \n    const buffer = await fsp.readFile(fp)\n    \n    if (encoding === 'binary')\n        return buffer\n    \n    if (encoding === 'utf-8')\n        return buffer.toString('utf8')\n    \n    if (encoding === 'auto') {\n        const { detect } = await import('chardet')\n        encoding = detect(buffer) as any\n        if (print)\n            console.log(`${fp} probably has encoding: ${encoding.toLowerCase()}`)\n    }\n    \n    return iconv.decode(buffer, encoding)\n}\n\nexport async function fread_lines (fp: string, options: { dir?: string, encoding?: Exclude<Encoding, 'binary'> | 'auto', print?: boolean } = { }) {\n    return (await fread(fp, options))\n        .split_lines()\n}\n\nexport async function fread_json <T = any> (fp: string, options: { dir?: string, encoding?: Encoding, print?: boolean } = { }): Promise<T> {\n    return JSON.parse(\n        await fread(fp, options)\n    )\n}\n\n\nexport async function fwrite (fp: string, data: Buffer, options?: { dir?: string, print?: boolean }): Promise<void>\nexport async function fwrite (fp: string, data: any, options?: { dir?: string, encoding?: Encoding, print?: boolean }): Promise<void>\nexport async function fwrite (fp: string, data: any, { dir, encoding = 'utf-8', print = true }: { dir?: string, encoding?: Encoding, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log('write:', fp)\n    \n    if (encoding === 'gb18030')\n        data = iconv.encode(data, encoding)\n    \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        data = to_json(data)\n    \n    await fsp.writeFile(fp, data)\n}\n\nexport async function fappend (fp: string, data: any, { dir, print = true }: { dir?: string, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log('append:', fp)\n        \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        throw new Error('data is not Buffer or string')\n        \n    await fsp.appendFile(fp, data)\n}\n\n\n/**\n    - fpd: absolute path of directory\n    - optoins?:\n        - deep?: `false` recursively\n        - absolute?: `false` return absolute path\n        - print?: `true`\n        - filter?: `true`  RegExp | (fp: string) => any\n*/\nexport async function flist (fpd: string, {\n    filter, \n    deep = false, \n    absolute = false,\n    print = true\n}: {\n    filter?: RegExp | ((fp: string) => any)\n    deep?: boolean\n    absolute?: boolean\n    print?: boolean\n} = { }) {\n    if (!path.isAbsolute(fpd))\n        throw new Error('fpd must be absolute path')\n    \n    let fps = await readdirAsync(fpd, {\n        ...(absolute ? { basePath: fpd } : { }),\n        deep,\n        stats: false,\n    })\n    \n    let fps_: string[] = [ ]\n    \n    const filter_regexp = filter instanceof RegExp\n    const filter_fn = Boolean(filter && !filter_regexp)\n    \n    for (let fp of fps) {\n        fp = path.normalize(fp)\n        \n        if (filter_regexp && !filter.test(fp))\n            continue\n            \n        if (filter_fn && !(filter as Function)(fp))\n            continue\n            \n        if (print)\n            console.log(fp)\n        \n        fps_.push(fp)\n    }\n    \n    return fps_\n}\n\n\n/** delete file or directory (use rimraf to delete directory fast)  \n    - fp: path\n    - options?:\n        - print?: `true` (effective only delete single file)\n*/\nexport async function fdelete (fp: string, { print = true, fast = false }: { print?: boolean, fast?: boolean } = { }) {\n    if (fp.length < 6) throw new Error(`${fp} too short`)\n    if (!path.isAbsolute(fp))\n        throw new Error('fpd must be absolute path')\n    \n    if (fp.is_dir) {\n        if (print)\n            console.log(`delete directory: ${fp}`.red)\n        await new Promise<void>((resolve, reject) => {\n            rimraf(fp, { glob: false, disableGlob: true }, error => {\n                if (error)\n                    reject(error)\n                else\n                    resolve()\n            })\n        })\n    } else {\n        if (print)\n            console.log('delete:', fp)\n        await fsp.unlink(fp)\n    }\n}\n\n\n/** copy file or direcotry\n    - src: src file/directory absolute path\n    - dst: dst file/directory absolute path\n    @example\n    fcopy('d:/temp/camera/', 'd:/camera/')\n*/\nexport async function fcopy (src: string, dst: string, {\n    print = true,\n    overwrite = true,\n}: {\n    print?: boolean\n    overwrite?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/'))\n        throw new Error('src and dst must be both file path or directory path')\n    \n    if (!path.isAbsolute(src) || !path.isAbsolute(dst))\n        throw new Error('src and dst must be absolute path')\n    \n    if (print)\n        console.log(`copy: ${src} → ${dst}`)\n    \n    await fse.copy(src, dst, { overwrite, errorOnExist: true })\n}\n\n\n/** move file or direcotry\n    - src: src file/directory absolute path\n    - dst: dst file/directory absolute path\n    @example\n    fmove('d:/temp/camera/', 'd:/camera/')\n*/\nexport async function fmove (src: string, dst: string, {\n    overwrite = false,\n    print = true\n}: {\n    overwrite?: boolean\n    print?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/'))\n        throw new Error('src and dst must be both file path or directory path')\n    \n    if (!path.isAbsolute(src) || !path.isAbsolute(dst))\n        throw new Error('src and dst must be absolute path')\n    \n    if (print)\n        console.log(`move: ${src} → ${dst}`)\n    \n    await fse.move(src, dst, { overwrite })\n}\n\n\n/** rename file  \n    - fp:  current filename/path\n    - fp_: new filename/path\n    - options?:\n        - fpd?: fp and fp_ is in same directory\n        - print?: `true`\n        - overwrite?: `true`  better performance without check\n */\nexport async function frename (\n    fp: string, \n    fp_: string,\n    {\n        fpd,\n        print = true,\n        overwrite = true\n    }: {\n        fpd?: string\n        print?: boolean\n        overwrite?: boolean\n    } = { }\n) {\n    if (fpd) {\n        fp = path.join(fpd, fp)\n        fp_ = path.join(fpd, fp_)\n    } else if (!path.isAbsolute(fp) || !path.isAbsolute(fp_))\n        throw new Error('fp and fp_ must be absolute path')\n    \n    if (print)\n        console.log('rename:', fp, '→', fp_)\n    \n    if (!overwrite && fp_.fexists)\n        throw new Error(`file already exists：${fp_}`)\n    \n    await fsp.rename(fp, fp_)\n}\n\n\nexport async function fmkdir (fpd: string, options: fs.MakeDirectoryOptions & { print?: boolean, suppress_existence?: boolean } = { }) {\n    if (!path.isAbsolute(fpd))\n        throw new Error('fpd must be absolute path')\n    \n    options.print ??= true\n    \n    if (fpd.fexists)\n        if (fpd.is_dir) {\n            if (options.print && !options.suppress_existence)\n                console.log('directory already exists:', fpd)\n            return\n        } else throw new Error(`file with same name already exists, cannot create directory: ${fpd}`)\n    else if (options.print)\n        console.log('mkdir:', fpd)\n    \n    await fsp.mkdir(fpd, { recursive: true })\n}\n\n\n/** \n    - fp_real: current real file path\n    - fp_link: file path or directory path\n*/\nexport async function flink (\n    fp_real: string, \n    fp_link: string, \n    {\n        junction = false,\n        print = true \n    }: { \n        junction?: boolean\n        print?: boolean\n} = { }) {\n    if (!path.isAbsolute(fp_real) || !path.isAbsolute(fp_link))\n        throw new Error('fpd must be absolute path')\n    \n    if (fp_link.fexists)\n        if (fp_link.is_dir)\n            fp_link = path.join(fp_link, fp_real.fname)\n        else if ( (await fsp.lstat(fp_link)).isSymbolicLink() ) {\n            console.log('link already exists:', fp_link)\n            return\n        } else\n            throw new Error('file with same name already exists, cannot create new link')\n        \n    \n    if (print)\n        console.log(`source file ${fp_real} linked to ${fp_link}`)\n    \n    if (junction)\n        fsp.symlink(fp_real, fp_link, 'junction')\n    else\n        fsp.symlink(fp_real, fp_link, fp_real.is_dir ? 'dir' : 'file')\n}\n\n\nexport function link_shortcut (target: string, name: string, { args }: { args?: string[] } = { }) {\n    const cmd = dedent`\n        $wsh_shell                 = New-Object -comObject WScript.Shell\n        $shortcut                  = $wsh_shell.CreateShortcut(\"d:/links/#{name}.lnk\")\n        $shortcut.TargetPath       = '${target}'\n        $shortcut.Arguments        = \"${args || ''}\"\n        $shortcut.WorkingDirectory = '${target.fdir}'\n        ${ target.is_dir ? '$shortcut.IconLocation = \"%SystemRoot%\\\\System32\\\\SHELL32.dll,3\"' : '' }\n        $shortcut.Save()\n    `\n    console.log(cmd)\n    // await psh(cmd)\n}\n\n\nexport let fwatchers: Record<string, fs.FSWatcher> = { }\n\n/**\n    - fp: path of file or directory\n    - callback: called when modified\n    - exec: call callback when watch is executed\n    \n    save fs.FSWatcher in watchers, subsequent call will auto close existing watcher for the same fp\n    \n    https://nodejs.org/dist/latest-v15.x/docs/api/fs.html#fs_fs_watch_filename_options_listener  \n    The listener callback gets two arguments (event, fname). \n        event is either 'rename' or 'change', and filename is the name of the file which triggered the event.\n        On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.\n    \n    The listener callback is attached to the 'change' event fired by fs.FSWatcher, but it is not the same thing as the 'change' value of event.  \n    \n*/\nexport async function fwatch (\n    fp: string,\n    onchange: (event: string, fname: string) => any, \n    { exec = true }: { exec?: boolean } = { }\n) {\n    if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path')\n    \n    const _watcher = fwatchers[fp]\n    if (_watcher)\n        _watcher.close()\n    \n    if (exec)\n        await onchange('change', fp.fname)\n    \n    const debounced_onchange = debounce(\n        (event, fname) => {\n            console.log(`file changed (${event}): ${fname}`)\n            onchange(event, path.normalize(fname))\n        },\n        500,\n        { leading: false, trailing: true }\n    )\n    \n    let watcher = watch(fp, debounced_onchange)\n    watcher.on('error', error => {\n        console.error(error)\n    })\n    return fwatchers[fp] = watcher\n}\n\n\n/** open a file and replace certain pattern */\nexport async function freplace (fp: string, pattern: string | RegExp, replacement: string) {\n    await fwrite(\n        fp,\n        (await fread(fp))\n            .replaceAll(pattern, replacement)\n    )\n}\n\n/** convert file encoding to UTF-8\n    - fp: file absolute path\n    - options?:\n        - dryrun?: `true`\n        - encoding?: `'auto'`\n*/\nexport async function f2utf8 (fp: string, {\n    dryrun = true,\n    encoding = 'auto',\n}: {\n    dryrun?: boolean\n    encoding?: Encoding | 'auto'\n} = { }) {\n    const text = await fread(fp, { encoding })\n    if (dryrun) {\n        console.log(text.slice(0, 10000))\n        return\n    }\n    \n    const fp_bak = `${fp.fdir}${fp.fname.replace(/(.*?)(\\.[^.]+)?$/, '$1.bak$2')}`\n    if (!fp_bak.fexists)\n        await fcopy(fp, fp_bak)\n    \n    await fwrite(fp, text)\n}\n\n"]}

package/net.browser.d.ts

@@ -21,3 +21,76 @@ export declare function request(url: string | URL, options: RequestRawOptions):
 export declare function request(url: string | URL, options: RequestOptions): Promise<string>;
 /** 发起 http 请求并将响应体作为 json 解析 */
 export declare function request_json<T = any>(url: string, options?: RequestOptions): Promise<T>;
+export declare function connect_websocket(url: string | URL, { protocols, on_open, on_close, on_error, on_message }: {
+    protocols?: string | string[];
+    on_open?(event: any, websocket: WebSocket): any;
+    on_close?(event: {
+        code: number;
+        reason: string;
+    }, websocket: WebSocket): any;
+    on_error?(event: any, websocket: WebSocket): any;
+    on_message(event: {
+        data: ArrayBuffer;
+    }, websocket: WebSocket): any;
+}): Promise<WebSocket>;
+/** 二进制消息格式
+    - json.length (小端序): 4 字节
+    - json 数据
+    - binary 数据
+*/
+export interface Message<T extends any[] = any[]> {
+    /** 本次 rpc 的 id */
+    id?: number;
+    /** rpc 发起方指定被调用的 function name, 多个相同 id, func 的 message 组成一个请求流 */
+    func?: string;
+    /** 等待执行，但不要序列化返回 func 的执行结果 (message 中无 args) */
+    ignore?: boolean;
+    /** 不等待 func 执行，remote 收到后直接确认返回 (message 中 done = true) */
+    async?: boolean;
+    /** 这个数组里面要么是对应的 JS 参数，要么是 Uint8Array 参数对应的 binary length
+        args 可以是:
+        - rpc 发起方调用 func 的参数，或者请求流 message 携带的数据
+        - 作为结果或者响应流的 message 数据，传给请求发起方
+    */
+    args?: T;
+    /** bins: 哪几个 arg 是 Uint8Array 类型的，如: [0, 3] */
+    bins?: number[];
+    /** 被调方执行 func 产生的错误 */
+    error?: Error;
+    /** 如果请求或者响应是一个流，通过这个 flag 表明是最后一个 message, 并且可以销毁 handler 了 */
+    done?: boolean;
+}
+/** 通过创建 Remote 对象对 WebSocket RPC 进行抽象
+    调用方使用 remote.call 进行调用
+    被调方在创建 Remote 对象时传入 funcs 注册处理函数，并使用 Remote.handle 方法处理 WebSocket message
+*/
+export declare class Remote {
+    url: string;
+    websocket: WebSocket;
+    id: number;
+    /** 被调方的 message 处理器 */
+    funcs: Record<string, (message: Message, websocket?: WebSocket) => void | Promise<void>>;
+    /** 调用方发起的 rpc 对应响应的 message 处理器 */
+    handlers: ((message: Message) => any)[];
+    print: boolean;
+    get connected(): boolean;
+    static parse<T extends any[] = any[]>(array_buffer: ArrayBuffer): Message<T>;
+    static pack({ id, func, ignore, async: _async, done, error, args: _args, }: Message): Uint8Array;
+    constructor({ url, funcs, websocket, }?: {
+        url?: string;
+        funcs?: Remote['funcs'];
+        websocket?: WebSocket;
+    });
+    connect(): Promise<void>;
+    disconnect(): void;
+    send(message: Message, websocket?: WebSocket): void;
+    /** 调用 remote 中的 func, 返回结果由 handler 处理，处理 done message 之后的返回值作为 call 函数的返回值 */
+    call<T extends any[] = any[], R = any>(message: Message, handler: (message: Message<T>) => any): Promise<R>;
+    /** 处理接收到的 WebSocket message
+        1. 被调用方接收 message 并开始处理
+        2. 调用方处理 message 响应
+    */
+    handle(event: {
+        data: ArrayBuffer;
+    }, websocket: WebSocket): Promise<void>;
+}

package/net.browser.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.request_json = exports.request = void 0;
+exports.Remote = exports.connect_websocket = exports.request_json = exports.request = void 0;
+const utils_browser_js_1 = require("./utils.browser.js");
 async function request(url, { method, queries, headers, body, type = 'application/json', cors, by = window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch', raw, } = {}) {
     url = new URL(url, location.href);
     if (queries)
@@ -67,4 +68,161 @@ async function request_json(url, options) {
     }
 }
 exports.request_json = request_json;
+let decoder = new TextDecoder();
+let encoder = new TextEncoder();
+async function connect_websocket(url, { protocols, on_open, on_close, on_error, on_message }) {
+    let websocket = new WebSocket(url, protocols);
+    // https://stackoverflow.com/questions/11821096/what-is-the-difference-between-an-arraybuffer-and-a-blob/39951543
+    websocket.binaryType = 'arraybuffer';
+    return new Promise((resolve, reject) => {
+        websocket.addEventListener('open', async (event) => {
+            console.log(`${websocket.url} opened`);
+            await on_open?.(event, websocket);
+            resolve(websocket);
+        });
+        websocket.addEventListener('close', event => {
+            console.log(`${websocket.url} closed with code = ${event.code}, reason = '${event.reason}'`);
+            on_close?.(event, websocket);
+        });
+        websocket.addEventListener('error', event => {
+            const message = `${websocket.url} errored`;
+            console.error(message, event);
+            on_error?.(event, websocket);
+            reject(Object.assign(new Error(message), { event }));
+        });
+        websocket.addEventListener('message', event => {
+            on_message(event, websocket);
+        });
+    });
+}
+exports.connect_websocket = connect_websocket;
+/** 通过创建 Remote 对象对 WebSocket RPC 进行抽象
+    调用方使用 remote.call 进行调用
+    被调方在创建 Remote 对象时传入 funcs 注册处理函数，并使用 Remote.handle 方法处理 WebSocket message
+*/
+class Remote {
+    constructor({ url, funcs = {}, websocket, } = {}) {
+        this.id = 0;
+        /** 调用方发起的 rpc 对应响应的 message 处理器 */
+        this.handlers = [];
+        this.print = false;
+        this.url = url;
+        this.funcs = funcs;
+        this.websocket = websocket;
+    }
+    get connected() {
+        return this.websocket?.readyState === WebSocket.OPEN;
+    }
+    static parse(array_buffer) {
+        const buf = new Uint8Array(array_buffer);
+        const dv = new DataView(array_buffer);
+        const len_json = dv.getUint32(0, true);
+        let offset = 4 + len_json;
+        let message = JSON.parse(decoder.decode(buf.subarray(4, offset)));
+        message.args || (message.args = []);
+        if (message.bins) {
+            let args = message.args;
+            for (const ibin of message.bins) {
+                const len_buf = args[ibin];
+                args[ibin] = buf.subarray(offset, offset + len_buf);
+                offset += len_buf;
+            }
+        }
+        return message;
+    }
+    static pack({ id, func, ignore, async: _async, done, error, args: _args = [], }) {
+        let args = [..._args];
+        let bins = [];
+        let bufs = [];
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            if (arg instanceof Uint8Array) {
+                bins.push(i);
+                bufs.push(arg);
+                args[i] = arg.length;
+            }
+        }
+        const data_json = {
+            id,
+            ...func ? { func } : {},
+            ...ignore ? { ignore } : {},
+            ..._async ? { async: _async } : {},
+            ...done ? { done } : {},
+            ...error ? { error } : {},
+            ...args.length ? { args } : {},
+            ...bins.length ? { bins } : {},
+        };
+        const str_json = encoder.encode(JSON.stringify(data_json));
+        let dv = new DataView(new ArrayBuffer(4));
+        dv.setUint32(0, str_json.length, true);
+        return (0, utils_browser_js_1.concat)([
+            dv,
+            str_json,
+            ...bufs
+        ]);
+    }
+    async connect() {
+        this.websocket = await connect_websocket(this.url, {
+            on_message: this.handle.bind(this)
+        });
+    }
+    disconnect() {
+        this.websocket?.close();
+        this.id = 0;
+        this.handlers = [];
+    }
+    send(message, websocket = this.websocket) {
+        if (!('id' in message))
+            message.id = this.id;
+        websocket.send(Remote.pack(message));
+    }
+    /** 调用 remote 中的 func, 返回结果由 handler 处理，处理 done message 之后的返回值作为 call 函数的返回值 */
+    async call(message, handler) {
+        return new Promise((resolve, reject) => {
+            this.handlers[this.id] = async (message) => {
+                const { error, done } = message;
+                if (error) {
+                    reject(Object.assign(new Error(), error));
+                    return;
+                }
+                let result = await handler(message);
+                if (done)
+                    resolve(result);
+            };
+            this.send(message);
+            this.id++;
+        });
+    }
+    /** 处理接收到的 WebSocket message
+        1. 被调用方接收 message 并开始处理
+        2. 调用方处理 message 响应
+    */
+    async handle(event, websocket) {
+        const message = Remote.parse(event.data);
+        const { func, id, done } = message;
+        if (this.print)
+            console.log(message);
+        if (func) // 作为被调方
+            try {
+                const handler = this.funcs[func] || this.funcs.default;
+                if (!handler)
+                    throw new Error(`找不到 rpc handler: ${func}`);
+                await handler(message, websocket);
+            }
+            catch (error) {
+                this.send({
+                    id: message.id,
+                    error,
+                    done: true
+                }, websocket);
+                throw error;
+            }
+        else { // 作为发起方
+            this.handlers[id](message);
+            if (done)
+                this.handlers[id] = null;
+        }
+    }
+}
+exports.Remote = Remote;
 //# sourceMappingURL=net.browser.js.map

package/net.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"net.browser.js","sourceRoot":"","sources":["net.browser.ts"],"names":[],"mappings":"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","sourcesContent":["export interface RequestOptions {\n    method?: 'get' | 'post' | 'put' | 'head' | 'delete' | 'patch'\n    \n    queries?: Record<string, any>\n    \n    headers?: Record<string, string>\n    \n    body?: string | object | HTMLFormElement\n    \n    type?: 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data'\n    \n    cors?: boolean\n    \n    by?: 'fetch' | 'GM_xmlhttpRequest'\n}\n\nexport interface RequestRawOptions extends RequestOptions {\n    raw: true\n}\n\n/**\n    - url: 可以只有 pathname 部分\n    - options:\n        - type: `'application/json'` 请求的 content-type 头 (如果有 body)\n        - by: `window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch'` 发起请求所使用的底层方法\n*/\nexport async function request (url: string | URL): Promise<string>\nexport async function request (url: string | URL, options: RequestRawOptions): Promise<Response>\nexport async function request (url: string | URL, options: RequestOptions): Promise<string>\nexport async function request (url: string | URL, {\n    method,\n    \n    queries,\n    \n    headers,\n    \n    body,\n    \n    type = 'application/json',\n    \n    cors,\n    \n    by = window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch',\n    \n    raw,\n}: RequestOptions & { raw?: boolean } = { }) {\n    url = new URL(url, location.href)\n    \n    if (queries)\n        for (const key in queries) {\n            let value = queries[key]\n            if (typeof value === 'boolean')\n                value = value ? '1' : '0'\n            url.searchParams.append(key, value)\n        }\n    \n    if (body && !method)\n        method = 'post'\n    \n    if (type === 'application/json' && typeof body !== 'undefined' && typeof body !== 'string')\n        body = JSON.stringify(body)\n    \n    url = url.toString()\n    \n    if (by === 'fetch') {\n        const options: RequestInit = {\n            ... method ? { method: method.toUpperCase() } : { },\n            \n            ... cors ? { mode: 'cors' } : { },\n            \n            credentials: 'include',\n            \n            headers: {\n                ... body ? { 'content-type': type } : { },\n                ... headers,\n            },\n            \n            ... body   ? { body: body as string } : { },\n        }\n        \n        const response = await fetch(\n            url,\n            options\n        )\n        \n        if (!response.ok)\n            throw Object.assign(\n                new Error(`StatusCodeError: ${response.status}`),\n                { url, response, ...options }\n            )\n        \n        if (raw)\n            return response\n        \n        return response.text()\n    }\n    \n    \n    return new Promise((resolve, reject) => {\n        GM_xmlhttpRequest({\n            ... method ? { method: (method as any).toUpperCase() } : { },\n            \n            url: url as string,\n            \n            headers: {\n                ... body ? { 'content-type': type } : { },\n                ... headers,\n            },\n            \n            ... body ? { data: body as string, } : { },\n            \n            onload (response) {\n                if (!(200 <= response.status && response.status <= 299)) {\n                    reject(\n                        Object.assign(\n                            new Error(`StatusCodeError: ${response.status}`), \n                            { url, queries, method, headers, body, response }\n                        )\n                    )\n                    return\n                }\n                \n                resolve(response.responseText)\n            }\n        })\n    })\n}\n\n\n/** 发起 http 请求并将响应体作为 json 解析 */\nexport async function request_json <T = any> (url: string, options?: RequestOptions): Promise<T> {\n    const resp = await request(url, options)\n    if (!resp) return\n    try {\n        return JSON.parse(resp)\n    } catch (error) {\n        console.error(resp)\n        throw error\n    }\n}\n\n"]}
+{"version":3,"file":"net.browser.js","sourceRoot":"","sources":["net.browser.ts"],"names":[],"mappings":"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","sourcesContent":["import { concat } from './utils.browser.js'\n\nexport interface RequestOptions {\n    method?: 'get' | 'post' | 'put' | 'head' | 'delete' | 'patch'\n    \n    queries?: Record<string, any>\n    \n    headers?: Record<string, string>\n    \n    body?: string | object | HTMLFormElement\n    \n    type?: 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data'\n    \n    cors?: boolean\n    \n    by?: 'fetch' | 'GM_xmlhttpRequest'\n}\n\nexport interface RequestRawOptions extends RequestOptions {\n    raw: true\n}\n\n/**\n    - url: 可以只有 pathname 部分\n    - options:\n        - type: `'application/json'` 请求的 content-type 头 (如果有 body)\n        - by: `window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch'` 发起请求所使用的底层方法\n*/\nexport async function request (url: string | URL): Promise<string>\nexport async function request (url: string | URL, options: RequestRawOptions): Promise<Response>\nexport async function request (url: string | URL, options: RequestOptions): Promise<string>\nexport async function request (url: string | URL, {\n    method,\n    \n    queries,\n    \n    headers,\n    \n    body,\n    \n    type = 'application/json',\n    \n    cors,\n    \n    by = window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch',\n    \n    raw,\n}: RequestOptions & { raw?: boolean } = { }) {\n    url = new URL(url, location.href)\n    \n    if (queries)\n        for (const key in queries) {\n            let value = queries[key]\n            if (typeof value === 'boolean')\n                value = value ? '1' : '0'\n            url.searchParams.append(key, value)\n        }\n    \n    if (body && !method)\n        method = 'post'\n    \n    if (type === 'application/json' && typeof body !== 'undefined' && typeof body !== 'string')\n        body = JSON.stringify(body)\n    \n    url = url.toString()\n    \n    if (by === 'fetch') {\n        const options: RequestInit = {\n            ... method ? { method: method.toUpperCase() } : { },\n            \n            ... cors ? { mode: 'cors' } : { },\n            \n            credentials: 'include',\n            \n            headers: {\n                ... body ? { 'content-type': type } : { },\n                ... headers,\n            },\n            \n            ... body   ? { body: body as string } : { },\n        }\n        \n        const response = await fetch(\n            url,\n            options\n        )\n        \n        if (!response.ok)\n            throw Object.assign(\n                new Error(`StatusCodeError: ${response.status}`),\n                { url, response, ...options }\n            )\n        \n        if (raw)\n            return response\n        \n        return response.text()\n    }\n    \n    \n    return new Promise((resolve, reject) => {\n        GM_xmlhttpRequest({\n            ... method ? { method: (method as any).toUpperCase() } : { },\n            \n            url: url as string,\n            \n            headers: {\n                ... body ? { 'content-type': type } : { },\n                ... headers,\n            },\n            \n            ... body ? { data: body as string, } : { },\n            \n            onload (response) {\n                if (!(200 <= response.status && response.status <= 299)) {\n                    reject(\n                        Object.assign(\n                            new Error(`StatusCodeError: ${response.status}`), \n                            { url, queries, method, headers, body, response }\n                        )\n                    )\n                    return\n                }\n                \n                resolve(response.responseText)\n            }\n        })\n    })\n}\n\n\n/** 发起 http 请求并将响应体作为 json 解析 */\nexport async function request_json <T = any> (url: string, options?: RequestOptions): Promise<T> {\n    const resp = await request(url, options)\n    if (!resp) return\n    try {\n        return JSON.parse(resp)\n    } catch (error) {\n        console.error(resp)\n        throw error\n    }\n}\n\n\n\nlet decoder = new TextDecoder()\n\nlet encoder = new TextEncoder()\n\n\nexport async function connect_websocket (\n    url: string | URL,\n    {\n        protocols,\n        on_open,\n        on_close,\n        on_error,\n        on_message\n    }: {\n        protocols?: string | string[]\n        on_open? (event: any, websocket: WebSocket): any\n        on_close? (event: { code: number, reason: string }, websocket: WebSocket): any\n        on_error? (event: any, websocket: WebSocket): any\n        on_message (event: { data: ArrayBuffer }, websocket: WebSocket): any\n    }\n) {\n    let websocket = new WebSocket(url, protocols)\n    \n    // https://stackoverflow.com/questions/11821096/what-is-the-difference-between-an-arraybuffer-and-a-blob/39951543\n    websocket.binaryType = 'arraybuffer'\n    \n    return new Promise<WebSocket>((resolve, reject) => {\n        websocket.addEventListener('open', async event => {\n            console.log(`${websocket.url} opened`)\n            \n            await on_open?.(event, websocket)\n            \n            resolve(websocket)\n        })\n        \n        websocket.addEventListener('close', event => {\n            console.log(`${websocket.url} closed with code = ${event.code}, reason = '${event.reason}'`)\n            on_close?.(event, websocket)\n        })\n        \n        websocket.addEventListener('error', event => {\n            const message = `${websocket.url} errored`\n            console.error(message, event)\n            on_error?.(event, websocket)\n            reject(\n                Object.assign(\n                    new Error(message),\n                    { event }\n                )\n            )\n        })\n        \n        websocket.addEventListener('message', event => {\n            on_message(event as any, websocket)\n        })\n    })\n}\n\n\n/** 二进制消息格式 \n    - json.length (小端序): 4 字节\n    - json 数据\n    - binary 数据\n*/\nexport interface Message <T extends any[] = any[]> {\n    /** 本次 rpc 的 id */\n    id?: number\n    \n    /** rpc 发起方指定被调用的 function name, 多个相同 id, func 的 message 组成一个请求流 */\n    func?: string\n    \n    /** 等待执行，但不要序列化返回 func 的执行结果 (message 中无 args) */\n    ignore?: boolean\n    \n    /** 不等待 func 执行，remote 收到后直接确认返回 (message 中 done = true) */\n    async?: boolean\n    \n    /** 这个数组里面要么是对应的 JS 参数，要么是 Uint8Array 参数对应的 binary length  \n        args 可以是:  \n        - rpc 发起方调用 func 的参数，或者请求流 message 携带的数据\n        - 作为结果或者响应流的 message 数据，传给请求发起方\n    */\n    args?: T\n    \n    /** bins: 哪几个 arg 是 Uint8Array 类型的，如: [0, 3] */\n    bins?: number[]\n    \n    /** 被调方执行 func 产生的错误 */\n    error?: Error\n    \n    /** 如果请求或者响应是一个流，通过这个 flag 表明是最后一个 message, 并且可以销毁 handler 了 */\n    done?: boolean\n}\n\n/** 通过创建 Remote 对象对 WebSocket RPC 进行抽象  \n    调用方使用 remote.call 进行调用  \n    被调方在创建 Remote 对象时传入 funcs 注册处理函数，并使用 Remote.handle 方法处理 WebSocket message  \n*/\nexport class Remote {\n    url: string\n    \n    websocket: WebSocket\n    \n    id = 0\n    \n    /** 被调方的 message 处理器 */\n    funcs: Record<\n        string, \n        (message: Message, websocket?: WebSocket) => void | Promise<void>\n    >\n    \n    /** 调用方发起的 rpc 对应响应的 message 处理器 */\n    handlers: ((message: Message) => any)[] = [ ]\n    \n    print = false\n    \n    get connected () {\n        return this.websocket?.readyState === WebSocket.OPEN\n    }\n    \n    \n    static parse <T extends any[] = any[]> (array_buffer: ArrayBuffer) {\n        const buf = new Uint8Array(array_buffer as ArrayBuffer)\n        const dv = new DataView(array_buffer)\n        \n        const len_json = dv.getUint32(0, true)\n        \n        let offset = 4 + len_json\n        \n        let message: Message<T> = JSON.parse(\n            decoder.decode(\n                buf.subarray(4, offset)\n            )\n        )\n        \n        message.args ||= [ ] as T\n        \n        if (message.bins) {\n            let args = message.args\n            \n            for (const ibin of message.bins) {\n                const len_buf = args[ibin]\n                args[ibin] = buf.subarray(offset, offset + len_buf)\n                offset += len_buf\n            }\n        }\n        \n        return message\n    }\n    \n    \n    static pack ({\n        id,\n        func,\n        ignore,\n        async: _async,\n        done,\n        error,\n        args: _args = [ ],\n    }: Message) {\n        let args = [..._args]\n        \n        let bins: number[] = [ ]\n        let bufs: Uint8Array[] = [ ]\n        \n        for (let i = 0;  i < args.length;  i++) {\n            const arg = args[i]\n            if (arg instanceof Uint8Array) {\n                bins.push(i)\n                bufs.push(arg)\n                args[i] = arg.length\n            }\n        }\n        \n        const data_json = {\n            id,\n            ... func ? { func } : { },\n            ... ignore ? { ignore } : { },\n            ... _async ? { async: _async } : { },\n            ... done ? { done } : { },\n            ... error ? { error } : { },\n            ... args.length ? { args } : { },\n            ... bins.length ? { bins } : { },\n        }\n        \n        const str_json = encoder.encode(\n            JSON.stringify(data_json)\n        )\n        \n        let dv = new DataView(\n            new ArrayBuffer(4)\n        )\n        \n        dv.setUint32(0, str_json.length, true)\n        \n        return concat([\n            dv,\n            str_json,\n            ... bufs\n        ])\n    }\n    \n    \n    constructor ({\n        url,\n        funcs = { },\n        websocket,\n    }: {\n        url?: string\n        funcs?: Remote['funcs']\n        websocket?: WebSocket\n    } = { }) {\n        this.url = url\n        this.funcs = funcs\n        this.websocket = websocket\n    }\n    \n    \n    async connect () {\n        this.websocket = await connect_websocket(this.url, {\n            on_message: this.handle.bind(this)\n        })\n    }\n    \n    \n    disconnect () {\n        this.websocket?.close()\n        this.id = 0\n        this.handlers = [ ]\n    }\n    \n    \n    send (message: Message, websocket = this.websocket) {\n        if (!('id' in message))\n            message.id = this.id\n        \n        websocket.send(\n            Remote.pack(message)\n        )\n    }\n    \n    \n    /** 调用 remote 中的 func, 返回结果由 handler 处理，处理 done message 之后的返回值作为 call 函数的返回值 */\n    async call <T extends any[] = any[], R = any> (\n        message: Message,\n        handler: (message: Message<T>) => any\n    ) {\n        return new Promise<R>((resolve, reject) => {\n            this.handlers[this.id] = async (message: Message<T>) => {\n                const { error, done } = message\n                \n                if (error) {\n                    reject(\n                        Object.assign(\n                            new Error(),\n                            error\n                        )\n                    )\n                    return\n                }\n                \n                let result = await handler(message)\n                \n                if (done)\n                    resolve(result)\n            }\n            \n            this.send(message)\n            \n            this.id++\n        })\n    }\n    \n    \n    /** 处理接收到的 WebSocket message\n        1. 被调用方接收 message 并开始处理\n        2. 调用方处理 message 响应\n    */\n    async handle (event: { data: ArrayBuffer }, websocket: WebSocket) {\n        const message = Remote.parse(event.data)\n        const { func, id, done } = message\n        \n        if (this.print)\n            console.log(message)\n        \n        if (func) // 作为被调方\n            try {\n                const handler = this.funcs[func] || this.funcs.default\n                \n                if (!handler)\n                    throw new Error(`找不到 rpc handler: ${func}`)\n                \n                await handler(message, websocket)\n            } catch (error) {\n                this.send(\n                    {\n                        id: message.id,\n                        error,\n                        done: true\n                    },\n                    websocket\n                )\n                throw error\n            }\n        else {  // 作为发起方\n            this.handlers[id](message)\n            if (done)\n                this.handlers[id] = null\n        }\n    }\n}\n\n"]}

package/net.d.ts

@@ -2,6 +2,7 @@
 /// <reference types="cheerio" />
 import { default as request_lib } from 'request';
 import { default as request_promise } from 'request-promise-native';
+import { WebSocket } from 'ws';
 import { Cookie, MemoryCookieStore } from 'tough-cookie';
 declare module 'tough-cookie' {
     interface MemoryCookieStore {
@@ -81,3 +82,78 @@ export declare function rpc(func: string, args?: any[], { url, async: _async, ig
     ignore?: boolean;
 }): Promise<any>;
 export declare function rpc_curl(func: string, args: any[]): string;
+export declare function connect_websocket(url: string | URL, { protocols, max_payload, // 8 GB
+on_open, on_close, on_error, on_message }: {
+    protocols?: string | string[];
+    max_payload?: number;
+    on_open?(event: any, websocket: WebSocket): any;
+    on_close?(event: {
+        code: number;
+        reason: string;
+    }, websocket: WebSocket): any;
+    on_error?(event: any, websocket: WebSocket): any;
+    on_message(event: {
+        data: ArrayBuffer;
+    }, websocket: WebSocket): any;
+}): Promise<WebSocket>;
+/** 二进制消息格式
+    - json.length (小端序): 4 字节
+    - json 数据
+    - binary 数据
+*/
+export interface Message<T extends any[] = any[]> {
+    /** 本次 rpc 的 id */
+    id?: number;
+    /** rpc 发起方指定被调用的 function name, 多个相同 id, func 的 message 组成一个请求流 */
+    func?: string;
+    /** 等待执行，但不要序列化返回 func 的执行结果 (message 中无 args) */
+    ignore?: boolean;
+    /** 不等待 func 执行，remote 收到后直接确认返回 (message 中 done = true) */
+    async?: boolean;
+    /** 这个数组里面要么是对应的 JS 参数，要么是 Uint8Array 参数对应的 binary length
+        args 可以是:
+        - rpc 发起方调用 func 的参数，或者请求流 message 携带的数据
+        - 作为结果或者响应流的 message 数据，传给请求发起方
+    */
+    args?: T;
+    /** bins: 哪几个 arg 是 Uint8Array 类型的，如: [0, 3] */
+    bins?: number[];
+    /** 被调方执行 func 产生的错误 */
+    error?: Error;
+    /** 如果请求或者响应是一个流，通过这个 flag 表明是最后一个 message, 并且可以销毁 handler 了 */
+    done?: boolean;
+}
+/** 通过创建 Remote 对象对 WebSocket RPC 进行抽象
+    调用方使用 remote.call 进行调用
+    被调方在创建 Remote 对象时传入 funcs 注册处理函数，并使用 Remote.handle 方法处理 WebSocket message
+*/
+export declare class Remote {
+    url: string;
+    websocket: WebSocket;
+    id: number;
+    /** 被调方的 message 处理器 */
+    funcs: Record<string, (message: Message, websocket?: WebSocket) => void | Promise<void>>;
+    /** 调用方发起的 rpc 对应响应的 message 处理器 */
+    handlers: ((message: Message) => any)[];
+    print: boolean;
+    get connected(): boolean;
+    static parse<T extends any[] = any[]>(array_buffer: ArrayBuffer): Message<T>;
+    static pack({ id, func, ignore, async: _async, done, error, args: _args, }: Message): Uint8Array;
+    constructor({ url, funcs, websocket, }?: {
+        url?: string;
+        funcs?: Remote['funcs'];
+        websocket?: WebSocket;
+    });
+    connect(): Promise<void>;
+    disconnect(): void;
+    send(message: Message, websocket?: WebSocket): void;
+    /** 调用 remote 中的 func, 返回结果由 handler 处理，处理 done message 之后的返回值作为 call 函数的返回值 */
+    call<T extends any[] = any[], R = any>(message: Message, handler: (message: Message<T>) => any): Promise<R>;
+    /** 处理接收到的 WebSocket message
+        1. 被调用方接收 message 并开始处理
+        2. 调用方处理 message 响应
+    */
+    handle(event: {
+        data: ArrayBuffer;
+    }, websocket: WebSocket): Promise<void>;
+}