npm install hyperdrive

var hyperdrive = require('hyperdrive')
var level = require('level')
var swarm = require('discovery-swarm')()
 
var db = level('./hyperdrive.db')
var drive = hyperdrive(db)
 
var archive = drive.createArchive()
var ws = archive.createFileWriteStream('hello.txt') // add hello.txt 
 
ws.write('hello')
ws.write('world')
ws.end()
 
var link = archive.key.toString('hex')
console.log(link, '<-- this is your hyperdrive link')
 
// the archive is now ready for sharing. 
// we can use swarm to replicate it to other peers 
swarm.listen()
swarm.join(new Buffer(link, 'hex'))
swarm.on('connection', function (connection) {
  connection.pipe(archive.replicate()).pipe(connection)
})

var swarm = require('discovery-swarm')()
var hyperdrive = require('hyperdrive')
var level = require('level')
 
var db = level('./another-hyperdrive.db')
var drive = hyperdrive(db)
 
var link = new Buffer('your-hyperdrive-link-from-the-above-example', 'hex')
var archive = drive.createArchive(link)
 
swarm.listen()
swarm.join(link)
swarm.on('connection', function (connection) {
  connection.pipe(archive.replicate()).pipe(connection)
  archive.get(0, function (err, entry) { // get the first file entry 
    console.log(entry) // prints {name: 'hello.txt', ...} 
    var stream = archive.createFileReadStream(entry)
    stream.on('data', function (data) {
      console.log(data) // <-- file data 
    })
    stream.on('end', function () {
      console.log('no more data')
    })
  })
})

var raf = require('random-access-file') // a storage driver that writes to the file system 
var archive = drive.createArchive({
  file: function (name) {
    return raf('my-download-folder/' + name)
  }
})

{
  live: false, // set this to share the archive without finalizing it 
  sparse: false, // set this to only download the pieces of the feed you are requesting / prioritizing 
  file: function (name) {
    // set this to determine how file data is stored. 
    // the storage instance should implement the hypercore storage api 
    // https://github.com/mafintosh/hypercore#storage-api 
    return someStorageInstance
  }
}

var archive = drive.createArchive({
  file: function (name) {
    console.log('returning storage for', name)
    return raf(name)
  }
})
 
archive.append('hello.txt', function () {
  console.log('hello.txt was read and appended')
})

{
  timeout: 1000 // time out after 1000ms. Default is Infinity 
}

{
  start: startOffset, // defaults to 0 
  end: endOffset // defaults to file.length 
}

var cursor = archive.createByteCursor('hello.txt')
 
// seek to byte offset 10000 and read the rest. 
cursor.seek(10000, function (err) {
  if (err) throw err
  cursor.next(function loop (err, data) {
    if (err) throw err
    if (!data) return console.log('no more data')
    console.log('cursor.position is ' + cursor.position)
    console.log('read', data.length, 'bytes')
    cursor.next(loop)
  })
})

{
  start: startOffset, // defaults to 0 
  end: endOffset // defaults to file.length 
}

{
  upload: true, // upload content to remote peer 
  download: true // downlod content from remote peer 
}