@wondai/n8n-nodes-nucleo 0.2.2 → 0.2.4

package/README.md

@@ -20,9 +20,11 @@ parede. Isso mantém o segredo fora do workflow, a lógica num lugar só e o tok
 |---|---|---|---|
 | 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
@@ -31,6 +33,10 @@ apelidos; devolve no máx 3 candidatos por consulta com `status` (`achou`/`ambig
 **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)
 
 1. **Settings → Community Nodes → Install** → `@wondai/n8n-nodes-nucleo`.

package/dist/nodes/Nucleo/Nucleo.node.js

@@ -85,6 +85,24 @@ function asArray(value) {
     }
     return [];
 }
+/** Lê um parâmetro JSON (string ou objeto) como objeto simples. Vazio → null. */
+function asObject(value) {
+    if (value && typeof value === "object" && !Array.isArray(value))
+        return value;
+    if (typeof value === "string") {
+        const t = value.trim();
+        if (!t)
+            return null;
+        try {
+            const j = JSON.parse(t);
+            return j && typeof j === "object" && !Array.isArray(j) ? j : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
 /** IDs separados por vírgula ou JSON array → string[]. */
 function parseIds(value) {
     if (Array.isArray(value))
@@ -196,7 +214,7 @@ class Nucleo {
                             name: "Alterar",
                             value: "alterar",
                             action: "Alterar pedido",
-                            description: "Altera data/observações/itens (adicionar, remover, mudar quantidade)",
+                            description: "Altera data/observações/itens. Itens por PRODUTO (adicionar soma, ajustar +/-, definir, remover produto) ou por id de item (compat).",
                         },
                         {
                             name: "Cancelar",
@@ -268,6 +286,14 @@ class Nucleo {
                     description: "Telefone do cliente (E.164). Resolve o cliente existente ou cria um novo.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
                 },
+                {
+                    displayName: "Nome do Cliente",
+                    name: "nomeCliente",
+                    type: "string",
+                    default: "",
+                    description: "Opcional. Preenche cliente novo ou cliente existente ainda sem nome. Não sobrescreve nome já cadastrado.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
                 {
                     displayName: "Itens (JSON)",
                     name: "itens",
@@ -304,6 +330,14 @@ class Nucleo {
                     description: "Data/hora ISO 8601 para encomenda. Vazio = imediato.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
                 },
+                {
+                    displayName: "Endereço de Entrega (JSON)",
+                    name: "enderecoEntrega",
+                    type: "json",
+                    default: "{}",
+                    description: 'Opcional. Para entrega, snapshot do endereço escolhido: {"logradouro","numero","complemento","bairro","cidade","estado","cep","referencia"}. Logradouro e cidade são obrigatórios quando enviado.',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
                 {
                     displayName: "Loja (unit_id)",
                     name: "unitId",
@@ -370,6 +404,30 @@ class Nucleo {
                     description: 'Muda a quantidade de itens já existentes: [{"item_id":"...","quantidade":4}]. Os IDs vêm do Detalhar. Trocar item = remover + adicionar. Vazio = não altera.',
                     displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
                 },
+                {
+                    displayName: "Ajustar Itens por Produto (JSON)",
+                    name: "ajustarItens",
+                    type: "json",
+                    default: "[]",
+                    description: 'Ajuste relativo POR PRODUTO (o cliente não sabe id de item): [{"produto_id":"...","quantidade_delta":7}] soma; -5 subtrai; resultado ≤ 0 remove a linha. produto_id vem do Catálogo Resolver. Vazio = não ajusta.',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Definir Itens por Produto (JSON)",
+                    name: "definirItens",
+                    type: "json",
+                    default: "[]",
+                    description: 'Quantidade absoluta POR PRODUTO: [{"produto_id":"...","quantidade":5}] deixa a linha com 5; 0 remove. produto_id vem do Catálogo Resolver. Vazio = não define.',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
+                {
+                    displayName: "Remover Produtos (produto_ids)",
+                    name: "removerProdutoIds",
+                    type: "string",
+                    default: "",
+                    description: "produto_ids a remover do pedido (todas as linhas do produto), separados por vírgula ou JSON array. Use para 'tirar os X' e para a troca. produto_id vem do Catálogo Resolver.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
                 {
                     displayName: "Motivo",
                     name: "motivo",
@@ -455,20 +513,27 @@ class Nucleo {
                 }
                 else if (resource === "pedido" && operation === "criar") {
                     const telefone = this.getNodeParameter("telefone", i).trim();
+                    const nomeCliente = this.getNodeParameter("nomeCliente", i, "").trim();
                     const itens = asArray(this.getNodeParameter("itens", i));
                     const tipoEntrega = this.getNodeParameter("tipoEntrega", i);
                     const observacoes = this.getNodeParameter("observacoes", i, "").trim();
                     const agendadoPara = this.getNodeParameter("agendadoPara", i, "").trim();
+                    const enderecoEntrega = asObject(this.getNodeParameter("enderecoEntrega", i, "{}"));
                     const unitId = this.getNodeParameter("unitId", i, "").trim();
                     idempotencyKey =
                         this.getNodeParameter("idempotencyKey", i, "").trim() || (0, node_crypto_1.randomUUID)();
                     const b = { telefone, itens };
+                    if (nomeCliente)
+                        b.nome_cliente = nomeCliente;
                     if (tipoEntrega)
                         b.tipo_entrega = tipoEntrega;
                     if (observacoes)
                         b.observacoes = observacoes;
                     if (agendadoPara)
                         b.agendado_para = agendadoPara;
+                    if (enderecoEntrega && Object.keys(enderecoEntrega).length) {
+                        b.endereco_entrega = enderecoEntrega;
+                    }
                     if (unitId)
                         b.unit_id = unitId;
                     method = "POST";
@@ -482,6 +547,9 @@ class Nucleo {
                     const adicionar = asArray(this.getNodeParameter("adicionarItens", i, "[]"));
                     const remover = parseIds(this.getNodeParameter("removerItemIds", i, ""));
                     const alterar = asArray(this.getNodeParameter("alterarItens", i, "[]"));
+                    const ajustar = asArray(this.getNodeParameter("ajustarItens", i, "[]"));
+                    const definir = asArray(this.getNodeParameter("definirItens", i, "[]"));
+                    const removerProdutos = parseIds(this.getNodeParameter("removerProdutoIds", i, ""));
                     const b = {};
                     if (observacoes.trim())
                         b.observacoes = observacoes.trim();
@@ -493,6 +561,12 @@ class Nucleo {
                         b.remover_item_ids = remover;
                     if (alterar.length)
                         b.alterar_itens = alterar;
+                    if (ajustar.length)
+                        b.ajustar_itens = ajustar;
+                    if (definir.length)
+                        b.definir_itens = definir;
+                    if (removerProdutos.length)
+                        b.remover_produto_ids = removerProdutos;
                     method = "PATCH";
                     path = `/api/v1/agent/pedido/${encodeURIComponent(pedidoId)}`;
                     bodyObj = b;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wondai/n8n-nodes-nucleo",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Node n8n para o Núcleo Wondai — atendimento de IA (cliente, catálogo fuzzy, pedidos) com assinatura HMAC v1. Tenant vem do token (a parede, ADR-013).",
   "keywords": [
     "n8n-community-node-package",