w-orm-lowdb 1.0.6 → 1.0.8

package/docs/WOrmLowdb.mjs.html

@@ -49,7 +49,7 @@
 import events from 'events'
 import { Low } from 'lowdb'
 import { JSONFile } from 'lowdb/node'
-import { Query } from 'mingo' //須指定安裝6.5.6, 若6.6.0無法匯入Query
+import { Query } from 'mingo'
 import get from 'lodash-es/get.js'
 import each from 'lodash-es/each.js'
 import map from 'lodash-es/map.js'
@@ -84,6 +84,9 @@ let kpGlock = {}
  */
 function WOrmLowdb(opt = {}) {
 
+    //_cache
+    let _cache = null
+
     //url
     let url = get(opt, 'url')
     if (!isestr(url)) {
@@ -128,6 +131,28 @@ function WOrmLowdb(opt = {}) {
         kpGlock[gkey] = false
     }
 
+    //getData
+    let getData = async() => {
+
+        //check
+        if (isarr(_cache)) {
+            return cloneDeep(_cache) //與外部使用數據脫勾
+        }
+
+        //read
+        await lowdb.read()
+
+        //default, 使用lowdb.read()初始化後須馬上檢測, 若無key則須先創建空陣列
+        if (!haskey(lowdb.data, key)) {
+            lowdb.data[key] = []
+        }
+
+        //update
+        _cache = lowdb.data[key]
+
+        return cloneDeep(_cache) //與外部使用數據脫勾
+    }
+
     /**
      * 查詢數據
      *
@@ -142,13 +167,8 @@ function WOrmLowdb(opt = {}) {
         let res = null
         try {
 
-            //read
-            await lowdb.read()
-
-            //default, 使用lowdb.read()初始化後須馬上檢測, 若無key則須先創建空陣列
-            if (!haskey(lowdb.data, key)) {
-                lowdb.data[key] = []
-            }
+            //ltdt
+            let ltdt = await getData()
 
             //filter
             if (iseobj(find)) {
@@ -158,12 +178,12 @@ function WOrmLowdb(opt = {}) {
                 // console.log('q', q)
 
                 //find
-                res = q.find(lowdb.data[key]).all()
+                res = q.find(ltdt).all()
                 // console.log('res', res)
 
             }
             else {
-                res = lowdb.data[key]
+                res = ltdt
             }
 
         }
@@ -277,15 +297,28 @@ function WOrmLowdb(opt = {}) {
                 ok: 1,
             }
 
-            //emit
-            ee.emit('change', 'insert', data, res)
-
         }
         catch (err) {
             isErr = true
             res = err
         }
 
+        //update, 不能保證插入多少, 一律重設快取
+        _cache = null
+
+        //emit, 於change可能須使用select, 故須放在重設快取之後
+        if (!isErr) {
+            try {
+
+                //emit
+                ee.emit('change', 'insert', data, res)
+
+            }
+            catch (err) {
+                console.log(err)
+            }
+        }
+
         if (isErr) {
             return Promise.reject(res)
         }
@@ -368,8 +401,11 @@ function WOrmLowdb(opt = {}) {
                 //查找資料表內v.id
                 let r = get(kp, v.id, null)
 
+                //existed
+                let existed = iseobj(r)
+
                 //check
-                if (iseobj(r)) {
+                if (existed) {
                     //已存在v.id
                     if (isEqual(v, r.v)) {
                         //內容相同不更新
@@ -384,6 +420,9 @@ function WOrmLowdb(opt = {}) {
                         b = true
                     }
                 }
+                else {
+                    //內容不存在
+                }
 
                 //rest
                 if (iseobj(rest)) {
@@ -400,10 +439,24 @@ function WOrmLowdb(opt = {}) {
                         ok: 1,
                     }
                 }
+                //rest.n === 0:
+                // 內容相同不更新, 不須update
+                // 內容不存在, 若autoInsert則須insert
 
                 //autoInsert
-                if (autoInsert && rest.n === 0) {
-                    rest = await insertCore(v)
+                if (autoInsert && rest.n === 0 && !existed) {
+                    let k = size(lowdb.data[key])
+                    lowdb.data[key].push(v)
+                    kp[v.id] = {
+                        k,
+                        v: lowdb.data[key][k],
+                    }
+                    b = true
+                    rest = {
+                        n: 1,
+                        nInserted: 1,
+                        ok: 1,
+                    }
                 }
 
                 return rest
@@ -414,15 +467,28 @@ function WOrmLowdb(opt = {}) {
                 await lowdb.write()
             }
 
-            //emit
-            ee.emit('change', 'save', data, res)
-
         }
         catch (err) {
             isErr = true
             res = err
         }
 
+        //update, 不能保證變更多少, 一律重設快取
+        _cache = null
+
+        //emit, 於change可能須使用select, 故須放在重設快取之後
+        if (!isErr) {
+            try {
+
+                //emit
+                ee.emit('change', 'save', data, res)
+
+            }
+            catch (err) {
+                console.log(err)
+            }
+        }
+
         if (isErr) {
             return Promise.reject(res)
         }
@@ -554,15 +620,28 @@ function WOrmLowdb(opt = {}) {
                 await lowdb.write()
             }
 
-            //emit
-            ee.emit('change', 'del', data, res)
-
         }
         catch (err) {
             isErr = true
             res = err
         }
 
+        //update, 不能保證刪除多少, 一律重設快取
+        _cache = null
+
+        //emit, 於change可能須使用select, 故須放在重設快取之後
+        if (!isErr) {
+            try {
+
+                //emit
+                ee.emit('change', 'del', data, res)
+
+            }
+            catch (err) {
+                console.log(err)
+            }
+        }
+
         if (isErr) {
             return Promise.reject(res)
         }
@@ -679,15 +758,28 @@ function WOrmLowdb(opt = {}) {
                 ok: 1,
             }
 
-            //emit
-            ee.emit('change', 'delAll', null, res)
-
         }
         catch (err) {
             isErr = true
             res = err
         }
 
+        //update, 不能保證刪除多少, 一律重設快取
+        _cache = null
+
+        //emit, 於change可能須使用select, 故須放在重設快取之後
+        if (!isErr) {
+            try {
+
+                //emit
+                ee.emit('change', 'delAll', null, res)
+
+            }
+            catch (err) {
+                console.log(err)
+            }
+        }
+
         if (isErr) {
             return Promise.reject(res)
         }
@@ -732,7 +824,7 @@ export default WOrmLowdb
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.4</a> on Sun May 11 2025 15:21:09 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 Thu May 14 2026 19:54:31 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.4</a> on Sun May 11 2025 15:21:09 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 Thu May 14 2026 19:54:31 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/g-basic.mjs

@@ -44,6 +44,14 @@ let rsm = [
     },
 ]
 
+let rsa = [
+    {
+        id: 'id-rosemary',
+        name: 'rosemary',
+        value: 654.321,
+    },
+]
+
 async function test() {
 
     //wo
@@ -105,6 +113,15 @@ async function test() {
     // let sr = await wo.select({ name: { $regex: 'PeT', $options: '$i' } })
     // console.log('selectReg', sr)
 
+    //save
+    await wo.save(rsa, { autoInsert: true })
+        .then(function(msg) {
+            console.log('save then', msg)
+        })
+        .catch(function(msg) {
+            console.log('save catch', msg)
+        })
+
     //del
     let d = ss.filter(function(v) {
         return v.name === 'kettle'
@@ -159,6 +176,8 @@ test()
 //     value: 456
 //   }
 // ]
+// change save
+// save then [ { n: 1, nModified: 1, ok: 1 } ]
 // change del
 // del then [ { n: 1, nDeleted: 1, ok: 1 } ]
 

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "w-orm-lowdb",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "main": "dist/w-orm-lowdb.umd.js",
   "dependencies": {
-    "lodash-es": "^4.17.21",
+    "lodash-es": "^4.18.1",
     "lowdb": "^7.0.1",
-    "mingo": "^6.6.1",
-    "wsemi": "^1.7.90"
+    "mingo": "^7.2.1",
+    "wsemi": "^1.8.52"
   },
   "devDependencies": {
-    "w-package-tools": "^1.0.90"
+    "w-package-tools": "^1.1.5"
   },
   "scripts": {
     "test": "mocha --parallel --timeout 60000",

package/script.txt

@@ -15,4 +15,3 @@ npm run deploy
 #npm test
 
 #npm publish
-

package/src/WOrmLowdb.mjs

@@ -2,7 +2,7 @@ import path from 'path'
 import events from 'events'
 import { Low } from 'lowdb'
 import { JSONFile } from 'lowdb/node'
-import { Query } from 'mingo' //須指定安裝6.5.6, 若6.6.0無法匯入Query
+import { Query } from 'mingo'
 import get from 'lodash-es/get.js'
 import each from 'lodash-es/each.js'
 import map from 'lodash-es/map.js'
@@ -37,6 +37,9 @@ let kpGlock = {}
  */
 function WOrmLowdb(opt = {}) {
 
+    //_cache
+    let _cache = null
+
     //url
     let url = get(opt, 'url')
     if (!isestr(url)) {
@@ -81,6 +84,28 @@ function WOrmLowdb(opt = {}) {
         kpGlock[gkey] = false
     }
 
+    //getData
+    let getData = async() => {
+
+        //check
+        if (isarr(_cache)) {
+            return cloneDeep(_cache) //與外部使用數據脫勾
+        }
+
+        //read
+        await lowdb.read()
+
+        //default, 使用lowdb.read()初始化後須馬上檢測, 若無key則須先創建空陣列
+        if (!haskey(lowdb.data, key)) {
+            lowdb.data[key] = []
+        }
+
+        //update
+        _cache = lowdb.data[key]
+
+        return cloneDeep(_cache) //與外部使用數據脫勾
+    }
+
     /**
      * 查詢數據
      *
@@ -95,13 +120,8 @@ function WOrmLowdb(opt = {}) {
         let res = null
         try {
 
-            //read
-            await lowdb.read()
-
-            //default, 使用lowdb.read()初始化後須馬上檢測, 若無key則須先創建空陣列
-            if (!haskey(lowdb.data, key)) {
-                lowdb.data[key] = []
-            }
+            //ltdt
+            let ltdt = await getData()
 
             //filter
             if (iseobj(find)) {
@@ -111,12 +131,12 @@ function WOrmLowdb(opt = {}) {
                 // console.log('q', q)
 
                 //find
-                res = q.find(lowdb.data[key]).all()
+                res = q.find(ltdt).all()
                 // console.log('res', res)
 
             }
             else {
-                res = lowdb.data[key]
+                res = ltdt
             }
 
         }
@@ -230,15 +250,28 @@ function WOrmLowdb(opt = {}) {
                 ok: 1,
             }
 
-            //emit
-            ee.emit('change', 'insert', data, res)
-
         }
         catch (err) {
             isErr = true
             res = err
         }
 
+        //update, 不能保證插入多少, 一律重設快取
+        _cache = null
+
+        //emit, 於change可能須使用select, 故須放在重設快取之後
+        if (!isErr) {
+            try {
+
+                //emit
+                ee.emit('change', 'insert', data, res)
+
+            }
+            catch (err) {
+                console.log(err)
+            }
+        }
+
         if (isErr) {
             return Promise.reject(res)
         }
@@ -321,8 +354,11 @@ function WOrmLowdb(opt = {}) {
                 //查找資料表內v.id
                 let r = get(kp, v.id, null)
 
+                //existed
+                let existed = iseobj(r)
+
                 //check
-                if (iseobj(r)) {
+                if (existed) {
                     //已存在v.id
                     if (isEqual(v, r.v)) {
                         //內容相同不更新
@@ -337,6 +373,9 @@ function WOrmLowdb(opt = {}) {
                         b = true
                     }
                 }
+                else {
+                    //內容不存在
+                }
 
                 //rest
                 if (iseobj(rest)) {
@@ -353,10 +392,24 @@ function WOrmLowdb(opt = {}) {
                         ok: 1,
                     }
                 }
+                //rest.n === 0:
+                // 內容相同不更新, 不須update
+                // 內容不存在, 若autoInsert則須insert
 
                 //autoInsert
-                if (autoInsert && rest.n === 0) {
-                    rest = await insertCore(v)
+                if (autoInsert && rest.n === 0 && !existed) {
+                    let k = size(lowdb.data[key])
+                    lowdb.data[key].push(v)
+                    kp[v.id] = {
+                        k,
+                        v: lowdb.data[key][k],
+                    }
+                    b = true
+                    rest = {
+                        n: 1,
+                        nInserted: 1,
+                        ok: 1,
+                    }
                 }
 
                 return rest
@@ -367,15 +420,28 @@ function WOrmLowdb(opt = {}) {
                 await lowdb.write()
             }
 
-            //emit
-            ee.emit('change', 'save', data, res)
-
         }
         catch (err) {
             isErr = true
             res = err
         }
 
+        //update, 不能保證變更多少, 一律重設快取
+        _cache = null
+
+        //emit, 於change可能須使用select, 故須放在重設快取之後
+        if (!isErr) {
+            try {
+
+                //emit
+                ee.emit('change', 'save', data, res)
+
+            }
+            catch (err) {
+                console.log(err)
+            }
+        }
+
         if (isErr) {
             return Promise.reject(res)
         }
@@ -507,15 +573,28 @@ function WOrmLowdb(opt = {}) {
                 await lowdb.write()
             }
 
-            //emit
-            ee.emit('change', 'del', data, res)
-
         }
         catch (err) {
             isErr = true
             res = err
         }
 
+        //update, 不能保證刪除多少, 一律重設快取
+        _cache = null
+
+        //emit, 於change可能須使用select, 故須放在重設快取之後
+        if (!isErr) {
+            try {
+
+                //emit
+                ee.emit('change', 'del', data, res)
+
+            }
+            catch (err) {
+                console.log(err)
+            }
+        }
+
         if (isErr) {
             return Promise.reject(res)
         }
@@ -632,15 +711,28 @@ function WOrmLowdb(opt = {}) {
                 ok: 1,
             }
 
-            //emit
-            ee.emit('change', 'delAll', null, res)
-
         }
         catch (err) {
             isErr = true
             res = err
         }
 
+        //update, 不能保證刪除多少, 一律重設快取
+        _cache = null
+
+        //emit, 於change可能須使用select, 故須放在重設快取之後
+        if (!isErr) {
+            try {
+
+                //emit
+                ee.emit('change', 'delAll', null, res)
+
+            }
+            catch (err) {
+                console.log(err)
+            }
+        }
+
         if (isErr) {
             return Promise.reject(res)
         }

package/test/basic.test.mjs

@@ -1,4 +1,5 @@
 import assert from 'assert'
+import fs from 'node:fs/promises'
 import WOrm from '../src/WOrmLowdb.mjs'
 import w from 'wsemi'
 
@@ -57,6 +58,14 @@ if (isWindows()) {
                 },
             ]
 
+            let rsa = [
+                {
+                    id: 'id-rosemary',
+                    name: 'rosemary',
+                    value: 654.321,
+                },
+            ]
+
             //wo
             let wo = WOrm(opt)
 
@@ -285,9 +294,24 @@ if (isWindows()) {
             //     })
             // vget[9] = rt
 
+            //save
+            rt = null
+            vans[10] = [{ n: 1, nModified: 1, ok: 1 }]
+            await wo.save(rsa, { autoInsert: true })
+                .then(function(msg) {
+                    // console.log('save then', msg)
+                    // save then [ { n: 1, nModified: 1, ok: 1 } ]
+                    rt = msg
+                })
+                .catch(function(msg) {
+                    // console.log('save catch', msg)
+                    rt = msg.toString()
+                })
+            vget[10] = rt
+
             //del
             rt = null
-            vans[10] = [{ n: 1, nDeleted: 1, ok: 1 }]
+            vans[11] = [{ n: 1, nDeleted: 1, ok: 1 }]
             let ss = await wo.select()
             let d = ss.filter(function(v) {
                 return v.name === 'kettle'
@@ -302,7 +326,7 @@ if (isWindows()) {
                     // console.log('del catch', msg)
                     rt = msg.toString()
                 })
-            vget[10] = rt
+            vget[11] = rt
 
         })
 
@@ -314,7 +338,7 @@ if (isWindows()) {
             assert.strict.deepStrictEqual(vget[2], vans[2])
         })
 
-        it(`should get ${JSON.stringify(vans[3])} for save`, async function() {
+        it(`should get ${JSON.stringify(vans[3])} for save(autoInsert=false)`, async function() {
             assert.strict.deepStrictEqual(vget[3], vans[3])
         })
 
@@ -342,10 +366,15 @@ if (isWindows()) {
         //     assert.strict.deepStrictEqual(vget[9], vans[9])
         // })
 
-        it(`should get ${JSON.stringify(vans[10])} for del`, async function() {
+        it(`should get ${JSON.stringify(vans[10])} for save(autoInsert=true)`, async function() {
             assert.strict.deepStrictEqual(vget[10], vans[10])
         })
 
+        it(`should get ${JSON.stringify(vans[11])} for del`, async function() {
+            assert.strict.deepStrictEqual(vget[11], vans[11])
+        })
+
     })
+
 }