@kreativwebdesign/react-authorizer

0.1.1 • Public • Published

💂‍♂️ react-authorizer 💂‍♀️

Basic library for handling authorization in your React app.

WIP

This module is not finished yet, so it's not using semantic versioning Things to watch out for:

  • Better documentation
  • More examples

Out of Scope

  • Authentication

Usage

Wrap your React tree inside the AuthProvider Component and pass the roles of the active user as an Array.

<AuthProvider roles={[ 'user', 'admin' ]}>
  {/* your react tree */}
</AuthProvider>

And then somewhere inside this tree:

<Authorize neededRoles={[ 'user', 'admin' ]}>
  {
    ({ isAuthorized, missingRoles, lacksRole }) => {
      if (isAuthorized) {
        return 'Welcome buddy';
      } else if (lacksRole('admin')) {
        return 'Sorry you are not an admin';
      } else {
        return 'You are not authorized too see anything here'
      }
    }
  }
</Authorize>

API

AuthProvider

Props

Name type required default value
roles Array Yes -

Authorize

Props

Name type required default value
neededRoles Array Yes -
children
function({
isAuthorized: Boolean,
missingRoles: Array,
lacksRole: (role: String) => Boolean,
hasRole: (role: String) => Boolean
}) => propTypes.node
Yes -

Examples

See some examples in action on codesandbox here.

Development

You must use yarn to maintain the project.

Install

run yarn install

Test

run yarn run test

Build

run yarn run build

Publishing

Attention! Use with care.

run yarn run release

Readme

Keywords

none

Package Sidebar

Install

npm i @kreativwebdesign/react-authorizer

Weekly Downloads

0

Version

0.1.1

License

MIT

Unpacked Size

11.5 kB

Total Files

16

Last publish

Collaborators

  • sir-marc
  • stuckisimon