Publicação: SDK n8n (n8n-nodes-pilot-status)

Este guia descreve como publicar o pacote do node do n8n que vive em:

packages/sdk-n8n/

O pacote publicado no NPM é n8n-nodes-pilot-status.

Link:

https://www.npmjs.com/package/n8n-nodes-pilot-status

Pré-requisitos

Acesso de publish no NPM para o pacote n8n-nodes-pilot-status
Node.js >= 18
Token de publish do NPM (recomendado em CI): NPM_TOKEN

O que vai para o NPM

O pacote publica apenas a pasta dist/ (ver files no package.json)
O prepublishOnly roda npm run build, que:
- Compila TypeScript para dist/
- Copia os ícones SVG para dist/nodes/...

Passo a passo (manual)

1) Atualize a versão

Edite packages/sdk-n8n/package.json e incremente version seguindo SemVer.

Isso é obrigatório: o npm publish usa a versão do package.json. Se você não alterar, a publicação vai falhar com erro de versão já existente no registry.

Se você usa package-lock.json, atualize-o também (o NPM atualiza automaticamente em alguns fluxos).

2) Instale dependências, rode testes e build

Execute dentro de packages/sdk-n8n/:

npm ci
npm test
npm run build

3) Valide o conteúdo do pacote

Antes de publicar, cheque o que será enviado:

npm publish --dry-run

Confirme que:

dist/ está incluído
Não há arquivos desnecessários (tokens, .env, etc.)

4) Autentique no NPM (se necessário)

Em ambiente local:

npm login

Em CI (recomendado), configure:

npm config set //registry.npmjs.org/:_authToken "$NPM_TOKEN"

5) Publique

npm publish

Verificações pós-publicação

Conferir a versão publicada:

npm view n8n-nodes-pilot-status version

Instalar em um n8n de teste:
- UI: Settings → Community Nodes → Install → n8n-nodes-pilot-status
- Docker/self-hosted: npm install n8n-nodes-pilot-status e reiniciar o n8n

Teste local sem publicar (tarball)

Para testar em um n8n local sem publicar:

Gere o tarball:

npm pack

Instale o .tgz gerado na instância do n8n (ex.: dentro do container ou volume de nodes), reinicie e valide se o node aparece.