Close

API wrapper for hack.chat using ws package

Mr.ip-0neMr.ip-0ne wrote 05/13/2017 at 17:37 • 2 min read • Like

API wrapper for hack.chat using ws package - Hack Chat of https://www.npmjs.com


Usage

var HackChat = require("hack-chat");

var chat = new HackChat(); // Client group for multiple channels

chat.join("lobby", "TestUser");

var programmingSession = chat.join("programming", "TestUser");

chat.on("onlineSet", function(session, users) {

// Each event from a group contains a session argument as first argument

console.log("Users online in ?" + session.channel + ": " + users.join(", "));

});

chat.on("chat", function(session, nick, text) {

console.log(nick + "@" + session.channel + ": " + text);

if (session.channel != "programming") {

programmingSession.sendMessage("Quote from ?" + session.channel + ": " + text);

}

});

HackChat.Session methods

new(channel: string, username: string, password?: string, options?: any = { server: "wss://hack.chat/chat-ws"; })

Description: Constructs a new chat session and directly connects to it

Example:

var session = new HackChat.Session("programming", "My_Username", "password123", { server: "wss://custom-server.com/chat-ws" });

sendRaw(json: any)

Description: Sends a raw JSON packet

Example:

session.sendRaw({ cmd: "ping" });

sendMessage(message: string)

Description: Sends a chat message

Example:

session.sendMessage("Hi everybody");

invite(user: string)

Description: Invites a user to a random channel

Example:

session.on("invited", function(nick, channel, time) {

var invitedSession = chat.join(channel, "My_Username", "password123");

invitedSession.once("onlineAdd", function(nick, time)

{

invitedSession.sendMessage("Hi, " + nick);

});

});

session.invite("WebFreak");

ping()

Description: Sends a ping packet. Can be used to check IP limit.

leave()

Description: Disconnects from the server, making this unusable

HackChat.Session events

All HackChat events are the same as the HackChat.Session events with the exception that the session where it got emitted from is the first argument

.on("joining")

Description: Emitted when sending the join request.

Arguments: None

.on("left")

Description: Emitted when disconnected from WebSocket.

Arguments: None

.on("chat")

Description: Emitted when someone sends a regular message.

Arguments:

.on("info")

Description: Emitted when some unhandled info event passes through.

Arguments:

.on("infoRaw")

Description: Emitted when any info event occurs. Will also trigger if it gets handled.

Arguments:

.on("warn")

Description: Emitted when some unhandled warn event passes through.

Arguments:

.on("warnRaw")

Description: Emitted when any warn event occurs. Will also trigger if it gets handled.

Arguments:

.on("ratelimit")

Description: Emitted when server is sending IP ratelimit warning. Will cancel regular warn event.

Arguments:

.on("banned")

Description: Emitted when admin is banning the user. Will cancel regular warn event.

Arguments:

.on("nicknameInvalid")

Description: Emitted when nickname trying to join with is invalid ("!", "$", "?", etc.) Will cancel regular warn event.

Arguments:

.on("nicknameTaken")

Description: Emitted when nickname trying to join with is already taken. Will cancel regular warn event.

Arguments:

.on("invited")

Description: Emitted when WebSocket successfully invited someone. Will cancel regular info event.

Arguments:

.on("invitation")

Description: Emitted when someone invited WebSocket. Will cancel regular info event.

Arguments:

.on("onlineSet")

Description: Emitted when successfully joined. Will contain an array of users.

Arguments:

.on("onlineAdd")

Description: Emitted when someone joins the channel.

Arguments:

.on("onlineRemove")

Description: Emitted when someone leaves the channel.

Arguments:

.on("error")

Description: Emitted when receiving invalid JSON or if WebSocket fails to send.

Arguments:

Like

Discussions