Home

Awesome

discovery-server

A tcp/utp server that auto announces itself using discovery-channel. Basically a server-only version of discovery-swarm

Usage

First spin up a server

var createServer = require('discovery-server')

var server = createServer(function (socket) {
  console.log('New connection!')
  socket.write('Hello, World!\n')
  socket.end()
})

server.listen('hello-world-server', 8080, function () {
  console.log('Now listening ...')
})

Then using discovery-channel you can connect to it

var dc = require('discovery-channel')()
var net = require('net')

dc.on('peer', function (key, peer) {
  var socket = net.connect(peer.port, peer.host)

  socket.on('data', function (data) {
    process.stdout.write(data)
    socket.on('end', function () {
      process.exit()
    })
  })

  socket.on('error', function () {
    socket.destroy()
  })
})

dc.join('hello-world-server')

API

var server = createServer([discoveryOptions], [onconnection])

Create a new tcp + utp server. discoveryOptions are forwarded to the discovery-channel constructor. In addition you can set {utp: false} to disable utp and only use tcp

Optionally you can pass a onconnection listener

server.listen(key, [port], [onlistening])

Start listening and announce your ip:port using the given key.

server.close([onclose])

Completely close down the server.

server.join(key)

Announce to an addition key after listening. It is also safe to call .listen multiple times instead.

server.address()

Returns an address object after the server has started listening containing the port and local address.

server.leave(key)

Stop announcing a key.

server.on('connection', connection, info)

Emitted when a tcp or utp socket connects. The info object looks like this {type: 'utp' | 'tcp'} and can be used to figure out what kind of connection you received.

server.on('listening')

Emitted when the server is fully listening.

server.on('close')

Emitted when the server is fully closed.

License

MIT