irclib/README.md

42 lines
2.0 KiB
Markdown
Raw Normal View History

2022-09-24 11:22:51 +00:00
# IRClib
Zero dependencies library for creating anything using the IRC protocol - bots, clients, you name it. It includes a variety of utilities, such as a nick list class that manages mode prefixes for you, NickServ authentication checker and message formatting (colors!).
[Read the Typedoc](https://lunasqu.ee/irclib/index.html)
## Getting started
There is an example usage documented in [src/examples/connection-test.ts](https://gitlab.icynet.eu/IcyNetwork/irclib/-/blob/master/src/examples/connection-test.ts), but basically you have two ways to create an IRC client connection:
1. Use the `IRCBot` class. This just takes connection options and it uses `IRCSocketConnector` (so it will not work in the browser!)
2. Use the `IRCConnection` class directly. To use this, you need to provide your own connector in addition to the options.
2022-09-24 11:22:51 +00:00
### Connection options
The connection options are documented in detail [here](https://lunasqu.ee/irclib/interfaces/IIRCOptions.html), but the most important are:
- `host` - Server host.
- `nick` - Your nickname.
- `port` - Server port, defaults to 6667.
- `ssl` - Use secure connection.
- `channels` - String-list of channels to join on connect.
### Connectors
This module provides two connectors: `IRCSocketConnector` for Node.js usage (`net` and `tls`) and `IRCWebSocketConnector` for browser usage (WebSockets). You can always write your own if you need something different.
2022-09-24 11:31:11 +00:00
**These are not included in the main module!** You need to import them from `@icynet/irclib/lib/connector/[..]`. This is to prevent browser bundlers from including `net` and `tls`!
2022-09-24 11:22:51 +00:00
### Event handlers
The main classes use a special custom [TypedEventEmitter](https://lunasqu.ee/irclib/classes/TypedEventEmitter.html) to send events.
2022-09-25 06:39:47 +00:00
- [Connection wrapper events](https://lunasqu.ee/irclib/types/IRCConnectionEvents.html)
2022-09-24 11:31:11 +00:00
- [Nick list events](https://lunasqu.ee/irclib/types/NickListEvents.html)
2022-09-24 11:22:51 +00:00
Basically, you're mostly just going to need the `message` event for IRC.
## IRCv3
Currently, this module only supports SASL authentication capability.