w-serv-orm 1.1.11 → 1.1.13

package/docs/WServOrm.html

@@ -83,7 +83,8 @@ mix之各步驟遇單筆失敗不中斷後續步驟，待全部步驟完成後
 主鍵欄為字串型(或型別未知)之資料表，主鍵為有限數字者一律以其字串形式處置(如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若給予須為陣列，delAll之條件若給予須為物件，否則於任何寫入之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of delAll, need an object'。
+輸入之形狀：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不經清除。
@@ -92,7 +93,7 @@ insert、save與mix之新增、修改，寫入前各欄位之字串皆經wsemi
 呼叫契約：check以reject或拋錯阻擋，回傳值不影響結果，且早於前處理執行；前處理逐一呼叫，各收新建之參數物件{woName,userId,mode,input}，input為前一個回傳之input，回傳須為含input之物件否則reject；後處理逐一呼叫，各收新建之參數物件且其output為前一個之回傳值，最後之回傳值即為procOrm之回傳值。
 後處理只在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>
     
@@ -100,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#line100">line 100</a>
+        <a href="WServOrm.mjs.html">WServOrm.mjs</a>, <a href="WServOrm.mjs.html#line101">line 101</a>
     </li></ul></dd>
     
 
@@ -443,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 Wed Oct 14 2026 07:49:10 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 05:14:34 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/WServOrm.mjs.html

@@ -67,7 +67,8 @@ import getProc from './getProc.mjs'
  * 主鍵欄為字串型(或型別未知)之資料表，主鍵為有限數字者一律以其字串形式處置(如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若給予須為陣列，delAll之條件若給予須為物件，否則於任何寫入之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of delAll, need an object'。
+ * 輸入之形狀：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不經清除。
@@ -77,7 +78,7 @@ import getProc from './getProc.mjs'
  * 呼叫契約：check以reject或拋錯阻擋，回傳值不影響結果，且早於前處理執行；前處理逐一呼叫，各收新建之參數物件{woName,userId,mode,input}，input為前一個回傳之input，回傳須為含input之物件否則reject；後處理逐一呼叫，各收新建之參數物件且其output為前一個之回傳值，最後之回傳值即為procOrm之回傳值。
  * 後處理只在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者照常建構，給予其他值即於建構時拋錯。
@@ -195,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 Wed Oct 14 2026 07:49:10 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 05:14:34 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 Oct 14 2026 07:49:10 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 05:14:34 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.11",
+  "version": "1.1.13",
   "main": "dist/w-serv-orm.umd.js",
   "dependencies": {
     "json5": "^2.2.3",
     "w-data-collector": "^1.0.46",
-    "wsemi": "^1.9.15"
+    "wsemi": "^1.9.18"
   },
   "devDependencies": {
     "w-orm-lowdb": "^1.0.31",
-    "w-package-tools": "^1.1.18"
+    "w-package-tools": "^1.1.20"
   },
   "scripts": {
     "test": "mocha --parallel \"test/*.test.mjs\" --timeout 180000",

package/src/WServOrm.mjs

@@ -20,7 +20,8 @@ import getProc from './getProc.mjs'
  * 主鍵欄為字串型(或型別未知)之資料表，主鍵為有限數字者一律以其字串形式處置(如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若給予須為陣列，delAll之條件若給予須為物件，否則於任何寫入之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of delAll, need an object'。
+ * 輸入之形狀：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不經清除。
@@ -30,7 +31,7 @@ import getProc from './getProc.mjs'
  * 呼叫契約：check以reject或拋錯阻擋，回傳值不影響結果，且早於前處理執行；前處理逐一呼叫，各收新建之參數物件{woName,userId,mode,input}，input為前一個回傳之input，回傳須為含input之物件否則reject；後處理逐一呼叫，各收新建之參數物件且其output為前一個之回傳值，最後之回傳值即為procOrm之回傳值。
  * 後處理只在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`)
         }
     })

package/src/getMapOrm.mjs

@@ -71,9 +71,19 @@ function isPkIdString(dsTab, keys) {
 }
 
 
+function getOwnItem(o, k) {
+    //取o之自有屬性k, 非自有、k非字串、o非物件或值為undefined者回傳null(R-INPUT-01 規則5)
+    //不用lodash get: 其會取到原型鏈上之值(__proto__、constructor、toString等)並解析路徑字串(如'tests.select'取到ORM之函數); 鍵本身含「.」者為自有屬性, 照常
+    if (o === null || typeof o !== 'object' || typeof k !== 'string' || !Object.prototype.hasOwnProperty.call(o, k)) {
+        return null
+    }
+    return o[k] === undefined ? null : o[k]
+}
+
+
 function isIdCast(ds, woName) {
     //資料表之主鍵欄為字串型或型別未知者, 主鍵之有限數字以其字串形式處置(R-ID-02); ds無該表者不轉型, 令select與del照舊原樣交ORM
-    let dsTab = get(ds, woName, null)
+    let dsTab = getOwnItem(ds, woName)
     let keys = get(dsTab, 'keys', null)
     if (!isarr(keys)) {
         return false
@@ -96,6 +106,171 @@ function castIdValue(v) {
 }
 
 
+function mapOwn(o, f) {
+    //使用端物件之複製與逐鍵轉換(R-OBJ-01 規則1、2): 只走自有可列舉鍵, 回傳新物件, f收(值, 鍵)
+    //不用lodash each: 其對具非負整數length鍵之物件(如{length:1,name:'x'})採陣列樣迭代, 只走索引0..length-1而丟棄全部自有鍵
+    //以fromEntries建立自有屬性, 不用r[k]=v: k為__proto__時會改設r之原型而不建立自有屬性
+    return Object.fromEntries(Object.keys(o).map((k) => [k, f(o[k], k)]))
+}
+
+
+//不支援之鍵或屬性的原因與訊息(R-OBJ-01 規則3、5), 訊息只列固定字句, 不回顯客戶端之值
+const MSGS_BAD_KEY = Object.freeze({
+    proto: 'unsupported key[__proto__]',
+    accessor: 'unsupported accessor property',
+    unreadable: 'unreadable value',
+    deep: 'too deep',
+})
+
+//find之巢狀深度上限, 以容器(一般物件與陣列)層數計, 根為第1層(R-OBJ-01 規則5)
+//castIdFind、castIdCond以遞迴處理$and、$or、$nor與$not, 遞迴深度即呼叫堆疊深度, 實測字串型主鍵表約1173層$and(約2346個容器)起爆堆疊;
+//64個容器層約為32層邏輯巢狀, 遠大於合理查詢(庫內最深約7個容器)而遠小於爆堆疊之閾值
+const MAX_DEPTH_FIND = 64
+
+
+function isPlainObj(v) {
+    //純物件(R-INPUT-01 規則3): isobj為真且原型為null, 或為某realm之Object.prototype(同lodash isPlainObject: 原型之原型為null、有constructor函數、其函數原始碼同Object, 故跨realm之物件亦通過)
+    //類別實例、Object.create(proto)、原型為null原型之一般物件、偽造Symbol.toStringTag之Map或包裝物件, 其自有可列舉鍵可能為空而被複製成{}, 令條件消失, 故不算
+    if (!isobj(v)) {
+        return false
+    }
+    let p = Object.getPrototypeOf(v)
+    if (p === null) {
+        return true
+    }
+    //p之原型為null, 故p.constructor只可能是p之自有屬性
+    return Object.getPrototypeOf(p) === null &&
+        typeof p.constructor === 'function' &&
+        Function.prototype.toString.call(p.constructor) === Function.prototype.toString.call(Object)
+}
+
+
+function logSafe(label, ...args) {
+    //診斷用之console.log: 輸出使用端原物件時會呼叫其util.inspect.custom, 拋錯不得使procOrm之reject變成例外物件(R-ERR-01 規則5)
+    try {
+        console.log(label, ...args)
+    }
+    catch (e) {
+        try {
+            console.log(label, '(unprintable)')
+        }
+        catch (e2) {
+            //放棄輸出
+        }
+    }
+}
+
+
+function getReasonBadKey(v, maxDepth = Infinity) {
+    //v之任何深度(一般物件之值、陣列之元素)含不支援之鍵或屬性者回傳原因(R-OBJ-01 規則3、5), 通過回傳null:
+    //  proto: 含自有__proto__鍵, 不論可否列舉; 自有鍵可由JSON.parse、Object.fromEntries、展開、structuredClone等產生, 物件字面量之__proto__為設原型而不算
+    //  accessor: 含存取器屬性(getter或setter), 其值每讀一次可能不同, 令檢查之值與使用之值無法保證相同, 且讀取可能有副作用
+    //  unreadable: 檢查時拋錯, 如Proxy之陷阱或已撤銷之Proxy
+    //  deep: 容器(一般物件與陣列)層數超過maxDepth(根為第1層), 走訪到第maxDepth+1層即停止; 只有find給予maxDepth, 寫入列不設上限(見R-OBJ-01 規則5)
+    //只走一般物件與陣列(JSON可表達之資料)之可列舉資料屬性, 以屬性描述子讀值而不呼叫getter; 其餘型別(Date、Map、Set、函數等)不進入
+    //以堆疊迭代避免本檢查爆呼叫堆疊(其後castIdFind、castIdCond之遞迴由maxDepth保護), seen避免循環結構無窮迭代(循環不會被判為過深, 見R-OBJ-01 已知限制)
+    try {
+        let seen = new Set()
+        let stack = [v, 1] //成對: 節點, 其層數
+        while (stack.length > 0) {
+            let depth = stack.pop()
+            let o = stack.pop()
+            let arr = Array.isArray(o) //不用isarr: 其以Object.prototype.toString判定, 可被Symbol.toStringTag偽造而走訪其length getter; 偽造者isobj亦為假, 故不進入
+            if (seen.has(o) || (!arr && !isobj(o))) {
+                continue
+            }
+            if (depth > maxDepth) {
+                return 'deep'
+            }
+            seen.add(o)
+            if (Object.prototype.hasOwnProperty.call(o, '__proto__')) {
+                return 'proto'
+            }
+            let ks = arr ? null : Object.keys(o)
+            let n = arr ? o.length : ks.length
+            for (let i = 0; i < n; i++) {
+                let d = Object.getOwnPropertyDescriptor(o, arr ? i : ks[i])
+                if (d === undefined) {
+                    continue //稀疏陣列之空洞
+                }
+                if (d.get !== undefined || d.set !== undefined) {
+                    return 'accessor'
+                }
+                if (typeof d.value === 'object' && d.value !== null) {
+                    stack.push(d.value, depth + 1)
+                }
+            }
+        }
+        return null
+    }
+    catch (e) {
+        return 'unreadable'
+    }
+}
+
+
+function getErrFind(mode, find) {
+    //select、delAll之find檢查(R-INPUT-01 規則3、R-OBJ-01 規則3), 通過回傳null, 否則回傳reject之字串
+    //find給予(非undefined)須為純物件: 未給、undefined與空物件{}為無條件(select回全部、delAll刪全部), 各後端對非物件之find多視為無條件而回全表或刪全表, 故由本套件先擋
+    //任何深度不得含自有__proto__鍵(複製時該鍵會被丟棄, 令ORM所見之條件與呼叫端含授權函數所見者不同)與存取器屬性(見getReasonBadKey), 且巢狀深度不得超過MAX_DEPTH_FIND
+    try {
+        if (find !== undefined && !isPlainObj(find)) {
+            return `invalid find of ${mode}, need an object`
+        }
+        let reason = getReasonBadKey(find, MAX_DEPTH_FIND)
+        if (reason !== null) {
+            return `invalid find of ${mode}, ${MSGS_BAD_KEY[reason]}`
+        }
+        return null
+    }
+    catch (e) {
+        //isobj、取原型時拋錯, 如已撤銷之Proxy
+        return `invalid find of ${mode}, ${MSGS_BAD_KEY.unreadable}`
+    }
+}
+
+
+function getMsgsBadKey(msg, data) {
+    //寫入之各筆任何深度含不支援之鍵或屬性者(R-OBJ-01 規則3), 依原因分組回傳訊息陣列, 各組列其於輸入內之位置data[k]; 單一物件輸入視為第0筆
+    //輸入為陣列時(批次容器)逐索引以屬性描述子取值: 索引為存取器即reject, 使其後各次讀取皆為資料屬性之讀取而與檢查之值一致
+    let groups = new Map()
+    let addFail = (reason, k) => {
+        if (!groups.has(reason)) {
+            groups.set(reason, [])
+        }
+        groups.get(reason).push({ k })
+    }
+    if (Array.isArray(data)) {
+        for (let k = 0; k < data.length; k++) {
+            try {
+                let d = Object.getOwnPropertyDescriptor(data, k)
+                if (d === undefined) {
+                    continue //空洞, 已於形狀檢查以非物件拒絕
+                }
+                if (d.get !== undefined || d.set !== undefined) {
+                    addFail('accessor', k)
+                    continue
+                }
+                let reason = getReasonBadKey(d.value)
+                if (reason !== null) {
+                    addFail(reason, k)
+                }
+            }
+            catch (e) { //Proxy陣列之陷阱拋錯
+                addFail('unreadable', k)
+            }
+        }
+    }
+    else {
+        let reason = getReasonBadKey(data)
+        if (reason !== null) {
+            addFail(reason, 0)
+        }
+    }
+    return map([...groups], ([reason, fails]) => getMsgFail(`${msg}, ${MSGS_BAD_KEY[reason]}`, fails))
+}
+
+
 function castIdRows(rows) {
     //寫入與刪除之數據: 各列之主鍵正規化, 寫於複本, 不改呼叫端之物件; 非物件之列原樣
     let one = !isarr(rows)
@@ -114,19 +289,15 @@ function castIdCond(c) {
     if (!isobj(c)) {
         return castIdValue(c)
     }
-    let r = {}
-    each(c, (v, k) => {
+    return mapOwn(c, (v, k) => {
         if (k === '$not') {
-            r[k] = castIdCond(v)
+            return castIdCond(v)
         }
-        else if (['$eq', '$ne', '$gt', '$gte', '$lt', '$lte', '$in', '$nin', '$all'].indexOf(k) >= 0) {
-            r[k] = isarr(v) ? map(v, castIdValue) : castIdValue(v)
-        }
-        else {
-            r[k] = v
+        if (['$eq', '$ne', '$gt', '$gte', '$lt', '$lte', '$in', '$nin', '$all'].indexOf(k) >= 0) {
+            return isarr(v) ? map(v, castIdValue) : castIdValue(v)
         }
+        return v
     })
-    return r
 }
 
 
@@ -135,19 +306,15 @@ function castIdFind(find) {
     if (!isobj(find)) {
         return find
     }
-    let r = {}
-    each(find, (v, k) => {
+    return mapOwn(find, (v, k) => {
         if (k === 'id') {
-            r[k] = castIdCond(v)
+            return castIdCond(v)
         }
-        else if (['$and', '$or', '$nor'].indexOf(k) >= 0 && isarr(v)) {
-            r[k] = map(v, castIdFind)
-        }
-        else {
-            r[k] = v
+        if (['$and', '$or', '$nor'].indexOf(k) >= 0 && isarr(v)) {
+            return map(v, castIdFind)
         }
+        return v
     })
-    return r
 }
 
 
@@ -310,13 +477,10 @@ function adjustData(ds, woName, userId, data, mode = 'save') { //mode: 'insert',
 
     //clearXSS
     if (true) {
-        data = map(data, (v, k) => {
-            let dt = {}
-            each(v, (vv, kk) => {
-                vv = clearXSS(vv)
-                dt[kk] = vv
+        data = map(data, (v) => {
+            return mapOwn(v, (vv) => {
+                return clearXSS(vv)
             })
-            return dt
         })
     }
 
@@ -344,6 +508,22 @@ function adjustData(ds, woName, userId, data, mode = 'save') { //mode: 'insert',
 
 
 async function mapOrm(ds, woItems, userId, woName, mode, input) {
+    //邊界保證(R-ERR-01 規則5): execMapOrm之檢查、轉型與ORM呼叫階段, 非字串之例外(RangeError、使用端物件之Proxy陷阱/toString拋錯、woItems之非ORM值等)
+    //一律console.log原文後以固定字串reject, 不轉出例外物件與其拋出之值; 字串(各處之固定訊息)原樣轉出
+    try {
+        return await execMapOrm(ds, woItems, userId, woName, mode, input)
+    }
+    catch (e) {
+        if (typeof e === 'string') {
+            return Promise.reject(e)
+        }
+        logSafe(`${typeof woName === 'string' ? woName : ''}.${typeof mode === 'string' ? mode : ''} mapOrm catch`, e)
+        return Promise.reject('failed to process input')
+    }
+}
+
+
+async function execMapOrm(ds, woItems, userId, woName, mode, input) {
     //由woName自動綁定至woItems內的ORM物件
     let err = null
     let r
@@ -353,12 +533,12 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
         return Promise.reject(`invalid woItems`)
     }
 
-    //wo
-    let wo = get(woItems, woName, null)
+    //wo, woName須為woItems之自有字串屬性(R-INPUT-01 規則5)
+    let wo = getOwnItem(woItems, woName)
 
-    //check
+    //check, 訊息回顯字串之woName為既有慣例(R-MSG-01 其他已知限制), 非字串者不回顯
     if (wo === null) {
-        return Promise.reject(`can not find table[${woName}] in ORM`)
+        return Promise.reject(`can not find table[${typeof woName === 'string' ? woName : ''}] in ORM`)
     }
 
     //idCast, 主鍵之有限數字以其字串形式處置(R-ID-02), 寫入、刪除與查詢條件共用同一判定
@@ -366,6 +546,13 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
 
     if (mode === 'select') {
 
+        //check, 條件若給予須為一般物件且不含自有__proto__鍵(R-INPUT-01 規則3、R-OBJ-01 規則3), 於轉型與查詢之前
+        let errFind = getErrFind('select', input)
+        if (errFind !== null) {
+            logSafe(`${woName}.select invalid find`, input)
+            return Promise.reject(errFind)
+        }
+
         //select, 條件中主鍵之比較值轉型(R-ID-02)
         r = await wo.select(idCast ? castIdFind(input) : input)
             .catch((msg) => {
@@ -394,6 +581,13 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
             return Promise.reject(getMsgFail(`${msgMode}, not an object`, failsNotObj))
         }
 
+        //check, 各筆任何深度不得含自有__proto__鍵與存取器屬性, 否則整批拒絕且不寫入任何一筆(R-OBJ-01 規則3)
+        let msgsBadKey = getMsgsBadKey(msgMode, input)
+        if (size(msgsBadKey) > 0) {
+            console.log(`${woName}.${mode} data has unsupported key`, msgsBadKey)
+            return Promise.reject(join(msgsBadKey, '; '))
+        }
+
         //castIdRows, 主鍵之有限數字轉為字串, 寫於複本(R-ID-02)
         if (idCast) {
             input = castIdRows(input)
@@ -485,10 +679,11 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
     }
     else if (mode === 'delAll') {
 
-        //check, 條件若給予須為一般物件(R-INPUT-01): 各後端對非物件之條件一律視為無條件而刪除全表; 未給(undefined)與空物件依規格為刪除全部
-        if (input !== undefined && !isobj(input)) {
-            console.log(`${woName}.delAll invalid find`, input)
-            return Promise.reject('invalid find of delAll, need an object')
+        //check, 條件若給予須為一般物件(R-INPUT-01 規則3): 各後端對非物件之條件一律視為無條件而刪除全表; 未給(undefined)與空物件依規格為刪除全部; 另不得含自有__proto__鍵(R-OBJ-01 規則3)
+        let errFind = getErrFind('delAll', input)
+        if (errFind !== null) {
+            logSafe(`${woName}.delAll invalid find`, input)
+            return Promise.reject(errFind)
         }
 
         //delAll, 條件中主鍵之比較值轉型(R-ID-02)
@@ -506,6 +701,15 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
             return Promise.reject('invalid input of mix, need the result object of ltdtDiffByKey')
         }
 
+        //check, add、del、diff為存取器者整批拒絕(R-OBJ-01 規則3 批次容器), 並取快照(各讀一次, 其後只用快照), 使各檢查與寫入所見一致
+        for (let key of ['add', 'del', 'diff']) {
+            let d = Object.getOwnPropertyDescriptor(input, key)
+            if (d !== undefined && (d.get !== undefined || d.set !== undefined)) {
+                return Promise.reject(`invalid input of mix, ${MSGS_BAD_KEY.accessor}`)
+            }
+        }
+        input = { add: input.add, del: input.del, diff: input.diff }
+
         //check, add、del、diff若給予須為陣列(R-INPUT-01), 否則各段之回傳將逐欄位產生
         for (let key of ['add', 'del', 'diff']) {
             if (input[key] !== undefined && !isarr(input[key])) {
@@ -526,6 +730,16 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
             return Promise.reject(join(msgsNotObj, '; '))
         }
 
+        //check, 新增與修改之各筆任何深度不得含自有__proto__鍵與存取器屬性, 於任何步驟寫入之前整批拒絕(R-OBJ-01 規則3); del之各筆不檢查(R-OBJ-01 已知限制)
+        let msgsBadKey = []
+        for (let [key, msg] of [['add', 'failed to insert data'], ['diff', 'failed to update data']]) {
+            msgsBadKey.push(...getMsgsBadKey(msg, get(input, key, [])))
+        }
+        if (size(msgsBadKey) > 0) {
+            console.log(`${woName}.mix data has unsupported key`, msgsBadKey)
+            return Promise.reject(join(msgsBadKey, '; '))
+        }
+
         //castIdRows, 各段主鍵之有限數字轉為字串, 寫於複本(R-ID-02)
         if (idCast) {
             input = { ...input }

package/src/getWoItems.mjs

@@ -1,5 +1,5 @@
-import each from 'lodash-es/each.js'
-import keys from 'lodash-es/keys.js'
+import each from 'lodash-es/each.js'
+import keys from 'lodash-es/keys.js'
 import iseobj from 'wsemi/src/iseobj.mjs'
 import isfun from 'wsemi/src/isfun.mjs'
 import isestr from 'wsemi/src/isestr.mjs'
@@ -41,8 +41,8 @@ function getWoItems(ds, WOrm, url, db) {
         //wo
         let wo = new WOrm(useOpt)
 
-        //save
-        woItems[v] = wo
+        //save, 以defineProperty建立自有屬性: 不用woItems[v]=wo, ds之鍵為__proto__時會改設woItems之原型而該表不可用(R-INPUT-01 規則5)
+        Object.defineProperty(woItems, v, { value: wo, enumerable: true, writable: true, configurable: true })
 
         // //change, 當數據有改變時清除快取
         // wo.on('change', (mode) => {