w-web-api 1.0.76 → 1.0.78

package/docs/WWebApi.html

@@ -80,7 +80,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="server_WWebApi.mjs.html">server/WWebApi.mjs</a>, <a href="server_WWebApi.mjs.html#line136">line 136</a>
+        <a href="server_WWebApi.mjs.html">server/WWebApi.mjs</a>, <a href="server_WWebApi.mjs.html#line139">line 139</a>
     </li></ul></dd>
     
 
@@ -871,6 +871,126 @@ instWWebApi.on('error', (err) => {
         </tr>
 
     
+
+        <tr>
+            
+                <td class="name"><code>logFd</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>'./logs'</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入log紀錄儲存位置字串（srLog 寫入與統計掃描共用），預設'./logs'</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>logInterval</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>'hr'</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入log紀錄檔案拆檔時長字串，可選'hr'或'day'，預設'hr'</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>logNumKeep</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Integer</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>null</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入log檔保留數上限正整數，超出者自最舊刪除，未給採w-syslog預設(hr模式365*24、day模式365)，預設null</p></td>
+        </tr>
+
+    
     </tbody>
 </table>
 
@@ -959,7 +1079,7 @@ instWWebApi.on('error', (err) => {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Aug 26 2026 18:01:59 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 00:31:20 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/index.html

@@ -71,7 +71,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Aug 26 2026 18:01:59 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 00:31:20 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/server_WWebApi.mjs.html

@@ -100,6 +100,9 @@ import ds from '../src/schema/index.mjs'
  * @param {String} [opt.webLogo=''] 輸入站台logo字串，採base64格式，預設''
  * @param {String} [opt.subfolder=''] 輸入站台所在子目錄字串，提供站台位於內網採反向代理進行服務時，故需支援位於子目錄情形，預設''
  * @param {String} [opt.urlRedirect=''] 輸入錯誤時自動轉址字串，提供站台例如無法登入或驗證失敗時須自動轉址，預設''
+ * @param {String} [opt.logFd='./logs'] 輸入log紀錄儲存位置字串（srLog 寫入與統計掃描共用），預設'./logs'
+ * @param {String} [opt.logInterval='hr'] 輸入log紀錄檔案拆檔時長字串，可選'hr'或'day'，預設'hr'
+ * @param {Integer} [opt.logNumKeep=null] 輸入log檔保留數上限正整數，超出者自最舊刪除，未給採w-syslog預設(hr模式365*24、day模式365)，預設null
  * @returns {Object} 回傳物件，其內server為hapi伺服器實體，wsrv為w-converhp的伺服器事件物件，wsds為w-serv-webdata的伺服器事件物件，可監聽error事件
  * @example
  *
@@ -955,7 +958,7 @@ function WWebApi(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser,
             //統計資訊頁：回傳各 event 之時段發生頻率（讀 logFd 之 log）。連線之 token 認證由 verifyConn 把關；
             //授權（限管理員）屬套件使用者責任（見 verifyConn 註解與設計要點與取捨「套件授權責任」）。timeLength 天數 / timeInterval 'hr'|'day'。
             getStaEvent: wrapErrLog('getStaEvent', (userId, timeLength = 7, timeInterval = 'hr') => {
-                return staEvent(timeLength, timeInterval, { fdLog: logFd })
+                return staEvent(timeLength, timeInterval, { fdLog: logFd, srLog })
             }),
 
             // getAPIsList: (userId, query = {}) => { //待提供api管理系統界面使用
@@ -989,7 +992,7 @@ export default WWebApi
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Aug 26 2026 18:01:59 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 00:31:20 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/src_components_Common_CheckYesNo.vue.html

@@ -174,7 +174,7 @@ export default {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Aug 26 2026 18:01:59 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 00:31:20 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "w-web-api",
-  "version": "1.0.76",
+  "version": "1.0.78",
   "main": "dist/w-web-api.umd.js",
   "dependencies": {
     "axios": "^1.18.1",
     "json5": "^2.2.3",
-    "w-component-vue": "^2.5.5",
-    "w-data-collector": "^1.0.33",
-    "w-echarts-vue": "^1.0.4",
-    "w-md2html": "^1.0.47",
-    "w-serv-hapi": "^1.0.83",
-    "w-serv-orm": "^1.0.50",
-    "w-syslog": "^1.0.22",
-    "w-ui-loginout": "^1.0.21",
-    "wsemi": "^1.8.80"
+    "w-component-vue": "^2.5.8",
+    "w-data-collector": "^1.0.34",
+    "w-echarts-vue": "^1.0.6",
+    "w-md2html": "^1.0.48",
+    "w-serv-hapi": "^1.0.84",
+    "w-serv-orm": "^1.0.51",
+    "w-syslog": "^1.0.23",
+    "w-ui-loginout": "^1.0.22",
+    "wsemi": "^1.8.81"
   },
   "devDependencies": {
     "@vue/cli-plugin-babel": "^5.0.8",
@@ -28,16 +28,18 @@
     "eslint-plugin-vue": "^9.10.0",
     "vue": "^2.7.16",
     "vuex": "^3.6.2",
-    "w-orm-lmdb": "^1.0.27",
+    "w-orm-lmdb": "^1.0.28",
     "w-package-tools": "^1.1.15",
     "w-package-tools-e2e": "^1.0.0",
-    "w-screenctl": "^1.0.15"
+    "w-screenctl": "^1.0.16"
   },
   "scripts": {
     "serve": "vue-cli-service serve",
     "build": "vue-cli-service build",
-    "test:unit": "node server/staLogs/test_staEvent.mjs",
-    "test": "node server/staLogs/test_staEvent.mjs && mocha --timeout 300000",
+    "test:unit": "node server/staLogs/test_staEvent.mjs && mocha test/unit-*.test.mjs --timeout 300000",
+    "test:apiunit": "node server/staLogs/test_staEvent.mjs && mocha test/unit-*.test.mjs test/api-*.test.mjs --timeout 300000",
+    "test:e2e": "node test/run-e2e-isolated.mjs",
+    "test": "npm run test:apiunit && npm run test:e2e",
     "lint": "vue-cli-service lint",
     "deploy": "gh-pages -d docs"
   },

package/server/WWebApi.mjs

@@ -53,6 +53,9 @@ import ds from '../src/schema/index.mjs'
  * @param {String} [opt.webLogo=''] 輸入站台logo字串，採base64格式，預設''
  * @param {String} [opt.subfolder=''] 輸入站台所在子目錄字串，提供站台位於內網採反向代理進行服務時，故需支援位於子目錄情形，預設''
  * @param {String} [opt.urlRedirect=''] 輸入錯誤時自動轉址字串，提供站台例如無法登入或驗證失敗時須自動轉址，預設''
+ * @param {String} [opt.logFd='./logs'] 輸入log紀錄儲存位置字串（srLog 寫入與統計掃描共用），預設'./logs'
+ * @param {String} [opt.logInterval='hr'] 輸入log紀錄檔案拆檔時長字串，可選'hr'或'day'，預設'hr'
+ * @param {Integer} [opt.logNumKeep=null] 輸入log檔保留數上限正整數，超出者自最舊刪除，未給採w-syslog預設(hr模式365*24、day模式365)，預設null
  * @returns {Object} 回傳物件，其內server為hapi伺服器實體，wsrv為w-converhp的伺服器事件物件，wsds為w-serv-webdata的伺服器事件物件，可監聽error事件
  * @example
  *
@@ -908,7 +911,7 @@ function WWebApi(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser,
             //統計資訊頁：回傳各 event 之時段發生頻率（讀 logFd 之 log）。連線之 token 認證由 verifyConn 把關；
             //授權（限管理員）屬套件使用者責任（見 verifyConn 註解與設計要點與取捨「套件授權責任」）。timeLength 天數 / timeInterval 'hr'|'day'。
             getStaEvent: wrapErrLog('getStaEvent', (userId, timeLength = 7, timeInterval = 'hr') => {
-                return staEvent(timeLength, timeInterval, { fdLog: logFd })
+                return staEvent(timeLength, timeInterval, { fdLog: logFd, srLog })
             }),
 
             // getAPIsList: (userId, query = {}) => { //待提供api管理系統界面使用

package/server/procApis.mjs

@@ -1,5 +1,6 @@
 import iseobj from 'wsemi/src/iseobj.mjs'
 import isestr from 'wsemi/src/isestr.mjs'
+import pmKeyMutex from 'wsemi/src/pmKeyMutex.mjs'
 
 
 function procApis(deps = {}) {
@@ -7,6 +8,10 @@ function procApis(deps = {}) {
     //deps
     let { woItems, procOrm, ds } = deps
 
+    //kmx: 後端層雙擊 / 並發防護 (CLAUDE.md 三層防護之第 3 層): 同 key 之寫入序列化, 防 API 直打 / e2e race 繞過前端
+    //  key: 既有筆 `saveApi:<id>` / `deleteApi:<id>`; 新增筆無 id 以 `saveApi:new:<name>` 占位 (同名並發新增第 2 次仍序列化執行, 由呼叫端 / 後續唯一性檢查決定是否拒絕)
+    let kmx = pmKeyMutex()
+
 
     let getApisList = async (userId) => {
         return await woItems.apis.select({})
@@ -20,21 +25,27 @@ function procApis(deps = {}) {
             return Promise.reject('errApiRowInvalid')
         }
 
-        //正規化：funNew 配 id/時間/預設並過濾欄位
-        let o = ds.apis.funNew(row)
+        //key
+        let key = isestr(row.id) ? `saveApi:${row.id}` : `saveApi:new:${String(row.name || '')}`
+
+        return kmx(key, async () => {
+
+            //正規化：funNew 配 id/時間/預設並過濾欄位
+            let o = ds.apis.funNew(row)
 
-        //保留原 id 與創建時間（既有筆）
-        if (isestr(row.id)) {
-            o.id = row.id
-            if (isestr(row.timeCreate)) {
-                o.timeCreate = row.timeCreate
+            //保留原 id 與創建時間（既有筆）
+            if (isestr(row.id)) {
+                o.id = row.id
+                if (isestr(row.timeCreate)) {
+                    o.timeCreate = row.timeCreate
+                }
             }
-        }
 
-        //save
-        let r = await procOrm(userId, 'apis', 'save', [o])
+            //save
+            let r = await procOrm(userId, 'apis', 'save', [o])
 
-        return r
+            return r
+        })
     }
 
 
@@ -45,9 +56,10 @@ function procApis(deps = {}) {
             return Promise.reject('errApiIdInvalid')
         }
 
-        let r = await procOrm(userId, 'apis', 'del', { id })
-
-        return r
+        return kmx(`deleteApi:${id}`, async () => {
+            let r = await procOrm(userId, 'apis', 'del', { id })
+            return r
+        })
     }
 
 

package/server/procLang.mjs

@@ -2,7 +2,6 @@ import get from 'lodash-es/get.js'
 import each from 'lodash-es/each.js'
 import iseobj from 'wsemi/src/iseobj.mjs'
 
-
 let kpLang = {
 
     csIng: {
@@ -26,7 +25,6 @@ let kpLang = {
         cht: '拒絕登入',
     },
 
-
     systemMessage: {
         eng: 'System message',
         cht: '系統確認訊息',
@@ -178,7 +176,6 @@ let kpLang = {
         cht: '回傳數據範例',
     },
 
-
     //--- API 管理（展示/編輯/測試）---
 
     docInput: {
@@ -226,18 +223,6 @@ let kpLang = {
         eng: 'Frequency of backend logged events (APIs, kpFunExt, connection verification).',
         cht: '後端各事件（API、kpFunExt、連線驗證）之發生頻率統計。',
     },
-    selectEvents: {
-        eng: 'Select events',
-        cht: '選擇事件',
-    },
-    selectAll: {
-        eng: 'All',
-        cht: '全選',
-    },
-    selectNone: {
-        eng: 'Clear',
-        cht: '清除',
-    },
     eventStatsTable: {
         eng: 'Event Statistics',
         cht: '事件統計表',
@@ -555,7 +540,6 @@ let kpLang = {
 
 }
 
-
 let init = (opt = {}) => {
 
     //kpLangExt
@@ -640,5 +624,4 @@ let init = (opt = {}) => {
     return r
 }
 
-
 export default init

package/server/srLog.mjs

@@ -1,5 +1,7 @@
 import get from 'lodash-es/get.js'
 import isestr from 'wsemi/src/isestr.mjs'
+import ispint from 'wsemi/src/ispint.mjs'
+import cint from 'wsemi/src/cint.mjs'
 import WSyslog from 'w-syslog/src/WSyslog.mjs'
 
 
@@ -18,10 +20,17 @@ let init = (opt = {}) => {
         interval = 'hr'
     }
 
-    let srLog = WSyslog({
-        fdLog,
-        interval,
-    })
+    //numKeep, settings 之 logNumKeep (opt-in): 未給採 w-syslog 預設 (hr: 365*24, day: 365), 有給但非正整數視為設定錯誤
+    let numKeep = get(opt, 'logNumKeep', null)
+    let o = { fdLog, interval }
+    if (numKeep !== null && numKeep !== undefined && numKeep !== '') {
+        if (!ispint(numKeep)) {
+            throw new Error(`invalid logNumKeep[${numKeep}], must be positive integer`)
+        }
+        o.numKeep = cint(numKeep)
+    }
+
+    let srLog = WSyslog(o)
 
     return srLog
 }

package/server/staLogs/staEvent.mjs

@@ -1,131 +1,19 @@
-import ot from 'dayjs'
-import get from 'lodash-es/get.js'
-import size from 'lodash-es/size.js'
-import groupBy from 'lodash-es/groupBy.js'
-import each from 'lodash-es/each.js'
-import mapValues from 'lodash-es/mapValues.js'
-import merge from 'lodash-es/merge.js'
-import genPm from 'wsemi/src/genPm.mjs'
-import isestr from 'wsemi/src/isestr.mjs'
-import fsTreeFolder from 'wsemi/src/fsTreeFolder.mjs'
-import fsBuildReadStreamText from 'wsemi/src/fsBuildReadStreamText.mjs'
-import filterVpfsByWindow from './filterVpfsByWindow.mjs'
+import { staLogs } from './staLogsCore.callWorker.mjs'
 
 
-//staEvent（通用事件頻率統計，骨架移植自 w-web-sso server/staLogs/staIp.mjs，但「不過濾特定 event」、
-//內層改依 `event` 欄位分組）：掃 fdLog 下所有 NDJSON log 檔，依時間 bucket（hr/day）+ 各 event 名聚合次數。
-//輸出供前端統計圖：可呈現「全部（count）」或「各 event 各自」之時段發生頻率。
-//
-//回傳格式（時間遞增、無資料時段補 0）：
+//staEvent（通用事件頻率統計）：掃 fdLog 下所有 NDJSON log 檔，依時間 bucket（hr/day）+ 各 event 名聚合次數。
+//自 ADR-028 起由 staLogsCore 提供：單趟掃描 + 檔級彙總快取（封閉小時檔只掃一次）+ single-flight，掃描交單一 worker（主執行緒不阻塞）。
+//簽章與輸出格式不變（時間遞增、無資料時段補 { count: 0 }）：
 //  [
 //    { time: '2026-06-22T10', data: { count: 6, 'verifyConn': 3, 'kpfun-getApisList': 2, 'kpfun-saveApi': 1 } },
 //    { time: '2026-06-22T11', data: { count: 0 } },
 //    ...
 //  ]
-//
-//參數：
-//  timeLength   往回統計天數（預設 7）
-//  timeInterval 時間粒度 'hr'（每小時，預設）/ 'day'（每日）
-//  opt.fdLog    log 資料夾（預設 './logs'，須與 srLog 寫入之 logFd 一致；e2e 可指向合成 log 達 hermetic）
+//參數：timeLength 往回統計天數（預設 7）；timeInterval 'hr'（預設）/ 'day'；opt.fdLog log 資料夾（預設 './logs'）；opt.srLog（單檔略過時記 warn）
 async function staEvent(timeLength = 7, timeInterval = 'hr', opt = {}) {
-
-    //fdLog
-    let fdLog = get(opt, 'fdLog')
-    if (!isestr(fdLog)) {
-        fdLog = './logs'
-    }
-
-    //fmt
-    let fmt = timeInterval === 'day' ? 'YYYY-MM-DD' : 'YYYY-MM-DDTHH'
-
-    //unit
-    let unit = timeInterval === 'hr' ? 'hour' : 'day'
-
-    //kpTime，產生完整的時間區間（無資料時段亦補 { count: 0 }，圖表 x 軸不留空洞）
-    let now = ot()
-    let tStart = now.subtract(timeLength, 'day')
-    let tCurr = tStart.startOf(unit)
-    let tEnd = now.startOf(unit)
-    let kpTime = {}
-    while (!tCurr.isAfter(tEnd)) {
-        kpTime[tCurr.format(fmt)] = { data: { count: 0 } }
-        tCurr = tCurr.add(1, unit)
-    }
-
-    //vpfs
-    let vpfs = fsTreeFolder(fdLog)
-    vpfs = filterVpfsByWindow(vpfs, tStart, fmt) //開檔前剔除窗外檔, 見該模組註解
-
-    //logs（逐檔逐行 stream parse，挑出 tStart 之後、且帶 event 字串者）
-    let logs = []
-    for (let vpf of vpfs) {
-
-        //fp
-        let fp = vpf.path
-
-        //ev
-        let ev = fsBuildReadStreamText(fp)
-
-        //line
-        ev.on('line', (line) => {
-            let v = null
-            try {
-                v = JSON.parse(line)
-                let t = ot(v.time)
-                let timeFmt = t.format(fmt)
-                let b1 = t.isAfter(tStart)
-                let b2 = isestr(v.event) //通用：任何帶 event 字串之 log 皆納入（非鎖定單一 event）
-                let b = b1 && b2
-                if (b) {
-                    logs.push({
-                        timeFmt,
-                        ...v,
-                    })
-                }
-            }
-            catch (err) {} //略過非 JSON / 壞行
-        })
-
-        //await close
-        let pm = genPm()
-        ev.on('close', () => {
-            pm.resolve()
-        })
-        await pm
-
-    }
-
-    //gs，依時間 bucket 分組
-    let gs = groupBy(logs, 'timeFmt')
-
-    //gsLog，各 bucket 內依 event 名計數 + 總數 count
-    let gsLog = mapValues(gs, vs => {
-        let count = size(vs)
-        let gev = groupBy(vs, 'event')
-        let kp = {}
-        each(gev, (vvs, event) => {
-            kp[event] = size(vvs)
-        })
-        return {
-            data: {
-                count,
-                ...kp,
-            }
-        }
-    })
-
-    //merge（補零時段 + 實際資料）
-    let mr = merge({}, kpTime, gsLog)
-
-    //rs（時間遞增排序輸出）
-    let rs = Object.keys(mr)
-        .sort()
-        .map(time => ({
-            time,
-            ...mr[time]
-        }))
-
-    return rs
+    let r = await staLogs(timeLength, timeInterval, opt)
+    return r.rs
 }
 
+
 export default staEvent

package/server/staLogs/staLogsCore.callWorker.mjs

@@ -0,0 +1,78 @@
+import { fileURLToPath } from 'url'
+import path from 'path'
+import { Worker } from 'worker_threads'
+import genPm from 'wsemi/src/genPm.mjs'
+import { staLogs as staLogsCore } from './staLogsCore.mjs'
+
+
+let __filename = fileURLToPath(import.meta.url)
+let __dirname = path.dirname(__filename)
+
+let fpWkDefault = path.resolve(__dirname, 'staLogsCore.shellWorker.mjs')
+
+
+//runWorker: 以單一 worker 執行掃描, 回傳 worker 之 payload; fpWk 可注入 (測試用)
+//  終止路徑一律走 settle(): message(done/error) / error / exit 三者任一先到者定案, 其餘為 no-op, 且皆 terminate 回收
+//  exit 為必要: worker 未送任何訊息即結束 (如 worker 內 process.exit) 時若無 exit 監聽, promise 永不落定,
+//  又因 staLogsCore 之 single-flight 以 finally 釋放 in-flight key, 該 key 會永久卡死 (後續同參數呼叫皆取得死 promise, 需重啟後端)
+function runWorker(param, fpWk = fpWkDefault) {
+    let pm = genPm()
+
+    //wk
+    let wk = new Worker(fpWk)
+
+    //settle
+    let settled = false
+    let settle = (fn, v) => {
+        if (!settled) {
+            settled = true
+            fn(v)
+        }
+        try {
+            wk.terminate()
+        }
+        catch (err) {}
+    }
+
+    wk.on('message', (msg) => {
+        if (msg.mode === 'done') {
+            settle(pm.resolve, msg.payload)
+        }
+        else if (msg.mode === 'error') {
+            settle(pm.reject, msg.payload)
+        }
+    })
+
+    wk.on('error', (err) => {
+        settle(pm.reject, err)
+    })
+
+    wk.on('exit', (code) => {
+        settle(pm.reject, new Error(`staLogs worker exited without result, code=${code}`))
+    })
+
+    wk.postMessage(param)
+
+    return pm
+}
+
+
+//scanFilesByWorker: 把「需重掃之檔案清單」交給單一 worker 掃描 (主執行緒不阻塞), 回傳每檔彙總
+async function scanFilesByWorker(files, tStartMs, fmt) {
+
+    //無需重掃時不 spawn
+    if (files.length === 0) {
+        return []
+    }
+
+    return runWorker({ files, tStartMs, fmt })
+}
+
+
+function staLogs(timeLength = 7, timeInterval = 'hr', opt = {}) {
+    return staLogsCore(timeLength, timeInterval, { ...opt, scanFiles: scanFilesByWorker })
+}
+
+
+export { staLogs, scanFilesByWorker, runWorker }
+export default staLogs