feat: dag.resolve API

Author: daviddias

API/dag/README.md

@@ -30,4 +30,17 @@ If no `callback` is passed, a [promise][] is returned.
 
 `callback` must follow `function (err, dagNode) {}` signature, where `err` is an error if the operation was not successful and `dagNode` is the IPLD format DAG node retrieved.
 
+#### `dag.resolve`
+
+> Resolves an IPLD path
+
+##### `Go` **WIP**
+
+##### `JavaScript` - ipfs.dag.resolve(cid, path, callback)
+
+- `cid` is a [CID][https://github.com/ipfs/js-cid] instance.
+- `path` is a String that represents a valid path to be resolved
+
+`callback` must follow `function (err, value) {}` signature, where `err` is an error if the operation was not successful and `value` is the value it was retrieved.
+
 If no `callback` is passed, a [promise][] is returned.

src/dag-resolve.js

@@ -0,0 +1,47 @@
+/* eslint-env mocha */
+/* eslint max-nested-callbacks: ["error", 8] */
+
+'use strict'
+
+const expect = require('chai').expect
+const dagPB = require('ipld-dag-pb')
+const DAGNode = dagPB.DAGNode
+const dagCBOR = require('ipld-dag-pb')
+
+module.exports = (common) => {
+  describe('.dag.resolve', () => {
+    let ipfs
+
+    before((done) => {
+      common.setup((err, factory) => {
+        expect(err).to.not.exist
+        factory.spawnNode((err, node) => {
+          expect(err).to.not.exist
+          ipfs = node
+          done()
+        })
+      })
+    })
+
+    after((done) => {
+      common.teardown(done)
+    })
+
+    describe('callback API', () => {
+      describe('.resolve', () => {
+        it.skip('dag-pb local scope', (done) => {})
+        it.skip('dag-pb one level', (done) => {})
+        it.skip('dag-pb two levels', (done) => {})
+        it.skip('dag-cbor local scope', (done) => {})
+        it.skip('dag-cbor one level', (done) => {})
+        it.skip('dag-cbor two levels', (done) => {})
+        it.skip('from dag-pb to dag-cbor', (done) => {})
+        it.skip('from dag-cbor to dag-pb', (done) => {})
+      })
+    })
+
+    describe('promise API', () => {
+      describe('.resolve', () => {})
+    })
+  })
+}

src/index.js

@@ -9,4 +9,5 @@ exports.swarm = require('./swarm')
 exports.block = require('./block')
 exports.dht = require('./dht')
 exports.dag = require('./dag')
+exports.dagResolve = require('./dag-resolve')
 exports.pubsub = require('./pubsub')