Git Product home page Git Product logo

hypersource's Introduction

hypersource

Build WebSocket APIs that leverage the HyperCore Protocol

Installation

$ npm install hypersource

Example

Below creates a web socket server that echos the first value as a response.

// can use hyperdrive, hypertrie, or hyperdb too
const hypercore = require('hypercore')
const ram = require('random-access-memory')
const hs = require('hypersource')

const server = hs.createServer((req, res) => {
  console.log('request from:', req.url)

  // 'req.key' points to the public key for this feed
  const reader = hypercore(ram, req)

  // 'res.key' and 'res.secretKey' contain the ephemeral key pair
  // used for writing a response. The public key is stored in the
  // 'userData' of the handshake
  const writer = hypercore(ram, res)

  // replicate from request
  reader.replicate(req)
  // replicate to response
  writer.replicate(res)

  // echo first value to writer
  reader.get(0, (err, buf) => writer.append(buf))

  // close response when writer uploads
  writer.once('upload', () => res.destroy())
})

server.listen(3000, () => {
  const { protocol, address, port } = server.address()
  console.log('Listening on %s//%s:%s', protocol, address, port)
})

Using simple-websocket we can connect to this host and initiate a request.

const WebSocket = require('simple-websocket')
const hypercore = require('hypercore')
const pump = require('pump')
const ram = require('random-access-memory')

const request = hypercore(ram)
request.ready(() => {
  const key = request.key.toString('hex')
  const stream = request.replicate({ live: true })
  const socket = new WebSocket(`ws://localhost:3000/${key}`)

  pump(stream, socket, stream).once('handshake', () => {
    const remotePublicKey = stream.remoteUserData
    const response = hypercore(ram, remotePublicKey)

    request.append('hello world')
    response.replicate({ stream, live: true })
    response.get(0, (err, res) => {
      console.log('response', res.toString()); // 'hello world'
    })
  })
})

API

server = hs.createServer([opts[, onrequest]])

Create a new hypersource web socket server where onrequest is called when the 'request' event is emitted and opts is an optional object that is passed directly to simple-websocket Server.

server.listen(port[, host[, callback]])

Listen on port on an optional host calling callback when the 'listening' event is fired.

addrinfo = server.address()

Returns the address info for the server.

const addrinfo = server.address() // { protocol: 'ws:', address: '::', family: 'IPv6', port: 3000 }

server.close()

Close the server.

server.on('error', error)

Emitted when an error occurs.

server.on('connection', socket, httpRequest)

Emitted when a connection has been established where socket is a Duplex stream that wraps the underlying web socket and httpRequest is a http.IncomingMessage containing HTTP request information.

server.on('request', request, response, discoveryKey)

Emitted when a request has been established where request and response both wrap hypercore-protocol streams and discoveryKey is the discovery key for the request.

The request and response object contains useful properties for creating hypercore instances and replicating their feeds.

request.url

The URL associated with the request.

request.method

The HTTP method associated with the request.

request.headers

The HTTP headers associated with the request.

request.key

The public key associated with the request.

request.publicKey

An alias to request.key.

request.discoveryKey

The discovery key associated with the request.

request.stream

The hypercore-protocol stream that is associated with the request.

response.key

The public key associated with the response.

response.publicKey

An alias to response.key.

response.secretKey

The secret key associated with the response.

response.discoveryKey

The discovery key associated with the response.

request.stream

The hypercore-protocol stream that is associated with the request.

License

MIT

hypersource's People

Contributors

jwerle avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.