corebasic 1.0.183 → 1.0.184

package/libs/dip.js

@@ -10,8 +10,8 @@ export const remove = Elabase.remove
 
 export const batchBegin = Elabase.batchBegin
 export const batchAbort = Elabase.batchAbort
-export const batchReset = Elabase.batchReset
 export const batchSubmit = Elabase.batchSubmit
+export const batch = Elabase.batch
 
 export const shard_stats = Elabase.shard_stats
 export let config = Elabase.config

package/libs/elabase.js

@@ -115,23 +115,33 @@ function generate_suffix(meta) {
 let BATCH_COUNTER = 0n;
 let batches = {}
 
-export function batchBegin() {
+export function batchBegin() { // Manual Lifecycle. If you forget to batchSubmit() or batchAbort(), then memory leak due to dangling batch
     const uid = ++BATCH_COUNTER; // Safe. No skew in async ++BATCH_COUNTER as single thread and ++COUNTER is atomic in event loop sense. ⚠️ Only breaks on worker_threads or cluster (multi-process)
     batches[uid] = []
     return uid
 }
-export function batchAbort(batch_id) {
-    delete batches[batch_id]
+export function batchAbort(batch) { // Mandatory  to prevent meory leak due to dangling batch if batchBegin() is called without batchSubmit()
+    delete batches[batch]
 }
-export function batchReset() {
-    batchAbort()
+
+export const batch = async (callback) => { // Convenience function with auto lifecyle management and auto submit when callback returns. abort is called appropriately.
+    const batch = Dip.batchBegin()
+
+    try {
+        await callback(batch)
+        return await batchSubmit(batch)
+    } catch (err) {
+        Dip.batchAbort(batch)
+        throw err
+    }
 }
-export function batchSubmit(batch_id, arg) {
-    if (!batch_id || !batches[batch_id] || !batches[batch_id].length)
+
+export function batchSubmit(batch, arg) {
+    if (!batch || !batches[batch] || !batches[batch].length)
         throw {message: `Error: Invalid batch in Dip.batchSubmit()`}
-    let txns = batches[batch_id]
-    let mode = batches[batch_id].some(txn => txn.insert || txn.update || txn.delete) ? "command" : "query"
-    delete batches[batch_id]
+    let txns = batches[batch]
+    let mode = batches[batch].some(txn => txn.insert || txn.update || txn.delete) ? "command" : "query"
+    delete batches[batch]
     return new Promise((resolve, reject) => resolve())
     .then(() => execute({ "batch": txns, mode, version: arg?.version, compression: arg?.compression }))
     .then (result => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "corebasic",
   "type": "module",
-  "version": "1.0.183",
+  "version": "1.0.184",
   "description": "",
   "main": "index.js",
   "scripts": {