w-serv-orm 1.1.10 → 1.1.12

package/docs/WServOrm.html

@@ -78,17 +78,22 @@
 <p>每次呼叫各自建立資料表ORM、設定與擴充函數，同一行程內之多個實例互不干擾；同一url與db之資料庫資源能否並存，依所用ORM而定。</p>
 <p>procOrm之save、del與mix，於ORM回傳之逐筆結果有任一筆ok為0(單筆失敗)時reject，訊息列出失敗筆之主鍵，如'failed to save data: id[b]'(超過100字元者截斷顯示；無有效主鍵者以data[k]列其於輸入內之位置，k自0起；超過10筆者只列前10筆並附總筆數)，錯誤原文另由console.log輸出。
 單筆失敗不中斷整批，故reject時其餘筆數已寫入。
-mix之各步驟遇單筆失敗不中斷後續步驟，待全部步驟完成後一併reject；遇整批性錯誤則立即reject，後續步驟不執行。</p>
-<p>insert、save與mix之新增、修改，數據未帶有效主鍵(非空字串或數字)者，若資料表之主鍵欄為id且為字串型(或型別未知)，由本套件產生主鍵(同各ORM之genIDSeq)並於resolve時回傳；無欄位之數據不補。
-reject時不回傳補出之主鍵，故重送未帶主鍵之數據會再產生新主鍵而重複寫入，需冪等重送者請自帶主鍵；save帶主鍵者重送以主鍵覆寫，del重送時已刪除者為主鍵未命中。
+mix之各步驟遇單筆失敗不中斷後續步驟，待全部步驟完成後一併reject；遇整批性錯誤則立即reject，後續步驟不執行。mix於resolve時回傳各步驟所處理之列之id(依add、del、diff之序串接，del之列不分是否命中)。</p>
+<p>insert、save與mix之新增、修改，數據未帶有效主鍵(未給、null、空字串，或非字串非數字之值，含NaN與±Infinity)者，若資料表之主鍵欄為id且為字串型(或型別未知；型別如STRING(36)者以括號前之字判定)，由本套件產生主鍵(同各ORM之genIDSeq)並於resolve時回傳；單一空物件與只含一個空物件之陣列不補(ORM視為無效輸入而不寫入)，多筆批次中之空物件列則補。
+主鍵欄為字串型(或型別未知)之資料表，主鍵為有限數字者一律以其字串形式處置(如123視為'123')：寫入、resolve回傳、del與mix之刪除，以及select、delAll條件中主鍵之比較($eq、$ne、$gt、$gte、$lt、$lte、$in、$nin、$all，含$not、$and、$or、$nor之內)皆同，故以數字或其字串形式寫入、查詢與刪除者為同一筆，範圍比較依字串之字典序；主鍵欄為整數型者不轉型。轉型只作用於procOrm，經woItems直接操作者不轉型。舊版w-orm-mongodb(2025-04-29以前)保留之數字主鍵資料，以數字查詢將查不到。
+reject時不回傳補出之主鍵，故重送未帶主鍵之數據會再產生新主鍵而重複寫入，需冪等重送者請自帶主鍵(非空字串或有限數字)；save帶主鍵者重送以主鍵覆寫，del重送時已刪除者為主鍵未命中。
+回傳之id為本套件依輸入(含補值與轉型)所得之主鍵，非ORM之寫入結果；ORM之比對規則較寬者(如w-orm-mdb之Jet不分大小寫、忽略尾端空白)，insert略過或save命中之對象可能與回傳之id不同。lmdb、lowdb、level、mongodb等主鍵固定為字串id之ORM，其資料表之id須為字串型pk或不標型別；本套件以id為主鍵，主鍵欄非id之ORM(如w-orm-postgresql預設為time)之回傳id不具主鍵意義。
+輸入之形狀：insert與save之各筆、mix之新增與修改之各筆須為物件，mix之add、del、diff若給予須為陣列，select與delAll之條件若給予須為純物件(原型為null或Object.prototype；未給、undefined與空物件{}為無條件：select回全部、delAll刪除全部；null、陣列、字串、數字、布林、函數、Date、RegExp、Map、Set與類別實例皆reject)，否則於任何寫入或查詢之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of select, need an object'、'invalid find of delAll, need an object'。
+資料表名(procOrm之woName)須為本實例資料表之自有名稱，否則reject 'can not find table[x] in ORM'(原型鏈上之名稱如constructor、toString與路徑字串如tests.select亦然)；select與delAll之條件之巢狀深度(物件與陣列各算一層)超過64層者reject 'invalid find of select, too deep'。條件與寫入列(insert、save、mix之新增與修改)之任何深度(一般物件之值、陣列之元素)含自有__proto__鍵(JSON.parse、Object.fromEntries、structuredClone等可產生；物件字面量之__proto__為設原型而不算)或存取器屬性(getter、setter)者整批reject，如'invalid find of select, unsupported key[<strong>proto</strong>]'、'failed to insert data, unsupported accessor property: data[0]'，訊息不回顯客戶端之值。含整數length鍵之條件與寫入列本身依其自有鍵處置，不被當成陣列樣物件；欄位值內之巢狀物件之XSS清除由wsemi之clearXSS進行，不在此限(見規則帳本R-OBJ-01之已知限制)。mix之del各筆與單獨del之各筆不做上述檢查。
+mix之add與del、del與diff含同一主鍵(依上述轉型後)者，於任何步驟之前整批reject且不寫入任何一筆，訊息列其位置而不回顯主鍵，如'invalid input of mix, same id in add and del: add[0], del[1]'；因mix依add、del、diff之序執行，同鍵將使新增因已存在而略過後即被刪除。
 insert(含mix之新增)為主鍵已存在即略過之冪等新增，回傳之id含被略過者；recover亦以insert還原，故資料表須先清空。
 insert、save與mix之新增、修改，寫入前各欄位之字串皆經wsemi之clearXSS清除(白名單外之標籤轉義，白名單內之標籤刪除白名單外之屬性與危險網址，標籤外之文字只轉義會開始標籤之&lt;，故'a &lt; b'等數學式不改寫)；select與del不經清除。
 字串主鍵若會被清除改寫(含HTML標記，如&lt;後緊接英文字母)，整批reject且不寫入任何一筆(mix於任何步驟之前檢查新增與修改)，訊息列其位置而不回顯主鍵，如'failed to save data, id contains HTML markup: data[1]'；否則改寫後之主鍵與呼叫端所持者不同，以原主鍵查詢與刪除皆找不到。</p>
 <p>擴充函數(addFunCheck、addFunPreProcessing、addFunPostProcessing)屬於各實例，重建實例後須重新註冊；註冊時須傳入函數，否則立即拋錯(addFunCheck另令該實例之procOrm一律reject)；註冊後約1毫秒(以計時器)才生效，在此之前之procOrm呼叫不會套用。
 呼叫契約：check以reject或拋錯阻擋，回傳值不影響結果，且早於前處理執行；前處理逐一呼叫，各收新建之參數物件{woName,userId,mode,input}，input為前一個回傳之input，回傳須為含input之物件否則reject；後處理逐一呼叫，各收新建之參數物件且其output為前一個之回傳值，最後之回傳值即為procOrm之回傳值。
-後處理只在check、前處理與ORM操作皆成功後執行，逐筆失敗(含del)或mix部分寫入後reject者皆不執行；後處理自身亦可reject。後處理之input為呼叫端傳入之數據，不含本套件補出之主鍵，主鍵見output。
+後處理只在check、前處理與ORM操作皆成功後執行，逐筆失敗(含del)或mix部分寫入後reject者皆不執行；後處理自身亦可reject。後處理之input為前處理後之數據(無前處理者即呼叫端傳入之數據)，不含本套件之補值與主鍵轉型，主鍵見output。
 如需觀察ORM實際寫入，可另監聽woItems內各ORM之change與error事件；惟事件由ORM發出，不含userId，mix會依步驟分次發出，經woItems直接寫入者亦會發出，insert之結果為聚合計數而非逐筆。
-錯誤型別：procOrm由本套件產生之reject一律為英文訊息字串(供前端顯示或對應多語系；ORM之錯誤原文另由console.log輸出而不轉出)，擴充函數自身之reject或拋錯則原樣轉出；建構(設定或ORM無效)、擴充函數註冊、backup與recover由本套件產生之錯誤一律為Error，ORM之錯誤則原樣轉出。</p>
+錯誤型別：procOrm由本套件產生之reject一律為英文訊息字串(供前端顯示或對應多語系；ORM之錯誤原文另由console.log輸出而不轉出；檢查與轉型階段之非預期例外，如使用端物件之Proxy陷阱拋錯、遞迴爆堆疊，統一為'failed to process input')，擴充函數自身之reject或拋錯則原樣轉出；建構(設定或ORM無效)、擴充函數註冊、backup與recover由本套件產生之錯誤一律為Error，ORM之錯誤則原樣轉出。</p>
 <p>授權：procOrm不做授權，不檢查使用者，亦不依使用者過濾數據；userId只供寫入稽核欄位(userId、userIdUpdate)與交給擴充函數。procOrm開放給前端時(如讓前端經資料通道直接操作資料表)，須由開放處負責授權；addFunCheck可掛額外檢查，惟伺服端程式之呼叫亦會經過。
 已移除之設定：useCheckUser、getUserById、useExcludeWhenNotAdmin，未給、null或false者照常建構，給予其他值即於建構時拋錯。</p></li></ul></dd>
     
@@ -96,7 +101,7 @@ insert、save與mix之新增、修改，寫入前各欄位之字串皆經wsemi
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WServOrm.mjs.html">WServOrm.mjs</a>, <a href="WServOrm.mjs.html#line96">line 96</a>
+        <a href="WServOrm.mjs.html">WServOrm.mjs</a>, <a href="WServOrm.mjs.html#line101">line 101</a>
     </li></ul></dd>
     
 
@@ -439,7 +444,7 @@ insert、save與mix之新增、修改，寫入前各欄位之字串皆經wsemi
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Tue Oct 13 2026 06:34:48 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 Sat Oct 17 2026 03:07:56 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/WServOrm.mjs.html

@@ -61,19 +61,24 @@ import getProc from './getProc.mjs'
  *
  * procOrm之save、del與mix，於ORM回傳之逐筆結果有任一筆ok為0(單筆失敗)時reject，訊息列出失敗筆之主鍵，如'failed to save data: id[b]'(超過100字元者截斷顯示；無有效主鍵者以data[k]列其於輸入內之位置，k自0起；超過10筆者只列前10筆並附總筆數)，錯誤原文另由console.log輸出。
  * 單筆失敗不中斷整批，故reject時其餘筆數已寫入。
- * mix之各步驟遇單筆失敗不中斷後續步驟，待全部步驟完成後一併reject；遇整批性錯誤則立即reject，後續步驟不執行。
+ * mix之各步驟遇單筆失敗不中斷後續步驟，待全部步驟完成後一併reject；遇整批性錯誤則立即reject，後續步驟不執行。mix於resolve時回傳各步驟所處理之列之id(依add、del、diff之序串接，del之列不分是否命中)。
  *
- * insert、save與mix之新增、修改，數據未帶有效主鍵(非空字串或數字)者，若資料表之主鍵欄為id且為字串型(或型別未知)，由本套件產生主鍵(同各ORM之genIDSeq)並於resolve時回傳；無欄位之數據不補。
- * reject時不回傳補出之主鍵，故重送未帶主鍵之數據會再產生新主鍵而重複寫入，需冪等重送者請自帶主鍵；save帶主鍵者重送以主鍵覆寫，del重送時已刪除者為主鍵未命中。
+ * insert、save與mix之新增、修改，數據未帶有效主鍵(未給、null、空字串，或非字串非數字之值，含NaN與±Infinity)者，若資料表之主鍵欄為id且為字串型(或型別未知；型別如STRING(36)者以括號前之字判定)，由本套件產生主鍵(同各ORM之genIDSeq)並於resolve時回傳；單一空物件與只含一個空物件之陣列不補(ORM視為無效輸入而不寫入)，多筆批次中之空物件列則補。
+ * 主鍵欄為字串型(或型別未知)之資料表，主鍵為有限數字者一律以其字串形式處置(如123視為'123')：寫入、resolve回傳、del與mix之刪除，以及select、delAll條件中主鍵之比較($eq、$ne、$gt、$gte、$lt、$lte、$in、$nin、$all，含$not、$and、$or、$nor之內)皆同，故以數字或其字串形式寫入、查詢與刪除者為同一筆，範圍比較依字串之字典序；主鍵欄為整數型者不轉型。轉型只作用於procOrm，經woItems直接操作者不轉型。舊版w-orm-mongodb(2025-04-29以前)保留之數字主鍵資料，以數字查詢將查不到。
+ * reject時不回傳補出之主鍵，故重送未帶主鍵之數據會再產生新主鍵而重複寫入，需冪等重送者請自帶主鍵(非空字串或有限數字)；save帶主鍵者重送以主鍵覆寫，del重送時已刪除者為主鍵未命中。
+ * 回傳之id為本套件依輸入(含補值與轉型)所得之主鍵，非ORM之寫入結果；ORM之比對規則較寬者(如w-orm-mdb之Jet不分大小寫、忽略尾端空白)，insert略過或save命中之對象可能與回傳之id不同。lmdb、lowdb、level、mongodb等主鍵固定為字串id之ORM，其資料表之id須為字串型pk或不標型別；本套件以id為主鍵，主鍵欄非id之ORM(如w-orm-postgresql預設為time)之回傳id不具主鍵意義。
+ * 輸入之形狀：insert與save之各筆、mix之新增與修改之各筆須為物件，mix之add、del、diff若給予須為陣列，select與delAll之條件若給予須為純物件(原型為null或Object.prototype；未給、undefined與空物件{}為無條件：select回全部、delAll刪除全部；null、陣列、字串、數字、布林、函數、Date、RegExp、Map、Set與類別實例皆reject)，否則於任何寫入或查詢之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of select, need an object'、'invalid find of delAll, need an object'。
+ * 資料表名(procOrm之woName)須為本實例資料表之自有名稱，否則reject 'can not find table[x] in ORM'(原型鏈上之名稱如constructor、toString與路徑字串如tests.select亦然)；select與delAll之條件之巢狀深度(物件與陣列各算一層)超過64層者reject 'invalid find of select, too deep'。條件與寫入列(insert、save、mix之新增與修改)之任何深度(一般物件之值、陣列之元素)含自有__proto__鍵(JSON.parse、Object.fromEntries、structuredClone等可產生；物件字面量之__proto__為設原型而不算)或存取器屬性(getter、setter)者整批reject，如'invalid find of select, unsupported key[__proto__]'、'failed to insert data, unsupported accessor property: data[0]'，訊息不回顯客戶端之值。含整數length鍵之條件與寫入列本身依其自有鍵處置，不被當成陣列樣物件；欄位值內之巢狀物件之XSS清除由wsemi之clearXSS進行，不在此限(見規則帳本R-OBJ-01之已知限制)。mix之del各筆與單獨del之各筆不做上述檢查。
+ * mix之add與del、del與diff含同一主鍵(依上述轉型後)者，於任何步驟之前整批reject且不寫入任何一筆，訊息列其位置而不回顯主鍵，如'invalid input of mix, same id in add and del: add[0], del[1]'；因mix依add、del、diff之序執行，同鍵將使新增因已存在而略過後即被刪除。
  * insert(含mix之新增)為主鍵已存在即略過之冪等新增，回傳之id含被略過者；recover亦以insert還原，故資料表須先清空。
  * insert、save與mix之新增、修改，寫入前各欄位之字串皆經wsemi之clearXSS清除(白名單外之標籤轉義，白名單內之標籤刪除白名單外之屬性與危險網址，標籤外之文字只轉義會開始標籤之<，故'a < b'等數學式不改寫)；select與del不經清除。
  * 字串主鍵若會被清除改寫(含HTML標記，如<後緊接英文字母)，整批reject且不寫入任何一筆(mix於任何步驟之前檢查新增與修改)，訊息列其位置而不回顯主鍵，如'failed to save data, id contains HTML markup: data[1]'；否則改寫後之主鍵與呼叫端所持者不同，以原主鍵查詢與刪除皆找不到。
  *
  * 擴充函數(addFunCheck、addFunPreProcessing、addFunPostProcessing)屬於各實例，重建實例後須重新註冊；註冊時須傳入函數，否則立即拋錯(addFunCheck另令該實例之procOrm一律reject)；註冊後約1毫秒(以計時器)才生效，在此之前之procOrm呼叫不會套用。
  * 呼叫契約：check以reject或拋錯阻擋，回傳值不影響結果，且早於前處理執行；前處理逐一呼叫，各收新建之參數物件{woName,userId,mode,input}，input為前一個回傳之input，回傳須為含input之物件否則reject；後處理逐一呼叫，各收新建之參數物件且其output為前一個之回傳值，最後之回傳值即為procOrm之回傳值。
- * 後處理只在check、前處理與ORM操作皆成功後執行，逐筆失敗(含del)或mix部分寫入後reject者皆不執行；後處理自身亦可reject。後處理之input為呼叫端傳入之數據，不含本套件補出之主鍵，主鍵見output。
+ * 後處理只在check、前處理與ORM操作皆成功後執行，逐筆失敗(含del)或mix部分寫入後reject者皆不執行；後處理自身亦可reject。後處理之input為前處理後之數據(無前處理者即呼叫端傳入之數據)，不含本套件之補值與主鍵轉型，主鍵見output。
  * 如需觀察ORM實際寫入，可另監聽woItems內各ORM之change與error事件；惟事件由ORM發出，不含userId，mix會依步驟分次發出，經woItems直接寫入者亦會發出，insert之結果為聚合計數而非逐筆。
- * 錯誤型別：procOrm由本套件產生之reject一律為英文訊息字串(供前端顯示或對應多語系；ORM之錯誤原文另由console.log輸出而不轉出)，擴充函數自身之reject或拋錯則原樣轉出；建構(設定或ORM無效)、擴充函數註冊、backup與recover由本套件產生之錯誤一律為Error，ORM之錯誤則原樣轉出。
+ * 錯誤型別：procOrm由本套件產生之reject一律為英文訊息字串(供前端顯示或對應多語系；ORM之錯誤原文另由console.log輸出而不轉出；檢查與轉型階段之非預期例外，如使用端物件之Proxy陷阱拋錯、遞迴爆堆疊，統一為'failed to process input')，擴充函數自身之reject或拋錯則原樣轉出；建構(設定或ORM無效)、擴充函數註冊、backup與recover由本套件產生之錯誤一律為Error，ORM之錯誤則原樣轉出。
  *
  * 授權：procOrm不做授權，不檢查使用者，亦不依使用者過濾數據；userId只供寫入稽核欄位(userId、userIdUpdate)與交給擴充函數。procOrm開放給前端時(如讓前端經資料通道直接操作資料表)，須由開放處負責授權；addFunCheck可掛額外檢查，惟伺服端程式之呼叫亦會經過。
  * 已移除之設定：useCheckUser、getUserById、useExcludeWhenNotAdmin，未給、null或false者照常建構，給予其他值即於建構時拋錯。
@@ -191,7 +196,7 @@ export default WServOrm
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Tue Oct 13 2026 06:34:48 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 Sat Oct 17 2026 03:07:56 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 Tue Oct 13 2026 06:34:48 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 Sat Oct 17 2026 03:07:56 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "w-serv-orm",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "main": "dist/w-serv-orm.umd.js",
   "dependencies": {
     "json5": "^2.2.3",
     "w-data-collector": "^1.0.46",
-    "wsemi": "^1.9.13"
+    "wsemi": "^1.9.17"
   },
   "devDependencies": {
     "w-orm-lowdb": "^1.0.31",
-    "w-package-tools": "^1.1.16"
+    "w-package-tools": "^1.1.20"
   },
   "scripts": {
     "test": "mocha --parallel \"test/*.test.mjs\" --timeout 180000",

package/src/WServOrm.mjs

@@ -14,19 +14,24 @@ import getProc from './getProc.mjs'
  *
  * procOrm之save、del與mix，於ORM回傳之逐筆結果有任一筆ok為0(單筆失敗)時reject，訊息列出失敗筆之主鍵，如'failed to save data: id[b]'(超過100字元者截斷顯示；無有效主鍵者以data[k]列其於輸入內之位置，k自0起；超過10筆者只列前10筆並附總筆數)，錯誤原文另由console.log輸出。
  * 單筆失敗不中斷整批，故reject時其餘筆數已寫入。
- * mix之各步驟遇單筆失敗不中斷後續步驟，待全部步驟完成後一併reject；遇整批性錯誤則立即reject，後續步驟不執行。
+ * mix之各步驟遇單筆失敗不中斷後續步驟，待全部步驟完成後一併reject；遇整批性錯誤則立即reject，後續步驟不執行。mix於resolve時回傳各步驟所處理之列之id(依add、del、diff之序串接，del之列不分是否命中)。
  *
- * insert、save與mix之新增、修改，數據未帶有效主鍵(非空字串或數字)者，若資料表之主鍵欄為id且為字串型(或型別未知)，由本套件產生主鍵(同各ORM之genIDSeq)並於resolve時回傳；無欄位之數據不補。
- * reject時不回傳補出之主鍵，故重送未帶主鍵之數據會再產生新主鍵而重複寫入，需冪等重送者請自帶主鍵；save帶主鍵者重送以主鍵覆寫，del重送時已刪除者為主鍵未命中。
+ * insert、save與mix之新增、修改，數據未帶有效主鍵(未給、null、空字串，或非字串非數字之值，含NaN與±Infinity)者，若資料表之主鍵欄為id且為字串型(或型別未知；型別如STRING(36)者以括號前之字判定)，由本套件產生主鍵(同各ORM之genIDSeq)並於resolve時回傳；單一空物件與只含一個空物件之陣列不補(ORM視為無效輸入而不寫入)，多筆批次中之空物件列則補。
+ * 主鍵欄為字串型(或型別未知)之資料表，主鍵為有限數字者一律以其字串形式處置(如123視為'123')：寫入、resolve回傳、del與mix之刪除，以及select、delAll條件中主鍵之比較($eq、$ne、$gt、$gte、$lt、$lte、$in、$nin、$all，含$not、$and、$or、$nor之內)皆同，故以數字或其字串形式寫入、查詢與刪除者為同一筆，範圍比較依字串之字典序；主鍵欄為整數型者不轉型。轉型只作用於procOrm，經woItems直接操作者不轉型。舊版w-orm-mongodb(2025-04-29以前)保留之數字主鍵資料，以數字查詢將查不到。
+ * reject時不回傳補出之主鍵，故重送未帶主鍵之數據會再產生新主鍵而重複寫入，需冪等重送者請自帶主鍵(非空字串或有限數字)；save帶主鍵者重送以主鍵覆寫，del重送時已刪除者為主鍵未命中。
+ * 回傳之id為本套件依輸入(含補值與轉型)所得之主鍵，非ORM之寫入結果；ORM之比對規則較寬者(如w-orm-mdb之Jet不分大小寫、忽略尾端空白)，insert略過或save命中之對象可能與回傳之id不同。lmdb、lowdb、level、mongodb等主鍵固定為字串id之ORM，其資料表之id須為字串型pk或不標型別；本套件以id為主鍵，主鍵欄非id之ORM(如w-orm-postgresql預設為time)之回傳id不具主鍵意義。
+ * 輸入之形狀：insert與save之各筆、mix之新增與修改之各筆須為物件，mix之add、del、diff若給予須為陣列，select與delAll之條件若給予須為純物件(原型為null或Object.prototype；未給、undefined與空物件{}為無條件：select回全部、delAll刪除全部；null、陣列、字串、數字、布林、函數、Date、RegExp、Map、Set與類別實例皆reject)，否則於任何寫入或查詢之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of select, need an object'、'invalid find of delAll, need an object'。
+ * 資料表名(procOrm之woName)須為本實例資料表之自有名稱，否則reject 'can not find table[x] in ORM'(原型鏈上之名稱如constructor、toString與路徑字串如tests.select亦然)；select與delAll之條件之巢狀深度(物件與陣列各算一層)超過64層者reject 'invalid find of select, too deep'。條件與寫入列(insert、save、mix之新增與修改)之任何深度(一般物件之值、陣列之元素)含自有__proto__鍵(JSON.parse、Object.fromEntries、structuredClone等可產生；物件字面量之__proto__為設原型而不算)或存取器屬性(getter、setter)者整批reject，如'invalid find of select, unsupported key[__proto__]'、'failed to insert data, unsupported accessor property: data[0]'，訊息不回顯客戶端之值。含整數length鍵之條件與寫入列本身依其自有鍵處置，不被當成陣列樣物件；欄位值內之巢狀物件之XSS清除由wsemi之clearXSS進行，不在此限(見規則帳本R-OBJ-01之已知限制)。mix之del各筆與單獨del之各筆不做上述檢查。
+ * mix之add與del、del與diff含同一主鍵(依上述轉型後)者，於任何步驟之前整批reject且不寫入任何一筆，訊息列其位置而不回顯主鍵，如'invalid input of mix, same id in add and del: add[0], del[1]'；因mix依add、del、diff之序執行，同鍵將使新增因已存在而略過後即被刪除。
  * insert(含mix之新增)為主鍵已存在即略過之冪等新增，回傳之id含被略過者；recover亦以insert還原，故資料表須先清空。
  * insert、save與mix之新增、修改，寫入前各欄位之字串皆經wsemi之clearXSS清除(白名單外之標籤轉義，白名單內之標籤刪除白名單外之屬性與危險網址，標籤外之文字只轉義會開始標籤之<，故'a < b'等數學式不改寫)；select與del不經清除。
  * 字串主鍵若會被清除改寫(含HTML標記，如<後緊接英文字母)，整批reject且不寫入任何一筆(mix於任何步驟之前檢查新增與修改)，訊息列其位置而不回顯主鍵，如'failed to save data, id contains HTML markup: data[1]'；否則改寫後之主鍵與呼叫端所持者不同，以原主鍵查詢與刪除皆找不到。
  *
  * 擴充函數(addFunCheck、addFunPreProcessing、addFunPostProcessing)屬於各實例，重建實例後須重新註冊；註冊時須傳入函數，否則立即拋錯(addFunCheck另令該實例之procOrm一律reject)；註冊後約1毫秒(以計時器)才生效，在此之前之procOrm呼叫不會套用。
  * 呼叫契約：check以reject或拋錯阻擋，回傳值不影響結果，且早於前處理執行；前處理逐一呼叫，各收新建之參數物件{woName,userId,mode,input}，input為前一個回傳之input，回傳須為含input之物件否則reject；後處理逐一呼叫，各收新建之參數物件且其output為前一個之回傳值，最後之回傳值即為procOrm之回傳值。
- * 後處理只在check、前處理與ORM操作皆成功後執行，逐筆失敗(含del)或mix部分寫入後reject者皆不執行；後處理自身亦可reject。後處理之input為呼叫端傳入之數據，不含本套件補出之主鍵，主鍵見output。
+ * 後處理只在check、前處理與ORM操作皆成功後執行，逐筆失敗(含del)或mix部分寫入後reject者皆不執行；後處理自身亦可reject。後處理之input為前處理後之數據(無前處理者即呼叫端傳入之數據)，不含本套件之補值與主鍵轉型，主鍵見output。
  * 如需觀察ORM實際寫入，可另監聽woItems內各ORM之change與error事件；惟事件由ORM發出，不含userId，mix會依步驟分次發出，經woItems直接寫入者亦會發出，insert之結果為聚合計數而非逐筆。
- * 錯誤型別：procOrm由本套件產生之reject一律為英文訊息字串(供前端顯示或對應多語系；ORM之錯誤原文另由console.log輸出而不轉出)，擴充函數自身之reject或拋錯則原樣轉出；建構(設定或ORM無效)、擴充函數註冊、backup與recover由本套件產生之錯誤一律為Error，ORM之錯誤則原樣轉出。
+ * 錯誤型別：procOrm由本套件產生之reject一律為英文訊息字串(供前端顯示或對應多語系；ORM之錯誤原文另由console.log輸出而不轉出；檢查與轉型階段之非預期例外，如使用端物件之Proxy陷阱拋錯、遞迴爆堆疊，統一為'failed to process input')，擴充函數自身之reject或拋錯則原樣轉出；建構(設定或ORM無效)、擴充函數註冊、backup與recover由本套件產生之錯誤一律為Error，ORM之錯誤則原樣轉出。
  *
  * 授權：procOrm不做授權，不檢查使用者，亦不依使用者過濾數據；userId只供寫入稽核欄位(userId、userIdUpdate)與交給擴充函數。procOrm開放給前端時(如讓前端經資料通道直接操作資料表)，須由開放處負責授權；addFunCheck可掛額外檢查，惟伺服端程式之呼叫亦會經過。
  * 已移除之設定：useCheckUser、getUserById、useExcludeWhenNotAdmin，未給、null或false者照常建構，給予其他值即於建構時拋錯。

package/src/getDbBackupAndRecover.mjs

@@ -9,7 +9,6 @@ import fsIsFile from 'wsemi/src/fsIsFile.mjs'
 import iseobj from 'wsemi/src/iseobj.mjs'
 import isearr from 'wsemi/src/isearr.mjs'
 import isestr from 'wsemi/src/isestr.mjs'
-import haskey from 'wsemi/src/haskey.mjs'
 import isfun from 'wsemi/src/isfun.mjs'
 import isbol from 'wsemi/src/isbol.mjs'
 import j2o from 'wsemi/src/j2o.mjs'
@@ -78,7 +77,7 @@ async function recover(fp, woItems, genModels, needCreateStorage = false) {
         if (!isestr(name)) {
             throw new Error(`invalid backup data, rs[${k}].name is not a string`)
         }
-        if (!haskey(woItems, name)) {
+        if (!Object.prototype.hasOwnProperty.call(woItems, name)) { //自有屬性, 不用haskey(in運算含原型鏈, constructor、toString等通過驗證後才在寫入時失敗)
             throw new Error(`invalid backup data, table[${name}] is not in woItems`)
         }
     })