@wondai/n8n-nodes-nucleo 0.6.5 → 0.8.0

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Nucleo = void 0;
 const node_crypto_1 = require("node:crypto");
 const n8n_workflow_1 = require("n8n-workflow");
+const quote_contract_1 = require("./quote-contract");
 /**
  * Node Núcleo Wondai — satélite de IA → Núcleo (ADR-003/013/015/016).
  *
@@ -63,8 +64,11 @@ function parseConsultas(raw, max = 10) {
             continue;
         seen.add(k);
         out.push(s);
-        if (out.length >= max)
-            break;
+    }
+    // Plano 030: rejeicao EXPLICITA acima do limite. O break silencioso descartava consultas
+    // (incidente 65144: 4 consultas perdidas), produzindo resultado parcial com aparencia de sucesso.
+    if (out.length > max) {
+        throw new Error(`Catalogo Resolver: ${out.length} consultas acima do limite de ${max}. Envie no maximo ${max} consultas de PRODUTO por chamada; adicionais e opcoes ja resolvidos nao sao novas consultas.`);
     }
     return out;
 }
@@ -268,9 +272,96 @@ class Nucleo {
                             action: "Anexar foto-referência ao pedido",
                             description: "Anexa a FOTO que o cliente mandou no WhatsApp (a decoração que ele quer) ao pedido — a imagem literal, não uma descrição. Recebe base64 (data-URL ou puro + mime). Idempotente pelo messageID.",
                         },
+                        {
+                            name: "Cotar",
+                            value: "cotar",
+                            action: "Cotar pedido (cotação canônica)",
+                            description: "Gera a COTAÇÃO CANÔNICA do Núcleo (preço/quantidade/config oficiais; nada de texto) e a persiste como pending. Use os mesmos itens estruturados de Criar.",
+                        },
+                        {
+                            name: "Validar Cotação (Dry-Run)",
+                            value: "validarCotacao",
+                            action: "Validar cotação sem escrever (shadow)",
+                            description: "Roda o preparo/precificação e devolve o mesmo shape da cotação com dry_run:true, SEM escrever nada.",
+                        },
+                        {
+                            name: "Marcar Cotação Apresentada",
+                            value: "apresentarCotacao",
+                            action: "Marcar cotação apresentada",
+                            description: "pending -> presented. Chamar SÓ no ramo de sucesso do envio público. Requer cotacao_id e cotacao_version.",
+                        },
+                        {
+                            name: "Consultar Cotação Ativa",
+                            value: "consultarCotacaoAtiva",
+                            action: "Consultar cotação apresentada ativa",
+                            description: "Devolve a cotação presented ativa do cliente (por telefone). Sem cotação apresentada => 404.",
+                        },
+                        {
+                            name: "Confirmar Cotação",
+                            value: "confirmarCotacao",
+                            action: "Confirmar cotação (cria 1 pedido)",
+                            description: "Revalida a cotação por fingerprint e cria exatamente UM pedido (transacional). Divergência => 409 e novo resumo. Requer cotacao_id, cotacao_version e cliente_telefone.",
+                        },
                     ],
                     default: "criar",
                 },
+                {
+                    displayName: "Cotação (Corpo JSON)",
+                    name: "cotacaoBody",
+                    type: "json",
+                    default: "{}",
+                    description: "Corpo da cotação (mesmo formato de Criar): telefone, itens[], tipo_entrega, endereco_entrega, agendado_para, forma_pagamento, taxa_entrega, desconto, cobrancas[], observacoes.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["cotar", "validarCotacao"] } },
+                },
+                {
+                    displayName: "Cotação ID",
+                    name: "cotacaoId",
+                    type: "string",
+                    default: "",
+                    description: "cotacao_id retornado por Cotar (vindo por expressão do workflow, nunca da LLM).",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["apresentarCotacao", "confirmarCotacao"] } },
+                },
+                {
+                    displayName: "Cotação Versão",
+                    name: "cotacaoVersion",
+                    type: "number",
+                    default: 1,
+                    description: "cotacao_version retornado por Cotar.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["apresentarCotacao", "confirmarCotacao"] } },
+                },
+                {
+                    displayName: "Message ID Apresentado",
+                    name: "cotacaoMessageId",
+                    type: "string",
+                    default: "",
+                    description: "ID da mensagem enviada (opcional), para auditoria da apresentação.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["apresentarCotacao"] } },
+                },
+                {
+                    displayName: "Message ID da Cotação",
+                    name: "cotacaoRequestMessageId",
+                    type: "string",
+                    default: "",
+                    required: true,
+                    description: "messageID real do turno. O package combina este valor com o hash do payload para gerar a Idempotency-Key.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["cotar"] } },
+                },
+                {
+                    displayName: "Telefone do Cliente",
+                    name: "cotacaoTelefone",
+                    type: "string",
+                    default: "",
+                    description: "Telefone normalizado, injetado por expressão do workflow.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["consultarCotacaoAtiva", "confirmarCotacao"] } },
+                },
+                {
+                    displayName: "Nome do Cliente",
+                    name: "cotacaoNome",
+                    type: "string",
+                    default: "",
+                    description: "Nome do cliente (opcional).",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["confirmarCotacao"] } },
+                },
                 {
                     displayName: "Operação",
                     name: "operation",
@@ -1446,6 +1537,53 @@ class Nucleo {
                     path = `/api/v1/agent/pedido/${encodeURIComponent(pedidoId)}/anexo`;
                     bodyObj = b;
                 }
+                else if (resource === "pedido" && operation === "cotar") {
+                    const body = asObject(this.getNodeParameter("cotacaoBody", i, "{}")) || {};
+                    (0, quote_contract_1.assertQuoteContract)(body);
+                    const messageId = this.getNodeParameter("cotacaoRequestMessageId", i).trim();
+                    idempotencyKey = (0, quote_contract_1.buildQuoteIdempotencyKey)(tokenId, messageId, body);
+                    method = "POST";
+                    path = "/api/v1/agent/pedido/cotacao";
+                    bodyObj = body;
+                }
+                else if (resource === "pedido" && operation === "validarCotacao") {
+                    const body = asObject(this.getNodeParameter("cotacaoBody", i, "{}")) || {};
+                    (0, quote_contract_1.assertQuoteContract)(body);
+                    method = "POST";
+                    path = "/api/v1/agent/pedido/cotacao/validar";
+                    bodyObj = body;
+                }
+                else if (resource === "pedido" && operation === "apresentarCotacao") {
+                    const cotacaoId = this.getNodeParameter("cotacaoId", i).trim();
+                    const version = Number(this.getNodeParameter("cotacaoVersion", i));
+                    const messageId = this.getNodeParameter("cotacaoMessageId", i, "").trim();
+                    const b = { cotacao_version: version };
+                    if (messageId)
+                        b.presented_message_id = messageId;
+                    method = "POST";
+                    path = `/api/v1/agent/pedido/cotacao/${encodeURIComponent(cotacaoId)}/apresentar`;
+                    bodyObj = b;
+                }
+                else if (resource === "pedido" && operation === "consultarCotacaoAtiva") {
+                    const telefone = this.getNodeParameter("cotacaoTelefone", i).trim();
+                    method = "POST";
+                    path = "/api/v1/agent/pedido/cotacao/ativa";
+                    bodyObj = { telefone };
+                }
+                else if (resource === "pedido" && operation === "confirmarCotacao") {
+                    const cotacaoId = this.getNodeParameter("cotacaoId", i).trim();
+                    const version = Number(this.getNodeParameter("cotacaoVersion", i));
+                    const telefone = this.getNodeParameter("cotacaoTelefone", i).trim();
+                    const nome = this.getNodeParameter("cotacaoNome", i, "").trim();
+                    const b = { cotacao_version: version, cliente_telefone: telefone };
+                    if (nome)
+                        b.cliente_nome = nome;
+                    // Idempotência DETERMINÍSTICA montada pelo package (nunca pela LLM), Plano 030 §9.5.
+                    idempotencyKey = `quote-confirm:${cotacaoId}:${version}`;
+                    method = "POST";
+                    path = `/api/v1/agent/pedido/cotacao/${encodeURIComponent(cotacaoId)}/confirmar`;
+                    bodyObj = b;
+                }
                 else if (resource === "conversa" && operation === "registrar") {
                     const resumo = this.getNodeParameter("resumo", i).trim();
                     const resultado = this.getNodeParameter("resultado", i);

package/dist/nodes/Nucleo/quote-contract.d.ts

@@ -0,0 +1,4 @@
+import type { IDataObject } from "n8n-workflow";
+export declare function canonicalQuotePayload(payload: IDataObject): string;
+export declare function buildQuoteIdempotencyKey(tokenId: string, messageId: string, payload: IDataObject): string;
+export declare function assertQuoteContract(payload: IDataObject): void;

package/dist/nodes/Nucleo/quote-contract.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalQuotePayload = canonicalQuotePayload;
+exports.buildQuoteIdempotencyKey = buildQuoteIdempotencyKey;
+exports.assertQuoteContract = assertQuoteContract;
+const node_crypto_1 = require("node:crypto");
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (!value || typeof value !== "object") {
+        return typeof value === "string" ? value.normalize("NFC") : value;
+    }
+    return Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, child]) => [key, canonicalize(child)]));
+}
+function canonicalQuotePayload(payload) {
+    return JSON.stringify(canonicalize(payload));
+}
+function buildQuoteIdempotencyKey(tokenId, messageId, payload) {
+    const message = messageId.trim();
+    if (!message)
+        throw new Error("Cotar pedido: messageID obrigatorio.");
+    const hash = (0, node_crypto_1.createHash)("sha256")
+        .update(canonicalQuotePayload(payload), "utf8")
+        .digest("hex")
+        .slice(0, 16);
+    return `quote:${tokenId}:${message}:${hash}`;
+}
+function assertQuoteContract(payload) {
+    const items = payload.itens;
+    if (!Array.isArray(items) || items.length === 0 || items.length > 10) {
+        throw new Error("Cotacao: itens precisa conter entre 1 e 10 linhas.");
+    }
+    for (const [index, raw] of items.entries()) {
+        if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+            throw new Error(`Cotacao: itens[${index}] invalido.`);
+        }
+        const item = raw;
+        const informed = item.quantidade_informada;
+        if (!String(item.produto_id ?? "").trim() ||
+            !String(item.consulta_original ?? "").trim() ||
+            !String(item.quantidade_original ?? "").trim() ||
+            !informed ||
+            !Number.isFinite(Number(informed.valor)) ||
+            Number(informed.valor) <= 0 ||
+            !String(informed.unidade ?? "").trim()) {
+            throw new Error(`Cotacao: itens[${index}] exige produto_id, consulta_original, quantidade_original e quantidade_informada.`);
+        }
+    }
+    const charges = Array.isArray(payload.cobrancas) ? payload.cobrancas : [];
+    for (const [index, raw] of charges.entries()) {
+        if (!raw || typeof raw !== "object" || Array.isArray(raw))
+            continue;
+        const charge = raw;
+        if (charge.tipo !== "paid_addon")
+            continue;
+        if (!String(charge.regra_chave ?? "").trim() ||
+            !String(charge.operational_config_revision_id ?? "").trim()) {
+            throw new Error(`Cotacao: cobrancas[${index}] paid_addon exige regra_chave e operational_config_revision_id.`);
+        }
+        if (charge.nome != null || charge.valor != null) {
+            throw new Error(`Cotacao: cobrancas[${index}] nao pode enviar nome ou valor; o Nucleo resolve pela revisao.`);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wondai/n8n-nodes-nucleo",
-  "version": "0.6.5",
+  "version": "0.8.0",
   "description": "Node n8n para o Núcleo Wondai — atendimento de IA multi-vertical (gate liga/desliga, cliente/paciente, catálogo fuzzy, pedidos [padaria], procedimento/agenda/agendamento [odonto], contexto operacional, telemetria) com assinatura HMAC v1. Tenant e vertical vêm do token (a parede, ADR-013/038).",
   "keywords": [
     "n8n-community-node-package",
@@ -25,6 +25,7 @@
   "scripts": {
     "build": "node scripts/build.mjs",
     "dev": "tsc --watch",
+    "test": "node scripts/test.mjs",
     "prepublishOnly": "node scripts/build.mjs"
   },
   "files": [