Migre uma integração existente
Ao atualizar uma versão antiga do RBAC, revise as chamadas em JavaScript e os caminhos de importação. O pacote atual é distribuído como @rbac/rbac, com entradas CommonJS e ESM.
Para atualizar uma versão principal publicada, siga os guias específicos: 1.x → 2.x e 2.x → 3.x. Esta é a documentação arquivada da 3.x; a versão atual é a 4.x.
Alterações entre versões principais
A versão 2 introduziu a implementação em TypeScript, atualizações de roles em execução, adapters para MongoDB/MySQL/PostgreSQL, middlewares e funções de autorização por tenant. A versão 3 exige Node.js 22.12.0+, move os schemas Zod para os subcaminhos opcionais @rbac/rbac/schemas e @rbac/rbac/roles.schema e rejeita identificadores inválidos de tabelas ou colunas SQL na construção do adapter. Revise essas alterações antes de atualizar integrações antigas.
Revise sua integração
- Consulte o changelog para alterações que afetem sua versão.
- Atualize a dependência e verifique suas chamadas
RBAC(config)(roles). A factory recebe primeiro a configuração opcional e depois o mapa de papéis. - Use
await rbac.can(role, operation, params?). A verificação sempre retornaPromise<boolean>. - Revise herança e condições
when. UtilizecallbackWhen()de@rbac/rbac/helperspara adaptar explicitamente callbacks legados do estilo Node.js. - Importe adapters de
@rbac/rbac/adapterse integrações de frameworks de@rbac/rbac/middlewares; instale separadamente o driver de banco opcional correspondente. - Execute testes de regressão para acessos negados, papéis desconhecidos, isolamento entre tenants e condições antes de publicar.
Se a aplicação importava schemas diretamente da raiz do pacote, utilize @rbac/rbac/schemas. O factory CommonJS continua chamável por require('@rbac/rbac'), e a importação padrão ESM expõe a mesma API.
Exemplo: adaptação explícita de uma condição com callback
import RBAC from '@rbac/rbac';
import { callbackWhen } from '@rbac/rbac/helpers';
const auth = RBAC<{ active: boolean }>()({
member: { can: [{
name: 'profile:edit',
when: callbackWhen((context, done) => done(null, context.active))
}] }
});
console.log(await auth.can('member', 'profile:edit', { active: true })); // trueOs adapters persistem definições de papéis, não closures arbitrárias executáveis. Revise condições serializadas ao migrar de papéis mantidos em memória. O guia de atualização explica como modificar uma instância depois de carregar novas definições.