socket-json-wrapper

Wrapper for socket connections that allows you to send and receive json objects.

Usage no npm install needed!

<script type="module">
  import socketJsonWrapper from 'https://cdn.skypack.dev/socket-json-wrapper';
</script>

README

socket-json-wrapper

Wrapper for socket connections that allows you to send and receive json objects.

Build Status Test Coverage License: MIT

bitHound Code bitHound Overall Score bitHound Dependencies

Installation

npm i socket-json-wrapper

Usage

In the server.js file:

const net = require('net')
const { Connection } = require('socket-json-wrapper')

const server = net.createServer(socket => {
  const connection = new Connection(socket)

  connection.on('message', data => {
    console.log('received:', data)
    // will log { dataFromClient: 'baz' }
  })

  // send some data to the server.
  connection.send({ dataFromServer: 'foo' })
})

In the client.js file:

const net = require('net')
const { Connection } = require('socket-json-wrapper')

const socket = net.createConnection(8080)

const connection = new Connection(socket)

connection.on('message', data => {
  console.log('received:', data)
  // will log { dataFromServer: 'foo' }
})

// send some data to the server.
connection.send({ dataFromClient: 'baz' })

API

connection.isDead

<boolean>

Is set to true if the underlying socket is not writable.

connection.socket

A refference to the wrapped socket.

connection.send(data)

  • data <*> - This may be any value that can by stringified to valid JSON.

It returns a <boolean> that is true if the data was written to the socket.

connection.close()

This method calls .end() on the underlying socket.

Typescript usage

In typescript you can define types that can be sent or received. You can do so by creating an interface and by passing it to the Connection when you are creating it.

import { createConnection } from 'net'
import { Connection } from 'socket-json-wrapper'

const socket = createConnection(8080)

interface Sendable {
  dataFromClient: string
}

interface Receivable {
  dataFromServer: string
}

// Pass interfaces that represent the messages that can be sent or received so you can get completions.
const connection = new Connection<Sendable, Receivable>(socket)

connection.on('message', data => {
  // Typescript will automatically know that the data parameter has a dataFromServer property.
  console.log('received:', data)
  // will log { dataFromServer: 'foo' }
})

// send some data to the server.
connection.send({ dataFromClient: 'baz' })
// Typescript will automatically detect if your message does not match the sendable type defined in the interface above.