first commit

.dockerignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+.git
+.env
+.gitignore
+.dockerignore
+logs
+tmp
+coverage

.gitattributes

@@ -1,35 +0,0 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,38 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+/dist
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# local env files
+.env*.local
+.env*
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

Dockerfile

@@ -0,0 +1,42 @@
+# Stage 1: Build
+FROM node:20-alpine AS builder
+
+# Install pnpm
+RUN npm install -g pnpm
+
+WORKDIR /app
+
+# Copy package files
+COPY package.json pnpm-lock.yaml ./
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN pnpm run build
+
+# Stage 2: Production
+FROM node:20-alpine
+
+# Install pnpm
+RUN npm install -g pnpm
+
+WORKDIR /app
+
+# Copy package files
+COPY package.json pnpm-lock.yaml ./
+
+# Install only production dependencies
+RUN pnpm install --prod --frozen-lockfile
+
+# Copy built artifacts from builder stage
+COPY --from=builder /app/dist ./dist
+
+# Expose the application port
+EXPOSE 3000
+
+# Start the application
+CMD ["pnpm", "start"]

README.md

@@ -1,10 +1,587 @@
+# Vortex CP
+
+A high-speed, vertical-slice aggregator for competitive programming metrics. Vortex CP unifies data from LeetCode, Codeforces, CodeChef, AtCoder, and GeeksforGeeks into a single, modular API layer. Built for modern web applications and AI agents via the **Model Context Protocol (MCP)**.
+
+---
+
+## Architecture
+
+Vortex follows a **strict vertical slice architecture**. Each competitive programming platform is an isolated, self-contained plugin that flows through a consistent request pipeline.
+
+### Vortex Flow Diagram
+
+```mermaid
+graph TD
+    A[HTTP Request] --> B[Fastify Router]
+    B --> C{Route Match}
+    
+    C -->|/api/v1/leetcode| D1[LeetCode Handler]
+    C -->|/api/v1/codeforces| D2[Codeforces Handler]
+    C -->|/api/v1/codechef| D3[CodeChef Handler]
+    C -->|/api/v1/atcoder| D4[AtCoder Handler]
+    C -->|/api/v1/gfg| D5[GFG Handler]
+    C -->|/api/v1/ratings| D6[Aggregator Handler]
+    
+    D1 --> E1[LeetCode Service]
+    D2 --> E2[Codeforces Service]
+    D3 --> E3[CodeChef Service]
+    D4 --> E4[AtCoder Service]
+    D5 --> E5[GFG Service]
+    D6 --> E6[Aggregator Service]
+    
+    E1 --> F1[LeetCode Provider]
+    E2 --> F2[Codeforces Provider]
+    E3 --> F3[CodeChef Provider]
+    E4 --> F4[AtCoder Provider]
+    E5 --> F5[GFG Provider]
+    E6 --> F6[Multi-Platform Provider]
+    
+    F1 --> G1[LeetCode GraphQL API]
+    F2 --> G2[Codeforces REST API]
+    F3 --> G3[CodeChef REST API]
+    F4 --> G4[AtCoder REST API]
+    F5 --> G5[GFG Scraper]
+    
+    G1 --> H[Response]
+    G2 --> H
+    G3 --> H
+    G4 --> H
+    G5 --> H
+    
+    H --> I[JSON Response]
+    
+    style D1 fill:#e3f2fd
+    style D2 fill:#e3f2fd
+    style D3 fill:#e3f2fd
+    style D4 fill:#e3f2fd
+    style D5 fill:#e3f2fd
+    style D6 fill:#fff3e0
+    style E6 fill:#fff3e0
+    style F6 fill:#fff3e0
+```
+
+### Vertical Slice Philosophy
+
+Each platform module (`src/modules/{platform}/`) is a **complete vertical slice**:
+
+| Layer | Responsibility | Dependencies |
+|-------|---------------|--------------|
+| **routes.ts** | Fastify plugin registration, OpenAPI schemas, endpoint definitions | None (Entry Point) |
+| **handlers.ts** | HTTP request/response handling, parameter extraction, validation | Service layer |
+| **service.ts** | Business logic, data transformation, error handling | Provider layer |
+| **provider.ts** | External API integration, HTTP client configuration | External APIs only |
+| **types.ts** | TypeScript interfaces for domain models | None |
+| **schemas.ts** | JSON Schema for request/response validation | None |
+
+**Key Constraint:** Each layer can only depend on layers below it. No cross-module dependencies are allowed except through the aggregator service.
+
 ---
-title: Vortex
-emoji: 🐠
-colorFrom: blue
-colorTo: yellow
-sdk: docker
-pinned: false
+
+## Project Structure
+
+```
+src/
+├── app.ts                      # Fastify app configuration & plugin registration
+├── server.ts                   # HTTP server bootstrap
+├── config/
+│   └── env.ts                  # Environment variable validation
+├── shared/
+│   ├── middlewares/
+│   │   └── validate.ts         # Global validation middleware
+│   └── utils/
+│       ├── http-client.ts      # Axios instance with timeout & retry
+│       └── timeout.ts          # Request timeout utilities
+├── types/
+│   ├── api.ts                  # Common API response types
+│   └── fastify.ts              # Fastify type augmentation
+└── modules/
+    ├── leetcode/               # LeetCode vertical slice
+    ├── codeforces/             # Codeforces vertical slice
+    ├── codechef/               # CodeChef vertical slice
+    ├── atcoder/                # AtCoder vertical slice
+    ├── gfg/                    # GeeksforGeeks vertical slice
+    ├── ratings/                # Cross-platform aggregator
+    └── mcp/                    # Model Context Protocol server
+```
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## Installation
+
+### Prerequisites
+
+- **Node.js** 18+ (LTS recommended)
+- **pnpm** 8+ (install via `npm i -g pnpm`)
+
+### Setup
+
+```bash
+# Clone repository
+git clone https://github.com/Anujjoshi3105/vortex.git
+cd vortex
+
+# Install dependencies
+pnpm install
+
+# Configure environment
+cp .env.example .env
+# Edit .env with your configuration
+```
+
+#### `.env.example`
+
+```env
+# Server Configuration
+PORT=3000
+HOST=0.0.0.0
+NODE_ENV=development
+
+# Security (optional)
+AUTH_SECRET=your_auth_secret_here
+```
+
+### Development
+
+```bash
+# Start dev server with hot-reload
+pnpm dev
+```
+
+Server starts at `http://localhost:3000`
+
+API documentation: `http://localhost:3000/docs`
+
+### Production Build
+
+```bash
+# Compile TypeScript
+pnpm build
+
+# Start production server
+pnpm start
+```
+
+### MCP Inspector (AI Tool Testing)
+
+```bash
+# Launch MCP Inspector UI
+pnpm inspect
+```
+
+Opens at `http://localhost:6274` for interactive MCP tool testing.
+
+---
+
+## API Reference
+
+### Platform-Specific Endpoints
+
+| Platform | Endpoint | Description |
+|----------|----------|-------------|
+| **LeetCode** | `GET /api/v1/leetcode/rating?username={user}` | User contest rating & ranking |
+| | `GET /api/v1/leetcode/contest-ranking?username={user}` | Contest participation history |
+| | `GET /api/v1/leetcode/daily-problem` | Today's daily challenge |
+| | `GET /api/v1/leetcode/contests` | Upcoming contests |
+| **Codeforces** | `GET /api/v1/codeforces/rating?username={user}` | Current rating & rank |
+| | `GET /api/v1/codeforces/contest-history?username={user}` | Rating change graph |
+| | `GET /api/v1/codeforces/status?username={user}&from=1&count=10` | Recent submissions |
+| | `GET /api/v1/codeforces/solved-problems?username={user}` | Unique solved problems |
+| **CodeChef** | `GET /api/v1/codechef/rating?username={user}` | Current rating & stars |
+| **AtCoder** | `GET /api/v1/atcoder/rating?username={user}` | Current rating & color |
+| **GeeksforGeeks** | `GET /api/v1/gfg/rating?username={user}` | Overall score & rank |
+
+### Aggregator Endpoint
+
+```http
+GET /api/v1/ratings?username={user}
+```
+
+Returns unified ratings from **all platforms** in a single response:
+
+```json
+{
+  "username": "tourist",
+  "platforms": {
+    "leetcode": { "rating": 3200, "rank": "Knight", ... },
+    "codeforces": { "rating": 3821, "rank": "Legendary Grandmaster", ... },
+    "codechef": { "rating": 2800, "stars": "7★", ... },
+    "atcoder": { "rating": 3817, "color": "red", ... },
+    "gfg": { "score": 9500, "rank": 1, ... }
+  }
+}
+```
+
+### Health Check
+
+```http
+GET /health
+```
+
+Returns `{ "status": "ok" }` for uptime monitoring.
+
+---
+
+## Model Context Protocol (MCP)
+
+Vortex exposes its functionality as **MCP tools** for AI agents (e.g., Claude Desktop, LangChain agents).
+
+### Connecting to Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "vortex-cp": {
+      "command": "node",
+      "args": [
+        "path/to/vortex/dist/server.js"
+      ],
+      "env": {
+        "PORT": "3000"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop.
+
+### MCP Endpoints (HTTP/SSE)
+
+- **SSE Transport**: `GET /mcp/sse`
+- **Message Handler**: `POST /mcp/messages?sessionId={id}`
+
+Use the MCP Inspector (`pnpm inspect`) to test tools interactively before integrating with agents.
+
+---
+
+## Contributors Guide
+
+### Adding a New Platform
+
+To maintain **vertical slice integrity**, follow this checklist when adding a new platform (e.g., HackerRank):
+
+#### 1. Create Module Directory
+
+```bash
+mkdir -p src/modules/hackerrank
+cd src/modules/hackerrank
+touch index.ts routes.ts handlers.ts service.ts provider.ts types.ts schemas.ts
+```
+
+#### 2. Define Types (`types.ts`)
+
+```typescript
+export interface HackerRankRating {
+  username: string;
+  rating: number;
+  rank: string;
+  solvedCount: number;
+}
+```
+
+#### 3. Implement Provider (`provider.ts`)
+
+**Responsibility:** External API integration only. No business logic.
+
+```typescript
+import axios from 'axios';
+import { HackerRankRating } from './types';
+
+export async function fetchUserRating(username: string): Promise<HackerRankRating> {
+  const { data } = await axios.get(`https://api.hackerrank.com/users/${username}`);
+  return {
+    username: data.username,
+    rating: data.rating,
+    rank: data.rank,
+    solvedCount: data.challenges_solved
+  };
+}
+```
+
+#### 4. Implement Service (`service.ts`)
+
+**Responsibility:** Business logic, data transformation, error handling.
+
+```typescript
+import * as provider from './provider';
+import { HackerRankRating } from './types';
+
+export async function getUserRating(username: string): Promise<HackerRankRating> {
+  if (!username || username.length < 3) {
+    throw new Error('Invalid username');
+  }
+  
+  const data = await provider.fetchUserRating(username);
+  
+  // Apply business rules (e.g., normalize rank)
+  return {
+    ...data,
+    rank: data.rank.toUpperCase()
+  };
+}
+```
+
+#### 5. Implement Handlers (`handlers.ts`)
+
+**Responsibility:** HTTP request/response handling, parameter extraction.
+
+```typescript
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from './service';
+
+interface RatingQuery {
+  username: string;
+}
+
+export async function getUserRatingHandler(
+  request: FastifyRequest<{ Querystring: RatingQuery }>,
+  reply: FastifyReply
+) {
+  const { username } = request.query;
+  
+  try {
+    const data = await service.getUserRating(username);
+    reply.send({ success: true, data });
+  } catch (error) {
+    reply.status(500).send({ success: false, error: error.message });
+  }
+}
+```
+
+#### 6. Define Schemas (`schemas.ts`)
+
+**Responsibility:** OpenAPI/JSON Schema for validation and documentation.
+
+```typescript
+export const ratingQuerySchema = {
+  type: 'object',
+  required: ['username'],
+  properties: {
+    username: { type: 'string', minLength: 3 }
+  }
+};
+
+export const ratingResponseSchema = {
+  type: 'object',
+  properties: {
+    success: { type: 'boolean' },
+    data: {
+      type: 'object',
+      properties: {
+        username: { type: 'string' },
+        rating: { type: 'number' },
+        rank: { type: 'string' },
+        solvedCount: { type: 'number' }
+      }
+    }
+  }
+};
+```
+
+#### 7. Create Routes Plugin (`routes.ts`)
+
+**Responsibility:** Fastify plugin registration, OpenAPI tags.
+
+```typescript
+import { FastifyPluginAsync } from 'fastify';
+import * as handlers from './handlers';
+import * as schemas from './schemas';
+
+export const hackerrankPlugin: FastifyPluginAsync = async (fastify) => {
+  fastify.get('/rating', {
+    schema: {
+      tags: ['HackerRank'],
+      description: 'Get HackerRank user rating',
+      querystring: schemas.ratingQuerySchema,
+      response: { 200: schemas.ratingResponseSchema }
+    }
+  }, handlers.getUserRatingHandler);
+};
+
+export default hackerrankPlugin;
+```
+
+#### 8. Barrel Export (`index.ts`)
+
+```typescript
+export { hackerrankPlugin } from './routes';
+export * from './types';
+```
+
+#### 9. Register in App (`src/app.ts`)
+
+```typescript
+import { hackerrankPlugin } from './modules/hackerrank';
+
+// Inside buildApp()
+await fastify.register(hackerrankPlugin, { prefix: '/api/v1/hackerrank' });
+```
+
+#### 10. Update OpenAPI Tags (`src/app.ts`)
+
+```typescript
+tags: [
+  // ... existing tags
+  { name: 'HackerRank', description: 'HackerRank platform integration' }
+]
+```
+
+**Result:** Your new platform is now a self-contained vertical slice with zero coupling to other modules.
+
+---
+
+## System Auditor Review: Future Resilience Checklist
+
+The following improvements are recommended for production-grade deployments at scale.
+
+### Resiliency
+
+| Feature | Status | Priority | Effort |
+|---------|--------|----------|--------|
+| **Circuit Breaker** | ❌ Not Implemented | High | Medium |
+| └─ Prevent cascading failures when external APIs are down | | | |
+| └─ Recommended: [opossum](https://www.npmjs.com/package/opossum) | | | |
+| **Retry Logic** | ⚠️ Partial (Axios defaults) | Medium | Low |
+| └─ Exponential backoff for transient failures | | | |
+| └─ Recommended: [axios-retry](https://www.npmjs.com/package/axios-retry) | | | |
+| **Fallback Responses** | ❌ Not Implemented | Medium | Low |
+| └─ Return cached/stale data when APIs are unreachable | | | |
+
+### Performance
+
+| Feature | Status | Priority | Effort |
+|---------|--------|----------|--------|
+| **Redis Caching** | ❌ Not Implemented | High | Medium |
+| └─ Cache platform APIs (TTL: 5-15 minutes) | | | |
+| └─ Recommended: [@fastify/redis](https://github.com/fastify/fastify-redis) | | | |
+| **Response Compression** | ❌ Not Implemented | Medium | Low |
+| └─ Compress JSON responses > 1KB | | | |
+| └─ Recommended: [@fastify/compress](https://github.com/fastify/fastify-compress) | | | |
+| **Request Timeouts** | ✅ Implemented | - | - |
+| └─ Per-provider timeout configuration exists | | | |
+
+### Security
+
+| Feature | Status | Priority | Effort |
+|---------|--------|----------|--------|
+| **Rate Limiting** | ❌ Not Implemented | High | Low |
+| └─ Prevent abuse (e.g., 100 req/min per IP) | | | |
+| └─ Recommended: [@fastify/rate-limit](https://github.com/fastify/fastify-rate-limit) | | | |
+| **API Key Middleware** | ⚠️ Partial (AUTH_SECRET unused) | Medium | Low |
+| └─ Optional authentication for public deployments | | | |
+| **Input Sanitization** | ✅ Implemented | - | - |
+| └─ JSON Schema validation active on all endpoints | | | |
+| **CORS Restrictions** | ⚠️ Too Permissive | Medium | Low |
+| └─ Currently allows `origin: '*'` - restrict in production | | | |
+
+### Observability
+
+| Feature | Status | Priority | Effort |
+|---------|--------|----------|--------|
+| **Structured Logging** | ⚠️ Basic (Fastify Logger) | High | Medium |
+| └─ Migrate to [Pino](https://github.com/pinojs/pino) with JSON output | | | |
+| └─ Add request IDs, trace context | | | |
+| **OpenTelemetry** | ❌ Not Implemented | Medium | High |
+| └─ Distributed tracing for multi-provider requests | | | |
+| └─ Recommended: [@opentelemetry/auto-instrumentations-node](https://www.npmjs.com/package/@opentelemetry/auto-instrumentations-node) | | | |
+| **Metrics Endpoint** | ❌ Not Implemented | Medium | Medium |
+| └─ Expose Prometheus metrics (`/metrics`) | | | |
+| └─ Track: request latency, error rates, cache hit rates | | | |
+
+### Implementation Roadmap
+
+**Phase 1: Resiliency** (Sprint 1-2)
+1. Add circuit breaker pattern to all providers
+2. Implement Redis caching layer
+3. Add rate limiting middleware
+
+**Phase 2: Security** (Sprint 3)
+1. Restrict CORS to whitelisted origins
+2. Implement API key authentication (optional)
+3. Add request/response sanitization audit
+
+**Phase 3: Observability** (Sprint 4-5)
+1. Migrate to Pino structured logging
+2. Add OpenTelemetry instrumentation
+3. Create Prometheus metrics endpoint
+4. Build Grafana dashboards
+
+---
+
+## Testing
+
+### Manual Testing
+
+```bash
+# Test single platform
+curl "http://localhost:3000/api/v1/leetcode/rating?username=tourist"
+
+# Test aggregator
+curl "http://localhost:3000/api/v1/ratings?username=tourist"
+```
+
+### MCP Tool Testing
+
+```bash
+# Launch MCP Inspector
+pnpm inspect
+
+# Test in MCP Inspector UI at http://localhost:6274
+# Select tool: get_leetcode_user_rating
+# Input: { "username": "tourist" }
+```
+
+---
+
+## Technology Stack
+
+| Category | Package | Purpose |
+|----------|---------|---------|
+| **Runtime** | Node.js 18+ | JavaScript runtime |
+| **Framework** | Fastify 5.x | High-performance HTTP server |
+| **Language** | TypeScript 5.x | Type-safe development |
+| **HTTP Client** | Axios 1.x | External API requests |
+| **Validation** | Zod 4.x | Runtime type validation |
+| **Scraping** | Cheerio 1.x | HTML parsing (GFG) |
+| **Documentation** | @fastify/swagger | OpenAPI generation |
+| **AI Protocol** | @modelcontextprotocol/sdk | MCP server implementation |
+| **Package Manager** | pnpm 8+ | Fast, disk-efficient installs |
+
+---
+
+## Contributing
+
+### Guidelines
+
+1. **Maintain Vertical Slices**: New features must follow the handler → service → provider pattern.
+2. **Type Everything**: All functions must have explicit TypeScript types.
+3. **Schema Validation**: Add JSON Schema for all new endpoints.
+4. **No Cross-Module Imports**: Modules cannot import from other platform modules (use the aggregator pattern).
+5. **Update OpenAPI**: Add tags and descriptions for all new routes.
+
+### Pull Request Checklist
+
+- [ ] New vertical slice follows project structure
+- [ ] TypeScript types defined in `types.ts`
+- [ ] JSON Schema validation in `schemas.ts`
+- [ ] OpenAPI documentation updated
+- [ ] No cross-module dependencies
+- [ ] Tested via Swagger UI and MCP Inspector
+
+---
+
+## License
+
+**ISC** - See [LICENSE](LICENSE) for details.
+
+---
+
+## Project Status
+
+**Current Version:** 1.0.0  
+**Deployment:** Development (not production-ready - see Auditor Review)  
+**Maintained By:** [@Anujjoshi3105](https://github.com/Anujjoshi3105)
+
+For issues or feature requests, open a GitHub issue at [Anujjoshi3105/vortex](https://github.com/Anujjoshi3105/vortex).

docker-compose.yml

@@ -0,0 +1,17 @@
+version: '3.8'
+
+services:
+  api:
+    build: .
+    ports:
+      - "${PORT:-3000}:${PORT:-3000}"
+    env_file:
+      - .env
+    environment:
+      - NODE_ENV=production
+    restart: unless-stopped
+    healthcheck:
+      test: [ "CMD", "wget", "-qO-", "http://localhost:${PORT:-3000}/health" ]
+      interval: 30s
+      timeout: 10s
+      retries: 3

docs/ARCHITECTURE.md

@@ -0,0 +1,67 @@
+# Architecture Design
+
+## Overview
+
+Vortex is built using a **Feature-Based Plugin Architecture** with **Vertical Slices**. This design ensures that each platform integration (LeetCode, Codeforces, etc.) is self-contained, highly modular, and easy to maintain.
+
+## Modular Structure
+
+Each platform and the AI interface is implemented as a Fastify plugin located in `src/modules/{module_name}/`. This allows for:
+- **Isolation**: Changes in one platform don't affect others.
+- **Scalability**: Easy to add or remove platforms.
+- **Consistency**: Every module follows the same structure and design patterns.
+- **AI Integration**: Dedicated MCP module for real-time tool access for AI agents.
+
+
+## Vertical Slices
+
+Unlike traditional horizontal layering (where all controllers are in one folder, all services in another), we use vertical slices. All code related to a specific feature (like LeetCode) lives in one directory.
+
+### Layered Responsibilities
+
+Inside each module, we follow a strict layering pattern:
+
+1.  **Plugin Entry (`index.ts`)**: Exports the Fastify plugin.
+2.  **Routes (`routes.ts`)**: Defines endpoints, registers schemas, and assigns handlers.
+3.  **Handlers (`handlers/`)**: Extracts data from requests (params, query, body), calls services, and sends responses.
+4.  **Services (`services/`)**: Orchestrates business logic. Pure TypeScript, no Fastify dependencies.
+5.  **Provider (`provider.ts`)**: Handles external communication (HTTP, GraphQL, Scraping).
+6.  **Schemas (`schemas.ts`)**: JSON schemas for request/response validation (also used for Swagger).
+7.  **Types (`types.ts`)**: TypeScript interfaces for data structures.
+ 
+ ### MCP Module Structure
+ 
+ The `src/modules/mcp/` module follows a slightly different structure to support the Model Context Protocol:
+ - **`tools/`**: Implementation of AI-callable tools.
+ - **`prompts/`**: Pre-defined prompts for LLM guidance.
+ - **`resources/`**: Static or dynamic data resources exposed to agents.
+ - **`index.ts`**: Plugin registration using `fastify-mcp`.
+
+
+
+## Data Flow
+
+```mermaid
+graph TD
+    User([User]) -->|HTTP Request| Server[Fastify Server]
+    Server -->|Routes| Handler[Handler Layer]
+    Handler -->|Params/Query| Service[Service Layer]
+    Service -->|Business Logic| Provider[Provider Layer]
+    Provider -->|Fetch| ExternalAPI[(External API / Web)]
+    ExternalAPI -->|Data| Provider
+    Provider -->|Raw Data| Service
+    Service -->|Model/Format| Handler
+    Handler -->|JSON Response| User
+```
+
+## Shared Infrastructure
+
+-   **`src/shared/`**: Common utilities, midlewares, and HTTP clients used across modules.
+-   **`src/config/`**: Environment variable management using `fastify-env`.
+-   **`src/types/`**: Global type definitions and Fastify type augmentation.
+
+## Performance & Validation
+
+-   **JSON Schema**: Every route uses high-performance JSON schema validation.
+-   **Serialization**: Fastify uses `fast-json-stringify` for lightning-fast responses based on our schemas.
+-   **TypeScript**: Full end-to-end type safety from provider to handler.

package.json

@@ -0,0 +1,32 @@
+{
+  "name": "vortex",
+  "version": "1.0.0",
+  "main": "dist/server.js",
+  "scripts": {
+    "dev": "nodemon src/server.ts",
+    "start": "node dist/server.js",
+    "build": "tsc",
+    "inspect": "npx @modelcontextprotocol/inspector"
+  },
+  "author": "",
+  "license": "ISC",
+  "description": "API for contest-related operations",
+  "dependencies": {
+    "@fastify/cors": "^11.2.0",
+    "@fastify/swagger": "^9.6.1",
+    "@fastify/swagger-ui": "^5.2.4",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "axios": "^1.7.9",
+    "cheerio": "^1.0.0",
+    "dotenv": "^16.4.7",
+    "fastify": "^5.7.2",
+    "fastify-mcp": "^2.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "nodemon": "^3.1.7",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}

pnpm-lock.yaml

@@ -0,0 +1,1936 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      '@fastify/cors':
+        specifier: ^11.2.0
+        version: 11.2.0
+      '@fastify/env':
+        specifier: ^5.0.3
+        version: 5.0.3
+      '@fastify/formbody':
+        specifier: ^8.0.2
+        version: 8.0.2
+      '@fastify/swagger':
+        specifier: ^9.6.1
+        version: 9.6.1
+      '@fastify/swagger-ui':
+        specifier: ^5.2.4
+        version: 5.2.4
+      '@modelcontextprotocol/sdk':
+        specifier: ^1.25.3
+        version: 1.25.3(hono@4.11.6)(zod@4.3.6)
+      axios:
+        specifier: ^1.7.9
+        version: 1.13.3
+      cheerio:
+        specifier: ^1.0.0
+        version: 1.2.0
+      dotenv:
+        specifier: ^16.4.7
+        version: 16.6.1
+      fastify:
+        specifier: ^5.7.2
+        version: 5.7.2
+      fastify-mcp:
+        specifier: ^2.1.0
+        version: 2.1.0(hono@4.11.6)(zod@4.3.6)
+      zod:
+        specifier: ^4.3.6
+        version: 4.3.6
+    devDependencies:
+      '@types/node':
+        specifier: ^25.0.10
+        version: 25.0.10
+      nodemon:
+        specifier: ^3.1.7
+        version: 3.1.11
+      ts-node:
+        specifier: ^10.9.2
+        version: 10.9.2(@types/node@25.0.10)(typescript@5.9.3)
+      typescript:
+        specifier: ^5.9.3
+        version: 5.9.3
+
+packages:
+
+  '@cspotcode/source-map-support@0.8.1':
+    resolution: {integrity: sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==}
+    engines: {node: '>=12'}
+
+  '@fastify/accept-negotiator@2.0.1':
+    resolution: {integrity: sha512-/c/TW2bO/v9JeEgoD/g1G5GxGeCF1Hafdf79WPmUlgYiBXummY0oX3VVq4yFkKKVBKDNlaDUYoab7g38RpPqCQ==}
+
+  '@fastify/ajv-compiler@4.0.5':
+    resolution: {integrity: sha512-KoWKW+MhvfTRWL4qrhUwAAZoaChluo0m0vbiJlGMt2GXvL4LVPQEjt8kSpHI3IBq5Rez8fg+XeH3cneztq+C7A==}
+
+  '@fastify/cors@11.2.0':
+    resolution: {integrity: sha512-LbLHBuSAdGdSFZYTLVA3+Ch2t+sA6nq3Ejc6XLAKiQ6ViS2qFnvicpj0htsx03FyYeLs04HfRNBsz/a8SvbcUw==}
+
+  '@fastify/env@5.0.3':
+    resolution: {integrity: sha512-VqXKcw+keaZaCry9dDtphDQy6l+B1UOodk4q57NdIK/tjZsPMYEBTXjEDiZCAiD9KaGJXbJOMgYdgejU1iD0jA==}
+
+  '@fastify/error@4.2.0':
+    resolution: {integrity: sha512-RSo3sVDXfHskiBZKBPRgnQTtIqpi/7zhJOEmAxCiBcM7d0uwdGdxLlsCaLzGs8v8NnxIRlfG0N51p5yFaOentQ==}
+
+  '@fastify/fast-json-stringify-compiler@5.0.3':
+    resolution: {integrity: sha512-uik7yYHkLr6fxd8hJSZ8c+xF4WafPK+XzneQDPU+D10r5X19GW8lJcom2YijX2+qtFF1ENJlHXKFM9ouXNJYgQ==}
+
+  '@fastify/formbody@8.0.2':
+    resolution: {integrity: sha512-84v5J2KrkXzjgBpYnaNRPqwgMsmY7ZDjuj0YVuMR3NXCJRCgKEZy/taSP1wUYGn0onfxJpLyRGDLa+NMaDJtnA==}
+
+  '@fastify/forwarded@3.0.1':
+    resolution: {integrity: sha512-JqDochHFqXs3C3Ml3gOY58zM7OqO9ENqPo0UqAjAjH8L01fRZqwX9iLeX34//kiJubF7r2ZQHtBRU36vONbLlw==}
+
+  '@fastify/merge-json-schemas@0.2.1':
+    resolution: {integrity: sha512-OA3KGBCy6KtIvLf8DINC5880o5iBlDX4SxzLQS8HorJAbqluzLRn80UXU0bxZn7UOFhFgpRJDasfwn9nG4FG4A==}
+
+  '@fastify/proxy-addr@5.1.0':
+    resolution: {integrity: sha512-INS+6gh91cLUjB+PVHfu1UqcB76Sqtpyp7bnL+FYojhjygvOPA9ctiD/JDKsyD9Xgu4hUhCSJBPig/w7duNajw==}
+
+  '@fastify/send@4.1.0':
+    resolution: {integrity: sha512-TMYeQLCBSy2TOFmV95hQWkiTYgC/SEx7vMdV+wnZVX4tt8VBLKzmH8vV9OzJehV0+XBfg+WxPMt5wp+JBUKsVw==}
+
+  '@fastify/static@9.0.0':
+    resolution: {integrity: sha512-r64H8Woe/vfilg5RTy7lwWlE8ZZcTrc3kebYFMEUBrMqlydhQyoiExQXdYAy2REVpST/G35+stAM8WYp1WGmMA==}
+
+  '@fastify/swagger-ui@5.2.4':
+    resolution: {integrity: sha512-Maw8OYPUDxlOzKQd3VMv7T/fmjf2h6BWR3XHkhk3dD3rIfzO7C/UPnzGuTpOGMqw1HCUnctADBbeTNAzAwzUqA==}
+
+  '@fastify/swagger@9.6.1':
+    resolution: {integrity: sha512-fKlpJqFMWoi4H3EdUkDaMteEYRCfQMEkK0HJJ0eaf4aRlKd8cbq0pVkOfXDXmtvMTXYcnx3E+l023eFDBsA1HA==}
+
+  '@hono/node-server@1.19.9':
+    resolution: {integrity: sha512-vHL6w3ecZsky+8P5MD+eFfaGTyCeOHUIFYMGpQGbrBTSmNNoxv0if69rEZ5giu36weC5saFuznL411gRX7bJDw==}
+    engines: {node: '>=18.14.1'}
+    peerDependencies:
+      hono: ^4
+
+  '@isaacs/balanced-match@4.0.1':
+    resolution: {integrity: sha512-yzMTt9lEb8Gv7zRioUilSglI0c0smZ9k5D65677DLWLtWJaXIS3CqcGyUFByYKlnUj6TkjLVs54fBl6+TiGQDQ==}
+    engines: {node: 20 || >=22}
+
+  '@isaacs/brace-expansion@5.0.0':
+    resolution: {integrity: sha512-ZT55BDLV0yv0RBm2czMiZ+SqCGO7AvmOM3G/w2xhVPH+te0aKgFjmBvGlL1dH+ql2tgGO3MVrbb3jCKyvpgnxA==}
+    engines: {node: 20 || >=22}
+
+  '@jridgewell/resolve-uri@3.1.2':
+    resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==}
+    engines: {node: '>=6.0.0'}
+
+  '@jridgewell/sourcemap-codec@1.5.5':
+    resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==}
+
+  '@jridgewell/trace-mapping@0.3.9':
+    resolution: {integrity: sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==}
+
+  '@lukeed/ms@2.0.2':
+    resolution: {integrity: sha512-9I2Zn6+NJLfaGoz9jN3lpwDgAYvfGeNYdbAIjJOqzs4Tpc+VU3Jqq4IofSUBKajiDS8k9fZIg18/z13mpk1bsA==}
+    engines: {node: '>=8'}
+
+  '@modelcontextprotocol/sdk@1.25.3':
+    resolution: {integrity: sha512-vsAMBMERybvYgKbg/l4L1rhS7VXV1c0CtyJg72vwxONVX0l4ZfKVAnZEWTQixJGTzKnELjQ59e4NbdFDALRiAQ==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@cfworker/json-schema': ^4.1.1
+      zod: ^3.25 || ^4.0
+    peerDependenciesMeta:
+      '@cfworker/json-schema':
+        optional: true
+
+  '@pinojs/redact@0.4.0':
+    resolution: {integrity: sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg==}
+
+  '@tsconfig/node10@1.0.12':
+    resolution: {integrity: sha512-UCYBaeFvM11aU2y3YPZ//O5Rhj+xKyzy7mvcIoAjASbigy8mHMryP5cK7dgjlz2hWxh1g5pLw084E0a/wlUSFQ==}
+
+  '@tsconfig/node12@1.0.11':
+    resolution: {integrity: sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==}
+
+  '@tsconfig/node14@1.0.3':
+    resolution: {integrity: sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==}
+
+  '@tsconfig/node16@1.0.4':
+    resolution: {integrity: sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==}
+
+  '@types/node@25.0.10':
+    resolution: {integrity: sha512-zWW5KPngR/yvakJgGOmZ5vTBemDoSqF3AcV/LrO5u5wTWyEAVVh+IT39G4gtyAkh3CtTZs8aX/yRM82OfzHJRg==}
+
+  abstract-logging@2.0.1:
+    resolution: {integrity: sha512-2BjRTZxTPvheOvGbBslFSYOUkr+SjPtOnrLP33f+VIWLzezQpZcqVg7ja3L4dBXmzzgwT+a029jRx5PCi3JuiA==}
+
+  accepts@2.0.0:
+    resolution: {integrity: sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==}
+    engines: {node: '>= 0.6'}
+
+  acorn-walk@8.3.4:
+    resolution: {integrity: sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==}
+    engines: {node: '>=0.4.0'}
+
+  acorn@8.15.0:
+    resolution: {integrity: sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==}
+    engines: {node: '>=0.4.0'}
+    hasBin: true
+
+  ajv-formats@3.0.1:
+    resolution: {integrity: sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==}
+    peerDependencies:
+      ajv: ^8.0.0
+    peerDependenciesMeta:
+      ajv:
+        optional: true
+
+  ajv@8.17.1:
+    resolution: {integrity: sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==}
+
+  anymatch@3.1.3:
+    resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==}
+    engines: {node: '>= 8'}
+
+  arg@4.1.3:
+    resolution: {integrity: sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==}
+
+  asynckit@0.4.0:
+    resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==}
+
+  atomic-sleep@1.0.0:
+    resolution: {integrity: sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ==}
+    engines: {node: '>=8.0.0'}
+
+  avvio@9.1.0:
+    resolution: {integrity: sha512-fYASnYi600CsH/j9EQov7lECAniYiBFiiAtBNuZYLA2leLe9qOvZzqYHFjtIj6gD2VMoMLP14834LFWvr4IfDw==}
+
+  axios@1.13.3:
+    resolution: {integrity: sha512-ERT8kdX7DZjtUm7IitEyV7InTHAF42iJuMArIiDIV5YtPanJkgw4hw5Dyg9fh0mihdWNn1GKaeIWErfe56UQ1g==}
+
+  balanced-match@1.0.2:
+    resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
+
+  binary-extensions@2.3.0:
+    resolution: {integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==}
+    engines: {node: '>=8'}
+
+  body-parser@2.2.2:
+    resolution: {integrity: sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA==}
+    engines: {node: '>=18'}
+
+  boolbase@1.0.0:
+    resolution: {integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==}
+
+  brace-expansion@1.1.12:
+    resolution: {integrity: sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==}
+
+  braces@3.0.3:
+    resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==}
+    engines: {node: '>=8'}
+
+  bytes@3.1.2:
+    resolution: {integrity: sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==}
+    engines: {node: '>= 0.8'}
+
+  call-bind-apply-helpers@1.0.2:
+    resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==}
+    engines: {node: '>= 0.4'}
+
+  call-bound@1.0.4:
+    resolution: {integrity: sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==}
+    engines: {node: '>= 0.4'}
+
+  cheerio-select@2.1.0:
+    resolution: {integrity: sha512-9v9kG0LvzrlcungtnJtpGNxY+fzECQKhK4EGJX2vByejiMX84MFNQw4UxPJl3bFbTMw+Dfs37XaIkCwTZfLh4g==}
+
+  cheerio@1.2.0:
+    resolution: {integrity: sha512-WDrybc/gKFpTYQutKIK6UvfcuxijIZfMfXaYm8NMsPQxSYvf+13fXUJ4rztGGbJcBQ/GF55gvrZ0Bc0bj/mqvg==}
+    engines: {node: '>=20.18.1'}
+
+  chokidar@3.6.0:
+    resolution: {integrity: sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==}
+    engines: {node: '>= 8.10.0'}
+
+  combined-stream@1.0.8:
+    resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==}
+    engines: {node: '>= 0.8'}
+
+  concat-map@0.0.1:
+    resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==}
+
+  content-disposition@1.0.1:
+    resolution: {integrity: sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q==}
+    engines: {node: '>=18'}
+
+  content-type@1.0.5:
+    resolution: {integrity: sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==}
+    engines: {node: '>= 0.6'}
+
+  cookie-signature@1.2.2:
+    resolution: {integrity: sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==}
+    engines: {node: '>=6.6.0'}
+
+  cookie@0.7.2:
+    resolution: {integrity: sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==}
+    engines: {node: '>= 0.6'}
+
+  cookie@1.1.1:
+    resolution: {integrity: sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==}
+    engines: {node: '>=18'}
+
+  cors@2.8.6:
+    resolution: {integrity: sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==}
+    engines: {node: '>= 0.10'}
+
+  create-require@1.1.1:
+    resolution: {integrity: sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==}
+
+  cross-spawn@7.0.6:
+    resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==}
+    engines: {node: '>= 8'}
+
+  css-select@5.2.2:
+    resolution: {integrity: sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==}
+
+  css-what@6.2.2:
+    resolution: {integrity: sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==}
+    engines: {node: '>= 6'}
+
+  debug@4.4.3:
+    resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==}
+    engines: {node: '>=6.0'}
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+
+  delayed-stream@1.0.0:
+    resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==}
+    engines: {node: '>=0.4.0'}
+
+  depd@2.0.0:
+    resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==}
+    engines: {node: '>= 0.8'}
+
+  dequal@2.0.3:
+    resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==}
+    engines: {node: '>=6'}
+
+  diff@4.0.4:
+    resolution: {integrity: sha512-X07nttJQkwkfKfvTPG/KSnE2OMdcUCao6+eXF3wmnIQRn2aPAHH3VxDbDOdegkd6JbPsXqShpvEOHfAT+nCNwQ==}
+    engines: {node: '>=0.3.1'}
+
+  dom-serializer@2.0.0:
+    resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==}
+
+  domelementtype@2.3.0:
+    resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==}
+
+  domhandler@5.0.3:
+    resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==}
+    engines: {node: '>= 4'}
+
+  domutils@3.2.2:
+    resolution: {integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==}
+
+  dotenv-expand@10.0.0:
+    resolution: {integrity: sha512-GopVGCpVS1UKH75VKHGuQFqS1Gusej0z4FyQkPdwjil2gNIv+LNsqBlboOzpJFZKVT95GkCyWJbBSdFEFUWI2A==}
+    engines: {node: '>=12'}
+
+  dotenv@16.6.1:
+    resolution: {integrity: sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==}
+    engines: {node: '>=12'}
+
+  dotenv@17.2.3:
+    resolution: {integrity: sha512-JVUnt+DUIzu87TABbhPmNfVdBDt18BLOWjMUFJMSi/Qqg7NTYtabbvSNJGOJ7afbRuv9D/lngizHtP7QyLQ+9w==}
+    engines: {node: '>=12'}
+
+  dunder-proto@1.0.1:
+    resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}
+    engines: {node: '>= 0.4'}
+
+  ee-first@1.1.1:
+    resolution: {integrity: sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==}
+
+  encodeurl@2.0.0:
+    resolution: {integrity: sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==}
+    engines: {node: '>= 0.8'}
+
+  encoding-sniffer@0.2.1:
+    resolution: {integrity: sha512-5gvq20T6vfpekVtqrYQsSCFZ1wEg5+wW0/QaZMWkFr6BqD3NfKs0rLCx4rrVlSWJeZb5NBJgVLswK/w2MWU+Gw==}
+
+  entities@4.5.0:
+    resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==}
+    engines: {node: '>=0.12'}
+
+  entities@6.0.1:
+    resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
+    engines: {node: '>=0.12'}
+
+  entities@7.0.1:
+    resolution: {integrity: sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==}
+    engines: {node: '>=0.12'}
+
+  env-schema@6.1.0:
+    resolution: {integrity: sha512-TWtYV2jKe7bd/19kzvNGa8GRRrSwmIMarhcWBzuZYPbHtdlUdjYhnaFvxrO4+GvcwF10sEeVGzf9b/wqLIyf9A==}
+
+  es-define-property@1.0.1:
+    resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==}
+    engines: {node: '>= 0.4'}
+
+  es-errors@1.3.0:
+    resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==}
+    engines: {node: '>= 0.4'}
+
+  es-object-atoms@1.1.1:
+    resolution: {integrity: sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==}
+    engines: {node: '>= 0.4'}
+
+  es-set-tostringtag@2.1.0:
+    resolution: {integrity: sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==}
+    engines: {node: '>= 0.4'}
+
+  escape-html@1.0.3:
+    resolution: {integrity: sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==}
+
+  etag@1.8.1:
+    resolution: {integrity: sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==}
+    engines: {node: '>= 0.6'}
+
+  eventsource-parser@3.0.6:
+    resolution: {integrity: sha512-Vo1ab+QXPzZ4tCa8SwIHJFaSzy4R6SHf7BY79rFBDf0idraZWAkYrDjDj8uWaSm3S2TK+hJ7/t1CEmZ7jXw+pg==}
+    engines: {node: '>=18.0.0'}
+
+  eventsource@3.0.7:
+    resolution: {integrity: sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==}
+    engines: {node: '>=18.0.0'}
+
+  express-rate-limit@7.5.1:
+    resolution: {integrity: sha512-7iN8iPMDzOMHPUYllBEsQdWVB6fPDMPqwjBaFrgr4Jgr/+okjvzAy+UHlYYL/Vs0OsOrMkwS6PJDkFlJwoxUnw==}
+    engines: {node: '>= 16'}
+    peerDependencies:
+      express: '>= 4.11'
+
+  express@5.2.1:
+    resolution: {integrity: sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==}
+    engines: {node: '>= 18'}
+
+  fast-decode-uri-component@1.0.1:
+    resolution: {integrity: sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg==}
+
+  fast-deep-equal@3.1.3:
+    resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
+
+  fast-json-stringify@6.2.0:
+    resolution: {integrity: sha512-Eaf/KNIDwHkzfyeQFNfLXJnQ7cl1XQI3+zRqmPlvtkMigbXnAcasTrvJQmquBSxKfFGeRA6PFog8t+hFmpDoWw==}
+
+  fast-querystring@1.1.2:
+    resolution: {integrity: sha512-g6KuKWmFXc0fID8WWH0jit4g0AGBoJhCkJMb1RmbsSEUNvQ+ZC8D6CUZ+GtF8nMzSPXnhiePyyqqipzNNEnHjg==}
+
+  fast-uri@3.1.0:
+    resolution: {integrity: sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==}
+
+  fastify-mcp@2.1.0:
+    resolution: {integrity: sha512-nx1Es7kEqzYe3COWwqdzQbtjgGJVKXFow6pd6rKKsByyXANdJAkEXAXeIJ+ox/vhGD26X7yX6pDDGmaezkBy6g==}
+
+  fastify-plugin@5.1.0:
+    resolution: {integrity: sha512-FAIDA8eovSt5qcDgcBvDuX/v0Cjz0ohGhENZ/wpc3y+oZCY2afZ9Baqql3g/lC+OHRnciQol4ww7tuthOb9idw==}
+
+  fastify@5.7.2:
+    resolution: {integrity: sha512-dBJolW+hm6N/yJVf6J5E1BxOBNkuXNl405nrfeR8SpvGWG3aCC2XDHyiFBdow8Win1kj7sjawQc257JlYY6M/A==}
+
+  fastq@1.20.1:
+    resolution: {integrity: sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==}
+
+  fill-range@7.1.1:
+    resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==}
+    engines: {node: '>=8'}
+
+  finalhandler@2.1.1:
+    resolution: {integrity: sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==}
+    engines: {node: '>= 18.0.0'}
+
+  find-my-way@9.4.0:
+    resolution: {integrity: sha512-5Ye4vHsypZRYtS01ob/iwHzGRUDELlsoCftI/OZFhcLs1M0tkGPcXldE80TAZC5yYuJMBPJQQ43UHlqbJWiX2w==}
+    engines: {node: '>=20'}
+
+  follow-redirects@1.15.11:
+    resolution: {integrity: sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==}
+    engines: {node: '>=4.0'}
+    peerDependencies:
+      debug: '*'
+    peerDependenciesMeta:
+      debug:
+        optional: true
+
+  form-data@4.0.5:
+    resolution: {integrity: sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==}
+    engines: {node: '>= 6'}
+
+  forwarded@0.2.0:
+    resolution: {integrity: sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==}
+    engines: {node: '>= 0.6'}
+
+  fresh@2.0.0:
+    resolution: {integrity: sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==}
+    engines: {node: '>= 0.8'}
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  function-bind@1.1.2:
+    resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==}
+
+  get-intrinsic@1.3.0:
+    resolution: {integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==}
+    engines: {node: '>= 0.4'}
+
+  get-proto@1.0.1:
+    resolution: {integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==}
+    engines: {node: '>= 0.4'}
+
+  glob-parent@5.1.2:
+    resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}
+    engines: {node: '>= 6'}
+
+  glob@13.0.0:
+    resolution: {integrity: sha512-tvZgpqk6fz4BaNZ66ZsRaZnbHvP/jG3uKJvAZOwEVUL4RTA5nJeeLYfyN9/VA8NX/V3IBG+hkeuGpKjvELkVhA==}
+    engines: {node: 20 || >=22}
+
+  gopd@1.2.0:
+    resolution: {integrity: sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==}
+    engines: {node: '>= 0.4'}
+
+  has-flag@3.0.0:
+    resolution: {integrity: sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==}
+    engines: {node: '>=4'}
+
+  has-symbols@1.1.0:
+    resolution: {integrity: sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==}
+    engines: {node: '>= 0.4'}
+
+  has-tostringtag@1.0.2:
+    resolution: {integrity: sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==}
+    engines: {node: '>= 0.4'}
+
+  hasown@2.0.2:
+    resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}
+    engines: {node: '>= 0.4'}
+
+  hono@4.11.6:
+    resolution: {integrity: sha512-ofIiiHyl34SV6AuhE3YT2mhO5HRWokce+eUYE82TsP6z0/H3JeJcjVWEMSIAiw2QkjDOEpES/lYsg8eEbsLtdw==}
+    engines: {node: '>=16.9.0'}
+
+  htmlparser2@10.1.0:
+    resolution: {integrity: sha512-VTZkM9GWRAtEpveh7MSF6SjjrpNVNNVJfFup7xTY3UpFtm67foy9HDVXneLtFVt4pMz5kZtgNcvCniNFb1hlEQ==}
+
+  http-errors@2.0.1:
+    resolution: {integrity: sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==}
+    engines: {node: '>= 0.8'}
+
+  iconv-lite@0.6.3:
+    resolution: {integrity: sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==}
+    engines: {node: '>=0.10.0'}
+
+  iconv-lite@0.7.2:
+    resolution: {integrity: sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==}
+    engines: {node: '>=0.10.0'}
+
+  ignore-by-default@1.0.1:
+    resolution: {integrity: sha512-Ius2VYcGNk7T90CppJqcIkS5ooHUZyIQK+ClZfMfMNFEF9VSE73Fq+906u/CWu92x4gzZMWOwfFYckPObzdEbA==}
+
+  inherits@2.0.4:
+    resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
+
+  ipaddr.js@1.9.1:
+    resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==}
+    engines: {node: '>= 0.10'}
+
+  ipaddr.js@2.3.0:
+    resolution: {integrity: sha512-Zv/pA+ciVFbCSBBjGfaKUya/CcGmUHzTydLMaTwrUUEM2DIEO3iZvueGxmacvmN50fGpGVKeTXpb2LcYQxeVdg==}
+    engines: {node: '>= 10'}
+
+  is-binary-path@2.1.0:
+    resolution: {integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==}
+    engines: {node: '>=8'}
+
+  is-extglob@2.1.1:
+    resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
+    engines: {node: '>=0.10.0'}
+
+  is-glob@4.0.3:
+    resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
+    engines: {node: '>=0.10.0'}
+
+  is-number@7.0.0:
+    resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
+    engines: {node: '>=0.12.0'}
+
+  is-promise@4.0.0:
+    resolution: {integrity: sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==}
+
+  isexe@2.0.0:
+    resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}
+
+  jose@6.1.3:
+    resolution: {integrity: sha512-0TpaTfihd4QMNwrz/ob2Bp7X04yuxJkjRGi4aKmOqwhov54i6u79oCv7T+C7lo70MKH6BesI3vscD1yb/yzKXQ==}
+
+  json-schema-ref-resolver@3.0.0:
+    resolution: {integrity: sha512-hOrZIVL5jyYFjzk7+y7n5JDzGlU8rfWDuYyHwGa2WA8/pcmMHezp2xsVwxrebD/Q9t8Nc5DboieySDpCp4WG4A==}
+
+  json-schema-resolver@3.0.0:
+    resolution: {integrity: sha512-HqMnbz0tz2DaEJ3ntsqtx3ezzZyDE7G56A/pPY/NGmrPu76UzsWquOpHFRAf5beTNXoH2LU5cQePVvRli1nchA==}
+    engines: {node: '>=20'}
+
+  json-schema-traverse@1.0.0:
+    resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==}
+
+  json-schema-typed@8.0.2:
+    resolution: {integrity: sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA==}
+
+  light-my-request@6.6.0:
+    resolution: {integrity: sha512-CHYbu8RtboSIoVsHZ6Ye4cj4Aw/yg2oAFimlF7mNvfDV192LR7nDiKtSIfCuLT7KokPSTn/9kfVLm5OGN0A28A==}
+
+  lru-cache@11.2.5:
+    resolution: {integrity: sha512-vFrFJkWtJvJnD5hg+hJvVE8Lh/TcMzKnTgCWmtBipwI5yLX/iX+5UB2tfuyODF5E7k9xEzMdYgGqaSb1c0c5Yw==}
+    engines: {node: 20 || >=22}
+
+  make-error@1.3.6:
+    resolution: {integrity: sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==}
+
+  math-intrinsics@1.1.0:
+    resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
+    engines: {node: '>= 0.4'}
+
+  media-typer@1.1.0:
+    resolution: {integrity: sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==}
+    engines: {node: '>= 0.8'}
+
+  merge-descriptors@2.0.0:
+    resolution: {integrity: sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==}
+    engines: {node: '>=18'}
+
+  mime-db@1.52.0:
+    resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==}
+    engines: {node: '>= 0.6'}
+
+  mime-db@1.54.0:
+    resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==}
+    engines: {node: '>= 0.6'}
+
+  mime-types@2.1.35:
+    resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==}
+    engines: {node: '>= 0.6'}
+
+  mime-types@3.0.2:
+    resolution: {integrity: sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==}
+    engines: {node: '>=18'}
+
+  mime@3.0.0:
+    resolution: {integrity: sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A==}
+    engines: {node: '>=10.0.0'}
+    hasBin: true
+
+  minimatch@10.1.1:
+    resolution: {integrity: sha512-enIvLvRAFZYXJzkCYG5RKmPfrFArdLv+R+lbQ53BmIMLIry74bjKzX6iHAm8WYamJkhSSEabrWN5D97XnKObjQ==}
+    engines: {node: 20 || >=22}
+
+  minimatch@3.1.2:
+    resolution: {integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==}
+
+  minipass@7.1.2:
+    resolution: {integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==}
+    engines: {node: '>=16 || 14 >=14.17'}
+
+  ms@2.1.3:
+    resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
+
+  negotiator@1.0.0:
+    resolution: {integrity: sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==}
+    engines: {node: '>= 0.6'}
+
+  nodemon@3.1.11:
+    resolution: {integrity: sha512-is96t8F/1//UHAjNPHpbsNY46ELPpftGUoSVNXwUfMk/qdjSylYrWSu1XavVTBOn526kFiOR733ATgNBCQyH0g==}
+    engines: {node: '>=10'}
+    hasBin: true
+
+  normalize-path@3.0.0:
+    resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
+    engines: {node: '>=0.10.0'}
+
+  nth-check@2.1.1:
+    resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==}
+
+  object-assign@4.1.1:
+    resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==}
+    engines: {node: '>=0.10.0'}
+
+  object-inspect@1.13.4:
+    resolution: {integrity: sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==}
+    engines: {node: '>= 0.4'}
+
+  on-exit-leak-free@2.1.2:
+    resolution: {integrity: sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA==}
+    engines: {node: '>=14.0.0'}
+
+  on-finished@2.4.1:
+    resolution: {integrity: sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==}
+    engines: {node: '>= 0.8'}
+
+  once@1.4.0:
+    resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==}
+
+  openapi-types@12.1.3:
+    resolution: {integrity: sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==}
+
+  parse5-htmlparser2-tree-adapter@7.1.0:
+    resolution: {integrity: sha512-ruw5xyKs6lrpo9x9rCZqZZnIUntICjQAd0Wsmp396Ul9lN/h+ifgVV1x1gZHi8euej6wTfpqX8j+BFQxF0NS/g==}
+
+  parse5-parser-stream@7.1.2:
+    resolution: {integrity: sha512-JyeQc9iwFLn5TbvvqACIF/VXG6abODeB3Fwmv/TGdLk2LfbWkaySGY72at4+Ty7EkPZj854u4CrICqNk2qIbow==}
+
+  parse5@7.3.0:
+    resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==}
+
+  parseurl@1.3.3:
+    resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==}
+    engines: {node: '>= 0.8'}
+
+  path-key@3.1.1:
+    resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==}
+    engines: {node: '>=8'}
+
+  path-scurry@2.0.1:
+    resolution: {integrity: sha512-oWyT4gICAu+kaA7QWk/jvCHWarMKNs6pXOGWKDTr7cw4IGcUbW+PeTfbaQiLGheFRpjo6O9J0PmyMfQPjH71oA==}
+    engines: {node: 20 || >=22}
+
+  path-to-regexp@8.3.0:
+    resolution: {integrity: sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==}
+
+  picomatch@2.3.1:
+    resolution: {integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==}
+    engines: {node: '>=8.6'}
+
+  pino-abstract-transport@3.0.0:
+    resolution: {integrity: sha512-wlfUczU+n7Hy/Ha5j9a/gZNy7We5+cXp8YL+X+PG8S0KXxw7n/JXA3c46Y0zQznIJ83URJiwy7Lh56WLokNuxg==}
+
+  pino-std-serializers@7.1.0:
+    resolution: {integrity: sha512-BndPH67/JxGExRgiX1dX0w1FvZck5Wa4aal9198SrRhZjH3GxKQUKIBnYJTdj2HDN3UQAS06HlfcSbQj2OHmaw==}
+
+  pino@10.3.0:
+    resolution: {integrity: sha512-0GNPNzHXBKw6U/InGe79A3Crzyk9bcSyObF9/Gfo9DLEf5qj5RF50RSjsu0W1rZ6ZqRGdzDFCRBQvi9/rSGPtA==}
+    hasBin: true
+
+  pkce-challenge@5.0.1:
+    resolution: {integrity: sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ==}
+    engines: {node: '>=16.20.0'}
+
+  process-warning@4.0.1:
+    resolution: {integrity: sha512-3c2LzQ3rY9d0hc1emcsHhfT9Jwz0cChib/QN89oME2R451w5fy3f0afAhERFZAwrbDU43wk12d0ORBpDVME50Q==}
+
+  process-warning@5.0.0:
+    resolution: {integrity: sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA==}
+
+  proxy-addr@2.0.7:
+    resolution: {integrity: sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==}
+    engines: {node: '>= 0.10'}
+
+  proxy-from-env@1.1.0:
+    resolution: {integrity: sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==}
+
+  pstree.remy@1.1.8:
+    resolution: {integrity: sha512-77DZwxQmxKnu3aR542U+X8FypNzbfJ+C5XQDk3uWjWxn6151aIMGthWYRXTqT1E5oJvg+ljaa2OJi+VfvCOQ8w==}
+
+  qs@6.14.1:
+    resolution: {integrity: sha512-4EK3+xJl8Ts67nLYNwqw/dsFVnCf+qR7RgXSK9jEEm9unao3njwMDdmsdvoKBKHzxd7tCYz5e5M+SnMjdtXGQQ==}
+    engines: {node: '>=0.6'}
+
+  quick-format-unescaped@4.0.4:
+    resolution: {integrity: sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg==}
+
+  range-parser@1.2.1:
+    resolution: {integrity: sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==}
+    engines: {node: '>= 0.6'}
+
+  raw-body@3.0.2:
+    resolution: {integrity: sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==}
+    engines: {node: '>= 0.10'}
+
+  readdirp@3.6.0:
+    resolution: {integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==}
+    engines: {node: '>=8.10.0'}
+
+  real-require@0.2.0:
+    resolution: {integrity: sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==}
+    engines: {node: '>= 12.13.0'}
+
+  require-from-string@2.0.2:
+    resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
+    engines: {node: '>=0.10.0'}
+
+  ret@0.5.0:
+    resolution: {integrity: sha512-I1XxrZSQ+oErkRR4jYbAyEEu2I0avBvvMM5JN+6EBprOGRCs63ENqZ3vjavq8fBw2+62G5LF5XelKwuJpcvcxw==}
+    engines: {node: '>=10'}
+
+  reusify@1.1.0:
+    resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
+    engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
+
+  rfdc@1.4.1:
+    resolution: {integrity: sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==}
+
+  router@2.2.0:
+    resolution: {integrity: sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==}
+    engines: {node: '>= 18'}
+
+  safe-regex2@5.0.0:
+    resolution: {integrity: sha512-YwJwe5a51WlK7KbOJREPdjNrpViQBI3p4T50lfwPuDhZnE3XGVTlGvi+aolc5+RvxDD6bnUmjVsU9n1eboLUYw==}
+
+  safe-stable-stringify@2.5.0:
+    resolution: {integrity: sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==}
+    engines: {node: '>=10'}
+
+  safer-buffer@2.1.2:
+    resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==}
+
+  secure-json-parse@4.1.0:
+    resolution: {integrity: sha512-l4KnYfEyqYJxDwlNVyRfO2E4NTHfMKAWdUuA8J0yve2Dz/E/PdBepY03RvyJpssIpRFwJoCD55wA+mEDs6ByWA==}
+
+  semver@7.7.3:
+    resolution: {integrity: sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==}
+    engines: {node: '>=10'}
+    hasBin: true
+
+  send@1.2.1:
+    resolution: {integrity: sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==}
+    engines: {node: '>= 18'}
+
+  serve-static@2.2.1:
+    resolution: {integrity: sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==}
+    engines: {node: '>= 18'}
+
+  set-cookie-parser@2.7.2:
+    resolution: {integrity: sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==}
+
+  setprototypeof@1.2.0:
+    resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==}
+
+  shebang-command@2.0.0:
+    resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==}
+    engines: {node: '>=8'}
+
+  shebang-regex@3.0.0:
+    resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
+    engines: {node: '>=8'}
+
+  side-channel-list@1.0.0:
+    resolution: {integrity: sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==}
+    engines: {node: '>= 0.4'}
+
+  side-channel-map@1.0.1:
+    resolution: {integrity: sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==}
+    engines: {node: '>= 0.4'}
+
+  side-channel-weakmap@1.0.2:
+    resolution: {integrity: sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==}
+    engines: {node: '>= 0.4'}
+
+  side-channel@1.1.0:
+    resolution: {integrity: sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==}
+    engines: {node: '>= 0.4'}
+
+  simple-update-notifier@2.0.0:
+    resolution: {integrity: sha512-a2B9Y0KlNXl9u/vsW6sTIu9vGEpfKu2wRV6l1H3XEas/0gUIzGzBoP/IouTcUQbm9JWZLH3COxyn03TYlFax6w==}
+    engines: {node: '>=10'}
+
+  sonic-boom@4.2.0:
+    resolution: {integrity: sha512-INb7TM37/mAcsGmc9hyyI6+QR3rR1zVRu36B0NeGXKnOOLiZOfER5SA+N7X7k3yUYRzLWafduTDvJAfDswwEww==}
+
+  split2@4.2.0:
+    resolution: {integrity: sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==}
+    engines: {node: '>= 10.x'}
+
+  statuses@2.0.2:
+    resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==}
+    engines: {node: '>= 0.8'}
+
+  supports-color@5.5.0:
+    resolution: {integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==}
+    engines: {node: '>=4'}
+
+  thread-stream@4.0.0:
+    resolution: {integrity: sha512-4iMVL6HAINXWf1ZKZjIPcz5wYaOdPhtO8ATvZ+Xqp3BTdaqtAwQkNmKORqcIo5YkQqGXq5cwfswDwMqqQNrpJA==}
+    engines: {node: '>=20'}
+
+  to-regex-range@5.0.1:
+    resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
+    engines: {node: '>=8.0'}
+
+  toad-cache@3.7.0:
+    resolution: {integrity: sha512-/m8M+2BJUpoJdgAHoG+baCwBT+tf2VraSfkBgl0Y00qIWt41DJ8R5B8nsEw0I58YwF5IZH6z24/2TobDKnqSWw==}
+    engines: {node: '>=12'}
+
+  toidentifier@1.0.1:
+    resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==}
+    engines: {node: '>=0.6'}
+
+  touch@3.1.1:
+    resolution: {integrity: sha512-r0eojU4bI8MnHr8c5bNo7lJDdI2qXlWWJk6a9EAFG7vbhTjElYhBVS3/miuE0uOuoLdb8Mc/rVfsmm6eo5o9GA==}
+    hasBin: true
+
+  ts-node@10.9.2:
+    resolution: {integrity: sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==}
+    hasBin: true
+    peerDependencies:
+      '@swc/core': '>=1.2.50'
+      '@swc/wasm': '>=1.2.50'
+      '@types/node': '*'
+      typescript: '>=2.7'
+    peerDependenciesMeta:
+      '@swc/core':
+        optional: true
+      '@swc/wasm':
+        optional: true
+
+  type-is@2.0.1:
+    resolution: {integrity: sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==}
+    engines: {node: '>= 0.6'}
+
+  typescript@5.9.3:
+    resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  undefsafe@2.0.5:
+    resolution: {integrity: sha512-WxONCrssBM8TSPRqN5EmsjVrsv4A8X12J4ArBiiayv3DyyG3ZlIg6yysuuSYdZsVz3TKcTg2fd//Ujd4CHV1iA==}
+
+  undici-types@7.16.0:
+    resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}
+
+  undici@7.19.1:
+    resolution: {integrity: sha512-Gpq0iNm5M6cQWlyHQv9MV+uOj1jWk7LpkoE5vSp/7zjb4zMdAcUD+VL5y0nH4p9EbUklq00eVIIX/XcDHzu5xg==}
+    engines: {node: '>=20.18.1'}
+
+  unpipe@1.0.0:
+    resolution: {integrity: sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==}
+    engines: {node: '>= 0.8'}
+
+  v8-compile-cache-lib@3.0.1:
+    resolution: {integrity: sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==}
+
+  vary@1.1.2:
+    resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==}
+    engines: {node: '>= 0.8'}
+
+  whatwg-encoding@3.1.1:
+    resolution: {integrity: sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==}
+    engines: {node: '>=18'}
+    deprecated: Use @exodus/bytes instead for a more spec-conformant and faster implementation
+
+  whatwg-mimetype@4.0.0:
+    resolution: {integrity: sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==}
+    engines: {node: '>=18'}
+
+  which@2.0.2:
+    resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==}
+    engines: {node: '>= 8'}
+    hasBin: true
+
+  wrappy@1.0.2:
+    resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}
+
+  yaml@2.8.2:
+    resolution: {integrity: sha512-mplynKqc1C2hTVYxd0PU2xQAc22TI1vShAYGksCCfxbn/dFwnHTNi1bvYsBTkhdUNtGIf5xNOg938rrSSYvS9A==}
+    engines: {node: '>= 14.6'}
+    hasBin: true
+
+  yn@3.1.1:
+    resolution: {integrity: sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==}
+    engines: {node: '>=6'}
+
+  zod-to-json-schema@3.25.1:
+    resolution: {integrity: sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA==}
+    peerDependencies:
+      zod: ^3.25 || ^4
+
+  zod@4.3.6:
+    resolution: {integrity: sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg==}
+
+snapshots:
+
+  '@cspotcode/source-map-support@0.8.1':
+    dependencies:
+      '@jridgewell/trace-mapping': 0.3.9
+
+  '@fastify/accept-negotiator@2.0.1': {}
+
+  '@fastify/ajv-compiler@4.0.5':
+    dependencies:
+      ajv: 8.17.1
+      ajv-formats: 3.0.1(ajv@8.17.1)
+      fast-uri: 3.1.0
+
+  '@fastify/cors@11.2.0':
+    dependencies:
+      fastify-plugin: 5.1.0
+      toad-cache: 3.7.0
+
+  '@fastify/env@5.0.3':
+    dependencies:
+      env-schema: 6.1.0
+      fastify-plugin: 5.1.0
+
+  '@fastify/error@4.2.0': {}
+
+  '@fastify/fast-json-stringify-compiler@5.0.3':
+    dependencies:
+      fast-json-stringify: 6.2.0
+
+  '@fastify/formbody@8.0.2':
+    dependencies:
+      fast-querystring: 1.1.2
+      fastify-plugin: 5.1.0
+
+  '@fastify/forwarded@3.0.1': {}
+
+  '@fastify/merge-json-schemas@0.2.1':
+    dependencies:
+      dequal: 2.0.3
+
+  '@fastify/proxy-addr@5.1.0':
+    dependencies:
+      '@fastify/forwarded': 3.0.1
+      ipaddr.js: 2.3.0
+
+  '@fastify/send@4.1.0':
+    dependencies:
+      '@lukeed/ms': 2.0.2
+      escape-html: 1.0.3
+      fast-decode-uri-component: 1.0.1
+      http-errors: 2.0.1
+      mime: 3.0.0
+
+  '@fastify/static@9.0.0':
+    dependencies:
+      '@fastify/accept-negotiator': 2.0.1
+      '@fastify/send': 4.1.0
+      content-disposition: 1.0.1
+      fastify-plugin: 5.1.0
+      fastq: 1.20.1
+      glob: 13.0.0
+
+  '@fastify/swagger-ui@5.2.4':
+    dependencies:
+      '@fastify/static': 9.0.0
+      fastify-plugin: 5.1.0
+      openapi-types: 12.1.3
+      rfdc: 1.4.1
+      yaml: 2.8.2
+
+  '@fastify/swagger@9.6.1':
+    dependencies:
+      fastify-plugin: 5.1.0
+      json-schema-resolver: 3.0.0
+      openapi-types: 12.1.3
+      rfdc: 1.4.1
+      yaml: 2.8.2
+    transitivePeerDependencies:
+      - supports-color
+
+  '@hono/node-server@1.19.9(hono@4.11.6)':
+    dependencies:
+      hono: 4.11.6
+
+  '@isaacs/balanced-match@4.0.1': {}
+
+  '@isaacs/brace-expansion@5.0.0':
+    dependencies:
+      '@isaacs/balanced-match': 4.0.1
+
+  '@jridgewell/resolve-uri@3.1.2': {}
+
+  '@jridgewell/sourcemap-codec@1.5.5': {}
+
+  '@jridgewell/trace-mapping@0.3.9':
+    dependencies:
+      '@jridgewell/resolve-uri': 3.1.2
+      '@jridgewell/sourcemap-codec': 1.5.5
+
+  '@lukeed/ms@2.0.2': {}
+
+  '@modelcontextprotocol/sdk@1.25.3(hono@4.11.6)(zod@4.3.6)':
+    dependencies:
+      '@hono/node-server': 1.19.9(hono@4.11.6)
+      ajv: 8.17.1
+      ajv-formats: 3.0.1(ajv@8.17.1)
+      content-type: 1.0.5
+      cors: 2.8.6
+      cross-spawn: 7.0.6
+      eventsource: 3.0.7
+      eventsource-parser: 3.0.6
+      express: 5.2.1
+      express-rate-limit: 7.5.1(express@5.2.1)
+      jose: 6.1.3
+      json-schema-typed: 8.0.2
+      pkce-challenge: 5.0.1
+      raw-body: 3.0.2
+      zod: 4.3.6
+      zod-to-json-schema: 3.25.1(zod@4.3.6)
+    transitivePeerDependencies:
+      - hono
+      - supports-color
+
+  '@pinojs/redact@0.4.0': {}
+
+  '@tsconfig/node10@1.0.12': {}
+
+  '@tsconfig/node12@1.0.11': {}
+
+  '@tsconfig/node14@1.0.3': {}
+
+  '@tsconfig/node16@1.0.4': {}
+
+  '@types/node@25.0.10':
+    dependencies:
+      undici-types: 7.16.0
+
+  abstract-logging@2.0.1: {}
+
+  accepts@2.0.0:
+    dependencies:
+      mime-types: 3.0.2
+      negotiator: 1.0.0
+
+  acorn-walk@8.3.4:
+    dependencies:
+      acorn: 8.15.0
+
+  acorn@8.15.0: {}
+
+  ajv-formats@3.0.1(ajv@8.17.1):
+    optionalDependencies:
+      ajv: 8.17.1
+
+  ajv@8.17.1:
+    dependencies:
+      fast-deep-equal: 3.1.3
+      fast-uri: 3.1.0
+      json-schema-traverse: 1.0.0
+      require-from-string: 2.0.2
+
+  anymatch@3.1.3:
+    dependencies:
+      normalize-path: 3.0.0
+      picomatch: 2.3.1
+
+  arg@4.1.3: {}
+
+  asynckit@0.4.0: {}
+
+  atomic-sleep@1.0.0: {}
+
+  avvio@9.1.0:
+    dependencies:
+      '@fastify/error': 4.2.0
+      fastq: 1.20.1
+
+  axios@1.13.3:
+    dependencies:
+      follow-redirects: 1.15.11
+      form-data: 4.0.5
+      proxy-from-env: 1.1.0
+    transitivePeerDependencies:
+      - debug
+
+  balanced-match@1.0.2: {}
+
+  binary-extensions@2.3.0: {}
+
+  body-parser@2.2.2:
+    dependencies:
+      bytes: 3.1.2
+      content-type: 1.0.5
+      debug: 4.4.3(supports-color@5.5.0)
+      http-errors: 2.0.1
+      iconv-lite: 0.7.2
+      on-finished: 2.4.1
+      qs: 6.14.1
+      raw-body: 3.0.2
+      type-is: 2.0.1
+    transitivePeerDependencies:
+      - supports-color
+
+  boolbase@1.0.0: {}
+
+  brace-expansion@1.1.12:
+    dependencies:
+      balanced-match: 1.0.2
+      concat-map: 0.0.1
+
+  braces@3.0.3:
+    dependencies:
+      fill-range: 7.1.1
+
+  bytes@3.1.2: {}
+
+  call-bind-apply-helpers@1.0.2:
+    dependencies:
+      es-errors: 1.3.0
+      function-bind: 1.1.2
+
+  call-bound@1.0.4:
+    dependencies:
+      call-bind-apply-helpers: 1.0.2
+      get-intrinsic: 1.3.0
+
+  cheerio-select@2.1.0:
+    dependencies:
+      boolbase: 1.0.0
+      css-select: 5.2.2
+      css-what: 6.2.2
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+      domutils: 3.2.2
+
+  cheerio@1.2.0:
+    dependencies:
+      cheerio-select: 2.1.0
+      dom-serializer: 2.0.0
+      domhandler: 5.0.3
+      domutils: 3.2.2
+      encoding-sniffer: 0.2.1
+      htmlparser2: 10.1.0
+      parse5: 7.3.0
+      parse5-htmlparser2-tree-adapter: 7.1.0
+      parse5-parser-stream: 7.1.2
+      undici: 7.19.1
+      whatwg-mimetype: 4.0.0
+
+  chokidar@3.6.0:
+    dependencies:
+      anymatch: 3.1.3
+      braces: 3.0.3
+      glob-parent: 5.1.2
+      is-binary-path: 2.1.0
+      is-glob: 4.0.3
+      normalize-path: 3.0.0
+      readdirp: 3.6.0
+    optionalDependencies:
+      fsevents: 2.3.3
+
+  combined-stream@1.0.8:
+    dependencies:
+      delayed-stream: 1.0.0
+
+  concat-map@0.0.1: {}
+
+  content-disposition@1.0.1: {}
+
+  content-type@1.0.5: {}
+
+  cookie-signature@1.2.2: {}
+
+  cookie@0.7.2: {}
+
+  cookie@1.1.1: {}
+
+  cors@2.8.6:
+    dependencies:
+      object-assign: 4.1.1
+      vary: 1.1.2
+
+  create-require@1.1.1: {}
+
+  cross-spawn@7.0.6:
+    dependencies:
+      path-key: 3.1.1
+      shebang-command: 2.0.0
+      which: 2.0.2
+
+  css-select@5.2.2:
+    dependencies:
+      boolbase: 1.0.0
+      css-what: 6.2.2
+      domhandler: 5.0.3
+      domutils: 3.2.2
+      nth-check: 2.1.1
+
+  css-what@6.2.2: {}
+
+  debug@4.4.3(supports-color@5.5.0):
+    dependencies:
+      ms: 2.1.3
+    optionalDependencies:
+      supports-color: 5.5.0
+
+  delayed-stream@1.0.0: {}
+
+  depd@2.0.0: {}
+
+  dequal@2.0.3: {}
+
+  diff@4.0.4: {}
+
+  dom-serializer@2.0.0:
+    dependencies:
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+      entities: 4.5.0
+
+  domelementtype@2.3.0: {}
+
+  domhandler@5.0.3:
+    dependencies:
+      domelementtype: 2.3.0
+
+  domutils@3.2.2:
+    dependencies:
+      dom-serializer: 2.0.0
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+
+  dotenv-expand@10.0.0: {}
+
+  dotenv@16.6.1: {}
+
+  dotenv@17.2.3: {}
+
+  dunder-proto@1.0.1:
+    dependencies:
+      call-bind-apply-helpers: 1.0.2
+      es-errors: 1.3.0
+      gopd: 1.2.0
+
+  ee-first@1.1.1: {}
+
+  encodeurl@2.0.0: {}
+
+  encoding-sniffer@0.2.1:
+    dependencies:
+      iconv-lite: 0.6.3
+      whatwg-encoding: 3.1.1
+
+  entities@4.5.0: {}
+
+  entities@6.0.1: {}
+
+  entities@7.0.1: {}
+
+  env-schema@6.1.0:
+    dependencies:
+      ajv: 8.17.1
+      dotenv: 17.2.3
+      dotenv-expand: 10.0.0
+
+  es-define-property@1.0.1: {}
+
+  es-errors@1.3.0: {}
+
+  es-object-atoms@1.1.1:
+    dependencies:
+      es-errors: 1.3.0
+
+  es-set-tostringtag@2.1.0:
+    dependencies:
+      es-errors: 1.3.0
+      get-intrinsic: 1.3.0
+      has-tostringtag: 1.0.2
+      hasown: 2.0.2
+
+  escape-html@1.0.3: {}
+
+  etag@1.8.1: {}
+
+  eventsource-parser@3.0.6: {}
+
+  eventsource@3.0.7:
+    dependencies:
+      eventsource-parser: 3.0.6
+
+  express-rate-limit@7.5.1(express@5.2.1):
+    dependencies:
+      express: 5.2.1
+
+  express@5.2.1:
+    dependencies:
+      accepts: 2.0.0
+      body-parser: 2.2.2
+      content-disposition: 1.0.1
+      content-type: 1.0.5
+      cookie: 0.7.2
+      cookie-signature: 1.2.2
+      debug: 4.4.3(supports-color@5.5.0)
+      depd: 2.0.0
+      encodeurl: 2.0.0
+      escape-html: 1.0.3
+      etag: 1.8.1
+      finalhandler: 2.1.1
+      fresh: 2.0.0
+      http-errors: 2.0.1
+      merge-descriptors: 2.0.0
+      mime-types: 3.0.2
+      on-finished: 2.4.1
+      once: 1.4.0
+      parseurl: 1.3.3
+      proxy-addr: 2.0.7
+      qs: 6.14.1
+      range-parser: 1.2.1
+      router: 2.2.0
+      send: 1.2.1
+      serve-static: 2.2.1
+      statuses: 2.0.2
+      type-is: 2.0.1
+      vary: 1.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  fast-decode-uri-component@1.0.1: {}
+
+  fast-deep-equal@3.1.3: {}
+
+  fast-json-stringify@6.2.0:
+    dependencies:
+      '@fastify/merge-json-schemas': 0.2.1
+      ajv: 8.17.1
+      ajv-formats: 3.0.1(ajv@8.17.1)
+      fast-uri: 3.1.0
+      json-schema-ref-resolver: 3.0.0
+      rfdc: 1.4.1
+
+  fast-querystring@1.1.2:
+    dependencies:
+      fast-decode-uri-component: 1.0.1
+
+  fast-uri@3.1.0: {}
+
+  fastify-mcp@2.1.0(hono@4.11.6)(zod@4.3.6):
+    dependencies:
+      '@modelcontextprotocol/sdk': 1.25.3(hono@4.11.6)(zod@4.3.6)
+      fastify: 5.7.2
+    transitivePeerDependencies:
+      - '@cfworker/json-schema'
+      - hono
+      - supports-color
+      - zod
+
+  fastify-plugin@5.1.0: {}
+
+  fastify@5.7.2:
+    dependencies:
+      '@fastify/ajv-compiler': 4.0.5
+      '@fastify/error': 4.2.0
+      '@fastify/fast-json-stringify-compiler': 5.0.3
+      '@fastify/proxy-addr': 5.1.0
+      abstract-logging: 2.0.1
+      avvio: 9.1.0
+      fast-json-stringify: 6.2.0
+      find-my-way: 9.4.0
+      light-my-request: 6.6.0
+      pino: 10.3.0
+      process-warning: 5.0.0
+      rfdc: 1.4.1
+      secure-json-parse: 4.1.0
+      semver: 7.7.3
+      toad-cache: 3.7.0
+
+  fastq@1.20.1:
+    dependencies:
+      reusify: 1.1.0
+
+  fill-range@7.1.1:
+    dependencies:
+      to-regex-range: 5.0.1
+
+  finalhandler@2.1.1:
+    dependencies:
+      debug: 4.4.3(supports-color@5.5.0)
+      encodeurl: 2.0.0
+      escape-html: 1.0.3
+      on-finished: 2.4.1
+      parseurl: 1.3.3
+      statuses: 2.0.2
+    transitivePeerDependencies:
+      - supports-color
+
+  find-my-way@9.4.0:
+    dependencies:
+      fast-deep-equal: 3.1.3
+      fast-querystring: 1.1.2
+      safe-regex2: 5.0.0
+
+  follow-redirects@1.15.11: {}
+
+  form-data@4.0.5:
+    dependencies:
+      asynckit: 0.4.0
+      combined-stream: 1.0.8
+      es-set-tostringtag: 2.1.0
+      hasown: 2.0.2
+      mime-types: 2.1.35
+
+  forwarded@0.2.0: {}
+
+  fresh@2.0.0: {}
+
+  fsevents@2.3.3:
+    optional: true
+
+  function-bind@1.1.2: {}
+
+  get-intrinsic@1.3.0:
+    dependencies:
+      call-bind-apply-helpers: 1.0.2
+      es-define-property: 1.0.1
+      es-errors: 1.3.0
+      es-object-atoms: 1.1.1
+      function-bind: 1.1.2
+      get-proto: 1.0.1
+      gopd: 1.2.0
+      has-symbols: 1.1.0
+      hasown: 2.0.2
+      math-intrinsics: 1.1.0
+
+  get-proto@1.0.1:
+    dependencies:
+      dunder-proto: 1.0.1
+      es-object-atoms: 1.1.1
+
+  glob-parent@5.1.2:
+    dependencies:
+      is-glob: 4.0.3
+
+  glob@13.0.0:
+    dependencies:
+      minimatch: 10.1.1
+      minipass: 7.1.2
+      path-scurry: 2.0.1
+
+  gopd@1.2.0: {}
+
+  has-flag@3.0.0: {}
+
+  has-symbols@1.1.0: {}
+
+  has-tostringtag@1.0.2:
+    dependencies:
+      has-symbols: 1.1.0
+
+  hasown@2.0.2:
+    dependencies:
+      function-bind: 1.1.2
+
+  hono@4.11.6: {}
+
+  htmlparser2@10.1.0:
+    dependencies:
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+      domutils: 3.2.2
+      entities: 7.0.1
+
+  http-errors@2.0.1:
+    dependencies:
+      depd: 2.0.0
+      inherits: 2.0.4
+      setprototypeof: 1.2.0
+      statuses: 2.0.2
+      toidentifier: 1.0.1
+
+  iconv-lite@0.6.3:
+    dependencies:
+      safer-buffer: 2.1.2
+
+  iconv-lite@0.7.2:
+    dependencies:
+      safer-buffer: 2.1.2
+
+  ignore-by-default@1.0.1: {}
+
+  inherits@2.0.4: {}
+
+  ipaddr.js@1.9.1: {}
+
+  ipaddr.js@2.3.0: {}
+
+  is-binary-path@2.1.0:
+    dependencies:
+      binary-extensions: 2.3.0
+
+  is-extglob@2.1.1: {}
+
+  is-glob@4.0.3:
+    dependencies:
+      is-extglob: 2.1.1
+
+  is-number@7.0.0: {}
+
+  is-promise@4.0.0: {}
+
+  isexe@2.0.0: {}
+
+  jose@6.1.3: {}
+
+  json-schema-ref-resolver@3.0.0:
+    dependencies:
+      dequal: 2.0.3
+
+  json-schema-resolver@3.0.0:
+    dependencies:
+      debug: 4.4.3(supports-color@5.5.0)
+      fast-uri: 3.1.0
+      rfdc: 1.4.1
+    transitivePeerDependencies:
+      - supports-color
+
+  json-schema-traverse@1.0.0: {}
+
+  json-schema-typed@8.0.2: {}
+
+  light-my-request@6.6.0:
+    dependencies:
+      cookie: 1.1.1
+      process-warning: 4.0.1
+      set-cookie-parser: 2.7.2
+
+  lru-cache@11.2.5: {}
+
+  make-error@1.3.6: {}
+
+  math-intrinsics@1.1.0: {}
+
+  media-typer@1.1.0: {}
+
+  merge-descriptors@2.0.0: {}
+
+  mime-db@1.52.0: {}
+
+  mime-db@1.54.0: {}
+
+  mime-types@2.1.35:
+    dependencies:
+      mime-db: 1.52.0
+
+  mime-types@3.0.2:
+    dependencies:
+      mime-db: 1.54.0
+
+  mime@3.0.0: {}
+
+  minimatch@10.1.1:
+    dependencies:
+      '@isaacs/brace-expansion': 5.0.0
+
+  minimatch@3.1.2:
+    dependencies:
+      brace-expansion: 1.1.12
+
+  minipass@7.1.2: {}
+
+  ms@2.1.3: {}
+
+  negotiator@1.0.0: {}
+
+  nodemon@3.1.11:
+    dependencies:
+      chokidar: 3.6.0
+      debug: 4.4.3(supports-color@5.5.0)
+      ignore-by-default: 1.0.1
+      minimatch: 3.1.2
+      pstree.remy: 1.1.8
+      semver: 7.7.3
+      simple-update-notifier: 2.0.0
+      supports-color: 5.5.0
+      touch: 3.1.1
+      undefsafe: 2.0.5
+
+  normalize-path@3.0.0: {}
+
+  nth-check@2.1.1:
+    dependencies:
+      boolbase: 1.0.0
+
+  object-assign@4.1.1: {}
+
+  object-inspect@1.13.4: {}
+
+  on-exit-leak-free@2.1.2: {}
+
+  on-finished@2.4.1:
+    dependencies:
+      ee-first: 1.1.1
+
+  once@1.4.0:
+    dependencies:
+      wrappy: 1.0.2
+
+  openapi-types@12.1.3: {}
+
+  parse5-htmlparser2-tree-adapter@7.1.0:
+    dependencies:
+      domhandler: 5.0.3
+      parse5: 7.3.0
+
+  parse5-parser-stream@7.1.2:
+    dependencies:
+      parse5: 7.3.0
+
+  parse5@7.3.0:
+    dependencies:
+      entities: 6.0.1
+
+  parseurl@1.3.3: {}
+
+  path-key@3.1.1: {}
+
+  path-scurry@2.0.1:
+    dependencies:
+      lru-cache: 11.2.5
+      minipass: 7.1.2
+
+  path-to-regexp@8.3.0: {}
+
+  picomatch@2.3.1: {}
+
+  pino-abstract-transport@3.0.0:
+    dependencies:
+      split2: 4.2.0
+
+  pino-std-serializers@7.1.0: {}
+
+  pino@10.3.0:
+    dependencies:
+      '@pinojs/redact': 0.4.0
+      atomic-sleep: 1.0.0
+      on-exit-leak-free: 2.1.2
+      pino-abstract-transport: 3.0.0
+      pino-std-serializers: 7.1.0
+      process-warning: 5.0.0
+      quick-format-unescaped: 4.0.4
+      real-require: 0.2.0
+      safe-stable-stringify: 2.5.0
+      sonic-boom: 4.2.0
+      thread-stream: 4.0.0
+
+  pkce-challenge@5.0.1: {}
+
+  process-warning@4.0.1: {}
+
+  process-warning@5.0.0: {}
+
+  proxy-addr@2.0.7:
+    dependencies:
+      forwarded: 0.2.0
+      ipaddr.js: 1.9.1
+
+  proxy-from-env@1.1.0: {}
+
+  pstree.remy@1.1.8: {}
+
+  qs@6.14.1:
+    dependencies:
+      side-channel: 1.1.0
+
+  quick-format-unescaped@4.0.4: {}
+
+  range-parser@1.2.1: {}
+
+  raw-body@3.0.2:
+    dependencies:
+      bytes: 3.1.2
+      http-errors: 2.0.1
+      iconv-lite: 0.7.2
+      unpipe: 1.0.0
+
+  readdirp@3.6.0:
+    dependencies:
+      picomatch: 2.3.1
+
+  real-require@0.2.0: {}
+
+  require-from-string@2.0.2: {}
+
+  ret@0.5.0: {}
+
+  reusify@1.1.0: {}
+
+  rfdc@1.4.1: {}
+
+  router@2.2.0:
+    dependencies:
+      debug: 4.4.3(supports-color@5.5.0)
+      depd: 2.0.0
+      is-promise: 4.0.0
+      parseurl: 1.3.3
+      path-to-regexp: 8.3.0
+    transitivePeerDependencies:
+      - supports-color
+
+  safe-regex2@5.0.0:
+    dependencies:
+      ret: 0.5.0
+
+  safe-stable-stringify@2.5.0: {}
+
+  safer-buffer@2.1.2: {}
+
+  secure-json-parse@4.1.0: {}
+
+  semver@7.7.3: {}
+
+  send@1.2.1:
+    dependencies:
+      debug: 4.4.3(supports-color@5.5.0)
+      encodeurl: 2.0.0
+      escape-html: 1.0.3
+      etag: 1.8.1
+      fresh: 2.0.0
+      http-errors: 2.0.1
+      mime-types: 3.0.2
+      ms: 2.1.3
+      on-finished: 2.4.1
+      range-parser: 1.2.1
+      statuses: 2.0.2
+    transitivePeerDependencies:
+      - supports-color
+
+  serve-static@2.2.1:
+    dependencies:
+      encodeurl: 2.0.0
+      escape-html: 1.0.3
+      parseurl: 1.3.3
+      send: 1.2.1
+    transitivePeerDependencies:
+      - supports-color
+
+  set-cookie-parser@2.7.2: {}
+
+  setprototypeof@1.2.0: {}
+
+  shebang-command@2.0.0:
+    dependencies:
+      shebang-regex: 3.0.0
+
+  shebang-regex@3.0.0: {}
+
+  side-channel-list@1.0.0:
+    dependencies:
+      es-errors: 1.3.0
+      object-inspect: 1.13.4
+
+  side-channel-map@1.0.1:
+    dependencies:
+      call-bound: 1.0.4
+      es-errors: 1.3.0
+      get-intrinsic: 1.3.0
+      object-inspect: 1.13.4
+
+  side-channel-weakmap@1.0.2:
+    dependencies:
+      call-bound: 1.0.4
+      es-errors: 1.3.0
+      get-intrinsic: 1.3.0
+      object-inspect: 1.13.4
+      side-channel-map: 1.0.1
+
+  side-channel@1.1.0:
+    dependencies:
+      es-errors: 1.3.0
+      object-inspect: 1.13.4
+      side-channel-list: 1.0.0
+      side-channel-map: 1.0.1
+      side-channel-weakmap: 1.0.2
+
+  simple-update-notifier@2.0.0:
+    dependencies:
+      semver: 7.7.3
+
+  sonic-boom@4.2.0:
+    dependencies:
+      atomic-sleep: 1.0.0
+
+  split2@4.2.0: {}
+
+  statuses@2.0.2: {}
+
+  supports-color@5.5.0:
+    dependencies:
+      has-flag: 3.0.0
+
+  thread-stream@4.0.0:
+    dependencies:
+      real-require: 0.2.0
+
+  to-regex-range@5.0.1:
+    dependencies:
+      is-number: 7.0.0
+
+  toad-cache@3.7.0: {}
+
+  toidentifier@1.0.1: {}
+
+  touch@3.1.1: {}
+
+  ts-node@10.9.2(@types/node@25.0.10)(typescript@5.9.3):
+    dependencies:
+      '@cspotcode/source-map-support': 0.8.1
+      '@tsconfig/node10': 1.0.12
+      '@tsconfig/node12': 1.0.11
+      '@tsconfig/node14': 1.0.3
+      '@tsconfig/node16': 1.0.4
+      '@types/node': 25.0.10
+      acorn: 8.15.0
+      acorn-walk: 8.3.4
+      arg: 4.1.3
+      create-require: 1.1.1
+      diff: 4.0.4
+      make-error: 1.3.6
+      typescript: 5.9.3
+      v8-compile-cache-lib: 3.0.1
+      yn: 3.1.1
+
+  type-is@2.0.1:
+    dependencies:
+      content-type: 1.0.5
+      media-typer: 1.1.0
+      mime-types: 3.0.2
+
+  typescript@5.9.3: {}
+
+  undefsafe@2.0.5: {}
+
+  undici-types@7.16.0: {}
+
+  undici@7.19.1: {}
+
+  unpipe@1.0.0: {}
+
+  v8-compile-cache-lib@3.0.1: {}
+
+  vary@1.1.2: {}
+
+  whatwg-encoding@3.1.1:
+    dependencies:
+      iconv-lite: 0.6.3
+
+  whatwg-mimetype@4.0.0: {}
+
+  which@2.0.2:
+    dependencies:
+      isexe: 2.0.0
+
+  wrappy@1.0.2: {}
+
+  yaml@2.8.2: {}
+
+  yn@3.1.1: {}
+
+  zod-to-json-schema@3.25.1(zod@4.3.6):
+    dependencies:
+      zod: 4.3.6
+
+  zod@4.3.6: {}

src/app.ts

@@ -0,0 +1,99 @@
+import Fastify, { FastifyRequest, FastifyReply } from "fastify";
+import cors from "@fastify/cors";
+import swagger from "@fastify/swagger";
+import swaggerUi from "@fastify/swagger-ui";
+import config from "./config/env";
+
+import { leetcodePlugin } from "./modules/leetcode";
+import { codeforcesPlugin } from "./modules/codeforces";
+import { codechefPlugin } from "./modules/codechef";
+import { atcoderPlugin } from "./modules/atcoder";
+import { gfgPlugin } from "./modules/gfg";
+import { ratingsPlugin } from "./modules/ratings";
+import { mcpPlugin } from "./modules/mcp";
+
+export async function buildApp() {
+    const fastify = Fastify({
+        logger: true,
+    });
+
+    fastify.setErrorHandler((error: any, request, reply) => {
+        fastify.log.error(error);
+        const statusCode = error.statusCode || 500;
+        reply.status(statusCode).send({
+            success: false,
+            error: error.name || 'InternalServerError',
+            message: error.message || 'An unexpected error occurred',
+        });
+    });
+
+    await fastify.register(cors, {
+        exposedHeaders: ['WWW-Authenticate', 'Mcp-Session-Id', 'Last-Event-Id', 'Mcp-Protocol-Version'],
+        origin: '*',
+    });
+
+    await fastify.register(swagger, {
+        openapi: {
+            info: {
+                title: "Vortex",
+                description: "A high-performance modular API to fetch competitive programming contest ratings and user statistics from platforms like LeetCode, Codeforces, CodeChef, and more. Built with Fastify and TypeScript.",
+                version: "1.0.0",
+                contact: {
+                    name: "GitHub",
+                    url: "https://github.com/Anujjoshi3105/vortex",
+                },
+                license: {
+                    name: "ISC",
+                    url: "https://opensource.org/licenses/ISC",
+                },
+            },
+            servers: [
+                {
+                    url: `http://localhost:${config.port}`,
+                    description: 'Development server',
+                },
+            ],
+            tags: [
+                { name: 'Default', description: 'General server health and infrastructure endpoints' },
+                { name: 'MCP', description: 'Model Context Protocol endpoints for AI agent integration' },
+                { name: 'Ratings', description: 'Cross-platform rating aggregation and comparison' },
+                { name: 'LeetCode - User', description: 'Fetch user profiles, badges, solved statistics, and submission history' },
+                { name: 'LeetCode - Contests', description: 'Access contest rankings, history, and upcoming competition data' },
+                { name: 'LeetCode - Problems', description: 'Retrieve daily challenges, problem details, and official solutions' },
+                { name: 'LeetCode - Discussion', description: 'Explore trending topics and community comments' },
+                { name: 'Codeforces - User', description: 'Fetch user profiles, ratings, contest history, and blogs' },
+                { name: 'Codeforces - Contests', description: 'Access contest standings, hacks, and rating changes' },
+                { name: 'Codeforces - Problems', description: 'Retrieve problemset and recent platform submissions' },
+                { name: 'Codeforces - Blog', description: 'Explore blog entries and community comments' },
+                { name: 'CodeChef', description: 'CodeChef platform integration' },
+                { name: 'AtCoder', description: 'AtCoder platform integration' },
+                { name: 'GFG', description: 'GeeksforGeeks platform integration for user profiles, submissions, posts, and contest leaderboards' },
+            ],
+        },
+    });
+
+    await fastify.register(swaggerUi, {
+        routePrefix: "/docs",
+        uiConfig: {
+            docExpansion: 'list',
+            deepLinking: true,
+            filter: true,
+        },
+        staticCSP: true,
+        transformStaticCSP: (header) => header,
+    });
+
+    fastify.get("/health", { schema: { tags: ['Default'] } }, async (request: FastifyRequest, reply: FastifyReply) => {
+        return { status: "ok" };
+    });
+    await fastify.register(mcpPlugin);
+    await fastify.register(ratingsPlugin, { prefix: "/api/v1/ratings" });
+    await fastify.register(leetcodePlugin, { prefix: "/api/v1/leetcode" });
+    await fastify.register(codeforcesPlugin, { prefix: "/api/v1/codeforces" });
+    await fastify.register(codechefPlugin, { prefix: "/api/v1/codechef" });
+    await fastify.register(atcoderPlugin, { prefix: "/api/v1/atcoder" });
+    await fastify.register(gfgPlugin, { prefix: "/api/v1/gfg" });
+
+
+    return fastify;
+}

src/config/env.ts

@@ -0,0 +1,11 @@
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+export const config = {
+    port: Number(process.env.PORT) || 3000,
+    host: process.env.HOST || '0.0.0.0',
+    nodeEnv: process.env.NODE_ENV || 'development',
+} as const;
+
+export default config;

src/modules/atcoder/constants.ts

@@ -0,0 +1,28 @@
+export function mapRating(rating: number): string {
+    if (rating >= 2800) return 'Red';
+    if (rating >= 2400) return 'Orange';
+    if (rating >= 2000) return 'Yellow';
+    if (rating >= 1600) return 'Blue';
+    if (rating >= 1200) return 'Cyan';
+    if (rating >= 800) return 'Green';
+    if (rating >= 400) return 'Brown';
+    return 'Gray';
+}
+
+export const ATCODER_BASE_URL = 'https://atcoder.jp';
+
+export const ATCODER_SELECTORS = {
+    AVATAR: '.avatar',
+    USERNAME: '.username',
+    KYU: 'h3 b',
+} as const;
+
+export const ATCODER_LABELS = {
+    RATING: 'Rating',
+    MAX_RATING: 'Highest Rating',
+    RANK: 'Rank',
+    RATED_MATCHES: 'Rated Matches',
+    LAST_COMPETED: 'Last Competed',
+    COUNTRY: 'Country/Region',
+    BIRTH_YEAR: 'Birth Year',
+} as const;

src/modules/atcoder/handlers.ts

@@ -0,0 +1,48 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from './service';
+import type { UserQuery, ContestQuery } from './types';
+
+export async function getUserRatingHandler(
+    request: FastifyRequest<{ Querystring: UserQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getUserRating(username);
+    return reply.send(data);
+}
+
+export async function getUserHistoryHandler(
+    request: FastifyRequest<{ Querystring: UserQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getUserHistory(username);
+    return reply.send(data);
+}
+
+export async function getContestStandingsHandler(
+    request: FastifyRequest<{ Querystring: ContestQuery & { extended?: boolean } }>,
+    reply: FastifyReply
+) {
+    const { contestId, extended } = request.query;
+    const data = await service.getContestStandings(contestId, extended);
+    return reply.send(data);
+}
+
+export async function getContestResultsHandler(
+    request: FastifyRequest<{ Querystring: ContestQuery }>,
+    reply: FastifyReply
+) {
+    const { contestId } = request.query;
+    const data = await service.getContestResults(contestId);
+    return reply.send(data);
+}
+
+export async function getVirtualStandingsHandler(
+    request: FastifyRequest<{ Querystring: ContestQuery & { showGhost?: boolean } }>,
+    reply: FastifyReply
+) {
+    const { contestId, showGhost } = request.query;
+    const data = await service.getVirtualStandings(contestId, showGhost);
+    return reply.send(data);
+}

src/modules/atcoder/index.ts

@@ -0,0 +1,2 @@
+export { default as atcoderPlugin } from './routes';
+export * from './types';

src/modules/atcoder/provider.ts

@@ -0,0 +1,109 @@
+import { httpClient } from '../../shared/utils/http-client';
+import * as cheerio from 'cheerio';
+import { UserHistory, ContestStandings, AtCoderUserRating, ContestResult } from './types';
+import { ATCODER_BASE_URL, ATCODER_SELECTORS, ATCODER_LABELS } from './constants';
+
+export async function fetchUserRating(username: string): Promise<AtCoderUserRating> {
+    const url = `${ATCODER_BASE_URL}/users/${username}`;
+    try {
+        const { data } = await httpClient.get(url);
+        const $ = cheerio.load(data);
+
+        // Check for 404 or "User not found"
+        if ($('title').text().includes('404') || $('body').text().includes('User not found')) {
+            throw new Error(`User '${username}' not found on AtCoder`);
+        }
+
+        const extractText = (label: string) => {
+            const th = $(`th:contains('${label}')`);
+            if (th.length === 0) return null;
+            return th
+                .next('td')
+                .text()
+                .replace(/\s+/g, ' ')
+                .trim();
+        };
+
+        const rawRating = extractText(ATCODER_LABELS.RATING);
+        if (rawRating === null) {
+            throw new Error('AtCoder schema change detected: Rating label not found');
+        }
+
+        const rating = parseInt(rawRating.split(' ')[0]) || 0;
+        const max_rating = parseInt(extractText(ATCODER_LABELS.MAX_RATING)?.split(' ')[0] || '0') || 0;
+        const rank = extractText(ATCODER_LABELS.RANK) || 'N/A';
+        const contests_participated = parseInt(extractText(ATCODER_LABELS.RATED_MATCHES) || '0') || 0;
+        const last_competed = extractText(ATCODER_LABELS.LAST_COMPETED) || 'N/A';
+        const country = extractText(ATCODER_LABELS.COUNTRY) || 'N/A';
+        const birth_year = extractText(ATCODER_LABELS.BIRTH_YEAR) || 'N/A';
+
+        const avatarAttr = $(ATCODER_SELECTORS.AVATAR).attr('src');
+        const avatar = avatarAttr
+            ? avatarAttr.startsWith('//') ? 'https:' + avatarAttr : avatarAttr
+            : '';
+        const display_name = $(ATCODER_SELECTORS.USERNAME).first().text().trim();
+        const kyu = $(ATCODER_SELECTORS.KYU).first().text().trim();
+
+        // Fetch rating history from the direct JSON endpoint
+        let rating_history: UserHistory[] = [];
+        try {
+            rating_history = await fetchUserHistory(username);
+        } catch (e) {
+            // Fallback to scraping if JSON endpoint fails
+            $('script').each((i, script) => {
+                const content = $(script).text();
+                if (content.includes('var rating_history =')) {
+                    const match = content.match(/var rating_history\s*=\s*(\[.*?\]);/);
+                    if (match) {
+                        try {
+                            rating_history = JSON.parse(match[1]);
+                        } catch (err) { }
+                    }
+                }
+            });
+        }
+
+        return {
+            rating,
+            max_rating,
+            rank,
+            contests_participated,
+            last_competed,
+            country,
+            birth_year,
+            avatar,
+            display_name: display_name || username,
+            kyu,
+            rating_history,
+        };
+    } catch (error: any) {
+        if (error.response?.status === 404) {
+            throw new Error(`User '${username}' not found on AtCoder`);
+        }
+        throw error;
+    }
+}
+
+export async function fetchUserHistory(username: string): Promise<UserHistory[]> {
+    const url = `https://atcoder.jp/users/${username}/history/json`;
+    const { data } = await httpClient.get(url);
+    return data;
+}
+
+export async function fetchContestStandings(contestId: string, extended: boolean = false): Promise<ContestStandings> {
+    const url = `https://atcoder.jp/contests/${contestId}/standings/${extended ? 'extended/' : ''}json`;
+    const { data } = await httpClient.get(url);
+    return data;
+}
+
+export async function fetchContestResults(contestId: string): Promise<ContestResult[]> {
+    const url = `https://atcoder.jp/contests/${contestId}/results/json`;
+    const { data } = await httpClient.get(url);
+    return data;
+}
+
+export async function fetchVirtualStandings(contestId: string, showGhost: boolean = true): Promise<ContestStandings> {
+    const url = `https://atcoder.jp/contests/${contestId}/standings/virtual/json?showGhost=${showGhost}`;
+    const { data } = await httpClient.get(url);
+    return data;
+}

src/modules/atcoder/routes.ts

@@ -0,0 +1,51 @@
+import { FastifyPluginAsync } from 'fastify';
+import * as handlers from './handlers';
+import * as schemas from './schemas';
+import validateUsername from '../../shared/middlewares/validate';
+import type { UserQuery, ContestQuery } from './types';
+
+const atcoderRoutes: FastifyPluginAsync = async (fastify) => {
+    fastify.get<{ Querystring: UserQuery }>(
+        '/rating',
+        {
+            preHandler: [validateUsername],
+            schema: schemas.userRatingSchema,
+        },
+        handlers.getUserRatingHandler
+    );
+
+    fastify.get<{ Querystring: UserQuery }>(
+        '/history',
+        {
+            preHandler: [validateUsername],
+            schema: schemas.userHistorySchema,
+        },
+        handlers.getUserHistoryHandler
+    );
+
+    fastify.get<{ Querystring: ContestQuery & { extended?: boolean } }>(
+        '/standings',
+        {
+            schema: schemas.contestStandingsSchema,
+        },
+        handlers.getContestStandingsHandler
+    );
+
+    fastify.get<{ Querystring: ContestQuery }>(
+        '/results',
+        {
+            schema: schemas.contestResultsSchema,
+        },
+        handlers.getContestResultsHandler
+    );
+
+    fastify.get<{ Querystring: ContestQuery & { showGhost?: boolean } }>(
+        '/virtual-standings',
+        {
+            schema: schemas.virtualStandingsSchema,
+        },
+        handlers.getVirtualStandingsHandler
+    );
+};
+
+export default atcoderRoutes;

src/modules/atcoder/schemas.ts

@@ -0,0 +1,143 @@
+export const userRatingSchema = {
+    summary: 'Get User Rating',
+    description: 'Fetches AtCoder user rating, rank, and platform details',
+    tags: ['AtCoder'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'AtCoder username' },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'object',
+            properties: {
+                username: { type: 'string' },
+                display_name: { type: 'string' },
+                platform: { type: 'string' },
+                rating: { type: 'number' },
+                max_rating: { type: 'number' },
+                level: { type: 'string' },
+                rank: { type: 'string' },
+                contests_participated: { type: 'number' },
+                last_competed: { type: 'string' },
+                kyu: { type: 'string' },
+                country: { type: 'string' },
+                birth_year: { type: 'string' },
+                avatar: { type: 'string' },
+                rating_history: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            IsRated: { type: 'boolean' },
+                            Place: { type: 'number' },
+                            OldRating: { type: 'number' },
+                            NewRating: { type: 'number' },
+                            Performance: { type: 'number' },
+                            InnerPerformance: { type: 'number' },
+                            ContestScreenName: { type: 'string' },
+                            ContestName: { type: 'string' },
+                            ContestNameEn: { type: 'string' },
+                            EndTime: { type: 'string' },
+                        }
+                    }
+                }
+            }
+        }
+    }
+};
+
+export const userHistorySchema = {
+    summary: 'Get User History',
+    description: 'Fetches AtCoder user rating history directly from the JSON endpoint',
+    tags: ['AtCoder'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'AtCoder username' },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    IsRated: { type: 'boolean' },
+                    Place: { type: 'number' },
+                    OldRating: { type: 'number' },
+                    NewRating: { type: 'number' },
+                    Performance: { type: 'number' },
+                    InnerPerformance: { type: 'number' },
+                    ContestScreenName: { type: 'string' },
+                    ContestName: { type: 'string' },
+                    ContestNameEn: { type: 'string' },
+                    EndTime: { type: 'string' },
+                }
+            }
+        }
+    }
+};
+
+export const contestStandingsSchema = {
+    summary: 'Get Contest Standings',
+    description: 'Fetches AtCoder contest standings in JSON format',
+    tags: ['AtCoder'],
+    querystring: {
+        type: 'object',
+        properties: {
+            contestId: { type: 'string', description: 'AtCoder contest ID (e.g., abc300)' },
+            extended: { type: 'boolean', description: 'Whether to fetch extended standings' },
+        },
+        required: ['contestId'],
+    },
+    response: {
+        200: {
+            type: 'object',
+            additionalProperties: true
+        }
+    }
+};
+
+export const contestResultsSchema = {
+    summary: 'Get Contest Results',
+    description: 'Fetches AtCoder contest results in JSON format',
+    tags: ['AtCoder'],
+    querystring: {
+        type: 'object',
+        properties: {
+            contestId: { type: 'string', description: 'AtCoder contest ID' },
+        },
+        required: ['contestId'],
+    },
+    response: {
+        200: {
+            type: 'object',
+            additionalProperties: true
+        }
+    }
+};
+
+export const virtualStandingsSchema = {
+    summary: 'Get Virtual Standings',
+    description: 'Fetches AtCoder virtual standings in JSON format',
+    tags: ['AtCoder'],
+    querystring: {
+        type: 'object',
+        properties: {
+            contestId: { type: 'string', description: 'AtCoder contest ID' },
+            showGhost: { type: 'boolean', description: 'Whether to show ghost entries' },
+        },
+        required: ['contestId'],
+    },
+    response: {
+        200: {
+            type: 'object',
+            additionalProperties: true
+        }
+    }
+};
+

src/modules/atcoder/service.ts

@@ -0,0 +1,63 @@
+import { mapRating } from './constants';
+import * as provider from './provider';
+import type { AtCoderRating, UserHistory, ContestStandings } from './types';
+
+export async function getUserRating(username: string): Promise<AtCoderRating> {
+    try {
+        const data = await provider.fetchUserRating(username);
+        return {
+            username,
+            display_name: data.display_name,
+            platform: 'atcoder',
+            rating: data.rating,
+            max_rating: data.max_rating,
+            level: mapRating(data.rating),
+            rank: data.rank,
+            contests_participated: data.contests_participated,
+            last_competed: data.last_competed,
+            kyu: data.kyu,
+            country: data.country,
+            birth_year: data.birth_year,
+            avatar: data.avatar,
+        };
+    } catch (error: any) {
+        console.error(`AtCoder Error for ${username}:`, error.message);
+        throw new Error('Failed to fetch AtCoder user data');
+    }
+}
+
+export async function getUserHistory(username: string): Promise<UserHistory[]> {
+    try {
+        return await provider.fetchUserHistory(username);
+    } catch (error: any) {
+        console.error(`AtCoder History Error for ${username}:`, error.message);
+        throw new Error('Failed to fetch AtCoder user history');
+    }
+}
+
+export async function getContestStandings(contestId: string, extended: boolean = false): Promise<ContestStandings> {
+    try {
+        return await provider.fetchContestStandings(contestId, extended);
+    } catch (error: any) {
+        console.error(`AtCoder Standings Error for ${contestId}:`, error.message);
+        throw new Error('Failed to fetch AtCoder contest standings');
+    }
+}
+
+export async function getContestResults(contestId: string): Promise<any> {
+    try {
+        return await provider.fetchContestResults(contestId);
+    } catch (error: any) {
+        console.error(`AtCoder Results Error for ${contestId}:`, error.message);
+        throw new Error('Failed to fetch AtCoder contest results');
+    }
+}
+
+export async function getVirtualStandings(contestId: string, showGhost: boolean = true): Promise<any> {
+    try {
+        return await provider.fetchVirtualStandings(contestId, showGhost);
+    } catch (error: any) {
+        console.error(`AtCoder Virtual Standings Error for ${contestId}:`, error.message);
+        throw new Error('Failed to fetch AtCoder virtual standings');
+    }
+}

src/modules/atcoder/types.ts

@@ -0,0 +1,95 @@
+export interface UserHistory {
+    IsRated: boolean;
+    Place: number;
+    OldRating: number;
+    NewRating: number;
+    Performance: number;
+    InnerPerformance: number;
+    ContestScreenName: string;
+    ContestName: string;
+    ContestNameEn: string;
+    EndTime: string;
+}
+
+export interface AtCoderRating {
+    username: string;
+    display_name: string;
+    platform: string;
+    rating: number;
+    max_rating: number;
+    level: string;
+    rank: string;
+    contests_participated: number;
+    last_competed: string;
+    kyu: string;
+    country: string;
+    birth_year: string;
+    avatar: string;
+}
+
+export interface UserQuery {
+    username: string;
+}
+
+export interface ContestQuery {
+    contestId: string;
+}
+
+export interface AtCoderUserRating {
+    rating: number;
+    max_rating: number;
+    rank: string;
+    contests_participated: number;
+    last_competed: string;
+    country: string;
+    birth_year: string;
+    avatar: string;
+    display_name: string;
+    kyu: string;
+    rating_history: UserHistory[];
+}
+
+export interface ContestResult {
+    IsRated: boolean;
+    Place: number;
+    OldRating: number;
+    NewRating: number;
+    Performance: number;
+    InnerPerformance: number;
+    ContestScreenName: string;
+    ContestName: string;
+    ContestNameEn: string;
+    EndTime: string;
+}
+
+export interface StandingData {
+    Rank: number;
+    Additional: any;
+    UserScreenName: string;
+    UserDisplayName: string;
+    IsRated: boolean;
+    Rating: number;
+    OldRating: number;
+    TotalResult: {
+        Count: number;
+        Score: number;
+        Elapsed: number;
+        Penalty: number;
+    };
+    TaskResults: {
+        [key: string]: {
+            Count: number;
+            Score: number;
+            Elapsed: number;
+            Status: number;
+            Pending: boolean;
+        };
+    };
+}
+
+export interface ContestStandings {
+    Fixed: boolean;
+    AdditionalColumns: any[];
+    TaskInfo: any[];
+    StandingsData: StandingData[];
+}

src/modules/codechef/constants.ts

@@ -0,0 +1,16 @@
+export function mapRating(rating: number): string {
+    if (rating >= 2500) return '7 star';
+    if (rating >= 2200) return '6 star';
+    if (rating >= 2000) return '5 star';
+    if (rating >= 1800) return '4 star';
+    if (rating >= 1600) return '3 star';
+    if (rating >= 1400) return '2 star';
+    return '1 star';
+}
+
+export const CODECHEF_BASE_URL = 'https://www.codechef.com/users/';
+
+export const CODECHEF_SELECTORS = {
+    RATING: '.rating-number',
+    MAX_RATING: '.rating-header small',
+} as const;

src/modules/codechef/handlers.ts

@@ -0,0 +1,12 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from './service';
+import type { UserQuery } from './types';
+
+export async function getUserRatingHandler(
+    request: FastifyRequest<{ Querystring: UserQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getUserRating(username);
+    return reply.send(data);
+}

src/modules/codechef/index.ts

@@ -0,0 +1,2 @@
+export { default as codechefPlugin } from './routes';
+export * from './types';

src/modules/codechef/provider.ts

@@ -0,0 +1,40 @@
+import { httpClient } from '../../shared/utils/http-client';
+import * as cheerio from 'cheerio';
+import { CodeChefUserRating } from './types';
+import { CODECHEF_BASE_URL, CODECHEF_SELECTORS } from './constants';
+
+export async function fetchUserRating(username: string): Promise<CodeChefUserRating> {
+    const url = `${CODECHEF_BASE_URL}${username}`;
+    try {
+        const { data } = await httpClient.get(url);
+        const $ = cheerio.load(data);
+
+        // Check if user exists on page (CodeChef usually shows a specific page for missing users or 404s)
+        if ($('body').text().includes('not found') || $('title').text().includes('404')) {
+            throw new Error(`User '${username}' not found on CodeChef`);
+        }
+
+        const ratingElement = $(CODECHEF_SELECTORS.RATING).first();
+        if (ratingElement.length === 0) {
+            throw new Error('CodeChef schema change detected: Rating selector not found');
+        }
+
+        const ratingText = ratingElement.text().trim();
+        const rating = parseInt(ratingText);
+
+        const maxRatingElement = $(CODECHEF_SELECTORS.MAX_RATING).first();
+        const maxRatingText = maxRatingElement.text().match(/\d+/)?.[0];
+        const max_rating = maxRatingText ? parseInt(maxRatingText) : undefined;
+
+        if (isNaN(rating)) {
+            throw new Error('Could not parse CodeChef rating. Schema might have changed.');
+        }
+
+        return { rating, max_rating };
+    } catch (error: any) {
+        if (error.response?.status === 404) {
+            throw new Error(`User '${username}' not found on CodeChef`);
+        }
+        throw error;
+    }
+}

src/modules/codechef/routes.ts

@@ -0,0 +1,18 @@
+import { FastifyPluginAsync } from 'fastify';
+import * as handlers from './handlers';
+import * as schemas from './schemas';
+import validateUsername from '../../shared/middlewares/validate';
+import type { UserQuery } from './types';
+
+const codechefRoutes: FastifyPluginAsync = async (fastify) => {
+    fastify.get<{ Querystring: UserQuery }>(
+        '/rating',
+        {
+            preHandler: [validateUsername],
+            schema: schemas.userRatingSchema,
+        },
+        handlers.getUserRatingHandler
+    );
+};
+
+export default codechefRoutes;

src/modules/codechef/schemas.ts

@@ -0,0 +1,23 @@
+export const userRatingSchema = {
+    summary: 'Get User Rating',
+    description: 'Fetches CodeChef user rating and platform details',
+    tags: ['CodeChef'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'CodeChef username' },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'object',
+            properties: {
+                username: { type: 'string' },
+                platform: { type: 'string' },
+                rating: { type: 'number' }
+            }
+        }
+    }
+};
+

src/modules/codechef/service.ts

@@ -0,0 +1,20 @@
+import { mapRating } from './constants';
+import * as provider from './provider';
+import type { CodeChefRating } from './types';
+
+export async function getUserRating(username: string): Promise<CodeChefRating> {
+    try {
+        const data = await provider.fetchUserRating(username);
+
+        return {
+            username,
+            platform: 'codechef',
+            rating: data.rating,
+            level: mapRating(data.rating),
+            max_rating: data.max_rating,
+        };
+    } catch (error: any) {
+        console.error(`CodeChef Error for ${username}:`, error.message);
+        throw new Error('Error fetching CodeChef rating');
+    }
+}

src/modules/codechef/types.ts

@@ -0,0 +1,15 @@
+export interface CodeChefRating {
+    username: string;
+    platform: string;
+    rating: number | string;
+    level: string;
+    max_rating?: number | string;
+}
+
+export interface UserQuery {
+    username: string;
+}
+export interface CodeChefUserRating {
+    rating: number;
+    max_rating?: number;
+}

src/modules/codeforces/handlers.ts

@@ -0,0 +1,160 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from './service';
+import type {
+    UserQuery,
+    StatusQuery,
+    ProblemsetQuery,
+    RecentActionsQuery,
+    ContestQuery,
+    StandingsQuery,
+    ContestStatusQuery,
+    BlogEntryQuery,
+    RecentStatusQuery
+} from './types';
+
+export async function getUserRatingHandler(
+    request: FastifyRequest<{ Querystring: UserQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getUserRating(username);
+    return reply.send(data);
+}
+
+export async function getContestHistoryHandler(
+    request: FastifyRequest<{ Querystring: UserQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getContestHistory(username);
+    return reply.send(data);
+}
+
+export async function getUserStatusHandler(
+    request: FastifyRequest<{ Querystring: StatusQuery }>,
+    reply: FastifyReply
+) {
+    const { username, from = 1, count = 10 } = request.query;
+    const data = await service.getUserStatus(username, Number(from), Number(count));
+    return reply.send(data);
+}
+
+export async function getUserBlogsHandler(
+    request: FastifyRequest<{ Querystring: UserQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getUserBlogs(username);
+    return reply.send(data);
+}
+
+export async function getSolvedProblemsHandler(
+    request: FastifyRequest<{ Querystring: UserQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getSolvedProblems(username);
+    return reply.send(data);
+}
+
+export async function getContestsHandler(
+    request: FastifyRequest<{ Querystring: { gym?: boolean } }>,
+    reply: FastifyReply
+) {
+    const { gym = false } = request.query;
+    const data = await service.getContests(gym);
+    return reply.send(data);
+}
+
+export async function getRecentActionsHandler(
+    request: FastifyRequest<{ Querystring: RecentActionsQuery }>,
+    reply: FastifyReply
+) {
+    const { maxCount = 20 } = request.query;
+    const data = await service.getRecentActions(Number(maxCount));
+    return reply.send(data);
+}
+
+export async function getProblemsHandler(
+    request: FastifyRequest<{ Querystring: ProblemsetQuery }>,
+    reply: FastifyReply
+) {
+    const { tags } = request.query;
+    const data = await service.getProblems(tags);
+    return reply.send(data);
+}
+
+export async function getContestStandingsHandler(
+    request: FastifyRequest<{ Querystring: StandingsQuery }>,
+    reply: FastifyReply
+) {
+    const { contestId, from, count, handles, room, showUnofficial } = request.query;
+    const data = await service.getContestStandings(
+        Number(contestId),
+        from ? Number(from) : undefined,
+        count ? Number(count) : undefined,
+        handles,
+        room ? Number(room) : undefined,
+        showUnofficial
+    );
+    return reply.send(data);
+}
+
+export async function getContestRatingChangesHandler(
+    request: FastifyRequest<{ Querystring: ContestQuery }>,
+    reply: FastifyReply
+) {
+    const { contestId } = request.query;
+    const data = await service.getContestRatingChanges(Number(contestId));
+    return reply.send(data);
+}
+
+export async function getContestHacksHandler(
+    request: FastifyRequest<{ Querystring: ContestQuery }>,
+    reply: FastifyReply
+) {
+    const { contestId } = request.query;
+    const data = await service.getContestHacks(Number(contestId));
+    return reply.send(data);
+}
+
+export async function getContestStatusHandler(
+    request: FastifyRequest<{ Querystring: ContestStatusQuery }>,
+    reply: FastifyReply
+) {
+    const { contestId, handle, from, count } = request.query;
+    const data = await service.getContestStatus(
+        Number(contestId),
+        handle,
+        from ? Number(from) : undefined,
+        count ? Number(count) : undefined
+    );
+    return reply.send(data);
+}
+
+export async function getProblemsetRecentStatusHandler(
+    request: FastifyRequest<{ Querystring: RecentStatusQuery }>,
+    reply: FastifyReply
+) {
+    const { count = 10 } = request.query;
+    const data = await service.getProblemsetRecentStatus(Number(count));
+    return reply.send(data);
+}
+
+export async function getBlogEntryHandler(
+    request: FastifyRequest<{ Querystring: BlogEntryQuery }>,
+    reply: FastifyReply
+) {
+    const { blogEntryId } = request.query;
+    const data = await service.getBlogEntry(Number(blogEntryId));
+    return reply.send(data);
+}
+
+export async function getBlogCommentsHandler(
+    request: FastifyRequest<{ Querystring: BlogEntryQuery }>,
+    reply: FastifyReply
+) {
+    const { blogEntryId } = request.query;
+    const data = await service.getBlogComments(Number(blogEntryId));
+    return reply.send(data);
+}

src/modules/codeforces/index.ts

@@ -0,0 +1,2 @@
+export { default as codeforcesPlugin } from './routes';
+export * from './types';

src/modules/codeforces/provider.ts

@@ -0,0 +1,221 @@
+import { httpClient } from '../../shared/utils/http-client';
+import type {
+    CodeforcesUser,
+    CodeforcesContestHistory,
+    CodeforcesSubmission,
+    BlogEntry,
+    CodeforcesContest,
+    RecentAction,
+    CodeforcesProblem,
+    ContestStandings,
+    RatingChange,
+    Hack,
+    BlogEntryView,
+    BlogComment,
+} from './types';
+
+const CODEFORCES_API_BASE = 'https://codeforces.com/api';
+
+// Fetch user information
+export async function fetchUserInfo(username: string): Promise<CodeforcesUser> {
+    const url = `${CODEFORCES_API_BASE}/user.info?handles=${username}`;
+    const { data } = await httpClient.get(url);
+
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching user info');
+    }
+
+    return data.result[0];
+}
+
+// Fetch user's contest rating history
+export async function fetchContestHistory(
+    username: string
+): Promise<CodeforcesContestHistory[]> {
+    const url = `${CODEFORCES_API_BASE}/user.rating?handle=${username}`;
+    const { data } = await httpClient.get(url);
+
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching contest history');
+    }
+
+    return data.result;
+}
+
+const MAX_CF_LIMIT = 1000;
+
+// Fetch user's submission status
+export async function fetchUserStatus(
+    username: string,
+    from: number = 1,
+    count: number = 10
+): Promise<CodeforcesSubmission[]> {
+    const safeCount = Math.min(count, MAX_CF_LIMIT);
+    const url = `${CODEFORCES_API_BASE}/user.status?handle=${username}&from=${from}&count=${safeCount}`;
+    const { data } = await httpClient.get(url);
+
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching user status');
+    }
+
+    return data.result;
+}
+
+// Fetch user's blog entries
+export async function fetchBlogEntries(username: string): Promise<BlogEntry[]> {
+    const url = `${CODEFORCES_API_BASE}/user.blogEntries?handle=${username}`;
+    const { data } = await httpClient.get(url);
+
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching blog entries');
+    }
+
+    return data.result;
+}
+
+// Fetch user submissions with limit
+export async function fetchAllSubmissions(
+    username: string,
+    from: number = 1,
+    count: number = 100
+): Promise<CodeforcesSubmission[]> {
+    const safeCount = Math.min(count, MAX_CF_LIMIT);
+    const url = `${CODEFORCES_API_BASE}/user.status?handle=${username}&from=${from}&count=${safeCount}`;
+    const { data } = await httpClient.get(url);
+
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching submissions');
+    }
+
+    return data.result;
+}
+
+// Fetch contests
+export async function fetchContests(gym: boolean = false): Promise<CodeforcesContest[]> {
+    const url = `${CODEFORCES_API_BASE}/contest.list?gym=${gym}`;
+    const { data } = await httpClient.get(url);
+
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching contest list');
+    }
+
+    return data.result;
+}
+
+// Fetch recent actions
+export async function fetchRecentActions(maxCount: number = 20): Promise<RecentAction[]> {
+    const url = `${CODEFORCES_API_BASE}/recentActions?maxCount=${maxCount}`;
+    const { data } = await httpClient.get(url);
+
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching recent actions');
+    }
+
+    return data.result;
+}
+
+// Fetch problemset problems
+export async function fetchProblems(tags?: string): Promise<{ problems: CodeforcesProblem[] }> {
+    const url = tags
+        ? `${CODEFORCES_API_BASE}/problemset.problems?tags=${tags}`
+        : `${CODEFORCES_API_BASE}/problemset.problems`;
+    const { data } = await httpClient.get(url);
+
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching problemset');
+    }
+
+    return data.result;
+}
+
+// Fetch contest standings
+export async function fetchContestStandings(
+    contestId: number,
+    from?: number,
+    count?: number,
+    handles?: string,
+    room?: number,
+    showUnofficial?: boolean
+): Promise<ContestStandings> {
+    let url = `${CODEFORCES_API_BASE}/contest.standings?contestId=${contestId}`;
+    if (from) url += `&from=${from}`;
+    if (count) url += `&count=${count}`;
+    if (handles) url += `&handles=${handles}`;
+    if (room) url += `&room=${room}`;
+    if (showUnofficial !== undefined) url += `&showUnofficial=${showUnofficial}`;
+
+    const { data } = await httpClient.get(url);
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching contest standings');
+    }
+    return data.result;
+}
+
+// Fetch contest rating changes
+export async function fetchContestRatingChanges(contestId: number): Promise<RatingChange[]> {
+    const url = `${CODEFORCES_API_BASE}/contest.ratingChanges?contestId=${contestId}`;
+    const { data } = await httpClient.get(url);
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching rating changes');
+    }
+    return data.result;
+}
+
+// Fetch contest hacks
+export async function fetchContestHacks(contestId: number): Promise<Hack[]> {
+    const url = `${CODEFORCES_API_BASE}/contest.hacks?contestId=${contestId}`;
+    const { data } = await httpClient.get(url);
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching contest hacks');
+    }
+    return data.result;
+}
+
+// Fetch contest status (submissions)
+export async function fetchContestStatus(
+    contestId: number,
+    handle?: string,
+    from?: number,
+    count?: number
+): Promise<CodeforcesSubmission[]> {
+    let url = `${CODEFORCES_API_BASE}/contest.status?contestId=${contestId}`;
+    if (handle) url += `&handle=${handle}`;
+    if (from) url += `&from=${from}`;
+    if (count) url += `&count=${count}`;
+
+    const { data } = await httpClient.get(url);
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching contest status');
+    }
+    return data.result;
+}
+
+// Fetch problemset recent status
+export async function fetchProblemsetRecentStatus(count: number): Promise<CodeforcesSubmission[]> {
+    const url = `${CODEFORCES_API_BASE}/problemset.recentStatus?count=${count}`;
+    const { data } = await httpClient.get(url);
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching recent status');
+    }
+    return data.result;
+}
+
+// Fetch blog entry content
+export async function fetchBlogEntry(blogEntryId: number): Promise<BlogEntryView> {
+    const url = `${CODEFORCES_API_BASE}/blogEntry.view?blogEntryId=${blogEntryId}`;
+    const { data } = await httpClient.get(url);
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching blog entry');
+    }
+    return data.result;
+}
+
+// Fetch blog entry comments
+export async function fetchBlogComments(blogEntryId: number): Promise<BlogComment[]> {
+    const url = `${CODEFORCES_API_BASE}/blogEntry.comments?blogEntryId=${blogEntryId}`;
+    const { data } = await httpClient.get(url);
+    if (data.status !== 'OK') {
+        throw new Error(data.comment || 'Error fetching blog comments');
+    }
+    return data.result;
+}

src/modules/codeforces/routes.ts

@@ -0,0 +1,98 @@
+import { FastifyPluginAsync } from 'fastify';
+import * as handlers from './handlers';
+import * as schemas from './schemas';
+import validateUsername from '../../shared/middlewares/validate';
+import type {
+    StatusQuery,
+    UserQuery,
+    ContestQuery,
+    StandingsQuery,
+    ContestStatusQuery,
+    BlogEntryQuery,
+    RecentStatusQuery
+} from './types';
+
+const codeforcesRoutes: FastifyPluginAsync = async (fastify) => {
+    // User routes (with username validation)
+    fastify.get<{ Querystring: UserQuery }>(
+        '/rating',
+        { preHandler: [validateUsername], schema: schemas.userRatingSchema },
+        handlers.getUserRatingHandler
+    );
+
+    fastify.get<{ Querystring: UserQuery }>(
+        '/contest-history',
+        { preHandler: [validateUsername], schema: schemas.contestHistorySchema },
+        handlers.getContestHistoryHandler
+    );
+
+    fastify.get<{ Querystring: StatusQuery }>(
+        '/status',
+        { preHandler: [validateUsername], schema: schemas.userStatusSchema },
+        handlers.getUserStatusHandler
+    );
+
+    fastify.get<{ Querystring: UserQuery }>(
+        '/blogs',
+        { preHandler: [validateUsername], schema: schemas.userBlogsSchema },
+        handlers.getUserBlogsHandler
+    );
+
+    fastify.get<{ Querystring: UserQuery }>(
+        '/solved-problems',
+        { preHandler: [validateUsername], schema: schemas.solvedProblemsSchema },
+        handlers.getSolvedProblemsHandler
+    );
+
+    // General platform routes
+    fastify.get('/contests', { schema: schemas.contestsSchema }, handlers.getContestsHandler);
+    fastify.get('/recent-actions', { schema: schemas.recentActionsSchema }, handlers.getRecentActionsHandler);
+    fastify.get('/problems', { schema: schemas.problemsSchema }, handlers.getProblemsHandler);
+
+    // Contest specific routes
+    fastify.get<{ Querystring: StandingsQuery }>(
+        '/contest/standings',
+        { schema: schemas.contestStandingsSchema },
+        handlers.getContestStandingsHandler
+    );
+
+    fastify.get<{ Querystring: ContestQuery }>(
+        '/contest/rating-changes',
+        { schema: schemas.contestRatingChangesSchema },
+        handlers.getContestRatingChangesHandler
+    );
+
+    fastify.get<{ Querystring: ContestQuery }>(
+        '/contest/hacks',
+        { schema: schemas.contestHacksSchema },
+        handlers.getContestHacksHandler
+    );
+
+    fastify.get<{ Querystring: ContestStatusQuery }>(
+        '/contest/status',
+        { schema: schemas.contestStatusSchema },
+        handlers.getContestStatusHandler
+    );
+
+    // Problemset routes
+    fastify.get<{ Querystring: RecentStatusQuery }>(
+        '/problemset/recent-status',
+        { schema: schemas.problemsetRecentStatusSchema },
+        handlers.getProblemsetRecentStatusHandler
+    );
+
+    // Blog routes
+    fastify.get<{ Querystring: BlogEntryQuery }>(
+        '/blog/view',
+        { schema: schemas.blogEntrySchema },
+        handlers.getBlogEntryHandler
+    );
+
+    fastify.get<{ Querystring: BlogEntryQuery }>(
+        '/blog/comments',
+        { schema: schemas.blogCommentsSchema },
+        handlers.getBlogCommentsHandler
+    );
+};
+
+export default codeforcesRoutes;

src/modules/codeforces/schemas.ts

@@ -0,0 +1,347 @@
+export const userRatingSchema = {
+    summary: 'Get User Rating',
+    description: 'Fetches Codeforces user rating and rank details',
+    tags: ['Codeforces - User'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'Codeforces handle' },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'object',
+            properties: {
+                username: { type: 'string' },
+                platform: { type: 'string' },
+                rating: { type: ['number', 'string'] },
+                level: { type: 'string' },
+                max_rating: { type: ['number', 'string'] },
+                max_level: { type: 'string' },
+                contribution: { type: 'number' },
+                friendOfCount: { type: 'number' },
+                avatar: { type: 'string' }
+            }
+        }
+    }
+};
+
+export const contestHistorySchema = {
+    summary: 'Get Contest History',
+    description: 'Fetches Codeforces contest participation history',
+    tags: ['Codeforces - User'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'Codeforces handle' },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    contestId: { type: 'number' },
+                    contestName: { type: 'string' },
+                    handle: { type: 'string' },
+                    rank: { type: 'number' },
+                    ratingUpdateTimeSeconds: { type: 'number' },
+                    oldRating: { type: 'number' },
+                    newRating: { type: 'number' }
+                }
+            }
+        }
+    }
+};
+
+export const userStatusSchema = {
+    summary: 'Get User Status',
+    description: 'Fetches Codeforces user submission status/history',
+    tags: ['Codeforces - User'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'Codeforces handle' },
+            from: { type: 'number', description: 'Starting index (1-based)', default: 1 },
+            count: { type: 'number', description: 'Number of submissions to fetch', default: 10 },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'number' },
+                    contestId: { type: 'number' },
+                    problem: {
+                        type: 'object',
+                        properties: {
+                            contestId: { type: 'number' },
+                            index: { type: 'string' },
+                            name: { type: 'string' },
+                            rating: { type: 'number' },
+                            tags: { type: 'array', items: { type: 'string' } }
+                        }
+                    },
+                    verdict: { type: 'string' },
+                    programmingLanguage: { type: 'string' },
+                    creationTimeSeconds: { type: 'number' }
+                }
+            }
+        }
+    }
+};
+
+export const userBlogsSchema = {
+    summary: 'Get User Blogs',
+    description: 'Fetches blog posts written by a Codeforces user',
+    tags: ['Codeforces - User'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'Codeforces handle' },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'number' },
+                    title: { type: 'string' },
+                    creationTimeSeconds: { type: 'number' },
+                    rating: { type: 'number' }
+                }
+            }
+        }
+    }
+};
+
+export const solvedProblemsSchema = {
+    summary: 'Get Solved Problems',
+    description: 'Fetches a list of problems solved by a Codeforces user',
+    tags: ['Codeforces - User'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'Codeforces handle' },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    name: { type: 'string' },
+                    rating: { type: 'number' },
+                    tags: { type: 'array', items: { type: 'string' } },
+                    link: { type: 'string' }
+                }
+            }
+        }
+    }
+};
+
+export const contestsSchema = {
+    summary: 'Get Contests',
+    description: 'Fetches a list of Codeforces contests',
+    tags: ['Codeforces - Contests'],
+    querystring: {
+        type: 'object',
+        properties: {
+            gym: { type: 'boolean', description: 'Whether to include gym contests', default: false }
+        }
+    },
+    response: {
+        200: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'number' },
+                    name: { type: 'string' },
+                    type: { type: 'string' },
+                    phase: { type: 'string' },
+                    frozen: { type: 'boolean' },
+                    durationSeconds: { type: 'number' },
+                    startTimeSeconds: { type: 'number' },
+                    relativeTimeSeconds: { type: 'number' }
+                }
+            }
+        }
+    }
+};
+
+export const recentActionsSchema = {
+    summary: 'Get Recent Actions',
+    description: 'Fetches recent actions on Codeforces (blogs, comments, etc.)',
+    tags: ['Codeforces - Blog'],
+    querystring: {
+        type: 'object',
+        properties: {
+            maxCount: { type: 'number', description: 'Maximum number of actions to fetch', default: 20 }
+        }
+    },
+    response: {
+        200: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    timeSeconds: { type: 'number' },
+                    blogEntry: {
+                        type: 'object',
+                        properties: {
+                            id: { type: 'number' },
+                            title: { type: 'string' }
+                        }
+                    },
+                    comment: {
+                        type: 'object',
+                        properties: {
+                            id: { type: 'number' },
+                            text: { type: 'string' },
+                            commentatorHandle: { type: 'string' }
+                        }
+                    }
+                }
+            }
+        }
+    }
+};
+
+export const problemsSchema = {
+    summary: 'Get Problemset Problems',
+    description: 'Fetches problems from the Codeforces problemset',
+    tags: ['Codeforces - Problems'],
+    querystring: {
+        type: 'object',
+        properties: {
+            tags: { type: 'string', description: 'Semicolon-separated list of tags' }
+        }
+    },
+    response: {
+        200: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    contestId: { type: 'number' },
+                    index: { type: 'string' },
+                    name: { type: 'string' },
+                    rating: { type: 'number' },
+                    tags: { type: 'array', items: { type: 'string' } }
+                }
+            }
+        }
+    }
+};
+
+export const contestStandingsSchema = {
+    summary: 'Get Contest Standings',
+    description: 'Fetches the scoreboard of a specific contest',
+    tags: ['Codeforces - Contests'],
+    querystring: {
+        type: 'object',
+        properties: {
+            contestId: { type: 'number', description: 'ID of the contest' },
+            from: { type: 'number', description: 'Starting index (1-based)', default: 1 },
+            count: { type: 'number', description: 'Number of rows to fetch', default: 10 },
+            handles: { type: 'string', description: 'Semicolon-separated list of handles' },
+            room: { type: 'number', description: 'Room number' },
+            showUnofficial: { type: 'boolean', description: 'Whether to show unofficial results', default: false }
+        },
+        required: ['contestId']
+    }
+};
+
+export const contestRatingChangesSchema = {
+    summary: 'Get Contest Rating Changes',
+    description: 'Fetches rating changes for all participants after a contest',
+    tags: ['Codeforces - Contests'],
+    querystring: {
+        type: 'object',
+        properties: {
+            contestId: { type: 'number', description: 'ID of the contest' }
+        },
+        required: ['contestId']
+    }
+};
+
+export const contestHacksSchema = {
+    summary: 'Get Contest Hacks',
+    description: 'Fetches a list of all hacks in a contest',
+    tags: ['Codeforces - Contests'],
+    querystring: {
+        type: 'object',
+        properties: {
+            contestId: { type: 'number', description: 'ID of the contest' }
+        },
+        required: ['contestId']
+    }
+};
+
+export const contestStatusSchema = {
+    summary: 'Get Contest Status',
+    description: 'Fetches submissions for a specific contest',
+    tags: ['Codeforces - Contests'],
+    querystring: {
+        type: 'object',
+        properties: {
+            contestId: { type: 'number', description: 'ID of the contest' },
+            handle: { type: 'string', description: 'Codeforces handle' },
+            from: { type: 'number', description: 'Starting index (1-based)', default: 1 },
+            count: { type: 'number', description: 'Number of submissions to fetch', default: 10 }
+        },
+        required: ['contestId']
+    }
+};
+
+export const problemsetRecentStatusSchema = {
+    summary: 'Get Problemset Recent Status',
+    description: 'Fetches recent submissions across the platform',
+    tags: ['Codeforces - Problems'],
+    querystring: {
+        type: 'object',
+        properties: {
+            count: { type: 'number', description: 'Number of submissions to fetch', default: 10 }
+        },
+        required: ['count']
+    }
+};
+
+export const blogEntrySchema = {
+    summary: 'Get Blog Entry',
+    description: 'Fetches a specific blog entry',
+    tags: ['Codeforces - Blog'],
+    querystring: {
+        type: 'object',
+        properties: {
+            blogEntryId: { type: 'number', description: 'ID of the blog entry' }
+        },
+        required: ['blogEntryId']
+    }
+};
+
+export const blogCommentsSchema = {
+    summary: 'Get Blog Comments',
+    description: 'Fetches comments for a specific blog entry',
+    tags: ['Codeforces - Blog'],
+    querystring: {
+        type: 'object',
+        properties: {
+            blogEntryId: { type: 'number', description: 'ID of the blog entry' }
+        },
+        required: ['blogEntryId']
+    }
+};

src/modules/codeforces/service.ts

@@ -0,0 +1,217 @@
+import * as provider from './provider';
+import type {
+    CodeforcesRatingResponse,
+    CodeforcesContestHistory,
+    CodeforcesSubmission,
+    SolvedProblem,
+    BlogEntry,
+    CodeforcesContest,
+    RecentAction,
+    CodeforcesProblem,
+    ContestStandings,
+    RatingChange,
+    Hack,
+} from './types';
+
+// Get user's rating
+export async function getUserRating(username: string): Promise<CodeforcesRatingResponse> {
+    try {
+        const user = await provider.fetchUserInfo(username);
+
+        return {
+            username,
+            platform: 'codeforces',
+            rating: user.rating || 'Unrated',
+            level: user.rank || 'Unrated',
+            max_rating: user.maxRating || 'Unrated',
+            max_level: user.maxRank || 'Unrated',
+            contribution: user.contribution,
+            friendOfCount: user.friendOfCount,
+            avatar: user.avatar,
+        };
+    } catch (error: any) {
+        console.error(`Codeforces Error for ${username}:`, error.message);
+        throw new Error('Error fetching Codeforces rating');
+    }
+}
+
+// Get user's contest history
+export async function getContestHistory(
+    username: string
+): Promise<CodeforcesContestHistory[]> {
+    try {
+        return await provider.fetchContestHistory(username);
+    } catch (error: any) {
+        console.error(`Codeforces Error for ${username}:`, error.message);
+        throw new Error('Error fetching Codeforces contest history');
+    }
+}
+
+// Get user's submission status
+export async function getUserStatus(
+    username: string,
+    from: number = 1,
+    count: number = 10
+): Promise<CodeforcesSubmission[]> {
+    try {
+        return await provider.fetchUserStatus(username, from, count);
+    } catch (error: any) {
+        console.error(`Codeforces Error for ${username}:`, error.message);
+        throw new Error('Error fetching Codeforces user status');
+    }
+}
+
+// Get user's blog entries
+export async function getUserBlogs(username: string): Promise<BlogEntry[]> {
+    try {
+        return await provider.fetchBlogEntries(username);
+    } catch (error: any) {
+        console.error(`Codeforces Error for ${username}:`, error.message);
+        throw new Error('Error fetching Codeforces user blog entries');
+    }
+}
+
+// Get user's solved problems
+export async function getSolvedProblems(username: string): Promise<SolvedProblem[]> {
+    try {
+        const submissions = await provider.fetchAllSubmissions(username, 1, 1000);
+
+        const solvedProblemsSet = new Set<string>();
+        const solvedProblems: SolvedProblem[] = [];
+
+        submissions.forEach((submission) => {
+            if (submission.verdict === 'OK') {
+                const problemId = `${submission.problem.contestId}${submission.problem.index}`;
+
+                if (!solvedProblemsSet.has(problemId)) {
+                    solvedProblemsSet.add(problemId);
+                    solvedProblems.push({
+                        id: problemId,
+                        name: submission.problem.name,
+                        rating: submission.problem.rating,
+                        tags: submission.problem.tags,
+                        link: `https://codeforces.com/contest/${submission.problem.contestId}/problem/${submission.problem.index}`,
+                    });
+                }
+            }
+        });
+
+        return solvedProblems;
+    } catch (error: any) {
+        console.error(`Codeforces Error for ${username}:`, error.message);
+        throw new Error('Error fetching Codeforces solved problems');
+    }
+}
+
+// Get contests
+export async function getContests(gym: boolean = false): Promise<CodeforcesContest[]> {
+    try {
+        return await provider.fetchContests(gym);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces contests');
+    }
+}
+
+// Get recent actions
+export async function getRecentActions(maxCount: number = 20): Promise<RecentAction[]> {
+    try {
+        return await provider.fetchRecentActions(maxCount);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces recent actions');
+    }
+}
+
+// Get problemset problems
+export async function getProblems(tags?: string): Promise<CodeforcesProblem[]> {
+    try {
+        const result = await provider.fetchProblems(tags);
+        return result.problems;
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces problemset');
+    }
+}
+
+// Get contest standings
+export async function getContestStandings(
+    contestId: number,
+    from?: number,
+    count?: number,
+    handles?: string,
+    room?: number,
+    showUnofficial?: boolean
+): Promise<ContestStandings> {
+    try {
+        return await provider.fetchContestStandings(contestId, from, count, handles, room, showUnofficial);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces contest standings');
+    }
+}
+
+// Get rating changes
+export async function getContestRatingChanges(contestId: number): Promise<RatingChange[]> {
+    try {
+        return await provider.fetchContestRatingChanges(contestId);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces contest rating changes');
+    }
+}
+
+// Get contest hacks
+export async function getContestHacks(contestId: number): Promise<Hack[]> {
+    try {
+        return await provider.fetchContestHacks(contestId);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces contest hacks');
+    }
+}
+
+// Get contest status
+export async function getContestStatus(
+    contestId: number,
+    handle?: string,
+    from?: number,
+    count?: number
+): Promise<CodeforcesSubmission[]> {
+    try {
+        return await provider.fetchContestStatus(contestId, handle, from, count);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces contest status');
+    }
+}
+
+// Get problemset recent status
+export async function getProblemsetRecentStatus(count: number): Promise<CodeforcesSubmission[]> {
+    try {
+        return await provider.fetchProblemsetRecentStatus(count);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces problemset recent status');
+    }
+}
+
+// Get blog entry
+export async function getBlogEntry(blogEntryId: number): Promise<any> {
+    try {
+        return await provider.fetchBlogEntry(blogEntryId);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces blog entry');
+    }
+}
+
+// Get blog comments
+export async function getBlogComments(blogEntryId: number): Promise<any[]> {
+    try {
+        return await provider.fetchBlogComments(blogEntryId);
+    } catch (error: any) {
+        console.error('Codeforces Error:', error.message);
+        throw new Error('Error fetching Codeforces blog comments');
+    }
+}

src/modules/codeforces/types.ts

@@ -0,0 +1,189 @@
+// Codeforces-specific TypeScript types
+
+export interface CodeforcesUser {
+    handle: string;
+    rating?: number;
+    rank?: string;
+    maxRating?: number;
+    maxRank?: string;
+    contribution?: number;
+    friendOfCount?: number;
+    avatar?: string;
+    titlePhoto?: string;
+    lastOnlineTimeSeconds?: number;
+    registrationTimeSeconds?: number;
+}
+
+export interface CodeforcesRatingResponse {
+    username: string;
+    platform: string;
+    rating: number | string;
+    level: string;
+    max_rating?: number | string;
+    max_level?: string;
+    contribution?: number;
+    friendOfCount?: number;
+    avatar?: string;
+}
+
+export interface CodeforcesContestHistory {
+    contestId: number;
+    contestName: string;
+    handle: string;
+    rank: number;
+    ratingUpdateTimeSeconds: number;
+    oldRating: number;
+    newRating: number;
+}
+
+export interface CodeforcesProblem {
+    contestId: number;
+    index: string;
+    name: string;
+    rating?: number;
+    tags: string[];
+}
+
+export interface CodeforcesSubmission {
+    id: number;
+    contestId?: number;
+    problem: CodeforcesProblem;
+    verdict: string;
+    programmingLanguage: string;
+    creationTimeSeconds: number;
+}
+
+export interface SolvedProblem {
+    id: string;
+    name: string;
+    rating?: number;
+    tags: string[];
+    link: string;
+}
+
+export interface BlogEntry {
+    id: number;
+    title: string;
+    creationTimeSeconds: number;
+    rating: number;
+}
+
+export interface UserQuery {
+    username: string;
+}
+
+export interface StatusQuery {
+    username: string;
+    from?: number;
+    count?: number;
+}
+
+export interface CodeforcesContest {
+    id: number;
+    name: string;
+    type: string;
+    phase: string;
+    frozen: boolean;
+    durationSeconds: number;
+    startTimeSeconds?: number;
+    relativeTimeSeconds?: number;
+}
+
+export interface RecentAction {
+    timeSeconds: number;
+    blogEntry?: BlogEntry;
+    comment?: {
+        id: number;
+        creationTimeSeconds: number;
+        commentatorHandle: string;
+        text: string;
+    };
+}
+
+export interface RankingRow {
+    party: any;
+    rank: number;
+    points: number;
+    penalty: number;
+    successfulHackCount: number;
+    unsuccessfulHackCount: number;
+    problemResults: any[];
+}
+
+export interface ContestStandings {
+    contest: CodeforcesContest;
+    problems: CodeforcesProblem[];
+    rows: RankingRow[];
+}
+
+export interface RatingChange {
+    contestId: number;
+    contestName: string;
+    handle: string;
+    rank: number;
+    ratingUpdateTimeSeconds: number;
+    oldRating: number;
+    newRating: number;
+}
+
+export interface Hack {
+    id: number;
+    creationTimeSeconds: number;
+    hacker: any;
+    defender: any;
+    verdict?: string;
+    problem: CodeforcesProblem;
+}
+
+export interface ProblemsetQuery {
+    tags?: string;
+}
+
+export interface RecentActionsQuery {
+    maxCount: number;
+}
+
+export interface ContestQuery {
+    contestId: number;
+}
+
+export interface StandingsQuery {
+    contestId: number;
+    from?: number;
+    count?: number;
+    handles?: string;
+    room?: number;
+    showUnofficial?: boolean;
+}
+
+export interface ContestStatusQuery {
+    contestId: number;
+    handle?: string;
+    from?: number;
+    count?: number;
+}
+
+export interface BlogEntryQuery {
+    blogEntryId: number;
+}
+
+export interface RecentStatusQuery {
+    count: number;
+}
+
+export interface BlogEntryView {
+    id: number;
+    title: string;
+    content: string;
+    creationTimeSeconds: number;
+    rating: number;
+    authorHandle: string;
+}
+
+export interface BlogComment {
+    id: number;
+    creationTimeSeconds: number;
+    commentatorHandle: string;
+    text: string;
+    rating: number;
+}

src/modules/gfg/constants.ts

@@ -0,0 +1,15 @@
+export const GFG_BASE_URL = 'https://www.geeksforgeeks.org/user/';
+
+export const GFG_SELECTORS = {
+    NEXT_DATA: 'script#__NEXT_DATA__',
+} as const;
+
+export function mapRating(rating: number): string {
+    if (rating >= 2500) return '7 star';
+    if (rating >= 2200) return '6 star';
+    if (rating >= 2000) return '5 star';
+    if (rating >= 1800) return '4 star';
+    if (rating >= 1600) return '3 star';
+    if (rating >= 1400) return '2 star';
+    return '1 star';
+}

src/modules/gfg/handlers.ts

@@ -0,0 +1,52 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from './service';
+import type {
+    UserQuery,
+    SubmissionsQuery,
+    UserPostsQuery,
+    LeaderboardQuery,
+    PromotionalEventsQuery
+} from './types';
+
+export async function getUserRatingHandler(
+    request: FastifyRequest<{ Querystring: UserQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getUserRating(username);
+    return reply.send(data);
+}
+
+export async function getUserSubmissionsHandler(
+    request: FastifyRequest<{ Body: SubmissionsQuery }>,
+    reply: FastifyReply
+) {
+    const data = await service.getUserSubmissions(request.body);
+    return reply.send(data);
+}
+
+export async function getUserPostsHandler(
+    request: FastifyRequest<{ Params: { username: string }, Querystring: Omit<UserPostsQuery, 'username'> }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const { fetch_type, page } = request.query;
+    const data = await service.getUserPosts({ username, fetch_type, page });
+    return reply.send(data);
+}
+
+export async function getPromotionalEventsHandler(
+    request: FastifyRequest<{ Querystring: PromotionalEventsQuery }>,
+    reply: FastifyReply
+) {
+    const data = await service.getPromotionalEvents(request.query);
+    return reply.send(data);
+}
+
+export async function getContestLeaderboardHandler(
+    request: FastifyRequest<{ Querystring: LeaderboardQuery }>,
+    reply: FastifyReply
+) {
+    const data = await service.getContestLeaderboard(request.query);
+    return reply.send(data);
+}

src/modules/gfg/index.ts

@@ -0,0 +1,2 @@
+export { default as gfgPlugin } from './routes';
+export * from './types';

src/modules/gfg/provider.ts

@@ -0,0 +1,95 @@
+import { httpClient } from '../../shared/utils/http-client';
+import * as cheerio from 'cheerio';
+import type {
+    GFGSubmissionsResponse,
+    SubmissionsQuery,
+    UserPostsQuery,
+    LeaderboardQuery,
+    PromotionalEventsQuery,
+    GFGUserRating,
+    GFGPost,
+    GFGPromotionalEvent,
+    GFGLeaderboard,
+} from './types';
+import { GFG_BASE_URL, GFG_SELECTORS } from './constants';
+
+export async function fetchUserRating(username: string): Promise<GFGUserRating> {
+    const url = `${GFG_BASE_URL}${username}/`;
+    try {
+        const { data } = await httpClient.get(url);
+        const $ = cheerio.load(data);
+
+        // Check for 404 or "User not found"
+        if ($('title').text().includes('404') || $('body').text().includes('User not found')) {
+            throw new Error(`User '${username}' not found on GeeksforGeeks`);
+        }
+
+        const scriptContent = $(GFG_SELECTORS.NEXT_DATA).html();
+        if (!scriptContent) {
+            throw new Error('GeeksforGeeks schema change detected: NEXT_DATA script not found');
+        }
+
+        const jsonData = JSON.parse(scriptContent);
+        const userData = jsonData?.props?.pageProps?.contestData?.user_contest_data;
+        const stars = jsonData?.props?.pageProps?.contestData?.user_stars;
+
+        if (!userData && !jsonData?.props?.pageProps?.contestData) {
+            throw new Error(`User '${username}' contest data not found. Profile might be private or schema changed.`);
+        }
+
+        return {
+            rating: userData?.current_rating || 'Unrated',
+            stars: stars ? `${stars} star` : 'Unrated',
+        };
+    } catch (error: any) {
+        if (error.response?.status === 404) {
+            throw new Error(`User '${username}' not found on GeeksforGeeks`);
+        }
+        throw error;
+    }
+}
+
+export async function fetchUserSubmissions(query: SubmissionsQuery): Promise<GFGSubmissionsResponse> {
+    const url = 'https://practiceapi.geeksforgeeks.org/api/v1/user/problems/submissions/';
+    const { data } = await httpClient.post(url, {
+        handle: query.handle,
+        requestType: query.requestType || "",
+        year: query.year || "",
+        month: query.month || ""
+    });
+    return data;
+}
+
+export async function fetchUserPosts(query: UserPostsQuery): Promise<GFGPost[]> {
+    const url = `https://communityapi.geeksforgeeks.org/post/user/${query.username}/`;
+    const { data } = await httpClient.get(url, {
+        params: {
+            fetch_type: query.fetch_type || 'posts',
+            page: query.page || 1
+        }
+    });
+    return data;
+}
+
+export async function fetchPromotionalEvents(query: PromotionalEventsQuery): Promise<GFGPromotionalEvent[]> {
+    const url = 'https://practiceapi.geeksforgeeks.org/api/vr/events/promotional/';
+    const { data } = await httpClient.get(url, {
+        params: {
+            page_source: query.page_source,
+            user_country_code: query.user_country_code || 'IN'
+        }
+    });
+    return data;
+}
+
+export async function fetchContestLeaderboard(query: LeaderboardQuery): Promise<GFGLeaderboard> {
+    const url = 'https://practiceapi.geeksforgeeks.org/api/latest/events/recurring/gfg-weekly-coding-contest/leaderboard/';
+    const { data } = await httpClient.get(url, {
+        params: {
+            leaderboard_type: query.leaderboard_type || 0,
+            page: query.page || 1,
+            year_month: query.year_month || ""
+        }
+    });
+    return data;
+}

src/modules/gfg/routes.ts

@@ -0,0 +1,58 @@
+import { FastifyPluginAsync } from 'fastify';
+import * as handlers from './handlers';
+import * as schemas from './schemas';
+import validateUsername from '../../shared/middlewares/validate';
+import type {
+    UserQuery,
+    SubmissionsQuery,
+    UserPostsQuery,
+    LeaderboardQuery,
+    PromotionalEventsQuery
+} from './types';
+
+const gfgRoutes: FastifyPluginAsync = async (fastify) => {
+    // Legacy mapping (GET for consistency with other platforms)
+    fastify.get<{ Querystring: UserQuery }>(
+        '/rating',
+        {
+            preHandler: [validateUsername],
+            schema: schemas.userRatingSchema,
+        },
+        handlers.getUserRatingHandler
+    );
+
+    // New APIs
+    fastify.post<{ Body: SubmissionsQuery }>(
+        '/submissions',
+        {
+            schema: schemas.userSubmissionsSchema,
+        },
+        handlers.getUserSubmissionsHandler
+    );
+
+    fastify.get<{ Params: { username: string }, Querystring: Omit<UserPostsQuery, 'username'> }>(
+        '/posts/:username',
+        {
+            schema: schemas.userPostsSchema,
+        },
+        handlers.getUserPostsHandler
+    );
+
+    fastify.get<{ Querystring: PromotionalEventsQuery }>(
+        '/events/promotional',
+        {
+            schema: schemas.promotionalEventsSchema,
+        },
+        handlers.getPromotionalEventsHandler
+    );
+
+    fastify.get<{ Querystring: LeaderboardQuery }>(
+        '/leaderboard',
+        {
+            schema: schemas.contestLeaderboardSchema,
+        },
+        handlers.getContestLeaderboardHandler
+    );
+};
+
+export default gfgRoutes;

src/modules/gfg/schemas.ts

@@ -0,0 +1,87 @@
+export const userRatingSchema = {
+    summary: 'Get User Rating',
+    description: 'Fetches GeeksforGeeks user rating and platform details',
+    tags: ['GFG'],
+    querystring: {
+        type: 'object',
+        properties: {
+            username: { type: 'string', description: 'GFG username' },
+        },
+        required: ['username'],
+    },
+    response: {
+        200: {
+            type: 'object',
+            properties: {
+                username: { type: 'string' },
+                platform: { type: 'string' },
+                rating: { type: ['number', 'string'] },
+                level: { type: 'string' }
+            }
+        }
+    }
+};
+
+export const userSubmissionsSchema = {
+    summary: 'Get User Submissions',
+    description: 'Fetches problems solved by a GFG user',
+    tags: ['GFG'],
+    body: {
+        type: 'object',
+        properties: {
+            handle: { type: 'string', description: 'GFG handle' },
+            requestType: { type: 'string', default: "" },
+            year: { type: 'string', default: "" },
+            month: { type: 'string', default: "" }
+        },
+        required: ['handle']
+    }
+};
+
+export const userPostsSchema = {
+    summary: 'Get User Posts',
+    description: 'Fetches articles and posts written by a GFG user',
+    tags: ['GFG'],
+    params: {
+        type: 'object',
+        properties: {
+            username: { type: 'string' }
+        },
+        required: ['username']
+    },
+    querystring: {
+        type: 'object',
+        properties: {
+            fetch_type: { type: 'string', default: 'posts' },
+            page: { type: 'number', default: 1 }
+        }
+    }
+};
+
+export const promotionalEventsSchema = {
+    summary: 'Get Promotional Events',
+    description: 'Fetches promotional events from GFG',
+    tags: ['GFG'],
+    querystring: {
+        type: 'object',
+        properties: {
+            page_source: { type: 'string' },
+            user_country_code: { type: 'string', default: 'IN' }
+        },
+        required: ['page_source']
+    }
+};
+
+export const contestLeaderboardSchema = {
+    summary: 'Get Contest Leaderboard',
+    description: 'Fetches the leaderboard for GFG weekly coding contests',
+    tags: ['GFG'],
+    querystring: {
+        type: 'object',
+        properties: {
+            leaderboard_type: { type: 'number', default: 0 },
+            page: { type: 'number', default: 1 },
+            year_month: { type: 'string', default: "" }
+        }
+    }
+};

src/modules/gfg/service.ts

@@ -0,0 +1,61 @@
+import * as provider from './provider';
+import type {
+    GFGRating,
+    SubmissionsQuery,
+    GFGSubmissionsResponse,
+    UserPostsQuery,
+    LeaderboardQuery,
+    PromotionalEventsQuery
+} from './types';
+
+export async function getUserRating(username: string): Promise<GFGRating> {
+    try {
+        const data = await provider.fetchUserRating(username);
+
+        return {
+            username,
+            platform: 'gfg',
+            rating: data.rating,
+            level: data.stars,
+        };
+    } catch (error: any) {
+        console.error(`GFG Error for ${username}:`, error.message);
+        throw new Error('Error fetching GFG user data');
+    }
+}
+
+export async function getUserSubmissions(query: SubmissionsQuery): Promise<GFGSubmissionsResponse> {
+    try {
+        return await provider.fetchUserSubmissions(query);
+    } catch (error: any) {
+        console.error(`GFG Submissions Error for ${query.handle}:`, error.message);
+        throw new Error('Error fetching GFG submissions');
+    }
+}
+
+export async function getUserPosts(query: UserPostsQuery): Promise<any> {
+    try {
+        return await provider.fetchUserPosts(query);
+    } catch (error: any) {
+        console.error(`GFG Posts Error for ${query.username}:`, error.message);
+        throw new Error('Error fetching GFG user posts');
+    }
+}
+
+export async function getPromotionalEvents(query: PromotionalEventsQuery): Promise<any> {
+    try {
+        return await provider.fetchPromotionalEvents(query);
+    } catch (error: any) {
+        console.error('GFG Promotional Events Error:', error.message);
+        throw new Error('Error fetching GFG promotional events');
+    }
+}
+
+export async function getContestLeaderboard(query: LeaderboardQuery): Promise<any> {
+    try {
+        return await provider.fetchContestLeaderboard(query);
+    } catch (error: any) {
+        console.error('GFG Leaderboard Error:', error.message);
+        throw new Error('Error fetching GFG contest leaderboard');
+    }
+}

src/modules/gfg/types.ts

@@ -0,0 +1,78 @@
+export interface GFGRating {
+    username: string;
+    platform: string;
+    rating: number | string;
+    level: string;
+}
+
+export interface UserQuery {
+    username: string;
+}
+
+export interface SubmissionsQuery {
+    handle: string;
+    requestType?: string;
+    year?: string;
+    month?: string;
+}
+
+export interface GFGSubmission {
+    slug: string;
+    pname: string;
+    lang: string;
+}
+
+export interface GFGSubmissionsResponse {
+    status: string;
+    message: string;
+    result: {
+        [difficulty: string]: {
+            [id: string]: GFGSubmission;
+        };
+    };
+    count: number;
+}
+
+export interface UserPostsQuery {
+    username: string;
+    fetch_type?: string;
+    page?: number;
+}
+
+export interface LeaderboardQuery {
+    leaderboard_type?: number;
+    page?: number;
+    year_month?: string;
+}
+
+export interface PromotionalEventsQuery {
+    page_source: string;
+    user_country_code?: string;
+}
+export interface GFGUserRating {
+    rating: number | string;
+    stars: string;
+}
+
+export interface GFGPost {
+    id: number;
+    title: string;
+    content: string;
+    creationDate: string;
+    author: string;
+}
+
+export interface GFGPromotionalEvent {
+    id: number;
+    link: string;
+    title: string;
+    image: string;
+}
+
+export interface GFGLeaderboard {
+    users: {
+        handle: string;
+        rank: number;
+        score: number;
+    }[];
+}

src/modules/leetcode/constants.ts

@@ -0,0 +1,18 @@
+export const LEETCODE_API_URL = 'https://leetcode.com/graphql';
+
+export const LEETCODE_HEADERS = {
+    'authority': 'leetcode.com',
+    'accept': '*/*',
+    'accept-language': 'en-US,en;q=0.9',
+    'content-type': 'application/json',
+    'origin': 'https://leetcode.com',
+    'referer': 'https://leetcode.com/',
+    'sec-ch-ua': '"Not_A Brand";v="8", "Chromium";v="120", "Google Chrome";v="120"',
+    'sec-ch-ua-mobile': '?0',
+    'sec-ch-ua-platform': '"Windows"',
+    'sec-fetch-dest': 'empty',
+    'sec-fetch-mode': 'cors',
+    'sec-fetch-site': 'same-origin',
+    'user-agent':
+        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+};

src/modules/leetcode/handlers/contest.ts

@@ -0,0 +1,36 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from '../services';
+import type { ContestRankingQuery } from '../types';
+
+export async function getContestRankingHandler(
+    request: FastifyRequest<{ Querystring: ContestRankingQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getContestRankingInfo(username);
+    return reply.send(data);
+}
+
+export async function getContestHistogramHandler(
+    request: FastifyRequest,
+    reply: FastifyReply
+) {
+    const data = await service.getContestHistogram();
+    return reply.send(data);
+}
+
+export async function getAllContestsHandler(
+    request: FastifyRequest,
+    reply: FastifyReply
+) {
+    const data = await service.getAllContests();
+    return reply.send(data);
+}
+
+export async function getUpcomingContestsHandler(
+    request: FastifyRequest,
+    reply: FastifyReply
+) {
+    const data = await service.getUpcomingContests();
+    return reply.send(data);
+}

src/modules/leetcode/handlers/discussion.ts

@@ -0,0 +1,30 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from '../services';
+
+export async function getTrendingDiscussHandler(
+    request: FastifyRequest<{ Querystring: { first?: string } }>,
+    reply: FastifyReply
+) {
+    const first = parseInt(request.query.first || '20', 10);
+    const data = await service.getTrendingDiscuss(first);
+    return reply.send(data);
+}
+
+export async function getDiscussTopicHandler(
+    request: FastifyRequest<{ Params: { topicId: string } }>,
+    reply: FastifyReply
+) {
+    const topicId = parseInt(request.params.topicId, 10);
+    const data = await service.getDiscussTopic(topicId);
+    return reply.send(data);
+}
+
+export async function getDiscussCommentsHandler(
+    request: FastifyRequest<{ Params: { topicId: string }; Querystring: any }>,
+    reply: FastifyReply
+) {
+    const topicId = parseInt(request.params.topicId, 10);
+    const query = (request.query || {}) as Record<string, any>;
+    const data = await service.getDiscussComments({ topicId, ...query });
+    return reply.send(data);
+}

src/modules/leetcode/handlers/index.ts

@@ -0,0 +1,4 @@
+export * from './contest';
+export * from './user';
+export * from './problem';
+export * from './discussion';

src/modules/leetcode/handlers/problem.ts

@@ -0,0 +1,37 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from '../services';
+
+export async function getDailyProblemHandler(request: FastifyRequest, reply: FastifyReply) {
+    const raw = (request.query as any).raw === 'true';
+    const data = await service.getDailyProblem(raw);
+    return reply.send(data);
+}
+
+export async function getSelectProblemHandler(
+    request: FastifyRequest<{ Querystring: { titleSlug: string; raw?: string } }>,
+    reply: FastifyReply
+) {
+    const { titleSlug, raw } = request.query;
+    if (!titleSlug) {
+        return reply.status(400).send({ error: 'Missing titleSlug query parameter' });
+    }
+    const data = await service.getSelectProblem(titleSlug, raw === 'true');
+    return reply.send(data);
+}
+
+export async function getProblemsHandler(request: FastifyRequest, reply: FastifyReply) {
+    const data = await service.getProblems(request.query);
+    return reply.send(data);
+}
+
+export async function getOfficialSolutionHandler(
+    request: FastifyRequest<{ Querystring: { titleSlug: string } }>,
+    reply: FastifyReply
+) {
+    const { titleSlug } = request.query;
+    if (!titleSlug) {
+        return reply.status(400).send({ error: 'Missing titleSlug query parameter' });
+    }
+    const data = await service.getOfficialSolution(titleSlug);
+    return reply.send(data);
+}

src/modules/leetcode/handlers/user.ts

@@ -0,0 +1,123 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+import * as service from '../services';
+import type { ContestRankingQuery } from '../types';
+
+export async function getUserRatingHandler(
+    request: FastifyRequest<{ Querystring: ContestRankingQuery }>,
+    reply: FastifyReply
+) {
+    const { username } = request.query;
+    const data = await service.getUserRating(username);
+    return reply.send(data);
+}
+
+export async function getUserProfileHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserProfile(username);
+    return reply.send(data);
+}
+
+export async function getUserDetailsHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserDetails(username);
+    return reply.send(data);
+}
+
+export async function getUserBadgesHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserBadges(username);
+    return reply.send(data);
+}
+
+export async function getUserSolvedHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserSolved(username);
+    return reply.send(data);
+}
+
+export async function getUserContestHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserContest(username);
+    return reply.send(data);
+}
+
+export async function getUserContestHistoryHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserContestHistory(username);
+    return reply.send(data);
+}
+
+export async function getUserSubmissionHandler(
+    request: FastifyRequest<{ Params: { username: string }; Querystring: { limit?: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const limit = parseInt(request.query.limit || '20', 10);
+    const data = await service.getUserSubmission(username, limit);
+    return reply.send(data);
+}
+
+export async function getUserAcSubmissionHandler(
+    request: FastifyRequest<{ Params: { username: string }; Querystring: { limit?: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const limit = parseInt(request.query.limit || '20', 10);
+    const data = await service.getUserAcSubmission(username, limit);
+    return reply.send(data);
+}
+
+export async function getUserCalendarHandler(
+    request: FastifyRequest<{ Params: { username: string }; Querystring: { year?: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const year = parseInt(request.query.year || '0', 10);
+    const data = await service.getUserCalendar(username, year);
+    return reply.send(data);
+}
+
+export async function getUserSkillHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserSkill(username);
+    return reply.send(data);
+}
+
+export async function getUserLanguageHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserLanguage(username);
+    return reply.send(data);
+}
+
+export async function getUserProgressHandler(
+    request: FastifyRequest<{ Params: { username: string } }>,
+    reply: FastifyReply
+) {
+    const { username } = request.params;
+    const data = await service.getUserProgress(username);
+    return reply.send(data);
+}

src/modules/leetcode/index.ts

@@ -0,0 +1,2 @@
+export { default as leetcodePlugin } from './routes';
+export * from './types';

src/modules/leetcode/provider.ts

@@ -0,0 +1,177 @@
+import { httpClient } from '../../shared/utils/http-client';
+import {
+    USER_CONTEST_RANKING_QUERY,
+    USER_RATING_QUERY,
+    CONTEST_HISTOGRAM_QUERY,
+    ALL_CONTESTS_QUERY,
+    DAILY_PROBLEM_QUERY,
+    SELECT_PROBLEM_QUERY,
+    PROBLEM_LIST_QUERY,
+    OFFICIAL_SOLUTION_QUERY,
+    TRENDING_DISCUSS_QUERY,
+    DISCUSS_TOPIC_QUERY,
+    DISCUSS_COMMENTS_QUERY,
+    USER_PROFILE_QUERY,
+    USER_PROFILE_CALENDAR_QUERY,
+    USER_QUESTION_PROGRESS_QUERY,
+    SKILL_STATS_QUERY,
+    LANGUAGE_STATS_QUERY,
+    AC_SUBMISSION_QUERY,
+    SUBMISSION_QUERY,
+    GET_USER_PROFILE_QUERY,
+    CONTEST_QUERY,
+    USER_BADGES_QUERY,
+    USER_SOLVED_QUERY,
+} from './utils/queries';
+import type {
+    ContestRankingResponse,
+    ContestHistogramResponse,
+    Contest,
+    UserData,
+    DailyProblemData,
+    SelectProblemData,
+    ProblemSetQuestionListData,
+    UserProfileResponse,
+    UserRatingData,
+    OfficialSolutionData,
+    TrendingDiscussData,
+    DiscussTopicData,
+    DiscussCommentsData,
+    UserCalendarData,
+    UserQuestionProgressData,
+    SkillStatsData,
+    LanguageStatsData,
+    AcSubmissionsData,
+    SubmissionsData,
+    ContestData,
+} from './types';
+
+import { LEETCODE_API_URL, LEETCODE_HEADERS } from './constants';
+
+async function leetcodeRequest<T>(query: string, variables: object = {}): Promise<T> {
+    const payload = { query, variables };
+    const response = await httpClient.post(LEETCODE_API_URL, payload, {
+        headers: LEETCODE_HEADERS,
+    });
+
+    if (response.status !== 200) {
+        throw new Error(`LeetCode API returned status ${response.status}`);
+    }
+
+    if (response.data.errors) {
+        throw new Error(response.data.errors[0].message);
+    }
+
+    return response.data.data;
+}
+
+// Existing functions
+export async function fetchUserContestRanking(username: string): Promise<ContestRankingResponse> {
+    return await leetcodeRequest<ContestRankingResponse>(USER_CONTEST_RANKING_QUERY, { username });
+}
+
+export async function fetchUserRating(username: string): Promise<UserRatingData> {
+    return await leetcodeRequest<UserRatingData>(USER_RATING_QUERY, { username });
+}
+
+export async function fetchContestHistogram(): Promise<ContestHistogramResponse> {
+    return await leetcodeRequest<ContestHistogramResponse>(CONTEST_HISTOGRAM_QUERY);
+}
+
+export async function fetchAllContests(): Promise<Contest[]> {
+    const data = await leetcodeRequest<{ allContests: Contest[] }>(ALL_CONTESTS_QUERY);
+    return data.allContests;
+}
+
+export async function fetchDailyProblem(): Promise<DailyProblemData> {
+    return await leetcodeRequest<DailyProblemData>(DAILY_PROBLEM_QUERY);
+}
+
+export async function fetchSelectProblem(titleSlug: string): Promise<SelectProblemData> {
+    return await leetcodeRequest<SelectProblemData>(SELECT_PROBLEM_QUERY, { titleSlug });
+}
+
+const MAX_LEETCODE_LIMIT = 100;
+
+export async function fetchProblems(filters: {
+    categorySlug?: string;
+    limit?: number;
+    skip?: number;
+    filters?: any;
+}): Promise<ProblemSetQuestionListData> {
+    const { categorySlug, limit = 20, skip = 0, filters: questionFilters } = filters;
+    const safeLimit = Math.min(limit, MAX_LEETCODE_LIMIT);
+
+    return await leetcodeRequest<ProblemSetQuestionListData>(PROBLEM_LIST_QUERY, {
+        categorySlug,
+        limit: safeLimit,
+        skip,
+        filters: questionFilters,
+    });
+}
+
+export async function fetchOfficialSolution(titleSlug: string): Promise<OfficialSolutionData> {
+    return await leetcodeRequest<OfficialSolutionData>(OFFICIAL_SOLUTION_QUERY, { titleSlug });
+}
+
+export async function fetchTrendingDiscuss(first: number): Promise<TrendingDiscussData> {
+    return await leetcodeRequest<TrendingDiscussData>(TRENDING_DISCUSS_QUERY, { first });
+}
+
+export async function fetchDiscussTopic(topicId: number): Promise<DiscussTopicData> {
+    return await leetcodeRequest<DiscussTopicData>(DISCUSS_TOPIC_QUERY, { topicId });
+}
+
+export async function fetchDiscussComments(params: {
+    topicId: number;
+    orderBy?: string;
+    pageNo?: number;
+    numPerPage?: number;
+}): Promise<DiscussCommentsData> {
+    return await leetcodeRequest<DiscussCommentsData>(DISCUSS_COMMENTS_QUERY, params);
+}
+
+export async function fetchUserProfile(username: string): Promise<UserProfileResponse> {
+    return await leetcodeRequest<UserProfileResponse>(GET_USER_PROFILE_QUERY, { username });
+}
+
+export async function fetchUserData(username: string): Promise<UserData> {
+    // This query is very large and might need optimization or splitting
+    return await leetcodeRequest<UserData>(USER_PROFILE_QUERY, { username });
+}
+
+export async function fetchUserCalendar(username: string, year: number): Promise<UserCalendarData> {
+    return await leetcodeRequest<UserCalendarData>(USER_PROFILE_CALENDAR_QUERY, { username, year });
+}
+
+export async function fetchUserQuestionProgress(username: string): Promise<UserQuestionProgressData> {
+    return await leetcodeRequest<UserQuestionProgressData>(USER_QUESTION_PROGRESS_QUERY, { username });
+}
+
+export async function fetchSkillStats(username: string): Promise<SkillStatsData> {
+    return await leetcodeRequest<SkillStatsData>(SKILL_STATS_QUERY, { username });
+}
+
+export async function fetchLanguageStats(username: string): Promise<LanguageStatsData> {
+    return await leetcodeRequest<LanguageStatsData>(LANGUAGE_STATS_QUERY, { username });
+}
+
+export async function fetchAcSubmissions(username: string, limit: number): Promise<AcSubmissionsData> {
+    return await leetcodeRequest<AcSubmissionsData>(AC_SUBMISSION_QUERY, { username, limit });
+}
+
+export async function fetchSubmissions(username: string, limit: number): Promise<SubmissionsData> {
+    return await leetcodeRequest<SubmissionsData>(SUBMISSION_QUERY, { username, limit });
+}
+
+export async function fetchContestData(username: string): Promise<ContestData> {
+    return await leetcodeRequest<ContestData>(CONTEST_QUERY, { username });
+}
+
+export async function fetchUserBadges(username: string): Promise<any> {
+    return await leetcodeRequest<any>(USER_BADGES_QUERY, { username });
+}
+
+export async function fetchUserSolved(username: string): Promise<any> {
+    return await leetcodeRequest<any>(USER_SOLVED_QUERY, { username });
+}