• ⏱ Lightweight
• 🔥 Blazing Fast
• ⚡️️ Zero dependency

• Focused on operations
• Scalable
• Each role is given specific access rights for every operation
• High granularity in assigning rights

yarn add @rbac/rbac or npm install @rbac/rbac

RBAC is a curried function thats initially takes an object with configurations, then returns another function that takes an object with roles, finally returns an object that holds "can" property that is a function.

You can use it in many ways, below is one of them:

RBAC expects an object with roles as property names.

const roles = {
  supervisor: {
    can: [{ name: 'products:find', when: (params, done) => {
      // done receives error as first argument and Truthy or Falsy value as second argument
      done(error, false);
    }}]
  },
  admin: {
    can: [{name: 'products:*', when: new Promise((resolve) => {
      resolve(true);
    })}]
  }
};

Want more? Check out the examples folder.

• Wildcard support
• Regex support
• Update roles in runtime

1. Build RBAC

• Run yarn install to get RBAC's dependencies
• Run yarn build to produce minified version of RBAC.

2. Development mode

• Having all the dependencies installed run yarn dev. This command will generate a non-minified version of your library and will run a watcher so you get the compilation on file change.

3. Running the tests

• Run yarn test

4. Scripts

• yarn build - produces production version of your library under the lib folder
• yarn dev - produces development version of your library and runs a watcher
• yarn test - well ... it runs the tests :)
• yarn test:watch - same as above but in a watch mode

This project is under MIT License [https://opensource.org/licenses/MIT]

This project scaffold was built with a modified version of webpack-library-starter

Thanks to Karl Düüna (DeadAlready) and his awesome post on medium