# El ciclo de acción, la extensión del resultado y los guardias de administradores

> Exerce la entrada, la salida, el extendimiento y el su con acciones válidas, inactivas y falladas.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: es
Content-SHA256: 0002361a3932ef14f7fa1795782fa6a7adbee93a02cb57088e669bc6b0a9cdbb
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`oninput($)` se ejecuta después de la validación de la entrada y del middleware declarado, justo antes de la función de la acción. `onoutput(error,response,$)` se ejecuta en el camino de finalización correcta, tras el filtrado de la salida y la extensión opcional. En 0.0.19, una entrada no válida o `$.invalid()` no llama a este hook; no lo trates como un hook universal de error o de finally.

`extend:'result'` añade el resultado de la acción a su entrada validada bajo esa clave y devuelve la entrada extendida. Una ruta con puntos usa asignación anidada. Es útil para la composición deliberada de acciones; cambia el contrato público de la respuesta.

Ya sea `sa:true` o `su:true` requiere de un usuario con una bandera de administrador. no definen dos terceros privilegio diferentes. los controles de permiso normales permanecen separados.

```js definitions/hooks.js
MAIN.hooks = [];
AUTH(function($) {
	var role = $.headers['x-demo-role'];
	if (role === 'sa' || role === 'su') $.success({ id:'admin', [role]:true });
	else if (role === 'member') $.success({id:'member'});
	else $.invalid();
});
NEWACTION('Hooks|extend', {
	input: '*name:String',
	extend: 'result',
	oninput: function($) { MAIN.hooks.push('input:' + $.payload.name); },
	onoutput: function(err, response) { MAIN.hooks.push('output:' + response.result.greeting); },
	action: function($, model) { $.callback({greeting:'Hello ' + model.name}); }
});
NEWACTION('Hooks|fail', {
	onoutput: function() { MAIN.hooks.push('unexpected'); },
	action: function($) { $.invalid('failed'); }
});
for (var flag of ['sa','su']) {
	var action = { action:function($) { $.success(); } };
	action[flag] = true;
	NEWACTION('Hooks|' + flag, action);
}
```

```js controllers/hooks.js
exports.install = function() {
	ROUTE('POST /extend/ @json --> Hooks|extend');
	ROUTE('GET /fail/ --> Hooks|fail');
	ROUTE('GET /sa/ --> Hooks|sa');
	ROUTE('GET /su/ --> Hooks|su');
	ROUTE('GET /hook-events/', $ => $.json(MAIN.hooks));
};
```