📦 nlon-socket
Socket adapter for nlon.
Since nlon by itself is not concerned by the actual method of data transfer, adapters can be used to apply the protocol over various media.
This package provides such an adapter for use with Node’s sockets.
Install
- pnpm:
pnpm add @elementbound/nlon-socket - npm:
npm i @elementbound/nlon-socket - yarn:
yarn add @elementbound/nlon-socket
Usage
The package provides factory methods to either wrap an existing socket or create a new one and add nlon on top of it.
Server
import { createSocketServer, wrapSocketServer } from '@elementbound/nlon-socket'
import net from 'node:net'
// Wrap an existing instance
const netServer = net.createServer(...)
const nlonServer = wrapSocketServer(netServer)
netServer.listen() // This must be called manually when wrapping
// Create a socket and start listening on it
// You can pass options for both the socket and nlon server
const nlonServer = createSocketServer({
host: 'localhost',
port: 63636
})
// Access wrapped net.Server instance
nlonServer.server
Peer
import { createSocketPeer, wrapSocketPeer }
import net from 'node:net'
// Wrap an existing instance
const socket = net.createConnection(...)
const nlonPeer = wrapSocketPeer(socket)
// Connect to host and initialize peer
const nlonPeer = createSocketPeer({
host: 'localhost',
port: 63636
})
// Access wrapped net.Socket instance
nlonPeer.socket
Documentation
- API docs
- Or generate your own with JSDoc:
pnpm doc
- Or generate your own with JSDoc:
License
This package is under the MIT License.