# Compilando e executando um componente nativo do servidor

> Compila o componente confiável de Total.js HTML, crie um exemplo, valida mensagens, reconfigure e libera seus recursos.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: pt
Content-SHA256: 65520ed04c8431cd0a1eca7efaf4fe04d070aab0abd0d5105eb26da123d6ad68
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`NEWCOMPONENT(html, [callback])` compila um **componente de servidor**, distinto de um jComponent do navegador. Aceita texto-fonte que contenha `<script total>` ou `<script node>`; sem callback devolve uma promessa. Um nome carrega `components/<name>.html`; um URL descarrega o código-fonte. Esta receita usa apenas código em linha de confiança, sem código remoto nem declarações npm.

O componente exportado fornece metadados, valores por omissão de `config` e `make(instance,config)`. `component.create(overrides)` cria uma instância com valores por omissão clonados. Declare `inputs:[{id,schema}]` para a transformação da entrada. `instance.input(inputId,data,callback)` entrega uma mensagem cujos `.data` e `.error` refletem a validação do esquema. **O manipulador corre mesmo com entrada inválida**, por isso verifique `message.error` antes de processar. `message.send(outputId,data)` emite uma saída; `message.destroy()` termina-a.

`instance.reconfigure(values)` atualiza a sua configuração e chama seus cintos de configuração/salvação. `instance.remove()` chama cintos do ciclo de vida e remove o caso; `component.remove()` remove todas as instâncias e invoca desinstalação.

```js controllers/components.js
exports.install = function() {
	ROUTE('GET /native-component/', exercise);
};
async function exercise($) {
	try {
		var source = '<script total>exports.id="native-echo";exports.name="Native echo";exports.config={prefix:"one:"};exports.inputs=[{id:"input",schema:"*name:String"}];exports.make=function(instance,config){instance.message=function($){if($.error){$.send("invalid",{invalid:true});$.destroy();return;}$.send("output",{text:config.prefix+$.data.name});$.destroy();};instance.destroy=function(){MAIN.componentClosed=true;};};</script>';
		var component = await NEWCOMPONENT(source);
		component.debugger = false;
		var instance = component.create();
		var first = await new Promise(resolve => instance.input('input',{name:'Ann'},message => resolve(message.data)));
		var invalid = await new Promise(resolve => instance.input('input',{},message => resolve(message.data)));
		instance.reconfigure({prefix:'two:'});
		var second = await new Promise(resolve => instance.input('input',{name:'Bob'},message => resolve(message.data)));
		instance.remove();
		var rejected = false;
		try { await NEWCOMPONENT('<body>no backend script</body>'); } catch (e) { rejected = true; }
		$.json({first:first,invalid:invalid,second:second,remaining:component.instances.length,closed:MAIN.componentClosed,rejected:rejected});
	} catch (e) { $.invalid(e); }
}
```
