valtech-components 4.0.154 → 4.0.155

package/lib/services/auth/guards.d.ts

@@ -65,6 +65,42 @@ export declare const guestGuard: CanActivateFn;
  * ```
  */
 export declare function permissionGuard(permissions: string | string[]): CanActivateFn;
+/**
+ * Factory de guard RBAC parametrizable — defense-in-depth a nivel de RUTA.
+ *
+ * Variante ergonómica de {@link permissionGuard} con firma variádica
+ * (`rbacGuard('a:read', 'b:manage')` en vez de `permissionGuard(['a:read', 'b:manage'])`),
+ * pensada para gatear vistas administrativas montadas vía los `provideValtech*Routes`
+ * de la lib. Pasa si el usuario tiene **AL MENOS UNO** de los permisos (OR), igual que
+ * el resto del gating del factory (`*valHasPermission`, menú). El match de wildcards
+ * (`*:*`, `resource:*`, `*:action`) lo resuelve `AuthService.hasPermission`.
+ *
+ * Es una capa ADICIONAL al gating fino dentro de los componentes (botones por
+ * `*valHasPermission`) y al 403 del backend — no los reemplaza. Sin permiso redirige
+ * a `unauthorizedRoute` (mismo destino que `permissionGuard`).
+ *
+ * @param permissions - Uno o más permisos requeridos (OR)
+ * @returns Guard function
+ *
+ * @example
+ * ```typescript
+ * import { rbacGuard } from 'valtech-components';
+ *
+ * const routes: Routes = [
+ *   {
+ *     path: 'api-keys',
+ *     canActivate: [rbacGuard('api-keys:read')],
+ *     component: ApiKeysViewComponent,
+ *   },
+ *   {
+ *     path: 'permissions',
+ *     canActivate: [rbacGuard('roles:read', 'rbac:manage')],
+ *     component: PermissionsViewComponent,
+ *   },
+ * ];
+ * ```
+ */
+export declare function rbacGuard(...permissions: string[]): CanActivateFn;
 /**
  * Guard que lee permisos desde route.data.
  * Permite configurar permisos directamente en la definición de rutas.

package/lib/services/auth/index.d.ts

@@ -71,7 +71,7 @@
 export * from './types';
 export { VALTECH_AUTH_CONFIG, provideValtechAuth, provideValtechAuthInterceptor, DEFAULT_AUTH_CONFIG, } from './config';
 export { AuthService } from './auth.service';
-export { authGuard, guestGuard, permissionGuard, permissionGuardFromRoute, superAdminGuard, roleGuard, } from './guards';
+export { authGuard, guestGuard, permissionGuard, permissionGuardFromRoute, rbacGuard, superAdminGuard, roleGuard, } from './guards';
 export { authInterceptor } from './interceptor';
 export { AuthStateService } from './auth-state.service';
 export { TokenService } from './token.service';

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "4.0.154";
+export declare const VERSION = "4.0.155";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "4.0.154",
+  "version": "4.0.155",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"