Support toJSON() on read methods.

[stephenplusplus]

Fixes #27

Provide options.toJSON = true to database.run, table.read, and table.createReadStream, and all returned rows will already have had toJSON called on them.

table.read({
  keys: [...],
  columns: [...],
  toJSON: true
}, function(err, rows) {
  var row = rows[0]
  // row.Name = 'value'
})

table.createReadStream({
    keys: [...],
    columns: [...],
    toJSON: true
  })
  .on('data', row => {
    // row.Name = 'value'
  })

row.toJSON() supports options, such as wrapNumbers. To get these through, the user has to provide toJSONOption: {...} alongside toJSON: true.

[stephenplusplus]

@WaldoJeffers want to take a look? :)

[codecov]

Codecov Report

Merging #94 into master will not change coverage.
The diff coverage is 100%.

@@          Coverage Diff          @@
##           master    #94   +/-   ##
=====================================
  Coverage     100%   100%           
=====================================
  Files          11     11           
  Lines        1248   1257    +9     
=====================================
+ Hits         1248   1257    +9

Impacted Files	Coverage Δ
src/partial-result-stream.js	100% <100%> (ø)	⬆️
src/database.js	100% <100%> (ø)	⬆️
src/transaction-request.js	100% <100%> (ø)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 718a13e...b416fe5. Read the comment docs.

[WaldoJeffers]

As for passing arguments to toJSON from table.createReadStream({...}), I can't think of anything other than:

• accepting a toJSONoptions: table.createReadStream({ toJSON: true, toJSONoptions: {...} })
• making toJSON accept a function instead of a Boolean table.createReadStream({ toJSON: row => toJSON(row, {...}) }), but the downside is you always have to a function even if you're interested in giving it custom options

[walshie4]

Didn't dig in too deeply to see if run would end up using the modified partial-result-stream, but it looks like database.run would not support this option per the current state of this PR. Is that correct?

[stephenplusplus]

I've added options.toJSON and options.toJSONOptions to:

• database.run() (thanks, @walshie4!)
• table.createReadStream()
• table.read()

Tests added. Please take another look!

[stephenplusplus]

@alexander-fenster would you mind taking another look?

[stephenplusplus]

Since we haven't released this yet, I have a PR to rename query.toJSON to query.json and query.toJSONOptions to query.jsonOptions. Please take a look!: #122