@adonisjs/websocket-packet

Websocket packets

This library is used to create/validate the websocket packets used by AdonisJs.

If you are writing a Javascript client, this is the library you must use. When writing client libraries for other platforms, simply follow the docs and the code to create your implementations.

npm i --save @adonisjs/websocket-packet

Usage

const wsp = require('@adonisjs/websocket-packet') 
console.log(wsp.codes)

wsp.isJoinPacket(packet)

Constants

codes : Object

Packet codes. The actual packet will have the numbers

Functions

isJoinPacket(packet) ⇒ Boolean

Validates if packet code is a JOIN code.

isLeavePacket(packet) ⇒ Boolean

Validates if packet code is a LEAVE code.

isOpenPacket(packet) ⇒ Boolean

Validates if packet code is a OPEN code.

isJoinAckPacket(packet) ⇒ Boolean

Validates if packet code is a JOIN_ACK code.

isJoinErrorPacket(packet) ⇒ Boolean

Validates if packet code is a JOIN_ERROR code.

isLeaveAckPacket(packet) ⇒ Boolean

Validates if packet code is a LEAVE_ACK code.

isLeaveErrorPacket(packet) ⇒ Boolean

Validates if packet code is a LEAVE_ERROR code.

isEventPacket(packet) ⇒ Boolean

Validates if packet code is a EVENT code.

isPingPacket(packet) ⇒ Boolean

Validates if packet code is a PING code.

isPongPacket(packet) ⇒ Boolean

Validates if packet code is a PONG code.

hasTopic(packet) ⇒ Boolean

Finding if a packet has a topic.

isValidJoinPacket() ⇒ Boolean

Makes sure packet is a valid join packet. Do call isJoinPacket before calling this method.

isValidLeavePacket() ⇒ Boolean

Makes sure packet is a valid leave packet. Do call isLeavePacket before calling this method.

isValidEventPacket() ⇒ Boolean

Makes sure packet is a valid event packet. Do call isEventPacket before calling this method.

joinPacket(topic) ⇒ Object

Makes a join packet

leavePacket(topic) ⇒ Object

Makes a leave packet

joinAckPacket(topic) ⇒ Object

Makes join acknowledge packet

joinErrorPacket(topic, message) ⇒ Object

Makes join error packet

leaveAckPacket(topic) ⇒ Object

Makes leave packet

leaveErrorPacket(topic, message) ⇒ Object

Makes leave error packet

eventPacket(topic, body) ⇒ Object

Makes the event packet

pingPacket() ⇒ Object

Makes ping packet

pongPacket() ⇒ Object

Makes pong packet

codes : Object

Packet codes. The actual packet will have the numbers

Kind: global constant
Example

{
 OPEN: 0,
 JOIN: 1,
 LEAVE: 2,
 JOIN_ACK: 3,
 JOIN_ERROR: 4,
 LEAVE_ACK: 5,
 LEAVE_ERROR: 6,
 EVENT: 7,
 PING: 8,
 PONG: 9

}

isJoinPacket(packet) ⇒ Boolean

Validates if packet code is a JOIN code.

Kind: global function

Param	Type
packet	Object

isLeavePacket(packet) ⇒ Boolean

Validates if packet code is a LEAVE code.

Kind: global function

Param	Type
packet	Object

isOpenPacket(packet) ⇒ Boolean

Validates if packet code is a OPEN code.

Kind: global function

Param	Type
packet	Object

isJoinAckPacket(packet) ⇒ Boolean

Validates if packet code is a JOIN_ACK code.

Kind: global function

Param	Type
packet	Object

isJoinErrorPacket(packet) ⇒ Boolean

Validates if packet code is a JOIN_ERROR code.

Kind: global function

Param	Type
packet	Object

isLeaveAckPacket(packet) ⇒ Boolean

Validates if packet code is a LEAVE_ACK code.

Kind: global function

Param	Type
packet	Object

isLeaveErrorPacket(packet) ⇒ Boolean

Validates if packet code is a LEAVE_ERROR code.

Kind: global function

Param	Type
packet	Object

isEventPacket(packet) ⇒ Boolean

Validates if packet code is a EVENT code.

Kind: global function

Param	Type
packet	Object

isPingPacket(packet) ⇒ Boolean

Validates if packet code is a PING code.

Kind: global function

Param	Type
packet	Object

isPongPacket(packet) ⇒ Boolean

Validates if packet code is a PONG code.

Kind: global function

Param	Type
packet	Object

hasTopic(packet) ⇒ Boolean

Finding if a packet has a topic.

Kind: global function

Param	Type
packet	Object

isValidJoinPacket() ⇒ Boolean

Makes sure packet is a valid join packet. Do call isJoinPacket before calling this method.

Kind: global function

isValidLeavePacket() ⇒ Boolean

Makes sure packet is a valid leave packet. Do call isLeavePacket before calling this method.

Kind: global function

isValidEventPacket() ⇒ Boolean

Makes sure packet is a valid event packet. Do call isEventPacket before calling this method.

Kind: global function

joinPacket(topic) ⇒ Object

Makes a join packet

Kind: global function
Throws:

• Error If topic is not defined or not a string

Param	Type
topic	String

leavePacket(topic) ⇒ Object

Makes a leave packet

Kind: global function
Throws:

• Error If topic is not defined or not a string

Param	Type
topic	String

joinAckPacket(topic) ⇒ Object

Makes join acknowledge packet

Kind: global function
Throws:

• Error If topic is not defined or is not a string

Param	Type
topic	String

joinErrorPacket(topic, message) ⇒ Object

Makes join error packet

Kind: global function
Throws:

• Error If topic is not defined or not a string
• Error If message is not defined or not a string

Param	Type
topic	String
message	String

leaveAckPacket(topic) ⇒ Object

Makes leave packet

Kind: global function
Throws:

• Error If topic is not defined or not a string

Param	Type
topic	String

leaveErrorPacket(topic, message) ⇒ Object

Makes leave error packet

Kind: global function
Throws:

• Error If topic is not defined or not a string
• Error If message is not defined or not a string

Param	Type
topic	String
message	String

eventPacket(topic, body) ⇒ Object

Makes the event packet

Kind: global function
Throws:

• Error If topic is not defined or not a string
• Error If body.event is not defined
• Error If body.data is not defined

Param	Type
topic	String
body	Object

pingPacket() ⇒ Object

Makes ping packet

Kind: global function

pongPacket() ⇒ Object

Makes pong packet

Kind: global function

Changelog

1.0.1 (2018-02-20)

Bug Fixes

• test: generate .nyc_output for coverage (d3ed7ad)

<a name="1.0.0"></a>

Features

• initial commit (b3f2bb0)