Criando Nodes Personalizados n8n: Do Código à Produção

Arquitetura de Nodes: A Vantagem do TypeScript

Cada node personalizado do n8n é uma classe TypeScript. O SDK oferece gerenciamento de credenciais com segurança de tipo, validação de entrada e tratamento de erros nativamente.

import {
	IExecuteFunctions,
	INodeExecutionData,
	INodeType,
	INodeTypeDescription,
} from 'n8n-workflow';

export class MyCustomNode implements INodeType {
	description: INodeTypeDescription = {
		displayName: 'My Custom Node',
		name: 'myCustomNode',
		group: ['transform'],
		version: 1,
		description: 'Does something useful',
		inputs: ['main'],
		outputs: ['main'],
	};

	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
		const items = this.getInputData();
		const results = [];
		
		for (const item of items) {
			results.push(item);
		}
		return [results];
	}
}

O SDK lida com a criptografia de credenciais, mantém o isolamento entre nodes e gerencia o estado. Você foca na lógica de integração, não em servidores.