@wondai/n8n-nodes-nucleo 0.5.4 → 0.5.6

package/README.md

@@ -32,6 +32,34 @@ parede. Isso mantém o segredo fora do workflow, a lógica num lugar só e o tok
 **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`).
+Produtos configuráveis também devolvem `regras_compra`. O agente deve coletar as opções
+obrigatórias e enviá-las em `itens[].configuracao`; o Núcleo recusa com HTTP 422 qualquer combo
+incompleto, opção inventada, quantidade inválida, prazo impossível ou personalização proibida.
+
+Exemplo de item configurável:
+
+```json
+{
+  "produto_id": "uuid-do-produto",
+  "quantidade": 1,
+  "configuracao": {
+    "opcoes": [
+      {
+        "grupo_id": "uuid-do-grupo",
+        "opcao_id": "uuid-da-opcao"
+      }
+    ]
+  }
+}
+```
+
+O node não interpreta essas regras: ele encaminha o JSON sem alteração. A validação e o snapshot
+imutável do contrato aplicado pertencem à API do Núcleo (ADR-035).
+
+A partir da v0.5.6, `Pedido Criar` falha antes da requisição quando `itens` está vazio ou quando
+alguma linha não traz `produto_id`/`alias` e `quantidade` positiva. É uma proteção de integração:
+o Núcleo continua sendo a autoridade final das regras, mas o workflow não envia pedido vazio por
+erro de tool schema.
 
 **Disponibilidade na Rede** ("tem na outra loja?") é exposta como **tool** do AI Agent, mas com regra
 estrita no prompt: **usar SÓ quando o cliente pedir explicitamente outra unidade**. Passe o `produto_id`

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

@@ -86,6 +86,29 @@ function asArray(value) {
     }
     return [];
 }
+function hasPedidoItemIdentifier(item) {
+    const produtoId = String(item.produto_id ?? "").trim();
+    const alias = String(item.alias ?? "").trim();
+    return Boolean(produtoId || alias);
+}
+function hasPositiveQuantidade(item) {
+    const quantidade = Number(item.quantidade);
+    return Number.isFinite(quantidade) && quantidade > 0;
+}
+function assertPedidoCriarItens(itens) {
+    if (!Array.isArray(itens) || itens.length === 0) {
+        throw new Error("Pedido Criar bloqueado: o campo itens precisa ser um array JSON não vazio com produto_id ou alias e quantidade. Resolva o catálogo e envie os itens estruturados antes de criar o pedido.");
+    }
+    const invalidIndex = itens.findIndex((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            return true;
+        const itemObject = item;
+        return !hasPedidoItemIdentifier(itemObject) || !hasPositiveQuantidade(itemObject);
+    });
+    if (invalidIndex >= 0) {
+        throw new Error(`Pedido Criar bloqueado: itens[${invalidIndex}] precisa ter produto_id ou alias e quantidade positiva.`);
+    }
+}
 /** Lê um parâmetro JSON (string ou objeto) como objeto simples. Vazio → null. */
 function asObject(value) {
     if (value && typeof value === "object" && !Array.isArray(value))
@@ -189,7 +212,7 @@ class Nucleo {
                             name: "Resolver Produtos",
                             value: "resolver",
                             action: "Resolver produtos do catálogo",
-                            description: "Busca vários produtos numa chamada — tolera erro de digitação e apelidos",
+                            description: "Busca vários produtos numa chamada, tolera erro de digitação e apelidos e devolve regras_compra quando houver escolhas, limites ou restrições obrigatórias",
                         },
                         {
                             name: "Disponibilidade Na Rede",
@@ -319,7 +342,7 @@ class Nucleo {
                     default: "",
                     required: true,
                     placeholder: "banofe, pão francês, coxinha",
-                    description: "Produtos a buscar: um por linha ou separados por vírgula (máx 10). Aceita erro de digitação, falta de acento e apelidos. Ex: 'banofe, pão francês'.",
+                    description: "Produtos a buscar: um por linha ou separados por vírgula (máx 10). Aceita erro de digitação, falta de acento e apelidos. Para produto configurável, use regras_compra como fonte da verdade e colete todas as opções obrigatórias antes de criar o pedido.",
                     displayOptions: { show: { resource: ["catalogo"], operation: ["resolver"] } },
                 },
                 // ----------------------------------------------------------------- catalogo:disponibilidadeRede
@@ -385,7 +408,7 @@ class Nucleo {
                     type: "json",
                     default: "[]",
                     required: true,
-                    description: 'Array de itens. Cada item: {"produto_id" OU "alias", "variacao_id"?, "quantidade", "personalizacao"?}. Ex: [{"alias":"paozinho","quantidade":6},{"produto_id":"...","quantidade":1}]',
+                    description: 'Array de itens. Cada item: {"produto_id" OU "alias", "variacao_id"?, "quantidade", "personalizacao"?, "configuracao"?}. Para produto configurável, copie somente escolhas devolvidas em regras_compra: {"configuracao":{"opcoes":[{"grupo_id":"uuid","opcao_id":"uuid"}],"quantidade_referencia":100,"confirmacao_humana":true}}. A API recusa combo incompleto ou opção inventada com 422.',
                     displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
                 },
                 {
@@ -531,7 +554,7 @@ class Nucleo {
                     name: "adicionarItens",
                     type: "json",
                     default: "[]",
-                    description: "Mesma forma de Itens. Vazio = não adiciona.",
+                    description: "Mesma forma de Itens, incluindo configuracao para escolhas obrigatórias retornadas em regras_compra. Vazio = não adiciona; item incompleto é recusado com 422.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
                 },
                 {
@@ -884,6 +907,7 @@ class Nucleo {
                     const telefone = this.getNodeParameter("telefone", i).trim();
                     const nomeCliente = this.getNodeParameter("nomeCliente", i, "").trim();
                     const itens = asArray(this.getNodeParameter("itens", i));
+                    assertPedidoCriarItens(itens);
                     const tipoEntrega = this.getNodeParameter("tipoEntrega", i);
                     const observacoes = this.getNodeParameter("observacoes", i, "").trim();
                     const agendadoPara = this.getNodeParameter("agendadoPara", i, "").trim();

package/package.json

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