- db: fixes, so given examples an API works
- improved db:add to return a positive result on completion or nil and the error message on fail