bare-dgram

npm i bare-dgram

const dgram = require('bare-dgram')

const client = dgram.createSocket('udp4')
const server = dgram.createSocket('udp4')

client.on('connect', () => client.send('hello'))

server.on('message', (msg, rinfo) => {
  console.log(`message: ${msg} from: ${rinfo.address}:${rinfo.port}`)
})

server.bind(() => client.connect(server.address().port))

new DgramSocket(opts?: DgramSocketOptions | DgramSocketType | null, onmessage?: (message: Buffer, remote: DgramRemoteInfo) => void)

bind(port?: number, address?: string, onlistening?: () => void): this
bind(port: number, onlistening: () => void): this
bind(opts: DgramSocketBindOptions, onlistening?: () => void): this
bind(onlistening: () => void): this

connect(port: number, address?: string, onconnect?: () => void): this
connect(port: number, onconnect: () => void): this
connect(opts: DgramSocketConnectOptions, onconnect?: () => void): this

send(msg: DgramMessage, offset: number, length: number, port?: number, address?: string, cb?: (err: Error | null, bytes: number) => void): void

createSocket(opts?: DgramSocketOptions | DgramSocketType | null, onmessage?: (message: Buffer, remote: DgramRemoteInfo) => void): DgramSocket

constants: {
  state: {
    CONNECTING: number
    CONNECTED: number
    BINDING: number
    BOUND: number
    READING: number
    CLOSING: number
    CLOSED: number
    UNREFED: number
  }
  address: {
    MAX_LENGTH: number
  }
  bind: {
    IPV6ONLY: number
    REUSEADDR: number
    REUSEPORT: number
  }
}

type IPFamily = 4 | 6

type DgramMessage = string | Buffer | ArrayBufferView | (string | Buffer | ArrayBufferView)[]

interface DgramRemoteInfo {
  address: string
  family: `IPv${IPFamily}`
  port: number
  size: number
}

interface DgramSocketAddress {
  address: string
  family: `IPv${IPFamily}`
  port: number
}

interface DgramSocketBindOptions {
  address?: string
  fd?: number
  port?: number
}

interface DgramSocketConnectOptions {
  address?: string
  port: number
}

interface DgramSocketEvents {
  close: []
  connect: []
  error: [err: Error]
  listening: []
  message: [message: Buffer, remote: DgramRemoteInfo]
}

interface DgramSocketOptions {
  ipv6Only?: boolean
  lookup?: DNSLookup
  readBufferSize?: number
  recvBufferSize?: number
  reuseAddr?: boolean
  reusePort?: boolean
  sendBufferSize?: number
  type?: DgramSocketType | null
}

type DgramSocketType = 'udp4' | 'udp6'

class DgramError {
  code: string
}

constants: {
  state: {
    CONNECTING: number
    CONNECTED: number
    BINDING: number
    BOUND: number
    READING: number
    CLOSING: number
    CLOSED: number
    UNREFED: number
  }
  address: {
    MAX_LENGTH: number
  }
  bind: {
    IPV6ONLY: number
    REUSEADDR: number
    REUSEPORT: number
  }
}