Granting a Role

To grant a role to an existing user, the accounts.roles.grant() method can be utilized:

import joystick, { accounts } from '@joystick.js/node';

joystick.app({
 accounts: {
   events: {
     on_login: ({ user )) => {
       accounts.roles.grant(user?._id, 'active_account');
     },
   },
 },
});

Above, we tap into the account event hook for the on_login() event to grant a temporary role to a user of active_account. When a role is granted to a user, it's added to an array on their document/row in the database called roles.

When calling accounts.roles.grant(), if a role does not already exist in the roles collection/table for the app, Joystick will automatically create it.

API Reference

accounts.roles.grant()

accounts.roles.grant(user_id: string, role: string) => void;

Arguments