# Живот на действие, разширяване на резултатите и администраторски пазители

> Упражнения за влизане, излизане, разширяване, съвпадение и съвпадане с валидни, невалидни и неуспешни действия.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: bg
Content-SHA256: 93ef8f9e201a9360824c145ba6bd194fa62de506fa48654390271426a9698183
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`oninput($)` се изпълнява след валидирането на входа и декларирания middleware, непосредствено преди функцията на действието. `onoutput(error,response,$)` се изпълнява по пътя на успешното завършване, след филтрирането на изхода и по желание разширяването. В 0.0.19 невалиден вход или `$.invalid()` не извиква този hook; не го третирайте като универсален hook за грешка или finally.

`extend:'result'` добавя резултата от действието към валидирания му вход под този ключ и връща разширения вход. Път с точки използва вложено присвояване. Полезно е за умишлено композиране на действия; променя публичния договор на отговора.

Нито `sa:true`, нито `su:true` изисква потребител с администраторски флаг. те не определят две различни привилегии. нормални разрешителни проверки остават отделни.

```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));
};
```