n8n-nodes-confirm8 0.20.0 → 0.21.0

package/dist/nodes/Confirm8Tool/Confirm8AgentTool.node.d.ts

@@ -1,5 +1,9 @@
 import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
 export declare class Confirm8AgentTool implements INodeType {
     description: INodeTypeDescription;
+    /**
+     * Parse natural date queries into filter JSON
+     */
+    private parseDateQuery;
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

package/dist/nodes/Confirm8Tool/Confirm8AgentTool.node.js

@@ -10,7 +10,7 @@ class Confirm8AgentTool {
             icon: 'file:tool.svg',
             group: ['transform'],
             version: 1,
-            description: 'AI Agent tool for Confirm8 API with relations and filters support',
+            description: 'AI tool for Confirm8. IMPORTANT: For "OS/ordem de serviço" use resource="order". For dates use filters with start_date/end_date. Example: {"start_date":{"gte":"2025-11-23"},"end_date":{"lte":"2025-11-25"}}',
             defaults: {
                 name: 'Confirm8 AI Tool',
             },
@@ -56,60 +56,126 @@ class Confirm8AgentTool {
                     name: 'resource',
                     type: 'options',
                     options: [
-                        { name: 'User', value: 'user', description: 'Users/employees' },
-                        { name: 'Client', value: 'client', description: 'Clients/customers' },
-                        { name: 'Item', value: 'item', description: 'Items/inventory' },
-                        { name: 'Item Type', value: 'itemType', description: 'Item categories' },
-                        { name: 'Task', value: 'task', description: 'Tasks/checklists' },
-                        { name: 'Service', value: 'service', description: 'Services' },
-                        { name: 'Product', value: 'product', description: 'Products' },
-                        { name: 'Order', value: 'order', description: 'Work orders' },
-                        { name: 'Modality', value: 'modality', description: 'Order modalities' },
-                        { name: 'Ticket', value: 'ticket', description: 'Tickets' },
-                        { name: 'Property', value: 'property', description: 'Properties' },
+                        { name: 'User', value: 'user', description: 'Users/Employees/Funcionários' },
+                        { name: 'Client', value: 'client', description: 'Clients/Customers/Clientes' },
+                        { name: 'Item', value: 'item', description: 'Items/Itens' },
+                        { name: 'Item Type', value: 'itemType', description: 'Item Types/Tipos' },
+                        { name: 'Task', value: 'task', description: 'Tasks/Tarefas/Checklists' },
+                        { name: 'Service', value: 'service', description: 'Services/Serviços' },
+                        { name: 'Product', value: 'product', description: 'Products/Produtos' },
+                        { name: 'Order (OS)', value: 'order', description: 'Work Orders/OS/Ordens de Serviço/WOS' },
+                        { name: 'Modality', value: 'modality', description: 'Modalities/Modalidades' },
+                        { name: 'Ticket', value: 'ticket', description: 'Tickets/Chamados' },
+                        { name: 'Property', value: 'property', description: 'Properties/Propriedades' },
                     ],
                     default: 'user',
-                    description: 'Resource type',
+                    description: 'CRITICAL: For "OS" or "ordem de serviço" ALWAYS use "order"',
                 },
                 {
                     displayName: 'Operation',
                     name: 'operation',
                     type: 'options',
                     options: [
-                        { name: 'Get All', value: 'getAll', description: 'List all records' },
-                        { name: 'Get', value: 'get', description: 'Get single record' },
-                        { name: 'Create', value: 'create', description: 'Create new record' },
-                        { name: 'Update', value: 'update', description: 'Update record' },
-                        { name: 'Activate', value: 'activate', description: 'Activate record' },
-                        { name: 'Deactivate', value: 'deactivate', description: 'Deactivate record' },
+                        { name: 'Get All (List)', value: 'getAll', description: 'List/Listar/Buscar todos/Mostrar todos' },
+                        { name: 'Get (Single)', value: 'get', description: 'Get one/Buscar um/Obter' },
+                        { name: 'Create', value: 'create', description: 'Create/Criar/Adicionar' },
+                        { name: 'Update', value: 'update', description: 'Update/Atualizar/Modificar' },
+                        { name: 'Activate', value: 'activate', description: 'Activate/Ativar' },
+                        { name: 'Deactivate', value: 'deactivate', description: 'Deactivate/Desativar' },
                     ],
                     default: 'getAll',
-                    description: 'Operation to perform',
+                    description: 'CRITICAL: To list/search use "getAll"',
                 },
                 {
                     displayName: 'Record ID',
                     name: 'recordId',
                     type: 'string',
                     default: '',
-                    description: 'ID of record',
+                    description: 'Record ID (only for get/update/activate/deactivate)',
                 },
                 {
                     displayName: 'Data',
                     name: 'data',
                     type: 'string',
                     default: '',
-                    description: 'JSON data for create/update',
+                    description: 'JSON data (only for create/update)',
                 },
                 {
                     displayName: 'Filters',
                     name: 'filters',
                     type: 'string',
                     default: '',
-                    description: 'Filters as JSON object. Example: {"start_date":{"gte":"2025-11-23"},"status":{"eq":"complete"}}',
+                    description: 'Filters as JSON. For dates: {"start_date":{"gte":"YYYY-MM-DD"},"end_date":{"lte":"YYYY-MM-DD"}}. For status: {"status":{"eq":"complete"}}',
                 },
             ],
         };
     }
+    /**
+     * Parse natural date queries into filter JSON
+     */
+    parseDateQuery(query) {
+        const now = new Date();
+        const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+        query = query.toLowerCase().trim();
+        // Helper to format date as YYYY-MM-DD
+        const formatDate = (date) => {
+            return date.toISOString().split('T')[0];
+        };
+        // Today
+        if (query.includes('hoje') || query.includes('today')) {
+            const endOfDay = new Date(today);
+            endOfDay.setHours(23, 59, 59, 999);
+            return {
+                start_date: { gte: formatDate(today) },
+                end_date: { lte: formatDate(endOfDay) }
+            };
+        }
+        // This week / semana atual
+        if (query.includes('semana') || query.includes('week')) {
+            const dayOfWeek = today.getDay();
+            const diff = dayOfWeek === 0 ? -6 : 1 - dayOfWeek; // Monday is start
+            const weekStart = new Date(today);
+            weekStart.setDate(today.getDate() + diff);
+            const weekEnd = new Date(weekStart);
+            weekEnd.setDate(weekStart.getDate() + 6);
+            return {
+                start_date: { gte: formatDate(weekStart) },
+                end_date: { lte: formatDate(weekEnd) }
+            };
+        }
+        // This month / mês atual
+        if (query.includes('mês') || query.includes('mes') || query.includes('month')) {
+            const monthStart = new Date(now.getFullYear(), now.getMonth(), 1);
+            const monthEnd = new Date(now.getFullYear(), now.getMonth() + 1, 0);
+            return {
+                start_date: { gte: formatDate(monthStart) },
+                end_date: { lte: formatDate(monthEnd) }
+            };
+        }
+        // Last N days
+        const lastDaysMatch = query.match(/últimos?\s+(\d+)\s+dias?|last\s+(\d+)\s+days?/);
+        if (lastDaysMatch) {
+            const days = parseInt(lastDaysMatch[1] || lastDaysMatch[2]);
+            const startDate = new Date(today);
+            startDate.setDate(today.getDate() - days);
+            return {
+                start_date: { gte: formatDate(startDate) },
+                end_date: { lte: formatDate(today) }
+            };
+        }
+        // Next N days
+        const nextDaysMatch = query.match(/próximos?\s+(\d+)\s+dias?|next\s+(\d+)\s+days?/);
+        if (nextDaysMatch) {
+            const days = parseInt(nextDaysMatch[1] || nextDaysMatch[2]);
+            const endDate = new Date(today);
+            endDate.setDate(today.getDate() + days);
+            return {
+                start_date: { gte: formatDate(today) },
+                end_date: { lte: formatDate(endDate) }
+            };
+        }
+        return null;
+    }
     async execute() {
         const items = this.getInputData();
         const returnData = [];
@@ -138,39 +204,110 @@ class Confirm8AgentTool {
                 const filtersParam = this.getNodeParameter('filters', i, '');
                 if (filtersParam) {
                     try {
+                        // Try to parse as JSON first
                         filters = JSON.parse(filtersParam);
                     }
                     catch (e) {
-                        // Ignore
+                        // If not JSON, try to parse as natural language date query
+                        const parsedDate = this.parseDateQuery(filtersParam);
+                        if (parsedDate) {
+                            filters = parsedDate;
+                        }
                     }
                 }
-                // Normalize variations
+                // Aggressive normalization - EXPAND THIS
                 const resourceMap = {
-                    'users': 'user', 'usuarios': 'user', 'usuários': 'user', 'employees': 'user',
+                    // Standard
+                    'users': 'user', 'usuarios': 'user', 'usuários': 'user', 'employees': 'user', 'funcionários': 'user', 'funcionarios': 'user',
                     'clients': 'client', 'clientes': 'client', 'customers': 'client',
                     'items': 'item', 'itens': 'item',
                     'itemtypes': 'itemType', 'tipos': 'itemType',
                     'tasks': 'task', 'tarefas': 'task',
                     'services': 'service', 'serviços': 'service', 'servicos': 'service',
                     'products': 'product', 'produtos': 'product',
-                    'orders': 'order', 'ordens': 'order', 'wos': 'order',
                     'modalities': 'modality', 'modalidades': 'modality',
                     'tickets': 'ticket', 'chamados': 'ticket',
                     'properties': 'property', 'propriedades': 'property',
+                    // CRITICAL: OS mappings
+                    'os': 'order',
+                    'o.s': 'order',
+                    'o.s.': 'order',
+                    'orders': 'order',
+                    'ordens': 'order',
+                    'ordem': 'order',
+                    'ordem de serviço': 'order',
+                    'ordem de servico': 'order',
+                    'ordens de serviço': 'order',
+                    'ordens de servico': 'order',
+                    'wos': 'order',
+                    'work order': 'order',
+                    'work orders': 'order',
+                    'pedidos': 'order',
+                    'pedido': 'order',
                 };
                 const operationMap = {
-                    'list': 'getAll', 'listar': 'getAll', 'mostrar': 'getAll',
-                    'buscar todos': 'getAll', 'busque': 'getAll',
-                    'criar': 'create', 'adicionar': 'create',
-                    'atualizar': 'update', 'modificar': 'update',
-                    'ativar': 'activate', 'desativar': 'deactivate',
+                    // List/Get All
+                    'list': 'getAll',
+                    'listar': 'getAll',
+                    'mostrar': 'getAll',
+                    'buscar': 'getAll',
+                    'busque': 'getAll',
+                    'buscar todos': 'getAll',
+                    'buscar todas': 'getAll',
+                    'buscar todo': 'getAll',
+                    'buscar toda': 'getAll',
+                    'get all': 'getAll',
+                    'show all': 'getAll',
+                    'list all': 'getAll',
+                    'todos': 'getAll',
+                    'todas': 'getAll',
+                    'obter todos': 'getAll',
+                    'obter todas': 'getAll',
+                    'pegar todos': 'getAll',
+                    'pegar todas': 'getAll',
+                    // Get Single
+                    'obter': 'get',
+                    'pegar': 'get',
+                    'ver': 'get',
+                    'visualizar': 'get',
+                    // Create
+                    'criar': 'create',
+                    'adicionar': 'create',
+                    'add': 'create',
+                    'novo': 'create',
+                    'nova': 'create',
+                    'new': 'create',
+                    // Update
+                    'atualizar': 'update',
+                    'modificar': 'update',
+                    'modify': 'update',
+                    'editar': 'update',
+                    'edit': 'update',
+                    // Activate/Deactivate
+                    'ativar': 'activate',
+                    'enable': 'activate',
+                    'habilitar': 'activate',
+                    'desativar': 'deactivate',
+                    'disable': 'deactivate',
+                    'desabilitar': 'deactivate',
                 };
-                resource = resourceMap[resource.toLowerCase().trim()] || resource;
-                operation = operationMap[operation.toLowerCase().trim()] || operation;
-                if (!resource || !operation) {
-                    throw new Error('Resource and operation are required');
+                // Normalize - clean and map
+                const cleanResource = resource.toLowerCase().trim().replace(/\s+/g, ' ');
+                const cleanOperation = operation.toLowerCase().trim().replace(/\s+/g, ' ');
+                resource = resourceMap[cleanResource] || resource;
+                operation = operationMap[cleanOperation] || operation;
+                // If still not valid, throw clear error
+                const validResources = ['user', 'client', 'item', 'itemType', 'task', 'service', 'product', 'order', 'modality', 'ticket', 'property'];
+                const validOperations = ['getAll', 'get', 'create', 'update', 'activate', 'deactivate'];
+                if (!validResources.includes(resource)) {
+                    throw new Error(`Invalid resource: "${resource}". Must be one of: ${validResources.join(', ')}. ` +
+                        `For OS/Ordem de Serviço use "order".`);
+                }
+                if (!validOperations.includes(operation)) {
+                    throw new Error(`Invalid operation: "${operation}". Must be one of: ${validOperations.join(', ')}. ` +
+                        `To list/search use "getAll".`);
                 }
-                // Map to endpoints with relations
+                // Resource config with relations
                 const resourceConfig = {
                     user: {
                         endpoint: 'users',
@@ -218,14 +355,11 @@ class Confirm8AgentTool {
                     },
                 };
                 const config = resourceConfig[resource];
-                if (!config) {
-                    throw new Error(`Unknown resource: ${resource}`);
-                }
                 const baseEndpoint = config.endpoint;
                 let endpoint = '';
                 let method = 'GET';
                 let body = {};
-                // Build endpoint based on operation
+                // Build endpoint
                 switch (operation) {
                     case 'getAll':
                         endpoint = `/v3/${baseEndpoint}`;
@@ -261,12 +395,10 @@ class Confirm8AgentTool {
                         method = ['client', 'item', 'itemType', 'task', 'service', 'product', 'order', 'modality'].includes(resource)
                             ? 'PUT' : 'PATCH';
                         break;
-                    default:
-                        throw new Error(`Unknown operation: ${operation}`);
                 }
                 // Build query string
                 const queryParams = [];
-                // Add relations (only for GET operations)
+                // Add relations (only GET)
                 if (method === 'GET' && config.relations.length > 0) {
                     config.relations.forEach(relation => {
                         queryParams.push(`relations=${relation}`);
@@ -282,7 +414,7 @@ class Confirm8AgentTool {
                         });
                     });
                 }
-                // Construct full URL
+                // Full URL
                 let fullUrl = `${baseUrl}${endpoint}`;
                 if (queryParams.length > 0) {
                     fullUrl += '?' + queryParams.join('&');
@@ -306,6 +438,12 @@ class Confirm8AgentTool {
                 returnData.push({
                     json: {
                         success: true,
+                        normalized: {
+                            originalResource: this.getNodeParameter('resource', i, ''),
+                            originalOperation: this.getNodeParameter('operation', i, ''),
+                            normalizedResource: resource,
+                            normalizedOperation: operation,
+                        },
                         operation,
                         resource,
                         endpoint,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-confirm8",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Simple n8n node for Confirm8 API - no credentials needed",
   "license": "MIT",
   "author": "Bill Hebert",