Skip to content
This repository has been archived by the owner on Mar 15, 2023. It is now read-only.

React hook performing authorization with Twitch Extensions JavaScript Helper

License

Notifications You must be signed in to change notification settings

lwojcik/react-twitch-ext-onauthorized

Repository files navigation

react-twitch-ext-onauthorized

As of 15 March 2023 this project is no longer updated or maintained.

React hook performing authorization with Twitch Extensions JavaScript Helper. It calls twitch.ext.onAuthorized and returns authorization object.

While onAuthorized is not the only method offered by The Extensions JavaScript Helper, it is one of the most important building blocks of each Twitch Extension.

Install

npm install --save react-twitch-ext-onauthorized

Usage

Example:

import { useTwitchAuth } from "react-twitch-ext-onauthorized";

const MyElement = () => {
  const twitchAuth = useTwitchAuth();
  return <div>TestElement {JSON.stringify(twitchAuth)}</div>;
};

When authorization succeeds, twitchAuth contains the following properties:

{
  authorized: true,
  channelId: 'channel id goes here',
  clientId: 'client id goes here',
  token: 'token goes here',
  userId: 'user id goes here',
}

When loaded outside of Twitch context, twitchAuth properties contain empty strings and authorized property will remain false:

{
  authorized: false,
  channelId: '',
  clientId: '',
  token: '',
  userId: '',
}

Note that you still have to provide Twitch JavaScript Helper yourself so that window.Twitch.ext resolves correctly -- see Twitch docs on adding the Extension Helper.

TypeScript

react-twitch-ext-onauthorized exposes two interfaces which can be used for type checking: TwitchAuthResponse and TwitchAuthObject.

To import them into your project add

import { TwitchAuthResponse } from "react-twitch-ext-onauthorized";

// OR

import { TwitchAuthObject } from "react-twitch-ext-onauthorized";

TwitchAuthResponse

Represents the shape of authorization object received from Twitch.

interface TwitchAuthResponse {
  channelId: string;
  clientId: string;
  token: string;
  userId: string;
}

TwitchAuthObject

Contains Twitch authorization object (TwitchAuthResponse) and a property authorized which denotes whether authorization was successful:

interface TwitchAuthObject {
  authorized: boolean;
  channelId: string;
  clientId: string;
  token: string;
  userId: string;
}

Contributions

Contributions of any kind are welcome.

You can contribute to React-twitch-ext-onauthorized by:

  • submiting bug reports or feature suggestions
  • improving documentation
  • submitting pull requests

Before contributing be sure to read Contributing Guidelines and Code of Conduct.

Contributors

To all who contribute code, improve documentation, submit issues or feature requests - thank you for making Twitch-ebs-tools even better!

We maintain an AUTHORS file where we keep a list of all project contributors. Please consider adding your name there with your next PR.

License

Code is available under MIT license. See LICENSE for more information.

Legal

This project is not authored, affiliated or endorsed in any way by Twitch.tv.