root
87 lines
3.6 KiB
JavaScript
87 lines
3.6 KiB
JavaScript
import { z } from 'zod';
|
|
import { errorResult, jsonResult, toErrorMessage } from '../shared.js';
|
|
async function fetchJson(url) {
|
|
const response = await fetch(url, { headers: { Accept: 'application/json' } });
|
|
if (!response.ok) {
|
|
throw new Error(`HTTP ${response.status} from ${url}`);
|
|
}
|
|
return response.json();
|
|
}
|
|
async function fetchText(url) {
|
|
const response = await fetch(url);
|
|
if (!response.ok) {
|
|
throw new Error(`HTTP ${response.status} from ${url}`);
|
|
}
|
|
return response.text();
|
|
}
|
|
async function fetchNpmDocs(name, version) {
|
|
const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(name)}`;
|
|
const info = (await fetchJson(registryUrl));
|
|
const resolvedVersion = version ?? info['dist-tags'].latest;
|
|
const versionData = info.versions[resolvedVersion];
|
|
let readme = null;
|
|
try {
|
|
readme = await fetchText(`https://unpkg.com/${name}@${resolvedVersion}/README.md`);
|
|
}
|
|
catch {
|
|
try {
|
|
readme = await fetchText(`https://unpkg.com/${name}@${resolvedVersion}/readme.md`);
|
|
}
|
|
catch {
|
|
readme = info.readme ?? null;
|
|
}
|
|
}
|
|
return {
|
|
ecosystem: 'npm',
|
|
package: name,
|
|
version: resolvedVersion,
|
|
description: versionData?.description ?? null,
|
|
homepage: versionData?.homepage ?? null,
|
|
repository: versionData?.repository?.url ?? null,
|
|
readme,
|
|
readmeSource: readme ? `https://unpkg.com/${name}@${resolvedVersion}/README.md` : null,
|
|
};
|
|
}
|
|
async function fetchPackagistDocs(name, version) {
|
|
const url = `https://packagist.org/packages/${encodeURIComponent(name)}.json`;
|
|
const info = (await fetchJson(url));
|
|
const pkg = info.package;
|
|
const versions = Object.keys(pkg.versions ?? {}).sort();
|
|
const resolvedVersion = version ?? versions[versions.length - 1];
|
|
return {
|
|
ecosystem: 'composer',
|
|
package: pkg.name,
|
|
version: resolvedVersion,
|
|
description: pkg.description ?? null,
|
|
repository: pkg.repository ?? null,
|
|
versions: versions.slice(-20),
|
|
note: 'README fetching for Packagist packages is not yet implemented; use the repository URL to read the README.',
|
|
};
|
|
}
|
|
export function registerSearchPackageDocsTool(server) {
|
|
server.registerTool('search_package_docs', {
|
|
title: 'Search Package Docs',
|
|
description: 'Fetch README/docs for an npm or Composer/Packagist package. For npm packages, resolves the version and fetches the README from unpkg. For Composer packages, returns Packagist metadata including the repository URL.',
|
|
inputSchema: {
|
|
name: z.string().min(1).describe('Package name, e.g. "axios" or "laravel/framework".'),
|
|
ecosystem: z
|
|
.enum(['npm', 'composer', 'auto'])
|
|
.optional()
|
|
.default('auto')
|
|
.describe('Which package ecosystem to search. Auto detects from the name ("laravel/framework" → composer).'),
|
|
version: z.string().optional().describe('Specific version to look up. Defaults to latest.'),
|
|
},
|
|
}, async ({ name, ecosystem, version }) => {
|
|
try {
|
|
const resolvedEcosystem = ecosystem === 'auto' ? (name.includes('/') ? 'composer' : 'npm') : ecosystem;
|
|
if (resolvedEcosystem === 'composer') {
|
|
return jsonResult(await fetchPackagistDocs(name, version));
|
|
}
|
|
return jsonResult(await fetchNpmDocs(name, version));
|
|
}
|
|
catch (error) {
|
|
return errorResult(toErrorMessage(error));
|
|
}
|
|
});
|
|
}
|
|
//# sourceMappingURL=searchPackageDocs.js.map
|