@oondemand/oon-core-back 0.5.0 → 0.5.1

package/README.md

@@ -21,6 +21,10 @@ O Core suporta `ecosystem.role` em `central.config.js`: `root` para a Central de
 
 Compatibilidade temporária: `CENTRAL_ATIVACAO_BACKEND_URL` e `MEUS_APPS_BACKEND_URL` continuam aceitas como aliases da URL da API. Nunca aponte a URL da API para o próprio Core.
 
+## Catálogo público de perfis
+
+`GET /core/role-catalog` expõe o contrato mínimo e versionado dos perfis RBAC declarados pelo App. A resposta contém `appCode`, `enabled` e código, nome, descrição e indicador administrativo de cada papel; permissões internas não são publicadas. O endpoint é somente leitura, usa cache público de cinco minutos e não concede autorização.
+
 ## Saúde operacional
 
 - `GET /health/ready`: retorna HTTP 200 somente quando o MongoDB está conectado; retorna 503 enquanto o runtime não estiver pronto.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oondemand/oon-core-back",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oondemand/oon-platform.git",

package/src/api/access.routes.js

@@ -8,6 +8,7 @@ const { asyncHandler } = require("../core/utils/helpers");
 const {
   policy,
   publicPolicy,
+  publicRoleCatalog,
   roleByCode,
   canAssignRole,
 } = require("../core/rbac/policy");
@@ -90,6 +91,11 @@ function assertAssignable(actor, roleCode) {
   return role;
 }
 
+router.get("/role-catalog", (_req, res) => {
+  res.set("Cache-Control", "public, max-age=300");
+  res.json(publicRoleCatalog());
+});
+
 router.get("/rbac", (_req, res) => {
   res.json(publicPolicy());
 });

package/src/core/rbac/policy.js

@@ -127,6 +127,21 @@ function canAssignRole(actorPermissions, targetRole) {
   return target.every((permission) => actor.includes(permission));
 }
 
+function publicRoleCatalog(config = ctx.config) {
+  const currentPolicy = policy(config);
+  return {
+    schemaVersion: 1,
+    appCode: String(config.appCode || config.slug || "central"),
+    enabled: currentPolicy.enabled,
+    roles: currentPolicy.roles.map((role) => ({
+      code: role.code,
+      name: role.name,
+      description: String(role.description || ""),
+      admin: role.admin === true || role.permissions?.includes("*") === true,
+    })),
+  };
+}
+
 function publicPolicy(config = ctx.config) {
   const currentPolicy = policy(config);
   return {
@@ -164,5 +179,6 @@ module.exports = {
   legacyRoleCandidates,
   matchingRoleForLegacyUser,
   canAssignRole,
+  publicRoleCatalog,
   publicPolicy,
 };