@nekzus/mcp-server 1.5.4 → 1.5.6

package/dist/index.js

@@ -487,99 +487,96 @@ function isNpmDownloadsData(data) {
         return false;
     }
 }
-async function handleNpmVersions(args) {
-    try {
-        const packagesToProcess = args.packages || [];
-        if (packagesToProcess.length === 0) {
-            throw new Error('No package names provided');
-        }
-        const results = await Promise.all(packagesToProcess.map(async (pkg) => {
-            const response = await fetch(`https://registry.npmjs.org/${pkg}`);
-            if (!response.ok) {
-                return { name: pkg, error: `Failed to fetch package info: ${response.statusText}` };
-            }
-            const rawData = await response.json();
-            if (!isNpmPackageInfo(rawData)) {
-                return { name: pkg, error: 'Invalid package info data received' };
-            }
-            const versions = Object.keys(rawData.versions ?? {}).sort((a, b) => {
-                const [aMajor = 0, aMinor = 0, aPatch = 0] = a.split('.').map(Number);
-                const [bMajor = 0, bMinor = 0, bPatch = 0] = b.split('.').map(Number);
-                if (aMajor !== bMajor)
-                    return aMajor - bMajor;
-                if (aMinor !== bMinor)
-                    return aMinor - bMinor;
-                return aPatch - bPatch;
+export async function handleNpmVersions(args) {
+    const results = await Promise.all(args.packages.map(async (pkg) => {
+        try {
+            const response = await fetch(`https://registry.npmjs.org/${pkg}`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
             });
-            return { name: pkg, versions };
-        }));
-        let text = '';
-        for (const result of results) {
-            if ('error' in result) {
-                text += `❌ ${result.name}: ${result.error}\n\n`;
+            if (!response.ok) {
+                throw new Error(`Failed to fetch package info: ${response.statusText}`);
             }
-            else {
-                text += `📦 Available versions for ${result.name}:\n${result.versions.join('\n')}\n\n`;
+            const data = await response.json();
+            if (!isNpmPackageInfo(data)) {
+                throw new Error('Invalid package info format');
             }
+            const versions = Object.keys(data.versions);
+            const latestVersion = data['dist-tags']?.latest;
+            return {
+                name: pkg,
+                versions,
+                latest: latestVersion,
+                success: true,
+            };
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Error fetching package versions: ${error instanceof Error ? error.message : 'Unknown error'}`,
-                },
-            ],
-            isError: true,
-        };
-    }
+        catch (error) {
+            return {
+                name: pkg,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                success: false,
+            };
+        }
+    }));
+    const content = results.map((result) => ({
+        type: 'text',
+        text: result.success
+            ? `📦 ${result.name}:
+Latest version: ${result.latest}
+Available versions: ${result.versions.join(', ')}`
+            : `❌ Error fetching ${result.name}: ${result.error}`,
+    }));
+    return { content, isError: false };
 }
-async function handleNpmLatest(args) {
-    try {
-        const packages = args.packages || [];
-        let text = '';
-        for (const pkg of packages) {
-            const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`);
+export async function handleNpmLatest(args) {
+    const results = await Promise.all(args.packages.map(async (pkg) => {
+        try {
+            const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
+            });
             if (!response.ok) {
-                throw new Error(`Failed to fetch latest version for ${pkg}: ${response.statusText}`);
+                throw new Error(`Failed to fetch latest version: ${response.statusText}`);
             }
-            const data = (await response.json());
-            text += `📦 Latest version of ${pkg}\n`;
-            text += `Version: ${data.version}\n`;
-            text += `Description: ${data.description || 'No description available'}\n`;
-            text += `Author: ${data.author?.name || 'Unknown'}\n`;
-            text += `License: ${data.license || 'Unknown'}\n`;
-            text += `Homepage: ${data.homepage || 'Not specified'}\n\n`;
-            text += '---\n\n';
+            const data = await response.json();
+            const latestInfo = data;
+            return {
+                name: pkg,
+                version: latestInfo.version,
+                description: latestInfo.description,
+                author: latestInfo.author?.name,
+                license: latestInfo.license,
+                homepage: latestInfo.homepage,
+                success: true,
+            };
         }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text,
-                },
-            ],
-            isError: false,
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Error fetching latest version: ${error instanceof Error ? error.message : 'Unknown error'}`,
-                },
-            ],
-            isError: true,
-        };
-    }
+        catch (err) {
+            return {
+                name: pkg,
+                error: err instanceof Error ? err.message : 'Unknown error',
+                success: false,
+            };
+        }
+    }));
+    const content = results.map((result) => ({
+        type: 'text',
+        text: result.success
+            ? `📦 Latest version of ${result.name}:
+Version: ${result.version}
+Description: ${result.description || 'No description available'}
+Author: ${result.author || 'Unknown'}
+License: ${result.license || 'Unknown'}
+Homepage: ${result.homepage || 'Not specified'}
+---`
+            : `❌ Error fetching latest version for ${result.name}: ${result.error}`,
+    }));
+    return { content, isError: false };
 }
-async function handleNpmDeps(args) {
+export async function handleNpmDeps(args) {
     try {
         const packagesToProcess = args.packages || [];
         if (packagesToProcess.length === 0) {
@@ -587,7 +584,12 @@ async function handleNpmDeps(args) {
         }
         const results = await Promise.all(packagesToProcess.map(async (pkg) => {
             try {
-                const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`);
+                const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
+                    headers: {
+                        Accept: 'application/json',
+                        'User-Agent': 'NPM-Sentinel-MCP',
+                    },
+                });
                 if (!response.ok) {
                     return { name: pkg, error: `Failed to fetch package info: ${response.statusText}` };
                 }
@@ -637,10 +639,7 @@ async function handleNpmDeps(args) {
             }
             text += '---\n\n';
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -654,10 +653,15 @@ async function handleNpmDeps(args) {
         };
     }
 }
-async function handleNpmTypes(args) {
+export async function handleNpmTypes(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
-            const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`);
+            const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
+            });
             if (!response.ok) {
                 throw new Error(`Failed to fetch package info: ${response.statusText}`);
             }
@@ -669,7 +673,12 @@ async function handleNpmTypes(args) {
                 text += `Types path: ${data.types || data.typings}\n`;
             }
             const typesPackage = `@types/${pkg.replace('@', '').replace('/', '__')}`;
-            const typesResponse = await fetch(`https://registry.npmjs.org/${typesPackage}/latest`).catch(() => null);
+            const typesResponse = await fetch(`https://registry.npmjs.org/${typesPackage}/latest`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
+            }).catch(() => null);
             if (typesResponse?.ok) {
                 const typesData = (await typesResponse.json());
                 text += `📦 DefinitelyTyped package available: ${typesPackage}@${typesData.version}\n`;
@@ -687,10 +696,7 @@ async function handleNpmTypes(args) {
                 text += '---\n\n';
             }
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -701,14 +707,19 @@ async function handleNpmTypes(args) {
         };
     }
 }
-async function handleNpmSize(args) {
+export async function handleNpmSize(args) {
     try {
         const packagesToProcess = args.packages || [];
         if (packagesToProcess.length === 0) {
             throw new Error('No package names provided');
         }
         const results = await Promise.all(packagesToProcess.map(async (pkg) => {
-            const response = await fetch(`https://bundlephobia.com/api/size?package=${pkg}`);
+            const response = await fetch(`https://bundlephobia.com/api/size?package=${pkg}`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
+            });
             if (!response.ok) {
                 return { name: pkg, error: `Failed to fetch package size: ${response.statusText}` };
             }
@@ -734,10 +745,7 @@ async function handleNpmSize(args) {
                 text += `Dependencies: ${result.dependencyCount}\n\n`;
             }
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -751,7 +759,7 @@ async function handleNpmSize(args) {
         };
     }
 }
-async function handleNpmVulnerabilities(args) {
+export async function handleNpmVulnerabilities(args) {
     try {
         const packagesToProcess = args.packages || [];
         if (packagesToProcess.length === 0) {
@@ -802,10 +810,7 @@ async function handleNpmVulnerabilities(args) {
             }
             text += '---\n\n';
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -819,16 +824,24 @@ async function handleNpmVulnerabilities(args) {
         };
     }
 }
-async function handleNpmTrends(args) {
+export async function handleNpmTrends(args) {
     try {
-        const period = args.period || 'last-month';
+        // Si period es undefined, vacío o inválido, usar el valor por defecto
+        const period = args.period && ['last-week', 'last-month', 'last-year'].includes(args.period)
+            ? args.period
+            : 'last-month';
         const periodDays = {
             'last-week': 7,
             'last-month': 30,
             'last-year': 365,
         };
         const results = await Promise.all(args.packages.map(async (pkg) => {
-            const response = await fetch(`https://api.npmjs.org/downloads/point/${period}/${pkg}`);
+            const response = await fetch(`https://api.npmjs.org/downloads/point/${period}/${pkg}`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
+            });
             if (!response.ok) {
                 return {
                     name: pkg,
@@ -871,10 +884,7 @@ async function handleNpmTrends(args) {
         }, 0);
         text += `Total downloads across all packages: ${totalDownloads.toLocaleString()}\n`;
         text += `Average daily downloads across all packages: ${Math.round(totalDownloads / periodDays[period]).toLocaleString()}\n`;
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -885,7 +895,7 @@ async function handleNpmTrends(args) {
         };
     }
 }
-async function handleNpmCompare(args) {
+export async function handleNpmCompare(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
             const [infoRes, downloadsRes] = await Promise.all([
@@ -917,10 +927,7 @@ async function handleNpmCompare(args) {
         for (const pkg of results) {
             text += `${pkg.name} | ${pkg.version} | ${pkg.downloads.toLocaleString()} | ${pkg.dependencies} | ${pkg.license || 'N/A'}\n`;
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -930,10 +937,15 @@ async function handleNpmCompare(args) {
     }
 }
 // Function to get package quality metrics
-async function handleNpmQuality(args) {
+export async function handleNpmQuality(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
-            const response = await fetch(`https://api.npms.io/v2/package/${encodeURIComponent(pkg)}`);
+            const response = await fetch(`https://api.npms.io/v2/package/${encodeURIComponent(pkg)}`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
+            });
             if (!response.ok) {
                 return { name: pkg, error: `Failed to fetch quality data: ${response.statusText}` };
             }
@@ -964,10 +976,7 @@ async function handleNpmQuality(args) {
             text +=
                 '- Note: Detailed metrics (tests, coverage, linting, types) are no longer provided by the API\n\n';
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -981,10 +990,15 @@ async function handleNpmQuality(args) {
         };
     }
 }
-async function handleNpmMaintenance(args) {
+export async function handleNpmMaintenance(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
-            const response = await fetch(`https://api.npms.io/v2/package/${encodeURIComponent(pkg)}`);
+            const response = await fetch(`https://api.npms.io/v2/package/${encodeURIComponent(pkg)}`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
+            });
             if (!response.ok) {
                 return { name: pkg, error: `Failed to fetch maintenance data: ${response.statusText}` };
             }
@@ -1007,10 +1021,7 @@ async function handleNpmMaintenance(args) {
             text += `📦 ${result.name}\n`;
             text += `- Maintenance Score: ${result.score}\n\n`;
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -1024,10 +1035,15 @@ async function handleNpmMaintenance(args) {
         };
     }
 }
-async function handleNpmPopularity(args) {
+export async function handleNpmPopularity(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
-            const response = await fetch(`https://api.npms.io/v2/package/${encodeURIComponent(pkg)}`);
+            const response = await fetch(`https://api.npms.io/v2/package/${encodeURIComponent(pkg)}`, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'NPM-Sentinel-MCP',
+                },
+            });
             if (!response.ok) {
                 return { name: pkg, error: `Failed to fetch popularity data: ${response.statusText}` };
             }
@@ -1057,10 +1073,7 @@ async function handleNpmPopularity(args) {
             text += `- Overall Score: ${result.score}\n`;
             text += '- Note: Detailed metrics are no longer provided by the API\n\n';
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -1074,7 +1087,7 @@ async function handleNpmPopularity(args) {
         };
     }
 }
-async function handleNpmMaintainers(args) {
+export async function handleNpmMaintainers(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
             const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`);
@@ -1141,7 +1154,7 @@ async function handleNpmMaintainers(args) {
         };
     }
 }
-async function handleNpmScore(args) {
+export async function handleNpmScore(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
             const response = await fetch(`https://api.npms.io/v2/package/${encodeURIComponent(pkg)}`);
@@ -1224,7 +1237,7 @@ async function handleNpmScore(args) {
         };
     }
 }
-async function handleNpmPackageReadme(args) {
+export async function handleNpmPackageReadme(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
             const response = await fetch(`https://registry.npmjs.org/${pkg}`);
@@ -1256,10 +1269,7 @@ async function handleNpmPackageReadme(args) {
                 text += `${'='.repeat(80)}\n\n`;
             }
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -1273,7 +1283,7 @@ async function handleNpmPackageReadme(args) {
         };
     }
 }
-async function handleNpmSearch(args) {
+export async function handleNpmSearch(args) {
     try {
         const limit = args.limit || 10;
         const response = await fetch(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(args.query)}&size=${limit}`);
@@ -1312,10 +1322,7 @@ async function handleNpmSearch(args) {
             }
             text += '\n';
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -1330,7 +1337,7 @@ async function handleNpmSearch(args) {
     }
 }
 // License compatibility checker
-async function handleNpmLicenseCompatibility(args) {
+export async function handleNpmLicenseCompatibility(args) {
     try {
         const licenses = await Promise.all(args.packages.map(async (pkg) => {
             const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`);
@@ -1375,10 +1382,7 @@ async function handleNpmLicenseCompatibility(args) {
         }
         text +=
             '\nNote: This is a basic analysis. For legal compliance, please consult with a legal expert.\n';
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -1393,7 +1397,7 @@ async function handleNpmLicenseCompatibility(args) {
     }
 }
 // Repository statistics analyzer
-async function handleNpmRepoStats(args) {
+export async function handleNpmRepoStats(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
             // First get the package info from npm to find the repository URL
@@ -1457,10 +1461,7 @@ async function handleNpmRepoStats(args) {
                 text += '\n\n';
             }
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -1474,7 +1475,7 @@ async function handleNpmRepoStats(args) {
         };
     }
 }
-async function handleNpmDeprecated(args) {
+export async function handleNpmDeprecated(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
             const response = await fetch(`https://registry.npmjs.org/${pkg}`);
@@ -1543,10 +1544,7 @@ async function handleNpmDeprecated(args) {
         for (const result of results) {
             text += result.text;
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -1560,7 +1558,7 @@ async function handleNpmDeprecated(args) {
         };
     }
 }
-async function handleNpmChangelogAnalysis(args) {
+export async function handleNpmChangelogAnalysis(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
             // First get the package info from npm to find the repository URL
@@ -1656,10 +1654,7 @@ async function handleNpmChangelogAnalysis(args) {
         for (const result of results) {
             text += result.text;
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {
@@ -1673,7 +1668,7 @@ async function handleNpmChangelogAnalysis(args) {
         };
     }
 }
-async function handleNpmAlternatives(args) {
+export async function handleNpmAlternatives(args) {
     try {
         const results = await Promise.all(args.packages.map(async (pkg) => {
             const response = await fetch(`https://registry.npmjs.org/-/v1/search?text=keywords:${pkg}&size=10`);
@@ -1726,10 +1721,7 @@ async function handleNpmAlternatives(args) {
         for (const result of results) {
             text += result.text;
         }
-        return {
-            content: [{ type: 'text', text }],
-            isError: false,
-        };
+        return { content: [{ type: 'text', text }], isError: false };
     }
     catch (error) {
         return {