Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including twitch-toolkit with all npm packages installed. Try it out:

var twitchToolkit = require("twitch-toolkit")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

twitch-toolkit v0.0.10

A set of tools to integrate with Twitch API, Twitch Chat and Twitch WebHooks.

twitch-toolkit

License Build Status

A set of tools to integrate with Twitch API, Twitch Chat and Twitch WebHooks.

NPM

To start to use this module, check the project documentation.

Installation

Using npm:

$ npm i --save twitch-toolkit

Usage

The library is composed by three independent modules:

  • API: Provides access to the Helix API.
  • Chat: Provides access to the chat events through tmi.js .
  • PubSub: Provides access to the Twitch PubSub.
  • WebHook: Provides access to the WebHook topics and events.

The toolkit exports each module and you can access it like this:

const {API, Chat, WebHook} = require('twitch-toolkit');

Every module must be instanced with the required configs as described in the next sessions.

API

The API module must be instanced with the following config object:

NameTypeDescription
client_idstringThe client_id to be used to access the API. This is required.
client_secretstringThe secret to be used to access the API that requires login. If this is not provided, the restricted methods will thrown an error.

Example:

const { API } = require('twitch-toolkit');
const twitchAPI = new API({client_id: 'id-string', client_secret: 'secret-string'})

The API methods are described in the TwitchApi documentation page

Chat

The API module must be instanced with the config objects described in the constructor documentation

Example:

const { Chat } = require('twitch-toolkit');
const twitchChat = new Chat(options)

To connected to the channels with the specified user, you'll need to call the connect function:

twitch.connect()

After that, you'll be able to listen to channel and chat events. You can also disconnect from the chat, if you wish:

twitch.disconnect()

The methods and events are described in the TwitchChatEmitter documentation page

PubSub

The Twitch PubSub implementation, as described in https://dev.twitch.tv/docs/pubsub/ .

The API module must be instanced with the following config object:

NameTypeDescription
loggerobjectThe logger object.
authTokenstringThe Twitch with OAuth token.
reconnectstringReconnect to Twitch PubSub when disconnected from server. Default: false

Example:

const { WebHook } = require('twitch-toolkit');
const twitchWebHook = new WebHook({
            client_id: 'id-string',
            callbackUrl: 'http://domain/path/to/cbUrl'
        });

The Webhook/WebSub requires a public endpoint on the running server/application to receive the data from the hub. Without this, its impossible to make this work.

The methods and events are described in the PubSub documentation page

Webhooks

The Twitch Webhooks implementation, as described in https://dev.twitch.tv/docs/api/webhooks-guide/ .

The API module must be instanced with the following config object:

NameTypeDescription
client_idstringThe client ID of the user to be passed to the Hub (un)subscribe requests. This is required.
callbackUrlstringThe callback URL that will receive the Hub requests. These requests should be forwarded to the handleRequest method to properly handle these data. This is required.
loggerobjectThe logger object.

Example:

const { WebHook } = require('twitch-toolkit');
const twitchWebHook = new WebHook({
            client_id: 'id-string',
            callbackUrl: 'http://domain/path/to/cbUrl'
        });

The Webhook/WebSub requires a public endpoint on the running server/application to receive the data from the hub. Without this, its impossible to make this work.

The methods and events are described in the WebHook documentation page

Tests

The module uses Mocha with Chai for unit tests and Istanbul for test coverage reports.

To run the mocha tests:

$ npm run test

To run tests in debug mode (--inspect-brk)

$ npm run test:debug

To run the tests with the coverage report:

$ npm run test:coverage

To properly run the tests, the following Environment Variables must be set:

Var NameValue
TWITCH_CLIENT_IDThe Client-ID to be used to make the API calls.
TWITCH_CLIENT_SECRETThe Client Secret to be used to make the API calls.
TWITCH_CLIENT_USERNAMEThe Username related to the Client-ID
TWITCH_CLIENT_PASSWORDThe OAUTH password. It can be generated here.
TWITCH_PUBSUB_CHANNEL_IDThe ID for the channel used in the PubSub tests.
TWITCH_PUBSUB_AUTH_TOKENThe OAUTH token for the PubSub with the proper scopes.

License

Licensed under the MIT License.

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free