Comece com regras simples
Os exemplos usam a API pública real e podem ser adaptados à aplicação. Instale @rbac/rbac antes de executá-los.
Hierarquia de roles
import RBAC from '@rbac/rbac';
const auth = RBAC()({
guest: { can: ['catalog:view'] },
seller: { inherits: ['guest'], can: ['catalog:create'] },
manager: { inherits: ['seller'], can: ['catalog:remove'] }
});
console.log(await auth.can('manager', 'catalog:view')); // true
console.log(await auth.can('seller', 'catalog:remove')); // falseCondição assíncrona de propriedade
import RBAC from '@rbac/rbac';
type Context = { actorId: string; documentId: string };
async function belongsTo(actorId: string, documentId: string): Promise<boolean> {
// Substitua por uma consulta confiável ao banco de dados.
return actorId === 'user-1' && documentId === 'doc-1';
}
const auth = RBAC<Context>()({
writer: { can: [{
name: 'document:edit',
when: ({ actorId, documentId }: Context) => belongsTo(actorId, documentId)
}] }
});
console.log(await auth.can('writer', 'document:edit', {
actorId: 'user-1', documentId: 'doc-1'
})); // trueValidar configurações
import { rolesSchema } from '@rbac/rbac/schemas';
const validated = rolesSchema.parse({
guest: { can: ['catalog:view'] }
});
console.log(validated.guest.can); // ['catalog:view']Os schemas ficam em um subpath Zod opcional; isso não significa que funções serializadas arbitrárias sejam permissões executáveis. Consulte condições, adapters e o playground.