whatsapp-docs-mcp 1.0.0 → 1.0.2

package/dist/utils/search.test.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const search_1 = require("./search");
+(0, vitest_1.describe)('normalizeText', () => {
+    (0, vitest_1.it)('deve remover acentos de texto', () => {
+        (0, vitest_1.expect)((0, search_1.normalizeText)('áudio')).toBe('audio');
+        (0, vitest_1.expect)((0, search_1.normalizeText)('ÁUDIO')).toBe('audio');
+        (0, vitest_1.expect)((0, search_1.normalizeText)('mensagem')).toBe('mensagem');
+        (0, vitest_1.expect)((0, search_1.normalizeText)('Mensagem')).toBe('mensagem');
+    });
+    (0, vitest_1.it)('deve converter para minúsculas', () => {
+        (0, vitest_1.expect)((0, search_1.normalizeText)('AUDIO')).toBe('audio');
+        (0, vitest_1.expect)((0, search_1.normalizeText)('Audio')).toBe('audio');
+    });
+    (0, vitest_1.it)('deve tratar textos com e sem acentos como iguais', () => {
+        (0, vitest_1.expect)((0, search_1.normalizeText)('áudio')).toBe((0, search_1.normalizeText)('audio'));
+        (0, vitest_1.expect)((0, search_1.normalizeText)('Mensagem')).toBe((0, search_1.normalizeText)('mensagem'));
+    });
+});
+(0, vitest_1.describe)('searchInContent', () => {
+    const sampleContent = 'É possível usar a API para enviar mensagens de voz e mensagens de áudio básicas.';
+    (0, vitest_1.it)('deve encontrar query simples no conteúdo', () => {
+        (0, vitest_1.expect)((0, search_1.searchInContent)(sampleContent, 'áudio')).toBe(true);
+        (0, vitest_1.expect)((0, search_1.searchInContent)(sampleContent, 'audio')).toBe(true);
+        (0, vitest_1.expect)((0, search_1.searchInContent)(sampleContent, 'mensagens')).toBe(true);
+    });
+    (0, vitest_1.it)('deve encontrar query no nome do arquivo', () => {
+        const filePath = 'mensagens/tipos_de_mensagens/audio_messages.md';
+        (0, vitest_1.expect)((0, search_1.searchInContent)('conteúdo qualquer', 'audio', filePath)).toBe(true);
+        (0, vitest_1.expect)((0, search_1.searchInContent)('conteúdo qualquer', 'áudio', filePath)).toBe(true);
+    });
+    (0, vitest_1.it)('deve encontrar múltiplas palavras (AND)', () => {
+        const content = 'mensagens de áudio podem ser enviadas';
+        // "audio" e "mensagens" estão ambas no conteúdo
+        (0, vitest_1.expect)((0, search_1.searchInContent)(content, 'audio mensagens')).toBe(true);
+        (0, vitest_1.expect)((0, search_1.searchInContent)(content, 'mensagens audio')).toBe(true);
+        // "video" não está no conteúdo
+        (0, vitest_1.expect)((0, search_1.searchInContent)(content, 'video mensagens')).toBe(false);
+    });
+    (0, vitest_1.it)('deve retornar false quando não encontra', () => {
+        (0, vitest_1.expect)((0, search_1.searchInContent)(sampleContent, 'vídeo')).toBe(false);
+        (0, vitest_1.expect)((0, search_1.searchInContent)(sampleContent, 'imagem')).toBe(false);
+    });
+    (0, vitest_1.it)('deve ignorar palavras muito curtas', () => {
+        const content = 'teste de busca';
+        // Palavras com menos de 3 caracteres são ignoradas
+        (0, vitest_1.expect)((0, search_1.searchInContent)(content, 'de')).toBe(true); // Mas ainda busca a string completa
+    });
+});
+(0, vitest_1.describe)('calculateRelevance', () => {
+    const sampleContent = `# Mensagens de áudio
+
+É possível usar a API para enviar mensagens de voz e mensagens de áudio básicas.
+As mensagens de áudio são suportadas pela API.`;
+    (0, vitest_1.it)('deve dar alta relevância quando encontra no nome do arquivo', () => {
+        const filePath = 'mensagens/tipos_de_mensagens/audio_messages.md';
+        const relevance = (0, search_1.calculateRelevance)(sampleContent, 'audio', filePath);
+        (0, vitest_1.expect)(relevance).toBeGreaterThan(50);
+    });
+    (0, vitest_1.it)('deve dar relevância quando encontra no título', () => {
+        const relevance = (0, search_1.calculateRelevance)(sampleContent, 'áudio', 'outro_arquivo.md');
+        (0, vitest_1.expect)(relevance).toBeGreaterThan(30);
+    });
+    (0, vitest_1.it)('deve dar maior relevância para queries mais relevantes', () => {
+        const filePath = 'mensagens/tipos_de_mensagens/audio_messages.md';
+        const relevanceAudio = (0, search_1.calculateRelevance)(sampleContent, 'audio', filePath);
+        const relevanceVideo = (0, search_1.calculateRelevance)(sampleContent, 'video', filePath);
+        (0, vitest_1.expect)(relevanceAudio).toBeGreaterThan(relevanceVideo);
+    });
+    (0, vitest_1.it)('deve retornar 0 para conteúdo não relacionado', () => {
+        const content = 'Conteúdo sobre vídeos e imagens';
+        const relevance = (0, search_1.calculateRelevance)(content, 'audio', 'outro.md');
+        (0, vitest_1.expect)(relevance).toBe(0);
+    });
+    (0, vitest_1.it)('deve considerar múltiplas ocorrências', () => {
+        const content = 'áudio áudio áudio áudio';
+        const relevance = (0, search_1.calculateRelevance)(content, 'audio', 'test.md');
+        (0, vitest_1.expect)(relevance).toBeGreaterThan(0);
+    });
+});
+(0, vitest_1.describe)('extractTitle', () => {
+    (0, vitest_1.it)('deve extrair título H1', () => {
+        const content = '# Título Principal\n\nConteúdo aqui';
+        (0, vitest_1.expect)((0, search_1.extractTitle)(content, 'test.md')).toBe('Título Principal');
+    });
+    (0, vitest_1.it)('deve extrair título H2 se não houver H1', () => {
+        const content = '## Título Secundário\n\nConteúdo aqui';
+        (0, vitest_1.expect)((0, search_1.extractTitle)(content, 'test.md')).toBe('Título Secundário');
+    });
+    (0, vitest_1.it)('deve usar nome do arquivo como fallback', () => {
+        const content = 'Conteúdo sem título';
+        (0, vitest_1.expect)((0, search_1.extractTitle)(content, 'audio_messages.md')).toBe('audio messages');
+    });
+    (0, vitest_1.it)('deve normalizar nome do arquivo', () => {
+        const content = 'Conteúdo sem título';
+        (0, vitest_1.expect)((0, search_1.extractTitle)(content, 'tipos-de-mensagens.md')).toBe('tipos de mensagens');
+    });
+});
+(0, vitest_1.describe)('extractExcerpt', () => {
+    const content = `Linha 1
+Linha 2
+Linha 3 com áudio
+Linha 4
+Linha 5`;
+    (0, vitest_1.it)('deve extrair trecho ao redor da busca', () => {
+        const excerpt = (0, search_1.extractExcerpt)(content, 'áudio');
+        (0, vitest_1.expect)(excerpt).toContain('áudio');
+        (0, vitest_1.expect)(excerpt.split('\n').length).toBeGreaterThan(1);
+    });
+    (0, vitest_1.it)('deve encontrar com normalização', () => {
+        const excerpt = (0, search_1.extractExcerpt)(content, 'audio');
+        (0, vitest_1.expect)(excerpt).toContain('áudio');
+    });
+    (0, vitest_1.it)('deve limitar tamanho do excerpt', () => {
+        const longContent = 'a\n'.repeat(200) + 'linha com audio\n' + 'b\n'.repeat(200);
+        const excerpt = (0, search_1.extractExcerpt)(longContent, 'audio');
+        (0, vitest_1.expect)(excerpt.length).toBeLessThanOrEqual(303); // 300 + '...'
+    });
+    (0, vitest_1.it)('deve retornar primeiras linhas como fallback', () => {
+        const contentWithoutMatch = 'Linha 1\nLinha 2\nLinha 3';
+        const excerpt = (0, search_1.extractExcerpt)(contentWithoutMatch, 'xyz');
+        (0, vitest_1.expect)(excerpt.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=search.test.js.map

package/dist/utils/search.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.test.js","sourceRoot":"","sources":["../../src/utils/search.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whatsapp-docs-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server for WhatsApp Business API documentation - Access comprehensive WhatsApp Business API docs through Model Context Protocol",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,7 +11,11 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsx watch src/index.ts",
-    "prepublishOnly": "npm run build"
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm run test:run"
   },
   "keywords": [
     "mcp",
@@ -44,7 +48,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
+    "@vitest/ui": "^4.0.16",
+    "tsx": "^4.7.0",
     "typescript": "^5.3.3",
-    "tsx": "^4.7.0"
+    "vitest": "^4.0.16"
   }
 }