w-orm-lmdb 1.0.5 → 1.0.7

package/docs/WOrmLmdb.html

@@ -80,7 +80,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line32">line 32</a>
+        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line34">line 34</a>
     </li></ul></dd>
     
 
@@ -336,6 +336,46 @@
         </tr>
 
     
+
+        <tr>
+            
+                <td class="name"><code>useCache</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Boolean</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>false</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入是否使用select快取，適用於單程序操作，預設false</p></td>
+        </tr>
+
+    
     </tbody>
 </table>
 
@@ -429,7 +469,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line407">line 407</a>
+        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line416">line 416</a>
     </li></ul></dd>
     
 
@@ -590,7 +630,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line522">line 522</a>
+        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line531">line 531</a>
     </li></ul></dd>
     
 
@@ -768,7 +808,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line177">line 177</a>
+        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line186">line 186</a>
     </li></ul></dd>
     
 
@@ -929,7 +969,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line280">line 280</a>
+        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line289">line 289</a>
     </li></ul></dd>
     
 
@@ -1216,7 +1256,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line123">line 123</a>
+        <a href="WOrmLmdb.mjs.html">WOrmLmdb.mjs</a>, <a href="WOrmLmdb.mjs.html#line132">line 132</a>
     </li></ul></dd>
     
 
@@ -1393,7 +1433,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Thu May 14 2026 19:53:45 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 Tue Jun 30 2026 10:11:04 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/WOrmLmdb.mjs.html

@@ -59,6 +59,7 @@ import isestr from 'wsemi/src/isestr.mjs'
 import isarr from 'wsemi/src/isarr.mjs'
 import isearr from 'wsemi/src/isearr.mjs'
 import iseobj from 'wsemi/src/iseobj.mjs'
+import isbol from 'wsemi/src/isbol.mjs'
 import haskey from 'wsemi/src/haskey.mjs'
 import evem from 'wsemi/src/evem.mjs'
 import genIDSeq from 'wsemi/src/genIDSeq.mjs'
@@ -74,6 +75,7 @@ import waitFun from 'wsemi/src/waitFun.mjs'
  * @param {String} [opt.url='_db'] 輸入資料庫用資料夾字串，預設'_db'
  * @param {String} [opt.db='worm'] 輸入使用資料庫名稱字串，預設'worm'
  * @param {String} [opt.cl='test'] 輸入使用資料表名稱字串，預設'test'
+ * @param {Boolean} [opt.useCache=false] 輸入是否使用select快取，適用於單程序操作，預設false
  * @returns {Object} 回傳操作資料庫物件，各事件功能詳見說明
  */
 function WOrmLmdb(opt = {}) {
@@ -99,6 +101,12 @@ function WOrmLmdb(opt = {}) {
         cl = 'test'
     }
 
+    //useCache
+    let useCache = get(opt, 'useCache')
+    if (!isbol(useCache)) {
+        useCache = false
+    }
+
     //storage
     let storage = `${url}/${db}/${cl}`
     // console.log('storage',storage)
@@ -117,7 +125,7 @@ function WOrmLmdb(opt = {}) {
     let getData = async() => {
 
         //check
-        if (isarr(_cache)) {
+        if (useCache && isarr(_cache)) {
             return cloneDeep(_cache) //與外部使用數據脫勾
         }
 
@@ -137,10 +145,11 @@ function WOrmLmdb(opt = {}) {
             ltdt.push(dt)
         }
 
-        //update
-        _cache = ltdt
-
-        return cloneDeep(ltdt) //與外部使用數據脫勾
+        if (useCache) {
+            _cache = ltdt
+            return cloneDeep(ltdt) //與外部使用數據脫勾
+        }
+        return ltdt
     }
 
     //getValue
@@ -673,12 +682,20 @@ function WOrmLmdb(opt = {}) {
         return res
     }
 
+    //close, 關閉內部LMDB env並釋放檔案鎖, close後該實例即報廢, 須重新new WOrmLmdb
+    let close = async () => {
+        if (client && client.status !== 'closed') {
+            await client.close() //lmdb root database之close(), 回傳Promise
+        }
+    }
+
     //save
     ee.select = select
     ee.insert = insert
     ee.save = save
     ee.del = del
     ee.delAll = delAll
+    ee.close = close
 
     return ee
 }
@@ -699,7 +716,7 @@ export default WOrmLmdb
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Thu May 14 2026 19:53:45 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 Tue Jun 30 2026 10:11:04 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 Thu May 14 2026 19:53:45 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 Tue Jun 30 2026 10:11:04 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-orm-lmdb",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "main": "dist/w-orm-lmdb.umd.js",
   "dependencies": {
     "lodash-es": "^4.18.1",
-    "lmdb": "^3.5.4",
-    "mingo": "^7.2.1",
-    "wsemi": "^1.8.52"
+    "lmdb": "^3.5.6",
+    "mingo": "^7.2.2",
+    "wsemi": "^1.8.62"
   },
   "devDependencies": {
-    "w-package-tools": "^1.1.5"
+    "w-package-tools": "^1.1.9"
   },
   "scripts": {
     "test": "mocha --parallel --timeout 60000",

package/src/WOrmLmdb.mjs

@@ -12,6 +12,7 @@ import isestr from 'wsemi/src/isestr.mjs'
 import isarr from 'wsemi/src/isarr.mjs'
 import isearr from 'wsemi/src/isearr.mjs'
 import iseobj from 'wsemi/src/iseobj.mjs'
+import isbol from 'wsemi/src/isbol.mjs'
 import haskey from 'wsemi/src/haskey.mjs'
 import evem from 'wsemi/src/evem.mjs'
 import genIDSeq from 'wsemi/src/genIDSeq.mjs'
@@ -27,6 +28,7 @@ import waitFun from 'wsemi/src/waitFun.mjs'
  * @param {String} [opt.url='_db'] 輸入資料庫用資料夾字串，預設'_db'
  * @param {String} [opt.db='worm'] 輸入使用資料庫名稱字串，預設'worm'
  * @param {String} [opt.cl='test'] 輸入使用資料表名稱字串，預設'test'
+ * @param {Boolean} [opt.useCache=false] 輸入是否使用select快取，適用於單程序操作，預設false
  * @returns {Object} 回傳操作資料庫物件，各事件功能詳見說明
  */
 function WOrmLmdb(opt = {}) {
@@ -52,6 +54,12 @@ function WOrmLmdb(opt = {}) {
         cl = 'test'
     }
 
+    //useCache
+    let useCache = get(opt, 'useCache')
+    if (!isbol(useCache)) {
+        useCache = false
+    }
+
     //storage
     let storage = `${url}/${db}/${cl}`
     // console.log('storage',storage)
@@ -70,7 +78,7 @@ function WOrmLmdb(opt = {}) {
     let getData = async() => {
 
         //check
-        if (isarr(_cache)) {
+        if (useCache && isarr(_cache)) {
             return cloneDeep(_cache) //與外部使用數據脫勾
         }
 
@@ -90,10 +98,11 @@ function WOrmLmdb(opt = {}) {
             ltdt.push(dt)
         }
 
-        //update
-        _cache = ltdt
-
-        return cloneDeep(ltdt) //與外部使用數據脫勾
+        if (useCache) {
+            _cache = ltdt
+            return cloneDeep(ltdt) //與外部使用數據脫勾
+        }
+        return ltdt
     }
 
     //getValue
@@ -626,12 +635,20 @@ function WOrmLmdb(opt = {}) {
         return res
     }
 
+    //close, 關閉內部LMDB env並釋放檔案鎖, close後該實例即報廢, 須重新new WOrmLmdb
+    let close = async () => {
+        if (client && client.status !== 'closed') {
+            await client.close() //lmdb root database之close(), 回傳Promise
+        }
+    }
+
     //save
     ee.select = select
     ee.insert = insert
     ee.save = save
     ee.del = del
     ee.delAll = delAll
+    ee.close = close
 
     return ee
 }