Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@wondai/n8n-nodes-nucleo) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@wondai/n8n-nodes-nucleo

Node community do n8n para o Núcleo Wondai — a camada de atendimento de IA (WhatsApp → n8n → Núcleo). Um único node com as operações que o agente precisa, assinando cada chamada com HMAC v1. O tenant (a padaria) vem do token, no servidor — nunca de nada que o n8n envie (a parede, ADR-013).

Substitui o pacote antigo @wondai/n8n-nodes-crm. Decisões: ADR-015 (este package + resolução inteligente de catálogo) e ADR-016 (orquestração: router + especialistas; catálogo como tool).

Filosofia: node burro, servidor inteligente

O node só monta a string canônica, assina e chama. Toda inteligência (busca fuzzy, apelidos, lote, teto de tokens, idempotência, isolamento entre padarias) vive no servidor, atrás da parede. Isso mantém o segredo fora do workflow, a lógica num lugar só e o token seguro.

Operações

Recurso	Operação	Endpoint	Escopo do token
Cliente	Buscar	`GET /api/v1/agent/cliente`	`cliente:ler`
Catálogo	Resolver Produtos	`POST /api/v1/agent/catalogo/resolver`	`catalogo:ler`
Pedido	Detalhar	`GET /api/v1/agent/pedido/:ref`	`pedido:ler`
Pedido	Criar	`POST /api/v1/agent/pedido`	`pedido:escrever`
Pedido	Alterar	`PATCH /api/v1/agent/pedido/:id`	`pedido:escrever`
Pedido	Cancelar	`POST /api/v1/agent/pedido/:id/cancelar`	`pedido:escrever`
Conversa	Registrar	`POST /api/v1/agent/conversa/fechar`	`conversa:escrever`

Resolver Produtos é a operação inteligente: manda várias consultas numa chamada (máx 10), tolera erro de digitação (banofe→Banoffee), falta de acento (pao frances→Pão Francês) e apelidos; devolve no máx 3 candidatos por consulta com status (achou/ambiguo/nao_achou).

Criar é idempotente: deixe Idempotency Key vazio (gera uma) ou repita a mesma chave num retry — o Núcleo nunca duplica o pedido.

No Pedido Criar, Nome do Cliente e Endereço de Entrega (JSON) são opcionais e existem para carregar o que a IA já coletou no atendimento. O node continua burro: só envia nome_cliente e endereco_entrega; quem decide tenant, valida e grava snapshot em crm.entregas é o Núcleo.

Instalação (n8n self-hosted)

Settings → Community Nodes → Install → @wondai/n8n-nodes-nucleo. (ou, em dev: npm run build aqui e aponte o n8n para a pasta / npm link.)
Para usar como ferramenta do AI Agent, o n8n precisa permitir nodes community como tools:
```
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
```
(variável de ambiente do servidor n8n; sem ela o node funciona como node normal, mas não aparece como tool do AI Agent.)

Credencial — "Núcleo Wondai API"

Campo	O que é
Base URL	Origem do Núcleo, sem barra final (ex: `https://app.suapadaria.com.br`).
Token ID	Id do token (público). Header `x-wondai-key`.
Signing Secret	Segredo de assinatura — exibido uma vez ao emitir o token.

O par Token ID + Signing Secret é emitido no painel /agente do Núcleo (uma credencial por padaria). O n8n guarda os dois cifrados no cofre — nunca em texto puro no workflow.

Assinatura (contrato HMAC v1)

Cada requisição leva os headers x-wondai-key, x-wondai-timestamp (unix s, janela ±300s), x-wondai-nonce (único — reuso = replay → 401) e x-wondai-signature. A assinatura é HMAC_SHA256(signingSecret, canônica) em hex, onde a canônica é:

v1
<MÉTODO>
<path + query>
<timestamp>
<nonce>
<sha256_hex(corpo)>     # corpo cru; "" no GET

Build (dev)

npm install
npm run build      # tsc → dist/ + copia ícones

Licença

MIT