rbac-ts v2.1.0

This is a typescript port of @rbac/rbac

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

Features

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

Thanks

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

Getting Started

Install

pnpm: pnpm add rbac-ts yarn: yarn add rbac-ts npm: npm i rbac-ts

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:

Setup RBAC config

Creating some roles

RBAC expects an object with roles as property names.

IMPORTANT! "when" property should be either a Callback function that receives params and done or a Promise that should resolve in Truthy or Falsy values. Example:

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);
    })}]
  }
};

Check if user can do some operation

Want more? Check out the examples folder.

Roadmap

• Wildcard support
• Regex support
• Update roles in runtime

Contributing

Contributions are welcome!

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

License

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