@gulibs/safe-coder 0.0.1

package/README.md

@@ -0,0 +1,515 @@
+# Safe Coder MCP 服务
+
+一个基于 Model Context Protocol (MCP) 的服务器，提供以下功能：
+- **最新库文档** - 从 npm、GitHub 和 HTTP 源获取文档
+- **全面错误检测** - 使用 ESLint、TypeScript、模式匹配和上下文分析
+- **代码验证** - 带自动修复功能
+- **错误解决方案建议** - 针对常见编码问题
+
+## 功能特性
+
+### 文档获取
+
+- 从 npm 注册表获取
+- 从 GitHub 仓库获取
+- 从直接 HTTP 文档站点获取
+- 智能缓存，基于版本键和 TTL
+- 热门包的背景刷新
+
+### 错误检测
+
+- 多层检测：
+  1. ESLint - 代码质量检查
+  2. TypeScript 编译器 - 类型检查
+  3. 模式匹配 - 常见错误模式
+  4. 上下文分析 - 未定义变量和 API 使用错误
+- 优先级错误报告（语法 → 类型 → 运行时 → 逻辑 → 警告）
+
+### 代码验证
+
+- 完整的验证管道
+- 自动修复常见错误（语法、缺失导入）
+- 错误解决方案数据库
+- 在代码展示前进行验证
+
+## 安装方式
+
+### 方式一：通过 npm 安装（推荐）
+
+如果已发布到 npm：
+
+```bash
+# 全局安装
+npm install -g @gulibs/safe-coder
+
+# 或者本地安装到项目
+npm install @gulibs/safe-coder
+```
+
+### 方式二：从源码安装
+
+```bash
+# 克隆或下载项目
+git clone <repository-url>
+cd safe-coder
+
+# 安装依赖
+npm install
+
+# 构建项目
+npm run build
+```
+
+## 配置
+
+设置环境变量（可选）：
+
+- `CACHE_TTL_MINUTES` - 文档缓存 TTL（分钟），默认：60
+- `GITHUB_TOKEN` - GitHub API token（用于访问私有仓库，可选）
+- `ENABLE_AUTO_FIX` - 启用自动修复，默认：true
+- `RATE_LIMIT_REQUESTS` - 每个窗口的最大请求数，默认：100
+- `RATE_LIMIT_WINDOW_MS` - 速率限制窗口（毫秒），默认：60000
+
+## 使用方法
+
+### 1. 运行服务器
+
+```bash
+# 开发模式（使用 tsx）
+npm run dev
+
+# 生产模式（需要先构建）
+npm run build
+npm start
+```
+
+服务器通过 stdio 运行，使用 MCP 协议进行通信。
+
+### 2. 在 Cursor 中配置
+
+#### 步骤 1：找到 Cursor 配置文件
+
+Cursor 的 MCP 配置文件位置：
+- **macOS**: `~/Library/Application Support/Cursor/User/globalStorage/mcp.json`
+- **Windows**: `%APPDATA%\Cursor\User\globalStorage\mcp.json`
+- **Linux**: `~/.config/Cursor/User/globalStorage/mcp.json`
+
+或者通过 Cursor 设置界面：
+1. 打开 Cursor 设置（`Cmd/Ctrl + ,`）
+2. 搜索 "MCP" 或 "Model Context Protocol"
+3. 找到 MCP 服务器配置
+
+#### 步骤 2：添加配置
+
+根据你的安装方式选择对应的配置：
+
+##### 如果通过 npm 全局安装：
+
+首先找到全局安装路径：
+
+```bash
+# 查看全局 node_modules 路径
+npm root -g
+```
+
+然后配置（替换 `<global-node-modules-path>` 为实际路径）：
+
+```json
+{
+  "mcpServers": {
+    "safe-coder": {
+      "command": "node",
+      "args": ["<global-node-modules-path>/@gulibs/safe-coder/dist/index.js"],
+      "env": {
+        "CACHE_TTL_MINUTES": "60",
+        "GITHUB_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+或者使用 npx（推荐，更简单）：
+
+```json
+{
+  "mcpServers": {
+    "safe-coder": {
+      "command": "npx",
+      "args": ["-y", "@gulibs/safe-coder"],
+      "env": {
+        "CACHE_TTL_MINUTES": "60",
+        "GITHUB_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+##### 如果从源码安装：
+
+找到你安装的路径，然后配置：
+
+```json
+{
+  "mcpServers": {
+    "safe-coder": {
+      "command": "node",
+      "args": ["/绝对路径/to/safe-coder/dist/index.js"],
+      "env": {
+        "CACHE_TTL_MINUTES": "60",
+        "GITHUB_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+**获取绝对路径的方法：**
+
+在项目目录下运行：
+
+```bash
+# macOS/Linux
+pwd
+
+# Windows PowerShell
+(Get-Location).Path
+```
+
+##### 如果使用本地项目安装（node_modules）：
+
+```json
+{
+  "mcpServers": {
+    "safe-coder": {
+      "command": "node",
+      "args": ["./node_modules/@gulibs/safe-coder/dist/index.js"],
+      "env": {
+        "CACHE_TTL_MINUTES": "60",
+        "GITHUB_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+#### 步骤 3：验证配置
+
+1. **检查配置文件格式**：确保 JSON 格式正确，可以使用在线 JSON 验证器
+2. **重启 Cursor**：保存配置后，完全重启 Cursor
+3. **检查连接状态**：
+   - 在 Cursor 设置中查看 MCP 服务器列表
+   - 应该能看到 "safe-coder" 服务器
+   - 状态应该显示为已连接（绿色）
+
+#### 步骤 4：测试工具
+
+在 Cursor 的 AI 对话中测试：
+
+```
+请使用 get_documentation 工具获取 axios 库的文档
+```
+
+如果工具正常工作，说明配置成功！
+
+### 3. 使用 MCP 工具
+
+配置完成后，你可以在 Cursor 的 AI 对话中使用以下工具：
+
+#### `get_documentation` - 获取文档
+
+获取库或包的文档。
+
+**参数：**
+- `packageName`（必需）：包名（npm）、仓库（owner/repo）或 URL
+- `version`（可选）：版本或分支 / 标签
+- `source`（可选）：源类型（'npm'、'github'、'http'）- 如果不指定会自动检测
+
+**使用示例：**
+
+```
+请帮我获取 axios 库的文档
+```
+
+或者直接调用：
+
+```json
+{
+  "packageName": "axios",
+  "version": "latest",
+  "source": "npm"
+}
+```
+
+#### `detect_errors` - 检测错误
+
+检测代码中的错误和警告。
+
+**参数：**
+- `code`（必需）：要分析的代码
+- `filename`（可选）：用于上下文的文件名（默认：'code.ts'）
+
+**使用示例：**
+
+```
+请检测这段代码的错误：
+const x = y;
+console.log(z);
+```
+
+#### `validate_code` - 验证代码
+
+验证代码并可选择自动修复常见错误。
+
+**参数：**
+- `code`（必需）：要验证的代码
+- `filename`（可选）：用于上下文的文件名
+- `autoFix`（可选）：启用自动修复（默认：true）
+
+**使用示例：**
+
+```
+请验证并修复这段代码：
+function test() {
+  return x
+}
+```
+
+#### `resolve_error` - 解决错误
+
+获取特定错误的解决方案建议。
+
+**参数：**
+- `errorType`（必需）：错误类型
+- `message`（必需）：错误消息
+- `line`（可选）：错误发生的行号
+
+**使用示例：**
+
+```
+我遇到了一个 undefined-variable 错误，消息是 "Variable 'x' is used but not defined"，在第 5 行
+```
+
+### 4. 使用 MCP 资源
+
+#### `safe-coder://documentation` - 缓存的文档
+
+访问缓存的文档条目，查看缓存状态。
+
+#### `safe-coder://error-patterns` - 错误模式数据库
+
+访问错误模式数据库，查看已知的错误模式和解决方案。
+
+## 开发
+
+### 项目结构
+
+```
+safe-coder/
+├── src/
+│   ├── documentation/  # 文档获取和缓存
+│   ├── errors/         # 错误检测（ESLint、TypeScript、模式、上下文）
+│   ├── validation/     # 代码验证和自动修复
+│   ├── server/         # MCP 服务器实现
+│   ├── types/          # TypeScript 类型定义
+│   ├── utils/          # 配置和工具函数
+│   └── index.ts        # 入口文件
+├── tests/              # 测试文件
+├── dist/               # 编译输出
+└── package.json
+```
+
+### 开发命令
+
+```bash
+# 安装依赖
+npm install
+
+# 构建项目
+npm run build
+
+# 开发模式运行（自动重新编译）
+npm run dev
+
+# 运行测试
+npm test
+
+# 监听模式运行测试
+npm run test:watch
+
+# 类型检查
+npm run type-check
+
+# 代码检查
+npm run lint
+```
+
+### 调试
+
+如果遇到问题，可以：
+
+1. **检查服务器是否正常运行**：
+
+   ```bash
+   npm run dev
+   ```
+
+   应该看到：`Safe Coder MCP server running on stdio`
+
+2. **查看 Cursor 的 MCP 日志**：
+   - 在 Cursor 中打开开发者工具
+   - 查看控制台中的 MCP 相关错误
+
+3. **测试工具调用**：
+   可以在 Cursor 的 AI 对话中直接请求使用工具，例如：
+
+   ```
+   请使用 get_documentation 工具获取 react 的文档
+   ```
+
+## 常见问题
+
+### Q: 服务器无法启动？
+
+**A:** 检查以下几点：
+- 确保已运行 `npm install` 和 `npm run build`
+- 检查 Node.js 版本（建议 18+）
+- 查看错误日志
+
+### Q: 无法获取 GitHub 文档？
+
+**A:**
+- 如果访问私有仓库，需要设置 `GITHUB_TOKEN` 环境变量
+- 公开仓库通常不需要 token，但设置 token 可以提高速率限制
+
+### Q: 错误检测不准确？
+
+**A:**
+- 确保代码文件扩展名正确（`.ts` 用于 TypeScript，`.js` 用于 JavaScript）
+- 某些复杂的错误可能需要更多上下文
+- 可以尝试使用 `validate_code` 工具获得更全面的分析
+
+### Q: 如何更新错误模式数据库？
+
+**A:**
+- 编辑 `src/errors/patterns.json` 文件
+- 添加新的错误模式
+- 重新构建项目
+
+## 发布到 npm（开发者）
+
+如果你想将这个包发布到 npm：
+
+### 1. 准备发布
+
+```bash
+# 确保已登录 npm
+npm login
+
+# 检查包名是否可用（如果已发布，需要更新版本号）
+npm view @gulibs/safe-coder
+
+# 更新版本号
+npm version patch  # 或 minor, major
+```
+
+### 2. 发布
+
+```bash
+# 发布到 npm
+npm publish
+
+# 如果使用作用域包且是首次发布，需要添加访问权限
+npm publish --access public
+```
+
+### 3. 验证发布
+
+```bash
+# 检查包是否已发布
+npm view @gulibs/safe-coder
+
+# 测试安装
+npm install -g @gulibs/safe-coder
+```
+
+## 本地开发配置示例
+
+如果你在本地开发，可以创建一个测试配置：
+
+### 创建测试配置文件
+
+在项目根目录创建 `cursor-mcp-config.json`：
+
+```json
+{
+  "mcpServers": {
+    "safe-coder": {
+      "command": "node",
+      "args": ["./dist/index.js"],
+      "env": {
+        "CACHE_TTL_MINUTES": "60",
+        "GITHUB_TOKEN": ""
+      }
+    }
+  }
+}
+```
+
+然后将此配置复制到 Cursor 的配置目录。
+
+### 快速测试脚本
+
+创建 `test-mcp.sh`（macOS/Linux）或 `test-mcp.bat`（Windows）：
+
+```bash
+#!/bin/bash
+# test-mcp.sh
+
+echo "构建项目..."
+npm run build
+
+echo "测试 MCP 服务器..."
+node dist/index.js
+```
+
+## 故障排除
+
+### 问题：Cursor 无法找到服务器
+
+**解决方案：**
+1. 检查路径是否正确（使用绝对路径）
+2. 确保 `dist/index.js` 文件存在
+3. 检查 Node.js 是否在 PATH 中：`which node` 或 `where node`
+
+### 问题：服务器启动失败
+
+**解决方案：**
+1. 检查依赖是否安装：`npm install`
+2. 检查构建是否成功：`npm run build`
+3. 查看错误日志
+
+### 问题：工具无法使用
+
+**解决方案：**
+1. 确认服务器在 Cursor 中显示为已连接
+2. 检查 Cursor 版本是否支持 MCP
+3. 查看 Cursor 开发者工具中的错误信息
+
+### 问题：权限错误
+
+**解决方案：**
+
+```bash
+# 确保 dist/index.js 有执行权限
+chmod +x dist/index.js
+```
+
+## 许可证
+
+MIT
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！

package/dist/documentation/cache.d.ts

@@ -0,0 +1,13 @@
+import type { Documentation } from '../types/documentation.js';
+export declare class DocumentationCache {
+    private cache;
+    private readonly defaultTTL;
+    constructor(defaultTTLMinutes?: number);
+    get(key: string): Documentation | null;
+    set(key: string, documentation: Documentation, ttl?: number): void;
+    generateKey(packageName: string, version?: string): string;
+    clear(): void;
+    size(): number;
+    cleanup(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/documentation/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/documentation/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,2BAA2B,CAAC;AAE3E,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,iBAAiB,GAAE,MAAW;IAI1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAetC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAUlE,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAI1D,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;IAKd,OAAO,IAAI,MAAM;CAalB"}

package/dist/documentation/cache.js

@@ -0,0 +1,48 @@
+export class DocumentationCache {
+    cache = new Map();
+    defaultTTL; // in milliseconds
+    constructor(defaultTTLMinutes = 60) {
+        this.defaultTTL = defaultTTLMinutes * 60 * 1000;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        if (new Date() > entry.expiresAt) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.documentation;
+    }
+    set(key, documentation, ttl) {
+        const expiresAt = new Date(Date.now() + (ttl || this.defaultTTL));
+        this.cache.set(key, {
+            documentation,
+            expiresAt,
+            version: documentation.version || 'latest',
+        });
+    }
+    generateKey(packageName, version) {
+        return version ? `${packageName}@${version}` : `${packageName}@latest`;
+    }
+    clear() {
+        this.cache.clear();
+    }
+    size() {
+        return this.cache.size;
+    }
+    // Clean expired entries
+    cleanup() {
+        const now = new Date();
+        let cleaned = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/documentation/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/documentation/cache.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IACrB,KAAK,GAA4B,IAAI,GAAG,EAAE,CAAC;IAClC,UAAU,CAAS,CAAC,kBAAkB;IAEvD,YAAY,oBAA4B,EAAE;QACxC,IAAI,CAAC,UAAU,GAAG,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;IAClD,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,IAAI,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC,aAAa,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,aAA4B,EAAE,GAAY;QACzD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAElE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,aAAa;YACb,SAAS;YACT,OAAO,EAAE,aAAa,CAAC,OAAO,IAAI,QAAQ;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,WAAmB,EAAE,OAAgB;QAC/C,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,SAAS,CAAC;IACzE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,wBAAwB;IACxB,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/documentation/github-client.d.ts

@@ -0,0 +1,11 @@
+import type { Documentation, DocumentationSource } from '../types/documentation.js';
+export declare class GitHubClient implements DocumentationSource {
+    private readonly apiUrl;
+    private readonly token?;
+    constructor(token?: string);
+    fetch(packageName: string, version?: string): Promise<Documentation>;
+    private parseRepository;
+    private fetchReadme;
+    private fetchDocs;
+}
+//# sourceMappingURL=github-client.d.ts.map

package/dist/documentation/github-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../../src/documentation/github-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEpF,qBAAa,YAAa,YAAW,mBAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;gBAEpB,KAAK,CAAC,EAAE,MAAM;IAIpB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B1E,OAAO,CAAC,eAAe;YAST,WAAW;YAoBX,SAAS;CAqCxB"}

package/dist/documentation/github-client.js

@@ -0,0 +1,88 @@
+import axios from 'axios';
+export class GitHubClient {
+    apiUrl = 'https://api.github.com';
+    token;
+    constructor(token) {
+        this.token = token || process.env.GITHUB_TOKEN;
+    }
+    async fetch(packageName, version) {
+        try {
+            // Parse packageName as owner/repo or extract from npm package
+            const [owner, repo] = this.parseRepository(packageName);
+            if (!owner || !repo) {
+                throw new Error(`Invalid GitHub repository format: ${packageName}`);
+            }
+            // Fetch README
+            const readme = await this.fetchReadme(owner, repo, version);
+            // Try to fetch docs directory if it exists
+            const docs = await this.fetchDocs(owner, repo, version);
+            const content = [readme, docs].filter(Boolean).join('\n\n---\n\n');
+            return {
+                name: `${owner}/${repo}`,
+                version,
+                content: content || `No documentation found for ${owner}/${repo}`,
+                source: 'github',
+                url: `https://github.com/${owner}/${repo}`,
+                lastUpdated: new Date(),
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch GitHub documentation: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    parseRepository(packageName) {
+        // Check if it's already in owner/repo format
+        if (packageName.includes('/')) {
+            const parts = packageName.split('/');
+            return [parts[0], parts[1]];
+        }
+        return [null, null];
+    }
+    async fetchReadme(owner, repo, ref) {
+        try {
+            const refParam = ref ? `?ref=${ref}` : '';
+            const url = `${this.apiUrl}/repos/${owner}/${repo}/readme${refParam}`;
+            const headers = {
+                'Accept': 'application/vnd.github.v3.raw',
+            };
+            if (this.token) {
+                headers['Authorization'] = `token ${this.token}`;
+            }
+            const response = await axios.get(url, { headers });
+            return response.data;
+        }
+        catch (error) {
+            // README might not exist, return empty
+            return '';
+        }
+    }
+    async fetchDocs(owner, repo, ref) {
+        try {
+            const refParam = ref ? `?ref=${ref}` : '';
+            const url = `${this.apiUrl}/repos/${owner}/${repo}/contents/docs${refParam}`;
+            const headers = {};
+            if (this.token) {
+                headers['Authorization'] = `token ${this.token}`;
+            }
+            const response = await axios.get(url, { headers });
+            // If docs is a directory, fetch all markdown files
+            if (Array.isArray(response.data)) {
+                const markdownFiles = response.data.filter((file) => file.type === 'file' && file.name.endsWith('.md'));
+                const contents = await Promise.all(markdownFiles.map(async (file) => {
+                    const fileUrl = `${this.apiUrl}/repos/${owner}/${repo}/contents/${file.path}${refParam}`;
+                    const fileResponse = await axios.get(fileUrl, {
+                        headers: { ...headers, 'Accept': 'application/vnd.github.v3.raw' }
+                    });
+                    return `## ${file.name}\n\n${fileResponse.data}`;
+                }));
+                return contents.join('\n\n');
+            }
+            return '';
+        }
+        catch (error) {
+            // Docs directory might not exist
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=github-client.js.map

package/dist/documentation/github-client.js.map

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

package/dist/documentation/http-fetcher.d.ts

@@ -0,0 +1,5 @@
+import type { Documentation, DocumentationSource } from '../types/documentation.js';
+export declare class HttpFetcher implements DocumentationSource {
+    fetch(packageName: string, version?: string): Promise<Documentation>;
+}
+//# sourceMappingURL=http-fetcher.d.ts.map