wsemi 1.9.13 → 1.9.15

package/test/execCli.test.mjs

@@ -1,4 +1,8 @@
 import assert from 'assert'
+import fs from 'fs'
+import path from 'path'
+import cp from 'child_process'
+import { fileURLToPath } from 'url'
 import execCli from '../src/execCli.mjs'
 
 
@@ -357,4 +361,95 @@ describe(`execCli`, function() {
         assert.strict.deepStrictEqual(r.stdout.length < 2000, true)
     })
 
+    //--- 失敗回報: 無法啟動子進程時不reject, error不含args與env之值 ---
+
+    let SA = 'SECRET_ARG_7d1f' //機密標記, 置於args
+    let SE = 'SECRET_ENV_9a2b' //機密標記, 置於env
+    let argLong = SA + 'x'.repeat(200000) //win32超過命令列上限, posix超過單一參數上限, 皆為spawn同步拋錯
+    let argNul = SA + '\u0000x'
+    let fdSrc = fileURLToPath(new URL('../src/', import.meta.url))
+    let fpEmfileRunner = path.resolve('./test/tools/spawnEmfileRunner.mjs')
+    let fdTmp = path.resolve('./test/_tmp/execCli')
+    let fpCmd = path.join(fdTmp, 'zzfallback.cmd')
+
+    //catchErr, 回傳Promise之拒絕值, 未拒絕時回{ resolved }
+    let catchErr = async (fn) => {
+        try {
+            let r = await fn()
+            return { resolved: r }
+        }
+        catch (err) {
+            return { rejected: err }
+        }
+    }
+
+    before(function() {
+        fs.mkdirSync(fdTmp, { recursive: true })
+        fs.writeFileSync(fpCmd, '@echo off\r\necho fallback %*\r\n') //無%dp0%\node_modules入口之.cmd, buildSpawnArgs走cmd.exe退路
+    })
+
+    after(function() {
+        fs.rmSync(fdTmp, { recursive: true, force: true })
+    })
+
+    it(`should resolve ok=false with pid undefined, without args and without retry when spawn throws synchronously`, async function() {
+        let r1 = await catchErr(() => execCli(nodeBin, ['-e', '1', argNul], { maxRetries: 2, retryDelayMs: 1 }))
+        let r2 = await catchErr(() => execCli(nodeBin, ['-e', '1', argLong], { maxRetries: 2, retryDelayMs: 1 }))
+        //P04a: 不reject, 結果物件之code為null、pid為undefined(同ENOENT), error為「碼: 訊息」且不含args
+        assert.strict.deepStrictEqual(['resolved' in r1, 'resolved' in r2], [true, true])
+        r1 = r1.resolved
+        r2 = r2.resolved
+        assert.strict.deepStrictEqual([r1.ok, r1.code, 'pid' in r1, r1.pid], [false, null, true, undefined])
+        assert.strict.deepStrictEqual(r1.error.startsWith('ERR_INVALID_ARG_VALUE: '), true)
+        assert.strict.deepStrictEqual(r1.error.includes(`'args[2]'`), true)
+        assert.strict.deepStrictEqual([r1.error.includes(SA), r1.error.includes('Received')], [false, false])
+        assert.strict.deepStrictEqual([r2.ok, r2.code, r2.error.includes(SA)], [false, null, false])
+        assert.strict.deepStrictEqual(r2.error.startsWith(process.platform === 'win32' ? 'ENAMETOOLONG: ' : ''), true)
+        //P04b: 同步錯誤不重試
+        assert.strict.deepStrictEqual([r1.attempts, r2.attempts], [1, 1])
+    })
+
+    it(`should not include env values in error when an env value contains a null byte`, async function() {
+        let r = await catchErr(() => execCli(nodeBin, ['-e', '1'], { env: { WSEMI_TEST_KEY: SE + '\u0000x' } }))
+        //P04c: 不reject, error保留變數名稱而不含其值
+        assert.strict.deepStrictEqual('resolved' in r, true)
+        assert.strict.deepStrictEqual(r.resolved.ok, false)
+        assert.strict.deepStrictEqual(r.resolved.error.includes('WSEMI_TEST_KEY'), true)
+        assert.strict.deepStrictEqual(r.resolved.error.includes(SE), false)
+    })
+
+    it(`should resolve ok=false with EMFILE without crashing when node cannot create stdio`, function() {
+        let p = cp.spawnSync(nodeBin, [fpEmfileRunner, fdSrc, 'execCli'], { encoding: 'utf8', windowsHide: true, timeout: 60000 })
+        let o = JSON.parse(p.stdout.trim().split(/\r?\n/).pop())
+        //P05: 不reject、不拋出未捕捉例外
+        assert.strict.deepStrictEqual(o.settle, 'resolve')
+        assert.strict.deepStrictEqual([o.value.ok, o.value.error.startsWith('EMFILE: ')], [false, true])
+        assert.strict.deepStrictEqual(o.hasSecret, false)
+        assert.strict.deepStrictEqual(o.uncaught, [])
+    })
+
+    it(`should treat a number in args like a string when a .cmd falls back to cmd.exe on win32`, async function() {
+        if (process.platform !== 'win32') {
+            this.skip()
+        }
+        let r = await catchErr(() => execCli(fpCmd, ['a', 123]))
+        let rs = await execCli(fpCmd, ['a', '123'])
+        //P04d: 不reject; P09: 非字串元素比照node轉為字串, 結果與給字串相同
+        assert.strict.deepStrictEqual('resolved' in r, true)
+        assert.strict.deepStrictEqual([r.resolved.ok, r.resolved.stdout], [true, rs.stdout])
+        assert.strict.deepStrictEqual(rs.stdout.includes('fallback'), true)
+    })
+
+    it(`should resolve ok=false instead of rejecting when building the .cmd fallback command throws on win32`, async function() {
+        if (process.platform !== 'win32') {
+            this.skip()
+        }
+        //無法轉為字串之元素使buildSpawnArgs於cmd.exe退路拋錯, 須與spawn同在try內
+        let r = await catchErr(() => execCli(fpCmd, ['a', Object.create(null)], { maxRetries: 2, retryDelayMs: 1 }))
+        //P04a、P04b
+        assert.strict.deepStrictEqual('resolved' in r, true)
+        assert.strict.deepStrictEqual([r.resolved.ok, r.resolved.code, r.resolved.pid, r.resolved.attempts], [false, null, undefined, 1])
+        assert.strict.deepStrictEqual(r.resolved.error.startsWith('UNKNOWN: '), true)
+    })
+
 })

package/test/execCliJsonRpc.test.mjs

@@ -1,4 +1,7 @@
 import assert from 'assert'
+import path from 'path'
+import cp from 'child_process'
+import { fileURLToPath } from 'url'
 import execCliJsonRpc from '../src/execCliJsonRpc.mjs'
 
 
@@ -140,4 +143,28 @@ describe(`execCliJsonRpc`, function() {
         assert.strict.deepStrictEqual('params' in r.results.p, false)
     })
 
+    //--- 失敗回報: error不含args之值, 系統資源用盡時不崩潰 ---
+
+    let SA = 'SECRET_ARG_7d1f' //機密標記, 置於args
+    let fdSrc = fileURLToPath(new URL('../src/', import.meta.url))
+    let fpEmfileRunner = path.resolve('./test/tools/spawnEmfileRunner.mjs')
+
+    it(`should not include args in error when spawn throws synchronously for a null byte`, async function() {
+        let r = await execCliJsonRpc(nodeBin, ['-e', '1', SA + '\u0000x'], [{ method: 'x' }])
+        //P06e
+        assert.strict.deepStrictEqual(r.ok, false)
+        assert.strict.deepStrictEqual(r.error.startsWith('x: ERR_INVALID_ARG_VALUE: '), true)
+        assert.strict.deepStrictEqual([r.error.includes(SA), r.error.includes('Received')], [false, false])
+    })
+
+    it(`should report EMFILE without crashing when node cannot create stdio`, function() {
+        let p = cp.spawnSync(nodeBin, [fpEmfileRunner, fdSrc, 'execCliJsonRpc'], { encoding: 'utf8', windowsHide: true, timeout: 60000 })
+        let o = JSON.parse(p.stdout.trim().split(/\r?\n/).pop())
+        //P06f
+        assert.strict.deepStrictEqual(o.settle, 'resolve')
+        assert.strict.deepStrictEqual([o.value.ok, o.value.error.startsWith('x: EMFILE: ')], [false, true])
+        assert.strict.deepStrictEqual(o.hasSecret, false)
+        assert.strict.deepStrictEqual(o.uncaught, [])
+    })
+
 })

package/test/execCliSession.test.mjs

@@ -1,4 +1,8 @@
 import assert from 'assert'
+import fs from 'fs'
+import path from 'path'
+import cp from 'child_process'
+import { fileURLToPath } from 'url'
 import execCliSession from '../src/execCliSession.mjs'
 
 
@@ -194,4 +198,82 @@ describe(`execCliSession`, function() {
         assert.strict.deepStrictEqual(r.code, 0)
     })
 
+    //--- 失敗回報: 不throw, error不含args與env之值 ---
+
+    let SA = 'SECRET_ARG_7d1f' //機密標記, 置於args
+    let SE = 'SECRET_ENV_9a2b' //機密標記, 置於env
+    let fdSrc = fileURLToPath(new URL('../src/', import.meta.url))
+    let fpEmfileRunner = path.resolve('./test/tools/spawnEmfileRunner.mjs')
+    let fdTmp = path.resolve('./test/_tmp/execCliSession')
+    let fpCmd = path.join(fdTmp, 'zzfallback.cmd')
+
+    before(function() {
+        fs.mkdirSync(fdTmp, { recursive: true })
+        fs.writeFileSync(fpCmd, '@echo off\r\necho fallback %*\r\n') //無%dp0%\node_modules入口之.cmd, buildSpawnArgs走cmd.exe退路
+    })
+
+    after(function() {
+        fs.rmSync(fdTmp, { recursive: true, force: true })
+    })
+
+    it(`should not throw and should report errors without args or env values when spawn throws synchronously`, async function() {
+        let s1 = null
+        let s2 = null
+        assert.doesNotThrow(() => {
+            s1 = execCliSession(nodeBin, ['-e', '1', SA + '\u0000x'])
+            s2 = execCliSession(nodeBin, ['-e', '1'], { env: { WSEMI_TEST_KEY: SE + '\u0000x' } })
+        })
+        let r1 = await s1.stop()
+        let r2 = await s2.stop()
+        //P06a: 以stop()之結果物件回報, error保留參數名稱而不含其值
+        assert.strict.deepStrictEqual(r1.error.startsWith('ERR_INVALID_ARG_VALUE: '), true)
+        assert.strict.deepStrictEqual(r1.error.includes(`'args[2]'`), true)
+        assert.strict.deepStrictEqual([r1.error.includes(SA), r1.error.includes('Received')], [false, false])
+        assert.strict.deepStrictEqual([r2.error.includes('WSEMI_TEST_KEY'), r2.error.includes(SE)], [true, false])
+    })
+
+    it(`should report EMFILE via stop() without throwing or crashing when node cannot create stdio`, function() {
+        let p = cp.spawnSync(nodeBin, [fpEmfileRunner, fdSrc, 'execCliSession'], { encoding: 'utf8', windowsHide: true, timeout: 60000 })
+        let o = JSON.parse(p.stdout.trim().split(/\r?\n/).pop())
+        //P06b
+        assert.strict.deepStrictEqual(o.settle, 'resolve')
+        assert.strict.deepStrictEqual(o.value.error.startsWith('EMFILE: '), true)
+        assert.strict.deepStrictEqual([o.value.exited, o.value.pid], [true, null])
+        assert.strict.deepStrictEqual(o.hasSecret, false)
+        assert.strict.deepStrictEqual(o.uncaught, [])
+    })
+
+    it(`should not throw when a .cmd falls back to cmd.exe and args contain a number on win32`, async function() {
+        if (process.platform !== 'win32') {
+            this.skip()
+        }
+        let lines = []
+        let s = null
+        assert.doesNotThrow(() => {
+            s = execCliSession(fpCmd, ['a', 123], {
+                onLine: (line) => {
+                    lines.push(line)
+                },
+            })
+        })
+        let r = await s.stop()
+        //P06c: 不throw; P09: 數字比照字串傳遞
+        assert.strict.deepStrictEqual([r.exited, r.code], [true, 0])
+        assert.strict.deepStrictEqual(lines.some((l) => l.includes('fallback') && l.includes('123')), true)
+    })
+
+    it(`should not throw when building the .cmd fallback command throws on win32`, async function() {
+        if (process.platform !== 'win32') {
+            this.skip()
+        }
+        //無法轉為字串之元素使buildSpawnArgs於cmd.exe退路拋錯, 須與spawn同在try內
+        let s = null
+        assert.doesNotThrow(() => {
+            s = execCliSession(fpCmd, ['a', Object.create(null)])
+        })
+        let r = await s.stop()
+        //P06c
+        assert.strict.deepStrictEqual([r.exited, r.pid, r.error.startsWith('UNKNOWN: ')], [true, null, true])
+    })
+
 })

package/test/execProcess.test.mjs

@@ -1,5 +1,7 @@
 import assert from 'assert'
 import cp from 'child_process'
+import path from 'path'
+import { fileURLToPath, pathToFileURL } from 'url'
 import execProcess from '../src/execProcess.mjs'
 
 
@@ -73,16 +75,19 @@ describe(`execProcess`, function() {
         assert.strict.deepStrictEqual(typeof err === 'string' && err.startsWith('code[2]'), true)
     })
 
-    it(`should reject on 'error' event when spawning a non-existent program`, async function() {
+    it(`should reject a string spawn[ENOENT] without args when spawning a non-existent program`, async function() {
         let err = null
         try {
-            await execProcess('non_existent_command_xyz_12345', ['arg'])
+            await execProcess('non_existent_command_xyz_12345', ['arg', 'SECRET_ARG_7d1f'])
         }
         catch (e) {
             err = e
         }
         // console.log('nonexistent err', err)
-        assert.strict.deepStrictEqual(err !== null, true)
+        //P02a: 無法啟動子程序時reject字串`spawn[錯誤碼]:\n訊息`, 訊息含程式名, 不含args
+        assert.strict.deepStrictEqual(typeof err === 'string' && err.startsWith('spawn[ENOENT]:\n'), true)
+        assert.strict.deepStrictEqual(err.includes('non_existent_command_xyz_12345'), true)
+        assert.strict.deepStrictEqual(err.includes('SECRET_ARG_7d1f'), false)
     })
 
     it(`should ignore opt.timeout when value is invalid (e.g., -1)`, async function() {
@@ -346,4 +351,131 @@ describe(`execProcess`, function() {
         assert.strict.deepStrictEqual(r1, r2)
     })
 
+    //--- 失敗回報: 無法啟動子程序之拒絕值為字串且不含參數(規格句見JSDoc之returns) ---
+
+    let SA = 'SECRET_ARG_7d1f' //機密標記, 置於args
+    let progMissing = path.resolve('./test/_tmp/execProcess/zz_no_such_prog_123.exe') //不存在之絕對路徑, 不建立
+    let argLong = SA + 'x'.repeat(200000) //win32超過命令列上限(ENAMETOOLONG), posix超過單一參數上限, 皆為spawn同步拋錯
+    let argNul = SA + '\u0000x'
+    let fdSrc = fileURLToPath(new URL('../src/', import.meta.url))
+    let fpEmfileRunner = path.resolve('./test/tools/spawnEmfileRunner.mjs')
+
+    //catchErr, 回傳Promise之拒絕值, 未拒絕時回{ resolved }
+    let catchErr = async (fn) => {
+        try {
+            let r = await fn()
+            return { resolved: r }
+        }
+        catch (err) {
+            return err
+        }
+    }
+
+    //runEmfile, 子行程內重現EMFILE後呼叫execProcess
+    let runEmfile = (opt) => {
+        let r = cp.spawnSync(nodeBin, [fpEmfileRunner, fdSrc, 'execProcess', JSON.stringify(opt)], { encoding: 'utf8', windowsHide: true, timeout: 60000 })
+        return JSON.parse(r.stdout.trim().split(/\r?\n/).pop())
+    }
+
+    for (let [name, opt] of [['spawn', {}], ['execFile', { mode: 'execFile' }], ['spawn with codeCmd auto', { codeCmd: 'auto' }]]) {
+        it(`should reject a string spawn[ENOENT] with the program path but without args for a missing program (${name})`, async function() {
+            let err = await catchErr(() => execProcess(progMissing, ['a', SA], opt))
+            //P02a、P02f
+            assert.strict.deepStrictEqual(typeof err, 'string')
+            assert.strict.deepStrictEqual(err.startsWith('spawn[ENOENT]:\n'), true)
+            assert.strict.deepStrictEqual(err.includes('zz_no_such_prog_123'), true)
+            assert.strict.deepStrictEqual(err.includes(SA), false)
+        })
+    }
+
+    for (let mode of ['spawn', 'execFile', 'exec']) {
+        it(`should reject a string spawn[...] without args when spawn throws synchronously for a too long argument (${mode})`, async function() {
+            let err = await catchErr(() => execProcess(nodeBin, ['-e', '1', argLong], { mode }))
+            //P02b、P02d
+            assert.strict.deepStrictEqual(typeof err, 'string')
+            assert.strict.deepStrictEqual(err.startsWith(process.platform === 'win32' ? 'spawn[ENAMETOOLONG]:\n' : 'spawn['), true)
+            assert.strict.deepStrictEqual(err.includes(SA), false)
+        })
+
+        it(`should reject spawn[ERR_INVALID_ARG_VALUE] naming the argument but not its value for a null byte (${mode})`, async function() {
+            let err = await catchErr(() => execProcess(nodeBin, ['-e', '1', argNul], { mode }))
+            //P02c、P02d: node訊息之「Received 值」須去除, exec模式之參數名為command
+            assert.strict.deepStrictEqual(typeof err, 'string')
+            assert.strict.deepStrictEqual(err.startsWith('spawn[ERR_INVALID_ARG_VALUE]:\n'), true)
+            assert.strict.deepStrictEqual(err.includes(mode === 'exec' ? `'command'` : `'args[2]'`), true)
+            assert.strict.deepStrictEqual(err.includes(SA), false)
+            assert.strict.deepStrictEqual(err.includes('Received'), false)
+        })
+    }
+
+    it(`should reject spawn[ENOENT] without the command line when the shell is missing in exec mode`, function() {
+        if (process.platform !== 'win32') {
+            this.skip()
+        }
+        //子行程內改ComSpec, 不影響本行程; exec模式之node附帶參數為整條指令列
+        let url = pathToFileURL(path.join(fdSrc, 'execProcess.mjs')).href
+        let sc = `process.env.ComSpec='C:\\\\zz-no-such-dir\\\\cmd.exe';let m=await import(${JSON.stringify(url)});m.default(process.execPath,['-e','1',${JSON.stringify(SA)}],{mode:'exec'}).then((r)=>console.log(JSON.stringify({r})),(e)=>console.log(JSON.stringify({e:String(e),t:typeof e})))`
+        let r = cp.spawnSync(nodeBin, ['--input-type=module', '-e', sc], { encoding: 'utf8', windowsHide: true, timeout: 60000 })
+        let o = JSON.parse(r.stdout.trim())
+        //P02d
+        assert.strict.deepStrictEqual(o.t, 'string')
+        assert.strict.deepStrictEqual(o.e.startsWith('spawn[ENOENT]:\n'), true)
+        assert.strict.deepStrictEqual(o.e.includes(SA), false)
+    })
+
+    it(`should reject a string when prog is an empty string or not a string`, async function() {
+        let err1 = await catchErr(() => execProcess('', ['-e', '1']))
+        let err2 = await catchErr(() => execProcess(undefined, ['-e', '1']))
+        //P02e
+        assert.strict.deepStrictEqual([typeof err1, typeof err2], ['string', 'string'])
+        assert.strict.deepStrictEqual(err1.startsWith('spawn[ERR_INVALID_ARG_VALUE]:\n'), true)
+        assert.strict.deepStrictEqual(err2.startsWith('spawn[ERR_INVALID_ARG_TYPE]:\n'), true)
+    })
+
+    it(`should reject a string when prog is quoted in spawn mode`, async function() {
+        let err = await catchErr(() => execProcess(`"${nodeBin}"`, ['-e', '1']))
+        //P07: spawn模式prog含引號時reject說明字串, 字誤已修
+        assert.strict.deepStrictEqual(typeof err, 'string')
+        assert.strict.deepStrictEqual(err.includes('does not need to add quotes'), true)
+    })
+
+    for (let [name, opt] of [['spawn', {}], ['execFile', { mode: 'execFile' }], ['exec', { mode: 'exec' }], ['spawn with codeCmd auto', { codeCmd: 'auto' }]]) {
+        it(`should reject spawn[EMFILE] without throwing or crashing when node cannot create stdio (${name})`, function() {
+            let o = runEmfile(opt)
+            //P03: 系統資源用盡時同無法啟動, 不拋出未捕捉例外
+            assert.strict.deepStrictEqual(o.settle, 'reject')
+            assert.strict.deepStrictEqual(typeof o.value === 'string' && o.value.startsWith('spawn[EMFILE]:\n'), true)
+            assert.strict.deepStrictEqual(o.hasSecret, false)
+            assert.strict.deepStrictEqual(o.uncaught, [])
+        })
+    }
+
+    //--- args: 空陣列與空字串代表無參數, 型別不符以reject回報 ---
+
+    //progNoArgs, 不帶參數即可執行並結束之系統程式
+    let progNoArgs = process.platform === 'win32' ? 'whoami' : 'pwd'
+
+    for (let mode of ['spawn', 'execFile', 'exec']) {
+        it(`should run the program without arguments when args is an empty array or an empty string (${mode})`, async function() {
+            let r1 = await catchErr(() => execProcess(progNoArgs, [], { mode, codeCmd: 'auto' }))
+            let r2 = await catchErr(() => execProcess(progNoArgs, '', { mode, codeCmd: 'auto' }))
+            //P11a、P11b: 照常執行並resolve輸出
+            assert.strict.deepStrictEqual('resolved' in r1 && r1.resolved.trim().length > 0, true)
+            assert.strict.deepStrictEqual('resolved' in r2 && r2.resolved.trim() === r1.resolved.trim(), true)
+        })
+    }
+
+    it(`should reject a string instead of throwing when args is neither an array nor a string`, async function() {
+        let rs = []
+        for (let v of [undefined, null, 123, {}, true]) {
+            let p = null
+            assert.doesNotThrow(() => {
+                p = execProcess(nodeBin, v)
+            })
+            rs.push(await catchErr(() => p))
+        }
+        //P11c
+        assert.strict.deepStrictEqual(rs, new Array(5).fill('args is not an array or string'))
+    })
+
 })

package/test/execProcessKillPid.test.mjs

@@ -104,4 +104,38 @@ describe(`execProcessKillPid`, function() {
         assert.strict.deepStrictEqual(completed, true)
     })
 
+    //--- 失敗回報: reject錯誤訊息字串, 與resolve之pid[N] killed對稱 ---
+
+    it(`should reject a string pid[N] kill failed when pid is not a number`, async function() {
+        let rs = []
+        for (let pid of ['abc', undefined]) {
+            try {
+                await execProcessKillPid(pid)
+                rs.push('resolved')
+            }
+            catch (e) {
+                rs.push(e)
+            }
+        }
+        //P08a
+        assert.strict.deepStrictEqual(rs, ['pid[abc] kill failed: pid must be a number', 'pid[undefined] kill failed: pid must be a number'])
+    })
+
+    it(`should reject a string pid[N] kill failed when killing a non-existent pid on win32`, async function() {
+        //posix下tree-kill吞掉ESRCH而resolve(見上一案), 僅win32之taskkill失敗會reject
+        let fakePid = 999999
+        if (process.platform !== 'win32' || isAlive(fakePid)) {
+            this.skip()
+        }
+        let err = null
+        try {
+            await execProcessKillPid(fakePid)
+        }
+        catch (e) {
+            err = e
+        }
+        //P08b
+        assert.strict.deepStrictEqual(typeof err === 'string' && err.startsWith(`pid[${fakePid}] kill failed: `), true)
+    })
+
 })

package/test/tools/spawnEmfileRunner.mjs

@@ -0,0 +1,55 @@
+//spawnEmfileRunner.mjs: 於獨立子行程以替身重現node之EMFILE/ENFILE分支後呼叫指定函數, 印出結局與未捕捉例外(JSON一行)
+//  替身依node lib/internal/child_process.js之ChildProcess.prototype.spawn: 對EMFILE、ENFILE設spawnfile與spawnargs後, 以nextTick觸發onexit(錯誤碼), 不建立stdin/stdout/stderr即return
+//  須於子行程執行, 因改的是ChildProcess.prototype, 不可污染mocha之worker
+//用法: node test/tools/spawnEmfileRunner.mjs <模組資料夾絕對路徑> <execProcess|execCli|execCliSession|execCliJsonRpc> [opt之JSON]
+import util from 'util'
+import cp from 'child_process'
+import path from 'path'
+import { pathToFileURL } from 'url'
+
+
+let [fdImpl, fn, sopt] = process.argv.slice(2)
+let opt = sopt ? JSON.parse(sopt) : {}
+let SA = 'SECRET_ARG_7d1f' //機密標記, 置於args
+let out = { settle: null, value: null, uncaught: [] }
+
+process.on('uncaughtException', (e) => {
+    out.uncaught.push(String(e && e.message))
+})
+
+//UV_EMFILE, 以系統錯誤對照表反查
+let UV_EMFILE = [...util.getSystemErrorMap()].find(([k, v]) => v[0] === 'EMFILE')[0]
+cp.ChildProcess.prototype.spawn = function(options) {
+    this.spawnfile = options.file
+    this.spawnargs = options.args
+    process.nextTick(() => {
+        this._handle.onexit(UV_EMFILE)
+    })
+    return UV_EMFILE
+}
+
+let mod = (await import(pathToFileURL(path.join(fdImpl, `${fn}.mjs`)).href)).default
+let args = ['-e', '1', SA]
+try {
+    let r = null
+    if (fn === 'execCliSession') {
+        let s = mod(process.execPath, args, opt)
+        r = await s.stop()
+    }
+    else if (fn === 'execCliJsonRpc') {
+        r = await mod(process.execPath, args, [{ method: 'x' }], opt)
+    }
+    else {
+        r = await mod(process.execPath, args, opt)
+    }
+    out.settle = 'resolve'
+    out.value = r
+}
+catch (err) {
+    out.settle = 'reject'
+    out.value = (typeof err === 'string') ? err : `<${err && err.constructor && err.constructor.name}> ${err && err.message}`
+}
+await new Promise((resolve) => setTimeout(resolve, 300)) //等候延後之未捕捉例外(nextTick之'error'事件)
+out.hasSecret = JSON.stringify(out).includes(SA)
+console.log(JSON.stringify(out))
+process.exit(0)

package/toolfp/dist/wsemip.umd.js

@@ -1,5 +1,5 @@
 /*!
- * wsemip v1.9.13
+ * wsemip v1.9.15
  * (c) 2018-2021 yuda-lyu(semisphere)
  * Released under the MIT License.
  */

package/toolparfor/dist/wpf.umd.js

@@ -1,5 +1,5 @@
 /*!
- * wpf v1.9.13
+ * wpf v1.9.15
  * (c) 2018-2021 yuda-lyu(semisphere)
  * Released under the MIT License.
  */

package/toolparfor/dist/wpf_pmSeries.umd.js

@@ -1,5 +1,5 @@
 /*!
- * wpf_pmSeries v1.9.13
+ * wpf_pmSeries v1.9.15
  * (c) 2018-2021 yuda-lyu(semisphere)
  * Released under the MIT License.
  */