w-serv-orm 1.1.10 → 1.1.11

package/docs/WServOrm.html

@@ -78,15 +78,19 @@
 <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若給予須為陣列，delAll之條件若給予須為物件，否則於任何寫入之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of delAll, need an object'。
+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>
 <p>授權：procOrm不做授權，不檢查使用者，亦不依使用者過濾數據；userId只供寫入稽核欄位(userId、userIdUpdate)與交給擴充函數。procOrm開放給前端時(如讓前端經資料通道直接操作資料表)，須由開放處負責授權；addFunCheck可掛額外檢查，惟伺服端程式之呼叫亦會經過。
@@ -96,7 +100,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#line100">line 100</a>
     </li></ul></dd>
     
 
@@ -439,7 +443,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 Wed Oct 14 2026 07:49:10 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/WServOrm.mjs.html

@@ -61,17 +61,21 @@ 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若給予須為陣列，delAll之條件若給予須為物件，否則於任何寫入之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of delAll, need an object'。
+ * 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之錯誤則原樣轉出。
  *
@@ -191,7 +195,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 Wed Oct 14 2026 07:49:10 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 Wed Oct 14 2026 07:49:10 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.11",
   "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.15"
   },
   "devDependencies": {
     "w-orm-lowdb": "^1.0.31",
-    "w-package-tools": "^1.1.16"
+    "w-package-tools": "^1.1.18"
   },
   "scripts": {
     "test": "mocha --parallel \"test/*.test.mjs\" --timeout 180000",

package/src/WServOrm.mjs

@@ -14,17 +14,21 @@ 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若給予須為陣列，delAll之條件若給予須為物件，否則於任何寫入之前reject，如'failed to insert data, not an object: data[0]'、'invalid find of delAll, need an object'。
+ * 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之錯誤則原樣轉出。
  *

package/src/getMapOrm.mjs

@@ -8,6 +8,8 @@ import truncate from 'lodash-es/truncate.js'
 import nowms2str from 'wsemi/src/nowms2str.mjs'
 import genIDSeq from 'wsemi/src/genIDSeq.mjs'
 import isarr from 'wsemi/src/isarr.mjs'
+import isearr from 'wsemi/src/isearr.mjs'
+import isobj from 'wsemi/src/isobj.mjs'
 import iseobj from 'wsemi/src/iseobj.mjs'
 import isestr from 'wsemi/src/isestr.mjs'
 import isnum from 'wsemi/src/isnum.mjs'
@@ -18,6 +20,7 @@ import getItemsFail from 'w-data-collector/src/getItemsFail.mjs'
 function getMsgFail(msg, fails) {
     //前端訊息僅列出失敗筆, 錯誤原文另由console.log輸出, 與既有整批錯誤之處理一致
     //有效主鍵(非空字串或數字)列為id[...], 否則列其於輸入內之位置, 失敗筆數過多時僅列前nShow筆並附總筆數
+    //呼叫端給予位置標籤ref者(如mix同鍵之add[0])原樣列出
     //主鍵超過nIdMax字元者截斷顯示(LMDB逐筆失敗常因主鍵超長, 故兩者常同時出現), log仍保留全文
 
     //nShow, nIdMax
@@ -26,6 +29,9 @@ function getMsgFail(msg, fails) {
 
     //ss
     let ss = map(take(fails, nShow), (v) => {
+        if (isestr(v.ref)) {
+            return v.ref
+        }
         if (isestr(v.id) || isnum(v.id)) {
             return `id[${truncate(String(v.id), { length: nIdMax, omission: '…' })}]`
         }
@@ -55,8 +61,9 @@ function isPkIdString(dsTab, keys) {
     }
 
     //check, 型別已知者須為字串型, 與w-orm-reladb可自動補值之主鍵欄型別一致
+    //比對前取「(」之前之字並轉大寫, 如STRING(36)視為STRING, 同w-orm-reladb以type.key判定而不含長度參數
     let type = get(settings, 'id.type', '') || get(dsTab, 'kpType.id', '')
-    if (isestr(type) && ['STRING', 'TEXT', 'CHAR', 'UUID', 'CITEXT'].indexOf(type.toUpperCase()) < 0) {
+    if (isestr(type) && ['STRING', 'TEXT', 'CHAR', 'UUID', 'CITEXT'].indexOf(type.split('(')[0].trim().toUpperCase()) < 0) {
         return false
     }
 
@@ -64,6 +71,147 @@ function isPkIdString(dsTab, keys) {
 }
 
 
+function isIdCast(ds, woName) {
+    //資料表之主鍵欄為字串型或型別未知者, 主鍵之有限數字以其字串形式處置(R-ID-02); ds無該表者不轉型, 令select與del照舊原樣交ORM
+    let dsTab = get(ds, woName, null)
+    let keys = get(dsTab, 'keys', null)
+    if (!isarr(keys)) {
+        return false
+    }
+    return isPkIdString(dsTab, keys)
+}
+
+
+function isIdNumFinite(v) {
+    //主鍵值是否為有限數字, 不用wsemi之isnum: 其對數字字串與Infinity亦為true
+    return typeof v === 'number' && Number.isFinite(v)
+}
+
+
+function castIdValue(v) {
+    //主鍵值之正規化: 有限數字轉為其字串形式, 其餘原樣(NaN、±Infinity亦原樣, 寫入時由adjustData視為未提供而補值)
+    //各後端之主鍵判準互異, lmdb、lowdb、level、mongodb只認非空字串而以genIDSeq取代數字, reladb、mdb之字串欄由資料庫把數字存為字串,
+    //故由本套件先轉, 令寫入、刪除與查詢條件同一規則, 回傳之主鍵與實際寫入者一致
+    return isIdNumFinite(v) ? String(v) : v
+}
+
+
+function castIdRows(rows) {
+    //寫入與刪除之數據: 各列之主鍵正規化, 寫於複本, 不改呼叫端之物件; 非物件之列原樣
+    let one = !isarr(rows)
+    let rs = map(one ? [rows] : rows, (v) => {
+        if (isobj(v) && isIdNumFinite(v.id)) {
+            return { ...v, id: castIdValue(v.id) }
+        }
+        return v
+    })
+    return one ? rs[0] : rs
+}
+
+
+function castIdCond(c) {
+    //主鍵之條件: 值或運算子物件; 比較運算子之值(陣列逐一)轉型, $not遞迴, 其餘運算子($regex、$exists等)原樣
+    if (!isobj(c)) {
+        return castIdValue(c)
+    }
+    let r = {}
+    each(c, (v, k) => {
+        if (k === '$not') {
+            r[k] = 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
+        }
+    })
+    return r
+}
+
+
+function castIdFind(find) {
+    //查詢條件(select、delAll之find): id之條件轉型, 遞迴$and、$or、$nor; 他欄原樣; 寫於複本, 非物件原樣
+    if (!isobj(find)) {
+        return find
+    }
+    let r = {}
+    each(find, (v, k) => {
+        if (k === 'id') {
+            r[k] = castIdCond(v)
+        }
+        else if (['$and', '$or', '$nor'].indexOf(k) >= 0 && isarr(v)) {
+            r[k] = map(v, castIdFind)
+        }
+        else {
+            r[k] = v
+        }
+    })
+    return r
+}
+
+
+function getItemsNotObj(data) {
+    //寫入之各筆須為一般物件(R-INPUT-01), 回傳[{k}], k為其於輸入內之位置; 單一非物件輸入視為第0筆
+    //非物件之元素經adjustData之clearXSS逐鍵複製時, 字串、陣列被展開成{0:...,1:...}、數字等變成{}, 寫入垃圾紀錄
+    let rs = []
+    each(isarr(data) ? data : [data], (v, k) => {
+        if (!isobj(v)) {
+            rs.push({ k })
+        }
+    })
+    return rs
+}
+
+
+function getMixIdKey(v) {
+    //mix跨段比對用之主鍵鍵值(R-MIX-01): 以castIdValue正規化(有限數字取其字串形式, 與寫入、刪除之轉型同一函數), 正規化後為非空字串者取之, 其餘(未提供)不參與比對
+    //不論資料表是否適用轉型(R-ID-02)皆正規化, 故整數主鍵欄之5與'5'亦視為同鍵
+    let id = castIdValue(get(v, 'id'))
+    return isestr(id) ? id : null
+}
+
+
+function getMsgsMixSameId(input) {
+    //mix之add與del、del與diff含同一主鍵者回傳各組之訊息(R-MIX-01), 位置以段名[k]列出而不回顯主鍵
+    //mix依add、del、diff之序執行, add與del同鍵將使新增因已存在而略過後即被刪除, del與diff同鍵將使刪除後由save以部份欄位重新插入
+    let msgs = []
+    for (let [ka, kb] of [['add', 'del'], ['del', 'diff']]) {
+
+        //ma, 前段各主鍵之位置
+        let ma = new Map()
+        each(get(input, ka, []), (v, k) => {
+            let key = getMixIdKey(v)
+            if (key !== null) {
+                ma.set(key, [...(ma.get(key) || []), k])
+            }
+        })
+
+        //ia, ib, 同鍵者之位置
+        let ia = []
+        let ib = []
+        each(get(input, kb, []), (v, k) => {
+            let key = getMixIdKey(v)
+            if (key !== null && ma.has(key)) {
+                ia = [...ia, ...ma.get(key)]
+                ib.push(k)
+            }
+        })
+
+        //msgs
+        if (size(ib) > 0) {
+            let refs = [
+                ...map([...new Set(ia)].sort((a, b) => a - b), (k) => ({ ref: `${ka}[${k}]` })),
+                ...map(ib, (k) => ({ ref: `${kb}[${k}]` })),
+            ]
+            msgs.push(getMsgFail(`invalid input of mix, same id in ${ka} and ${kb}`, refs))
+        }
+
+    }
+    return msgs
+}
+
+
 function getItemsIdXSS(data) {
     //輸入數據之主鍵(非空字串)會被clearXSS改寫者, 回傳[{k,id}], k為其於輸入內之位置
     //寫入路徑之欄位皆經clearXSS而select與del不經過, 主鍵被改寫後以原主鍵查詢與刪除皆找不到, 故呼叫端須於寫入前整批拒絕
@@ -172,15 +320,20 @@ function adjustData(ds, woName, userId, data, mode = 'save') { //mode: 'insert',
         })
     }
 
-    //id, 未提供有效主鍵者由本套件補值, 令回傳之主鍵與實際寫入者一致, 補值器同各ORM之genIDSeq
-    //有效主鍵之判定同w-orm系列: 非空字串或數字(reladb、mdb視數字為有效)
-    //補值寫在上方之複本, 不改呼叫端原物件; 無欄位之列不補, 保留ORM視空物件為無效輸入之行為
+    //id, 未提供有效主鍵者由本套件補值, 令回傳之主鍵與實際寫入者一致, 補值器同各ORM之genIDSeq(R-ID-01)
+    //有效主鍵為非空字串: 字串型主鍵欄之有限數字已於mapOrm轉為字串(R-ID-02), 剩餘之數字(NaN、±Infinity)與其他型別視為未提供
+    //補值寫在上方之複本, 不改呼叫端原物件
+    //輸入依wsemi之iseobj、isearr判為無效者(單一空物件、只含一個空物件之陣列)不補, 保留ORM視之為無效輸入(規格T5)而不寫入之行為;
+    //多筆批次中之空物件列則補, 因後端照常補值寫入, 不補則回傳undefined而與實際不符
     if (isPkIdString(ds[woName], keys)) {
-        each(data, (v) => {
-            if (size(v) > 0 && !isestr(v.id) && !isnum(v.id)) {
-                v.id = genIDSeq()
-            }
-        })
+        let effective = one ? iseobj(data[0]) : isearr(data)
+        if (effective) {
+            each(data, (v) => {
+                if (!isestr(v.id)) {
+                    v.id = genIDSeq()
+                }
+            })
+        }
     }
 
     //復原data型態, 若原本data為物件則取第0個回傳
@@ -208,10 +361,13 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
         return Promise.reject(`can not find table[${woName}] in ORM`)
     }
 
+    //idCast, 主鍵之有限數字以其字串形式處置(R-ID-02), 寫入、刪除與查詢條件共用同一判定
+    let idCast = isIdCast(ds, woName)
+
     if (mode === 'select') {
 
-        //select
-        r = await wo.select(input)
+        //select, 條件中主鍵之比較值轉型(R-ID-02)
+        r = await wo.select(idCast ? castIdFind(input) : input)
             .catch((msg) => {
                 console.log(`${woName}.select catch`, msg)
                 err = 'failed to select data'
@@ -228,11 +384,26 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
         //inputOrig, 呼叫端原輸入, 逐筆失敗之訊息以呼叫端視角列出(本套件補出之主鍵只寫於複本, reject時呼叫端未曾取得)
         let inputOrig = input
 
+        //msgMode
+        let msgMode = mode === 'insert' ? 'failed to insert data' : 'failed to save data'
+
+        //check, 各筆須為一般物件, 否則整批拒絕且不寫入任何一筆(R-INPUT-01)
+        let failsNotObj = getItemsNotObj(input)
+        if (size(failsNotObj) > 0) {
+            console.log(`${woName}.${mode} data is not an object`, failsNotObj)
+            return Promise.reject(getMsgFail(`${msgMode}, not an object`, failsNotObj))
+        }
+
+        //castIdRows, 主鍵之有限數字轉為字串, 寫於複本(R-ID-02)
+        if (idCast) {
+            input = castIdRows(input)
+        }
+
         //check, 主鍵會被clearXSS改寫者整批拒絕, 不寫入任何一筆
         let failsIdXSS = getItemsIdXSS(input)
         if (size(failsIdXSS) > 0) {
             console.log(`${woName}.${mode} id changed by clearXSS`, failsIdXSS)
-            return Promise.reject(getMsgIdXSS(mode === 'insert' ? 'failed to insert data' : 'failed to save data', failsIdXSS))
+            return Promise.reject(getMsgIdXSS(msgMode, failsIdXSS))
         }
 
         //adjustData
@@ -290,6 +461,11 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
     }
     else if (mode === 'del') {
 
+        //castIdRows, 主鍵之有限數字轉為字串, 寫於複本(R-ID-02); 刪除不經clearXSS(R-XSS-01)
+        if (idCast) {
+            input = castIdRows(input)
+        }
+
         //del
         r = await wo.del(input)
             .catch((msg) => {
@@ -309,8 +485,14 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
     }
     else if (mode === 'delAll') {
 
-        //delAll
-        r = await wo.delAll(input)
+        //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')
+        }
+
+        //delAll, 條件中主鍵之比較值轉型(R-ID-02)
+        r = await wo.delAll(idCast ? castIdFind(input) : input)
             .catch((msg) => {
                 console.log(`${woName}.delAll catch`, msg)
                 err = 'failed to delete data'
@@ -324,6 +506,36 @@ 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-INPUT-01), 否則各段之回傳將逐欄位產生
+        for (let key of ['add', 'del', 'diff']) {
+            if (input[key] !== undefined && !isarr(input[key])) {
+                return Promise.reject('invalid input of mix, need the result object of ltdtDiffByKey')
+            }
+        }
+
+        //check, 新增與修改之各筆須為一般物件, 於任何步驟寫入之前整批拒絕(R-INPUT-01)
+        let msgsNotObj = []
+        for (let [key, msg] of [['add', 'failed to insert data'], ['diff', 'failed to update data']]) {
+            let fails = getItemsNotObj(get(input, key, []))
+            if (size(fails) > 0) {
+                console.log(`${woName}.mix ${key} data is not an object`, fails)
+                msgsNotObj.push(getMsgFail(`${msg}, not an object`, fails))
+            }
+        }
+        if (size(msgsNotObj) > 0) {
+            return Promise.reject(join(msgsNotObj, '; '))
+        }
+
+        //castIdRows, 各段主鍵之有限數字轉為字串, 寫於複本(R-ID-02)
+        if (idCast) {
+            input = { ...input }
+            for (let key of ['add', 'del', 'diff']) {
+                if (isarr(input[key])) {
+                    input[key] = castIdRows(input[key])
+                }
+            }
+        }
+
         //check, 新增與修改之主鍵會被clearXSS改寫者, 於任何步驟寫入之前整批拒絕
         let msgsIdXSS = []
         for (let [key, msg] of [['add', 'failed to insert data'], ['diff', 'failed to update data']]) {
@@ -337,6 +549,13 @@ async function mapOrm(ds, woItems, userId, woName, mode, input) {
             return Promise.reject(join(msgsIdXSS, '; '))
         }
 
+        //check, add與del、del與diff同鍵者, 於任何步驟寫入之前整批拒絕(R-MIX-01)
+        let msgsSameId = getMsgsMixSameId(input)
+        if (size(msgsSameId) > 0) {
+            console.log(`${woName}.mix same id across steps`, msgsSameId)
+            return Promise.reject(join(msgsSameId, '; '))
+        }
+
         //rt,r
         let rt
         r = [] //default to array

package/test/api-pkcast.test.mjs

@@ -0,0 +1,113 @@
+import fs from 'fs'
+import assert from 'assert'
+import WOrm from 'w-orm-lowdb/src/WOrmLowdb.mjs'
+import ltdtDiffByKey from 'wsemi/src/ltdtDiffByKey.mjs'
+import ds from '../schema/index.mjs'
+import WServOrm from '../src/WServOrm.mjs'
+
+
+//以真ORM(w-orm-lowdb, 主鍵固定為字串id, 數字主鍵原會被其以genIDSeq取代)經procOrm驗證R-ID-02、R-MIX-01; schema之tests表之id為STRING pk
+let fd = './test/_tmp/api-pkcast'
+
+async function getReject(pm) {
+    try {
+        await pm
+    }
+    catch (err) {
+        return err
+    }
+    throw new Error('預期reject但resolve')
+}
+
+
+describe('數字主鍵接w-orm-lowdb', function() {
+
+    let so = null
+    let proc = (mode, input) => so.procOrm('u1', 'tests', mode, input)
+    let rows = async () => (await so.woItems.tests.select()).map((v) => [v.id, v.isActive])
+    let quiet = async (fn) => {
+        let logOrig = console.log
+        console.log = () => {}
+        try {
+            return await fn()
+        }
+        finally {
+            console.log = logOrig
+        }
+    }
+
+    before(function() {
+        fs.rmSync(fd, { recursive: true, force: true })
+        fs.mkdirSync(fd, { recursive: true })
+        so = WServOrm(ds, WOrm, `${fd}/db.json`, 'worm')
+    })
+
+    beforeEach(async function() {
+        await so.woItems.tests.delAll()
+    })
+
+    after(async function() {
+        await so.closeAll()
+        fs.rmSync(fd, { recursive: true, force: true })
+    })
+
+    it('A08 數字主鍵存為其字串形式, 重送與修改命中同一筆, 以數字或字串皆可查可刪', async function() {
+        //R-ID-02 規則2: 回報 = 實際; 重送不增筆(原每次另增genIDSeq之列); 寫入、查詢、刪除同一規則
+        let r = await proc('insert', [{ id: 123, isActive: 'y' }])
+        assert.deepStrictEqual(r, [{ id: '123' }])
+        await proc('insert', [{ id: 123, isActive: 'y' }])
+        await proc('save', [{ id: 123, isActive: 'n' }])
+        await proc('mix', { diff: [{ id: 123, isActive: 'm' }] })
+        assert.deepStrictEqual(await rows(), [['123', 'm']])
+        assert.strictEqual((await proc('select', { id: 123 })).length, 1)
+        assert.strictEqual((await proc('select', { id: '123' })).length, 1)
+        let rd = await proc('del', [{ id: 123 }])
+        assert.deepStrictEqual(rd, [{ n: 1, nDeleted: 1, ok: 1 }])
+        assert.deepStrictEqual(await rows(), [])
+    })
+
+    it('A09 表內已有他方以字串寫入之同值主鍵: 以數字save覆寫該列, insert略過而回報字串主鍵', async function() {
+        //R-ID-02 規則2: 123與'123'為同一筆(對外行為變更, 原另增genIDSeq之列)
+        await so.woItems.tests.insert([{ id: '777', isActive: 'A' }])
+        let rs = await proc('save', [{ id: 777, isActive: 'B' }])
+        assert.deepStrictEqual(rs, [{ id: '777' }])
+        let ri = await proc('insert', [{ id: 777, isActive: 'C' }])
+        assert.deepStrictEqual(ri, [{ id: '777' }])
+        assert.deepStrictEqual(await rows(), [['777', 'B']])
+    })
+
+    it('A10 以ltdtDiffByKey嚴格比對產生之add 888、del 888字串, 整批reject且表內不變', async function() {
+        //R-MIX-01 規則1、2: 原為insert略過、del刪除而resolve遺失資料
+        await so.woItems.tests.insert([{ id: '888', isActive: 'y' }])
+        let old = await so.woItems.tests.select()
+        let input = ltdtDiffByKey(old, [{ ...old[0], id: 888 }], 'id', { withInfor: false })
+        assert.deepStrictEqual([input.add.length, input.del.length], [1, 1])
+        let err = await quiet(() => getReject(proc('mix', input)))
+        assert.strictEqual(err, 'invalid input of mix, same id in add and del: add[0], del[0]')
+        assert.deepStrictEqual(await rows(), [['888', 'y']])
+    })
+
+    it('A11 同批之數字與其字串形式: 表內一筆(首筆內容), 回報兩筆同鍵', async function() {
+        //R-ID-02 規則2; insert回傳之id含被略過者
+        let r = await proc('insert', [{ id: 999, isActive: 'p' }, { id: '999', isActive: 'q' }])
+        assert.deepStrictEqual(r, [{ id: '999' }, { id: '999' }])
+        assert.deepStrictEqual(await rows(), [['999', 'p']])
+    })
+
+    it('A12 查詢與delAll之條件以數字給予: 等值、$in、$ne、$not命中字串主鍵, 範圍依字典序', async function() {
+        //R-ID-02 規則2(查詢條件)與已知限制(範圍依字典序: '40' < '5')
+        await proc('insert', [{ id: 5, isActive: 'y' }, { id: 40, isActive: 'y' }, { id: 'abc', isActive: 'y' }])
+        let ids = async (find) => (await proc('select', find)).map((v) => v.id).sort()
+        assert.deepStrictEqual(await ids({ id: 5 }), ['5'])
+        assert.deepStrictEqual(await ids({ id: { $in: [5, 40] } }), ['40', '5'])
+        assert.deepStrictEqual(await ids({ id: { $ne: 5 } }), ['40', 'abc'])
+        assert.deepStrictEqual(await ids({ id: { $not: { $eq: 5 } } }), ['40', 'abc'])
+        assert.deepStrictEqual(await ids({ id: { $lt: 5 } }), ['40'])
+        let r1 = await proc('delAll', { id: { $in: [40] } })
+        assert.deepStrictEqual(r1, { n: 1, nDeleted: 1, ok: 1 })
+        let r2 = await proc('delAll', { id: 5 })
+        assert.deepStrictEqual(r2, { n: 1, nDeleted: 1, ok: 1 })
+        assert.deepStrictEqual(await rows(), [['abc', 'y']])
+    })
+
+})

package/test/api-procOrm.test.mjs

@@ -44,17 +44,18 @@ describe('procOrm接w-orm-lowdb', function() {
     })
 
     it('A02 del含無效主鍵', async function() {
-        //R02: 逐筆ok為0即reject並列出失敗主鍵; R10: 單筆失敗不中斷整批, 有效筆已刪除
-        let err = await getReject(proc('del', [{ id: 'a1' }, { id: 123 }]))
-        assert.strict.equal(err, 'failed to delete data: id[123]')
+        //R02: 逐筆ok為0即reject並列出失敗筆(無有效主鍵者列位置); R10: 單筆失敗不中斷整批, 有效筆已刪除
+        //無效主鍵取非字串非數字之值: 數字依R-ID-02轉為字串後為有效主鍵(未命中), 不再觸發逐筆失敗
+        let err = await getReject(proc('del', [{ id: 'a1' }, { id: true }]))
+        assert.strict.equal(err, 'failed to delete data: data[1]')
         let rs = await proc('select', { id: 'a1' })
         assert.strict.equal(rs.length, 0)
     })
 
     it('A03 mix之del含無效主鍵', async function() {
-        //R03: del之逐筆失敗不中斷diff, diff已寫入, 最後reject列出del之失敗
-        let err = await getReject(proc('mix', { del: [{ id: 456 }], diff: [{ id: 'a2', isActive: 'y' }] }))
-        assert.strict.equal(err, 'failed to delete data: id[456]')
+        //R03: del之逐筆失敗不中斷diff, diff已寫入, 最後reject列出del之失敗(未帶主鍵之列以位置列出)
+        let err = await getReject(proc('mix', { del: [{ id: null }], diff: [{ id: 'a2', isActive: 'y' }] }))
+        assert.strict.equal(err, 'failed to delete data: data[0]')
         let rs = await proc('select', { id: 'a2' })
         assert.strict.equal(rs.length, 1)
     })