level-update

A levelup plugin that can be used implements conditional updates.

level-update

A levelup plugin that can be used implements conditional updates.

The name of this module may change if I think of something better.

level-update intercepts database mutations (put, del, batch), retrives the current value for that key, and passed the old value, and the new value to a user supplied merge function.

The merge function can be used a number of ways - if it throws an error, the put/del/batch will callback an error.

If it returns a string or Buffer, then that value will be saved instead.

And if it returns something else, then the new value will be saved as normal.

  var Update = require('level-update')
 
  Update(db, function merge (newValueoldValuekey) {
    return someSortOfMerge(newValue, oldValue)
  })
 
  db.put('key', 'VALUE', function (err) {
    //this will be intercepted 
  })

If oldValue is null, the operation is a create.

If newValue is null, the operation is a delete.

Otherwise, the operation is an update.

check that new value is correct, or throw error.

check that new value comes after old, or merge concurrent updates.

level-update uses lock to preserve update scemantics, this is necessay to be able so that merged mutations can behave deterministically - level-update does a get, and then combines the current value with the new value. It is essetial that the value has not changed in between the get and the put!

level-update doesn't support the chained interface for db.batch(), but only the array interface.

MIT