serper-search-mcp 2.0.0

package/README.md

@@ -0,0 +1,428 @@
+# Serper Search MCP Server v2.0.0 - Enterprise Edition
+
+🚀 **Enterprise-grade Google search MCP server** with **dual architecture**: JavaScript for integration + TypeScript for enterprise development.
+
+👨‍💻 **Author:** SMJAHID from SMLabs01
+📦 **NPM:** `@modelcontextprotocol/server-serper-search`
+🐳 **Docker:** `smlabs01/server-serper-search`
+🔧 **Architecture:** JavaScript (primary) + TypeScript (enterprise modular design)
+
+---
+
+## 🏗️ Dual Architecture Approach
+
+This server provides **the best of both worlds**:
+
+### **JavaScript Version (Primary)**
+- **File:** `index.js` - Single file deployment
+- **Transport:** Full HTTP/SSE + STDIO support
+- **Integration:** Zero build process, immediate deployment
+- **Use Case:** Kilo Code integration, simple deployment
+
+### **TypeScript Version (Enterprise)**
+- **Structure:** `src/` - Modular enterprise architecture
+- **Features:** Type safety, better IDE support, team development
+- **Build:** `npm run build` creates `dist/` folder
+- **Use Case:** Large teams, maintainability, advanced development
+
+## 🏗️ Enterprise Architecture
+This server follows enterprise-grade patterns:
+
+```
+src/
+├── api/
+│   └── SerperAPI.ts          # Serper API client abstraction
+├── tools/
+│   └── SearchTools.ts        # Tool definitions and validation
+├── utils/
+│   └── ResultFormatter.ts    # Response formatting utilities
+├── server/
+│   └── SerperMCPServer.ts    # Main server implementation
+├── types/
+│   └── index.ts             # TypeScript type definitions
+└── index.ts                 # Application entry point
+```
+
+## Features
+- 🔍 **Multi-Type Search**: Web, Images, Videos, News, and Shopping search capabilities
+- 🚀 **Multi-Transport**: STDIO (default) and HTTP/SSE transport modes
+- 🌍 **Advanced Filtering**: Country, language, freshness, and content filters
+- 🤖 **AI Summarization**: Generate summaries from search results
+- 🐳 **Docker Support**: Multi-stage builds with smlabs01 namespace
+- 📦 **NPM Package**: TypeScript with full CLI support
+- ⚡ **Fast Results**: Optimized API client with error handling
+- 🎯 **Structured Data**: Clean JSON responses perfect for AI processing
+- 🔧 **Enterprise Ready**: Modular architecture for maintainability
+
+## 🚀 Quick Start & Integration Guide
+
+**🎯 Use JavaScript Version (`index.js`) for integration:**
+
+```bash
+# No build process required
+node index.js --help
+
+# HTTP transport ready
+SERPER_MCP_TRANSPORT=http SERPER_MCP_PORT=8080 node index.js
+
+# Docker integration
+docker run -e SERPER_API_KEY=your_key smlabs01/server-serper-search:2.0.0
+```
+
+**Why JavaScript for Integration:**
+- ✅ **Zero configuration** - No build step needed
+- ✅ **HTTP transport** - Full MCP SSE support
+- ✅ **Simple deployment** - Single file execution
+- ✅ **Standard approach** - Like other MCP servers
+
+### For Enterprise Development (Optional)
+
+**🏗️ Use TypeScript Version (`src/`) for development:**
+
+```bash
+# Build TypeScript
+npm run build
+
+# Use compiled version
+node dist/index.js --help
+
+# Enterprise benefits
+# - Type safety and IntelliSense
+# - Modular architecture
+# - Better for large teams
+```
+
+## Installation & Setup
+
+### Option 1: NPX (Recommended for Integration)
+
+1. **Get your Serper API key** from [Serper.dev](https://serper.dev)
+
+2. **Configure the MCP server** in your MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "serper-search": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-serper-search"],
+      "env": {
+        "SERPER_API_KEY": "your_actual_api_key_here"
+      }
+    }
+  }
+}
+```
+
+3. **Restart your MCP client** 
+
+### Option 2: Docker
+
+1. **Pull from Docker Hub** (Recommended):
+```bash
+docker pull smlabs01/server-serper-search:2.0.0
+```
+
+2. **Or build locally**:
+```bash
+docker build -t smlabs01/server-serper-search:2.0.0 .
+```
+
+3. **Configure the MCP server**:
+```json
+{
+  "mcpServers": {
+    "serper-search": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "SERPER_API_KEY=your_actual_api_key_here",
+        "smlabs01/server-serper-search:2.0.0"
+      ]
+    }
+  }
+}
+```
+
+### Option 2.1: Docker Compose (Development)
+
+1. **Set your API key**:
+```bash
+export SERPER_API_KEY="your_actual_api_key_here"
+```
+
+2. **Start with Docker Compose**:
+```bash
+# Production mode
+docker-compose up
+
+# Development mode with hot reload
+docker-compose --profile dev up
+```
+
+3. **Access the server** at `http://localhost:8080`
+
+### Option 3: Local Installation
+
+1. **Clone and install**:
+```bash
+git clone https://github.com/smjahid012/serper-search-mcp-server.git
+cd server-serper-search
+npm install
+```
+
+2. **Set environment variable**:
+```bash
+export SERPER_API_KEY="your_actual_api_key_here"
+```
+
+3. **Run locally**:
+```bash
+# STDIO mode (default)
+npm start
+
+# HTTP mode
+npm run http
+
+# Show help
+npm run help
+```
+
+### Option 4: Command Line Interface
+
+```bash
+# Show all options
+node index.js --help
+
+# Run with custom options
+node index.js --transport http --port 3000 --host 127.0.0.1
+
+# Environment variables
+SERPER_MCP_TRANSPORT=http SERPER_MCP_PORT=3000 node index.js
+```
+
+## Usage
+
+Once configured, you can use the search tools in your MCP client:
+
+### Available Tools:
+
+#### 1. `search_web` - General Web Search
+**Parameters:**
+- `query` (required): The search query string (max 400 chars, 50 words)
+- `num_results` (optional): Number of results to return (1-20, default: 10)
+- `country` (optional): Country code (default: "US")
+- `search_lang` (optional): Search language (default: "en")
+- `ui_lang` (optional): UI language (default: "en-US")
+- `freshness` (optional): Time filter ("pd", "pw", "pm", "py")
+- `safesearch` (optional): Content filtering ("off", "moderate", "strict")
+- `summary` (optional): Enable AI summarization (default: false)
+
+**Example:**
+```javascript
+// Advanced search with filtering
+await callTool("search_web", {
+  query: "artificial intelligence recent news",
+  num_results: 15,
+  country: "US",
+  freshness: "pw",  // Past week
+  safesearch: "moderate",
+  summary: true     // Get AI summary
+});
+```
+
+#### 2. `search_images` - Image Search
+**Parameters:**
+- `query` (required): The image search query
+- `num_results` (optional): Number of results to return (default: 10)
+
+**Example:**
+```javascript
+// Search for AI-generated images
+await callTool("search_images", {
+  query: "artificial intelligence artwork",
+  num_results: 8
+});
+```
+
+#### 3. `search_videos` - Video Search
+**Parameters:**
+- `query` (required): The video search query
+- `num_results` (optional): Number of results to return (default: 10)
+
+**Example:**
+```javascript
+// Search for tutorial videos
+await callTool("search_videos", {
+  query: "machine learning tutorials",
+  num_results: 5
+});
+```
+
+#### 4. `search_news` - News Search
+**Parameters:**
+- `query` (required): The news search query
+- `num_results` (optional): Number of results to return (default: 10)
+
+**Example:**
+```javascript
+// Get latest AI news
+await callTool("search_news", {
+  query: "artificial intelligence breakthroughs 2024",
+  num_results: 10
+});
+```
+
+#### 5. `search_shopping` - Shopping/Product Search
+**Parameters:**
+- `query` (required): The shopping search query
+- `num_results` (optional): Number of results to return (default: 10)
+
+**Example:**
+```javascript
+// Search for products
+await callTool("search_shopping", {
+  query: "wireless headphones under $100",
+  num_results: 5
+});
+```
+
+## Configuration
+
+### Environment Variables
+
+The server supports the following environment variables:
+
+| Variable | Description | Default | Required |
+|----------|-------------|---------|----------|
+| `SERPER_API_KEY` | Your Serper API key | - | ✅ |
+| `SERPER_MCP_TRANSPORT` | Transport mode | `stdio` | ❌ |
+| `SERPER_MCP_PORT` | HTTP server port | `8080` | ❌ |
+| `SERPER_MCP_HOST` | HTTP server host | `0.0.0.0` | ❌ |
+| `SERPER_MCP_LOG_LEVEL` | Logging level | `info` | ❌ |
+
+### Command Line Options
+
+```bash
+node index.js [options]
+
+Options:
+  --transport <stdio\|http>    Transport type (default: stdio)
+  --port <number>             HTTP server port (default: 8080)
+  --host <string>             HTTP server host (default: "0.0.0.0")
+  --log-level <string>        Logging level (default: "info")
+  --api-key <string>          Serper API key
+  --help                      Show help message
+```
+
+## Search Capabilities
+
+The server supports all major Google search types through the Serper API:
+
+| Search Type | Use Case | Data Included |
+|-------------|----------|---------------|
+| **Web** | General research, content discovery | Title, URL, snippet, SEO data |
+| **Images** | AI datasets, creative tools, visual research | Image URL, thumbnail, source page |
+| **Videos** | Learning, entertainment, research | Title, channel, duration, thumbnail |
+| **News** | Current events, trend monitoring | Headlines, sources, publication dates |
+| **Shopping** | E-commerce, price comparison | Products, prices, ratings, sources |
+
+## Usage Scenarios
+
+With these comprehensive search capabilities, your Serper MCP server can be used for:
+
+### 🤖 **AI & Machine Learning**
+- **Dataset Collection**: Gather images for training computer vision models
+- **Research**: Find latest papers, tutorials, and educational videos
+- **Content Generation**: Source diverse content for AI-generated materials
+
+### 🔍 **Research & Analysis**
+- **Market Research**: Track product prices, reviews, and competition
+- **Trend Analysis**: Monitor news and social media for emerging trends
+- **Competitive Intelligence**: Research competitor products and strategies
+
+### 📈 **Business Intelligence**
+- **Lead Generation**: Find business contact information and company data
+- **Content Marketing**: Discover trending topics and viral content
+- **SEO Research**: Analyze search results and ranking factors
+
+### 🎨 **Creative Work**
+- **Design Inspiration**: Search for visual references and creative assets
+- **Media Research**: Find videos, images, and audio for projects
+- **Content Curation**: Gather materials for blogs, presentations, and reports
+
+### 💼 **E-commerce & Shopping**
+- **Price Monitoring**: Track product prices across different retailers
+- **Product Research**: Find detailed product information and reviews
+- **Market Analysis**: Compare products and identify market gaps
+
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Support
+
+For issues and questions:
+- GitHub Issues: [Report bugs](https://github.com/smjahid012/serper-search-mcp-server/issues)
+- Serper API: [Get API key](https://serper.dev)
+
+## 📋 Version History & Migration Guide
+
+### v2.0.0 (Latest) - Enterprise Edition 🚀
+**Release Date:** October 2024
+**Author:** SMJAHID from SMLabs01
+
+**🎯 New Features:**
+- 🌐 **Multi-Transport Support**: HTTP/SSE + STDIO transport modes
+- 🎛️ **Advanced Filtering**: Country, language, freshness, content filters
+- 🤖 **AI Summarization**: Generate summaries from search results
+- 🔧 **Command Line Interface**: Full CLI with help and options
+- 🐳 **Docker Compose**: Development and production environments
+- ⚙️ **Enhanced Configuration**: Environment variables and CLI options
+- 📦 **Enterprise Architecture**: Modular TypeScript structure available
+
+**🔧 Improvements:**
+- 📊 **Parameter Validation**: Query length limits and input validation
+- 🔍 **Enhanced Search Parameters**: Full Serper API feature support
+- 📚 **Comprehensive Documentation**: Complete integration guide
+- 🏗️ **Better Architecture**: Improved error handling and logging
+- 🚀 **Performance Optimized**: Faster startup and response times
+
+**📁 File Structure:**
+```
+JavaScript (Primary): index.js - Single file deployment
+TypeScript (Enterprise): src/ (6 modules) - Modular architecture
+Docker: smlabs01/server-serper-search:2.0.0
+NPM: @modelcontextprotocol/server-serper-search
+```
+
+**⬆️ Migration from v1.x:**
+- ✅ **Backward Compatible**: All v1.x configurations work
+- ✅ **Default Transport**: STDIO (same as v1.x)
+- ✅ **New Features**: Opt-in via parameters
+- ⚡ **No Breaking Changes**: Existing integrations continue working
+
+### v1.1.0 - Multi-Type Search Expansion
+**Added:** Images, Videos, News, Shopping search capabilities
+**Enhanced:** Result formatting and documentation
+
+### v1.0.0 - Initial Release
+**Features:** Basic web search, Docker/NPX support, MCP compliance
+
+---
+
+## 📋 **v2.0.0 Integration Summary**
+
+| Component | JavaScript Version | TypeScript Version | Agent Ready |
+|-----------|-------------------|-------------------|----------------|
+| **Primary Server** | ✅ `index.js` | ❌ `src/` (enterprise) | ✅ **JavaScript** |
+| **Transport Support** | ✅ HTTP/SSE + STDIO | ✅ STDIO | ✅ **JavaScript** |
+| **Build Required** | ❌ No | ✅ Yes (`npm run build`) | ✅ **JavaScript** |
+| **Docker Hub** | ✅ `smlabs01/server-serper-search` | ✅ Same | ✅ **Both** |
+| **Enterprise Ready** | ❌ Simple | ✅ Modular structure | ✅ **TypeScript** |
+
+---

package/dist/api/SerperAPI.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Serper API Client for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+import { SearchOptions, SerperAPIResponse, SearchType } from '../types';
+export declare class SerperAPI {
+    private apiKey;
+    private baseURL;
+    constructor(apiKey: string);
+    /**
+     * Perform search request to Serper API
+     */
+    search(query: string, searchType?: SearchType, options?: Partial<SearchOptions>): Promise<SerperAPIResponse>;
+    /**
+     * Build request body for Serper API
+     */
+    private buildRequestBody;
+    /**
+     * Validate API key by making a test request
+     */
+    validateApiKey(): Promise<boolean>;
+    /**
+     * Get API usage information (if available)
+     */
+    getApiInfo(): {
+        endpoint: string;
+        version: string;
+    };
+}
+//# sourceMappingURL=SerperAPI.d.ts.map

package/dist/api/SerperAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerperAPI.d.ts","sourceRoot":"","sources":["../../src/api/SerperAPI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAExE,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM;IAK1B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,UAAkB,EAAE,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8B7H;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoDxB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IASxC;;OAEG;IACH,UAAU,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAMpD"}

package/dist/api/SerperAPI.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Serper API Client for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerperAPI = void 0;
+class SerperAPI {
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.baseURL = 'https://google.serper.dev';
+    }
+    /**
+     * Perform search request to Serper API
+     */
+    async search(query, searchType = 'web', options = {}) {
+        const requestBody = this.buildRequestBody(query, searchType, {
+            query,
+            ...options
+        });
+        try {
+            const response = await fetch(`${this.baseURL}/search`, {
+                method: 'POST',
+                headers: {
+                    'X-API-KEY': this.apiKey,
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(requestBody)
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Serper API error (${response.status}): ${errorText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error('Unknown error occurred during API request');
+        }
+    }
+    /**
+     * Build request body for Serper API
+     */
+    buildRequestBody(query, searchType, options) {
+        const { num_results = 10, country = 'US', search_lang = 'en', ui_lang = 'en-US', freshness, safesearch = 'moderate', summary = false } = options;
+        const requestBody = {
+            q: query,
+            num: Math.min(num_results, 20), // Cap at 20 per API limits
+            gl: country, // Country code
+            hl: ui_lang, // UI language
+            lr: `lang_${search_lang}` // Search language
+        };
+        // Add search type specific parameters
+        switch (searchType) {
+            case 'images':
+                requestBody.tbm = 'isch'; // Images search
+                break;
+            case 'videos':
+                requestBody.tbm = 'vid'; // Videos search
+                break;
+            case 'news':
+                requestBody.tbm = 'nws'; // News search
+                break;
+            case 'shopping':
+                requestBody.tbm = 'shop'; // Shopping search
+                break;
+            // web search uses default parameters
+        }
+        // Add optional filters
+        if (freshness) {
+            requestBody.tbs = `qdr:${freshness}`; // Time-based search
+        }
+        if (safesearch && safesearch !== 'moderate') {
+            requestBody.safe = safesearch === 'strict' ? 'active' : 'off';
+        }
+        if (summary) {
+            requestBody.summary = true; // Enable AI summarization
+        }
+        return requestBody;
+    }
+    /**
+     * Validate API key by making a test request
+     */
+    async validateApiKey() {
+        try {
+            await this.search('test query', 'web', { num_results: 1 });
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Get API usage information (if available)
+     */
+    getApiInfo() {
+        return {
+            endpoint: this.baseURL,
+            version: '2.0.0'
+        };
+    }
+}
+exports.SerperAPI = SerperAPI;
+//# sourceMappingURL=SerperAPI.js.map

package/dist/api/SerperAPI.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { SerperMCPServer } from './server/SerperMCPServer';
+export { SerperMCPServer };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AA0G3D,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerperMCPServer = void 0;
+const SerperMCPServer_1 = require("./server/SerperMCPServer");
+Object.defineProperty(exports, "SerperMCPServer", { enumerable: true, get: function () { return SerperMCPServer_1.SerperMCPServer; } });
+/**
+ * Serper Search MCP Server v2.0.0 - Enterprise Edition
+ *
+ * Author: SMJAHID from SMLabs01
+ * Description: Enterprise-grade Google search MCP server with multi-transport support
+ *
+ * Features:
+ * - Multi-Type Search (Web, Images, Videos, News, Shopping)
+ * - Multi-Transport (STDIO, HTTP/SSE)
+ * - Advanced Filtering (Country, Language, Freshness, Content)
+ * - AI Summarization
+ * - Docker & NPM Deployment
+ */
+// Parse command line arguments
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--transport':
+                options.transport = args[++i];
+                break;
+            case '--port':
+                options.port = parseInt(args[++i]);
+                break;
+            case '--host':
+                options.host = args[++i];
+                break;
+            case '--log-level':
+                options.logLevel = args[++i];
+                break;
+            case '--api-key':
+                options.apiKey = args[++i];
+                break;
+            case '--help':
+                console.log(`
+Serper MCP Server v2.0.0 - Enterprise Edition
+
+Usage: node dist/index.js [options]
+
+Options:
+  --transport <stdio|http>    Transport mode (default: stdio)
+  --port <number>             HTTP server port (default: 8080)
+  --host <string>             HTTP server host (default: "0.0.0.0")
+  --log-level <string>        Logging level (default: "info")
+  --api-key <string>          Serper API key
+  --help                      Show this help message
+
+Environment Variables:
+  SERPER_API_KEY              Your Serper API key (required)
+  SERPER_MCP_TRANSPORT        Transport mode ("stdio" or "http")
+  SERPER_MCP_PORT             HTTP server port
+  SERPER_MCP_HOST             HTTP server host
+  SERPER_MCP_LOG_LEVEL        Logging level
+
+Examples:
+  # STDIO mode (default)
+  npm start
+
+  # HTTP mode
+  node dist/index.js --transport http --port 3000
+
+  # Docker deployment
+  docker run -e SERPER_API_KEY=your_key smlabs01/server-serper-search
+
+Author: SMJAHID from SMLabs01
+        `);
+                return;
+        }
+    }
+    return options;
+}
+// Main execution
+async function main() {
+    try {
+        console.log('🚀 Starting Serper MCP Server v2.0.0 - Enterprise Edition');
+        console.log('👨‍💻 Author: SMJAHID from SMLabs01');
+        const options = parseArgs();
+        const server = new SerperMCPServer_1.SerperMCPServer(options);
+        console.log(`🌐 Transport: ${server.config.transport}`);
+        if (server.config.transport === 'http') {
+            console.log(`📍 Server: http://${server.config.host}:${server.config.port}`);
+        }
+        await server.run();
+    }
+    catch (error) {
+        console.error('❌ Failed to start server:', error);
+        process.exit(1);
+    }
+}
+// Start server if this file is run directly
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAEA,8DAA2D;AA0GlD,gGA1GA,iCAAe,OA0GA;AAxGxB;;;;;;;;;;;;GAYG;AAEH,+BAA+B;AAC/B,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,aAAa;gBAChB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzB,MAAM;YACR,KAAK,aAAa;gBAChB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,WAAW;gBACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3B,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA+BX,CAAC,CAAC;gBACH,OAAO;QACX,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iBAAiB;AACjB,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QAEnD,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,iCAAe,CAAC,OAAO,CAAC,CAAC;QAE5C,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;IAErB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC;AACT,CAAC"}