Releases · jeromeludmann/deno-irc

07 Feb 21:32

jeromeludmann

v0.8.1

2b3f335

v0.8.1

Fixes

Mode Setting Formats

Some MODE message formats are not properly parsed.

Following variants are now supported:

MODE #channel +bme *!*@host someone!user@host

MODE #channel +b *!*@host -m +e someone!user@host

Coverage

Missing test cases have been added and coverage now reaches 100% for core and plugins parts.

To generate the coverage report:

make test-coverage

HTML report:

make test-coverage-html

Assets 2

06 Feb 12:13

jeromeludmann

v0.8.0

f432316

v0.8.0

More Granular Raw Events

The client can now subscribe to more granular raw events.

For instance, instead of doing:

client.on("raw", (msg) => {
  if (msg.command === "join") {
    // ...
  }
});

client.on("raw", (msg) => {
  if (msg.command === "rpl_topic") {
    // ...
  }
});

it is now possible to just write:

client.on("raw:join", (msg) => {
  // ...
});

client.on("raw:rpl_topic", (msg) => {
  // ...
});

The previous raw event name keeps the same behavior:

client.on("raw", (msg) => {
  // all the raw events
});

But internally, it now translate into all the available raw events:

client.on([
  "raw:admin", "raw:cap", "raw:connect", // ...
  "raw:rpl_welcome", "raw:rpl_yourhost", "raw:rpl_created", // ...
  "raw:err_unknownerror", "raw:err_nosuchnick", "raw:err_nosuchnick", // ...
], (msg) => {
  // all the raw events
});

Multi Events Subscribing

Event emitter allow to listen more than one event.

Example from plugins/nicklist:

client.on(["part", "kick", "quit", "kill"], (msg) => {
  const { source, params } = msg; // msg is PartEvent | KickEvent | QuitEvent | KillEvent

  const nick = "nick" in params ? params.nick : source?.name;
  const channel = "channel" in params ? params.channel : undefined;

  if (nick !== undefined) {
    removeNick(nick, channel);
  }
});

Allowing to listen to several events at a time can be handy in some specific cases.

Supported Server Feature Events

Events related to supported server features are now emitted:

isupport:chanmodes and isupport:prefix (used by plugins/chanmodes to handle channel modes aspects)
isupport:chantypes (used by plugins/chantypes to provide some helpers like client.utils.isChannel)
isupport:usermodes

They are mainly used to offer a way to be aware of the server features and allow client to update its own behavior.

Client Helpers

client.utils contains some convenient methods based on supported server features.

Following have been added:

client.utils.isChannel (previously imported from core/strings)
client.utils.isCtcp (previously imported from plugins/ctcp)
client.utils.createCtcp (previously imported from plugins/ctcp)

Assets 2

30 Jan 16:44

jeromeludmann

v0.7.0

04830ad

v0.7.0

Fixes

Nicklist

Add missing NICK support to track nick changes in plugins/nicklist.

BREAKING CHANGES

Each message contains now source and params object.

source object is optional and replaces the old origin key. It contains name key (containing the user nick or the server host). It may also contain an optional mask object, containing user name and host name (only if the source refers to a user).
params object contains all the existing previous message keys, except the source object.

Example with privmsg event:

client.on("privmsg", (msg) => {
  const { source, params } = msg;

  if (!source) {
    return;
  }

  if (source.name === "nick") {
    client.privmsg(params.target, `Hello ${source.name}!`);
  }
});

Internal

Plugin Dependencies

Plugins resolve their dependencies first before to load themselves.

It allows to prevent a plugin which depends on another plugins to be loaded before them. It also improves plugin internal API by providing plugin factory from core/plugins.ts.

Potential circular dependencies will be prevented thanks to type checking.