mvcc-api 1.2.4 → 1.2.6

package/README.md

@@ -34,7 +34,7 @@ It easily and powerfully solves complex concurrency problems that are difficult
     *   Business logic and storage logic can be perfectly separated.
 
 4.  **Improved Development Productivity**
-    *   No need to write complex synchronization code yourself; write safe code with just intuitive `api.read()`, `api.write()`, and `commit()`.
+    *   No need to write complex synchronization code yourself; write safe code with just intuitive `api.read()`, `api.write()`, and `api.commit()`.
 
 ## Installation
 
@@ -54,7 +54,7 @@ import {
   SyncMVCCTransaction,
   AsyncMVCCStrategy,
   AsyncMVCCTransaction
-} from 'https://cdn.jsdelivr.net/npm/mvcc-api@7/+esm'
+} from 'https://cdn.jsdelivr.net/npm/mvcc-api@1/+esm'
 ```
 
 ## Usage
@@ -136,8 +136,9 @@ const child = parent.createNested()
 parent.write('shared', 'parent')  // Parent modifies after child creation
 child.write('shared', 'child')    // Child modifies same key
 
-const result = child.commit()
+const result = child.commit('It should fail')
 if (!result.success) {
+  console.log(result.label) // "It should fail"
   console.log(result.error) // "Commit conflict: Key 'shared' was modified..."
 }
 ```
@@ -189,13 +190,13 @@ const bResult = b.commit()
 
 | Method | Description | Return Value |
 | :--- | :--- | :--- |
-| `create(key, value)` | Create new key-value | `this` |
-| `write(key, value)` | Update existing key | `this` |
-| `delete(key)` | Delete key | `this` |
-| `read(key)` | Read value | `T \| null` |
-| `exists(key)` | Check if key exists | `boolean` |
-| `commit()` | Apply changes | `TransactionResult<K, T>` |
-| `rollback()` | Discard changes | `TransactionResult<K, T>` |
+| `create(key: K, value: T)` | Create new key-value | `this` |
+| `write(key: K, value: T)` | Update existing key | `this` |
+| `delete(key: K)` | Delete key | `this` |
+| `read(key: K)` | Read value | `T \| null` |
+| `exists(key: K)` | Check if key exists | `boolean` |
+| `commit(label?: string)` | Apply changes | `TransactionResult<K, T>` |
+| `rollback(label?: string)` | Discard changes | `TransactionResult<K, T>` |
 | `createNested()` | Create child transaction | `MVCCTransaction` |
 
 ### `TransactionResult<K, T>`
@@ -206,6 +207,7 @@ type TransactionConflict<K, T> = { key: K, parent: T, child: T }
 
 {
   success: boolean              // Success status
+  label?: string                // Label of the transaction
   error?: string                // Error message on failure (e.g. conflict)
   conflict?: TransactionConflict<K, T> // Conflict information on failure
   created: TransactionEntry[]   // Keys and values created via create()

package/dist/cjs/index.cjs

@@ -22,6 +22,8 @@ var src_exports = {};
 __export(src_exports, {
   AsyncMVCCStrategy: () => AsyncMVCCStrategy,
   AsyncMVCCTransaction: () => AsyncMVCCTransaction,
+  MVCCStrategy: () => MVCCStrategy,
+  MVCCTransaction: () => MVCCTransaction,
   SyncMVCCStrategy: () => SyncMVCCStrategy,
   SyncMVCCTransaction: () => SyncMVCCTransaction
 });
@@ -445,7 +447,17 @@ var SyncMVCCTransaction = class _SyncMVCCTransaction extends MVCCTransaction {
         break;
       }
     }
-    if (!targetVerObj || !targetVerObj.exists) return null;
+    if (!targetVerObj) {
+      if (nextVerObj) {
+        const cached2 = this.deletedCache.get(key);
+        if (cached2) {
+          const match = cached2.find((c) => c.deletedAtVersion === nextVerObj.version);
+          if (match) return match.value;
+        }
+      }
+      return null;
+    }
+    if (!targetVerObj.exists) return null;
     if (!nextVerObj) {
       return strategy.read(key);
     }
@@ -1067,7 +1079,17 @@ var AsyncMVCCTransaction = class _AsyncMVCCTransaction extends MVCCTransaction {
         break;
       }
     }
-    if (!targetVerObj || !targetVerObj.exists) return null;
+    if (!targetVerObj) {
+      if (nextVerObj) {
+        const cached2 = this.deletedCache.get(key);
+        if (cached2) {
+          const match = cached2.find((c) => c.deletedAtVersion === nextVerObj.version);
+          if (match) return match.value;
+        }
+      }
+      return null;
+    }
+    if (!targetVerObj.exists) return null;
     if (!nextVerObj) {
       return strategy.read(key);
     }

package/dist/esm/index.mjs

@@ -416,7 +416,17 @@ var SyncMVCCTransaction = class _SyncMVCCTransaction extends MVCCTransaction {
         break;
       }
     }
-    if (!targetVerObj || !targetVerObj.exists) return null;
+    if (!targetVerObj) {
+      if (nextVerObj) {
+        const cached2 = this.deletedCache.get(key);
+        if (cached2) {
+          const match = cached2.find((c) => c.deletedAtVersion === nextVerObj.version);
+          if (match) return match.value;
+        }
+      }
+      return null;
+    }
+    if (!targetVerObj.exists) return null;
     if (!nextVerObj) {
       return strategy.read(key);
     }
@@ -1038,7 +1048,17 @@ var AsyncMVCCTransaction = class _AsyncMVCCTransaction extends MVCCTransaction {
         break;
       }
     }
-    if (!targetVerObj || !targetVerObj.exists) return null;
+    if (!targetVerObj) {
+      if (nextVerObj) {
+        const cached2 = this.deletedCache.get(key);
+        if (cached2) {
+          const match = cached2.find((c) => c.deletedAtVersion === nextVerObj.version);
+          if (match) return match.value;
+        }
+      }
+      return null;
+    }
+    if (!targetVerObj.exists) return null;
     if (!nextVerObj) {
       return strategy.read(key);
     }
@@ -1105,6 +1125,8 @@ var AsyncMVCCTransaction = class _AsyncMVCCTransaction extends MVCCTransaction {
 export {
   AsyncMVCCStrategy,
   AsyncMVCCTransaction,
+  MVCCStrategy,
+  MVCCTransaction,
   SyncMVCCStrategy,
   SyncMVCCTransaction
 };

package/dist/types/index.d.ts

@@ -1,2 +1,4 @@
+export { TransactionEntry, TransactionConflict, TransactionMergeFailure, TransactionResult } from './types';
+export * from './core/base';
 export * from './core/sync';
 export * from './core/async';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mvcc-api",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "Multiversion Concurrency Control (MVCC) API for TypeScript",
   "license": "MIT",
   "author": "izure <admin@izure.org>",