@oondemand/oon-core-back 0.7.0 → 0.7.1

package/README.md

@@ -23,7 +23,11 @@ Compatibilidade temporária: `CENTRAL_ATIVACAO_BACKEND_URL` e `MEUS_APPS_BACKEND
 
 ## 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.
+Todo App com RBAC declarado expõe `GET /core/role-catalog`. O contrato `schemaVersion: 1` contém `appCode`, `enabled` e `roles[]` com `code`, `name`, `description` e `admin`. Desde o SDK 0.7.1, a extensão aditiva opcional `roles[].commercialPermissions` publica nomes explícitos de permissões funcionais permitidas pelo papel. Wildcards são expandidos somente pelas permissões declaradas em `rbac.permissions`; wildcard literal e namespaces `tenant`, `publications`, `homologation`, `production`, `apps`, `users` e `roles` são excluídos. Políticas internas e permissões técnicas não são publicadas.
+
+O campo permanece opcional no schemaVersion 1: catálogos anteriores são conformes para descoberta e fluxos existentes. O novo aceite comercial inicial requer essa capacidade e deve falhar fechado com `APP_ROLE_CATALOG_UNAVAILABLE` quando ausente; não se infere autoridade do nome admin. Consumidores antigos devem tolerar campos adicionais. O runtime continua intersectando cada grant explícito com a política local atual.
+
+O endpoint é somente leitura, usa cache público de cinco minutos e não concede autorização.
 
 ## Saúde operacional
 

package/package.json

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

package/src/core/rbac/policy.js

@@ -127,6 +127,15 @@ function canAssignRole(actorPermissions, targetRole) {
   return target.every((permission) => actor.includes(permission));
 }
 
+// Public, bounded capability names only; never publish wildcard or authority
+// over identity, tenants or the Platform's delivery lifecycle.
+function commercialRolePermissions(role, config = ctx.config) {
+  const declared = rolePermissions(role);
+  const candidates = declared.includes("*") ? policy(config).permissions : declared;
+  return unique(candidates).filter(permission => PERMISSION_PATTERN.test(permission)
+    && !/^(tenant|publications|homologation|production|apps|users|roles)\./.test(permission)).sort();
+}
+
 function publicRoleCatalog(config = ctx.config) {
   const currentPolicy = policy(config);
   return {
@@ -138,6 +147,7 @@ function publicRoleCatalog(config = ctx.config) {
       name: role.name,
       description: String(role.description || ""),
       admin: role.admin === true || role.permissions?.includes("*") === true,
+      commercialPermissions: commercialRolePermissions(role, config),
     })),
   };
 }
@@ -180,5 +190,7 @@ module.exports = {
   matchingRoleForLegacyUser,
   canAssignRole,
   publicRoleCatalog,
+  commercialRolePermissions,
   publicPolicy,
 };
+