serper-search-mcp 2.0.0

package/dist/server/SerperMCPServer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Main Serper MCP Server for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+import { ServerConfig } from '../types';
+export declare class SerperMCPServer {
+    readonly config: ServerConfig;
+    private server;
+    private serperAPI;
+    constructor(options?: Partial<ServerConfig>);
+    /**
+     * Setup MCP tool handlers
+     */
+    private setupToolHandlers;
+    /**
+     * Perform search operation
+     */
+    private performSearch;
+    /**
+     * Start the server
+     */
+    run(): Promise<void>;
+    /**
+     * Get server configuration
+     */
+    getConfig(): ServerConfig;
+    /**
+     * Get server info
+     */
+    getInfo(): {
+        name: string;
+        version: string;
+        author: string;
+        features: string[];
+    };
+}
+//# sourceMappingURL=SerperMCPServer.d.ts.map

package/dist/server/SerperMCPServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerperMCPServer.d.ts","sourceRoot":"","sources":["../../src/server/SerperMCPServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,YAAY,EAA6B,MAAM,UAAU,CAAC;AAKnE,qBAAa,eAAe;IAC1B,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;gBAEjB,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM;IAgC/C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;OAEG;YACW,aAAa;IAyC3B;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB1B;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;OAEG;IACH,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;CAejF"}

package/dist/server/SerperMCPServer.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Main Serper MCP Server for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerperMCPServer = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const SerperAPI_1 = require("../api/SerperAPI");
+const SearchTools_1 = require("../tools/SearchTools");
+const ResultFormatter_1 = require("../utils/ResultFormatter");
+class SerperMCPServer {
+    constructor(options = {}) {
+        // Merge provided options with defaults
+        this.config = {
+            apiKey: options.apiKey || process.env.SERPER_API_KEY || '',
+            transport: options.transport || process.env.SERPER_MCP_TRANSPORT || 'stdio',
+            port: options.port || parseInt(process.env.SERPER_MCP_PORT || '8080'),
+            host: options.host || process.env.SERPER_MCP_HOST || '0.0.0.0',
+            logLevel: options.logLevel || process.env.SERPER_MCP_LOG_LEVEL || 'info'
+        };
+        // Validate required configuration
+        if (!this.config.apiKey) {
+            throw new Error('SERPER_API_KEY environment variable is required');
+        }
+        // Initialize components
+        this.serperAPI = new SerperAPI_1.SerperAPI(this.config.apiKey);
+        this.server = new index_js_1.Server({
+            name: 'serper-search-server',
+            version: '2.0.0'
+        }, {
+            capabilities: {
+                tools: {}
+            }
+        });
+        this.setupToolHandlers();
+    }
+    /**
+     * Setup MCP tool handlers
+     */
+    setupToolHandlers() {
+        // List available tools
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+            return {
+                tools: SearchTools_1.SearchTools.getAllTools()
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                // Validate arguments
+                SearchTools_1.SearchTools.validateToolArgs(name, args);
+                // Route to appropriate handler
+                switch (name) {
+                    case 'search_web':
+                        return await this.performSearch(args, 'web');
+                    case 'search_images':
+                        return await this.performSearch(args, 'images');
+                    case 'search_videos':
+                        return await this.performSearch(args, 'videos');
+                    case 'search_news':
+                        return await this.performSearch(args, 'news');
+                    case 'search_shopping':
+                        return await this.performSearch(args, 'shopping');
+                    default:
+                        throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                if (error instanceof types_js_1.McpError) {
+                    throw error;
+                }
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, message);
+            }
+        });
+    }
+    /**
+     * Perform search operation
+     */
+    async performSearch(args, searchType) {
+        const searchOptions = {
+            query: args.query,
+            num_results: args.num_results || 10,
+            country: args.country || 'US',
+            search_lang: args.search_lang || 'en',
+            ui_lang: args.ui_lang || 'en-US',
+            freshness: args.freshness,
+            safesearch: args.safesearch || 'moderate',
+            summary: args.summary || false
+        };
+        try {
+            // Perform search via API
+            const searchResults = await this.serperAPI.search(searchOptions.query, searchType, searchOptions);
+            // Format results
+            const formattedResults = ResultFormatter_1.ResultFormatter.formatResults(searchResults, searchOptions.num_results || 10, searchType);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formattedResults
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Search failed: ${message}`);
+        }
+    }
+    /**
+     * Start the server
+     */
+    async run() {
+        try {
+            if (this.config.transport === 'http') {
+                // HTTP transport using SSE - Note: HTTP transport may need different implementation
+                // For now, fallback to STDIO for TypeScript compatibility
+                const transport = new stdio_js_1.StdioServerTransport();
+                await this.server.connect(transport);
+                console.log(`🚀 Serper MCP Server v2.0.0 running on STDIO (HTTP transport available in JavaScript version)`);
+                console.log(`👨‍💻 Author: SMJAHID from SMLabs01`);
+            }
+            else {
+                // Default STDIO transport
+                const transport = new stdio_js_1.StdioServerTransport();
+                await this.server.connect(transport);
+                console.log('🚀 Serper MCP Server v2.0.0 running on STDIO');
+                console.log('👨‍💻 Author: SMJAHID from SMLabs01');
+            }
+        }
+        catch (error) {
+            console.error('❌ Failed to start server:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get server configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get server info
+     */
+    getInfo() {
+        return {
+            name: 'Serper Search MCP Server',
+            version: '2.0.0',
+            author: 'SMJAHID from SMLabs01',
+            features: [
+                'Multi-Type Search (Web, Images, Videos, News, Shopping)',
+                'Multi-Transport (STDIO, HTTP/SSE)',
+                'Advanced Filtering (Country, Language, Freshness)',
+                'AI Summarization',
+                'Enterprise Architecture',
+                'Docker & NPM Deployment'
+            ]
+        };
+    }
+}
+exports.SerperMCPServer = SerperMCPServer;
+//# sourceMappingURL=SerperMCPServer.js.map

package/dist/server/SerperMCPServer.js.map

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

package/dist/tools/SearchTools.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Search Tools for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+import { ToolDefinition } from '../types';
+export declare class SearchTools {
+    /**
+     * Get all available search tools
+     */
+    static getAllTools(): ToolDefinition[];
+    /**
+     * Web search tool definition
+     */
+    static getWebSearchTool(): ToolDefinition;
+    /**
+     * Image search tool definition
+     */
+    static getImageSearchTool(): ToolDefinition;
+    /**
+     * Video search tool definition
+     */
+    static getVideoSearchTool(): ToolDefinition;
+    /**
+     * News search tool definition
+     */
+    static getNewsSearchTool(): ToolDefinition;
+    /**
+     * Shopping search tool definition
+     */
+    static getShoppingSearchTool(): ToolDefinition;
+    /**
+     * Validate tool arguments
+     */
+    static validateToolArgs(toolName: string, args: any): void;
+}
+//# sourceMappingURL=SearchTools.d.ts.map

package/dist/tools/SearchTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchTools.d.ts","sourceRoot":"","sources":["../../src/tools/SearchTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,UAAU,CAAC;AAEtD,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc,EAAE;IAUtC;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,cAAc;IAuDzC;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,cAAc;IAkC3C;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,cAAc;IAkC3C;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,cAAc;IAwC1C;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,cAAc;IAkC9C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;CA0B3D"}

package/dist/tools/SearchTools.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * Search Tools for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchTools = void 0;
+class SearchTools {
+    /**
+     * Get all available search tools
+     */
+    static getAllTools() {
+        return [
+            this.getWebSearchTool(),
+            this.getImageSearchTool(),
+            this.getVideoSearchTool(),
+            this.getNewsSearchTool(),
+            this.getShoppingSearchTool()
+        ];
+    }
+    /**
+     * Web search tool definition
+     */
+    static getWebSearchTool() {
+        return {
+            name: 'search_web',
+            description: 'Search the web using Serper API (Google search results)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'The search query to execute (max 400 chars, 50 words)'
+                    },
+                    num_results: {
+                        type: 'number',
+                        description: 'Number of results to return (1-20, default: 10)',
+                        minimum: 1,
+                        maximum: 20,
+                        default: 10
+                    },
+                    country: {
+                        type: 'string',
+                        description: 'Country code (default: "US")',
+                        default: 'US'
+                    },
+                    search_lang: {
+                        type: 'string',
+                        description: 'Search language (default: "en")',
+                        default: 'en'
+                    },
+                    ui_lang: {
+                        type: 'string',
+                        description: 'UI language (default: "en-US")',
+                        default: 'en-US'
+                    },
+                    freshness: {
+                        type: 'string',
+                        description: 'Time filter: "pd" (day), "pw" (week), "pm" (month), "py" (year)',
+                        enum: ['pd', 'pw', 'pm', 'py']
+                    },
+                    safesearch: {
+                        type: 'string',
+                        description: 'Content filtering',
+                        enum: ['off', 'moderate', 'strict'],
+                        default: 'moderate'
+                    },
+                    summary: {
+                        type: 'boolean',
+                        description: 'Enable AI summarization (default: false)',
+                        default: false
+                    }
+                },
+                required: ['query']
+            }
+        };
+    }
+    /**
+     * Image search tool definition
+     */
+    static getImageSearchTool() {
+        return {
+            name: 'search_images',
+            description: 'Search for images using Serper API',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'The image search query'
+                    },
+                    num_results: {
+                        type: 'number',
+                        description: 'Number of results to return (default: 10)',
+                        minimum: 1,
+                        maximum: 20,
+                        default: 10
+                    },
+                    country: {
+                        type: 'string',
+                        description: 'Country code (default: "US")',
+                        default: 'US'
+                    },
+                    search_lang: {
+                        type: 'string',
+                        description: 'Search language (default: "en")',
+                        default: 'en'
+                    }
+                },
+                required: ['query']
+            }
+        };
+    }
+    /**
+     * Video search tool definition
+     */
+    static getVideoSearchTool() {
+        return {
+            name: 'search_videos',
+            description: 'Search for videos using Serper API',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'The video search query'
+                    },
+                    num_results: {
+                        type: 'number',
+                        description: 'Number of results to return (default: 10)',
+                        minimum: 1,
+                        maximum: 20,
+                        default: 10
+                    },
+                    country: {
+                        type: 'string',
+                        description: 'Country code (default: "US")',
+                        default: 'US'
+                    },
+                    search_lang: {
+                        type: 'string',
+                        description: 'Search language (default: "en")',
+                        default: 'en'
+                    }
+                },
+                required: ['query']
+            }
+        };
+    }
+    /**
+     * News search tool definition
+     */
+    static getNewsSearchTool() {
+        return {
+            name: 'search_news',
+            description: 'Search for news articles using Serper API',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'The news search query'
+                    },
+                    num_results: {
+                        type: 'number',
+                        description: 'Number of results to return (default: 10)',
+                        minimum: 1,
+                        maximum: 20,
+                        default: 10
+                    },
+                    country: {
+                        type: 'string',
+                        description: 'Country code (default: "US")',
+                        default: 'US'
+                    },
+                    search_lang: {
+                        type: 'string',
+                        description: 'Search language (default: "en")',
+                        default: 'en'
+                    },
+                    freshness: {
+                        type: 'string',
+                        description: 'Time filter (default: "pd" for last 24 hours)',
+                        enum: ['pd', 'pw', 'pm', 'py'],
+                        default: 'pd'
+                    }
+                },
+                required: ['query']
+            }
+        };
+    }
+    /**
+     * Shopping search tool definition
+     */
+    static getShoppingSearchTool() {
+        return {
+            name: 'search_shopping',
+            description: 'Search for products and shopping results using Serper API',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'The shopping search query'
+                    },
+                    num_results: {
+                        type: 'number',
+                        description: 'Number of results to return (default: 10)',
+                        minimum: 1,
+                        maximum: 20,
+                        default: 10
+                    },
+                    country: {
+                        type: 'string',
+                        description: 'Country code (default: "US")',
+                        default: 'US'
+                    },
+                    search_lang: {
+                        type: 'string',
+                        description: 'Search language (default: "en")',
+                        default: 'en'
+                    }
+                },
+                required: ['query']
+            }
+        };
+    }
+    /**
+     * Validate tool arguments
+     */
+    static validateToolArgs(toolName, args) {
+        const tool = this.getAllTools().find(t => t.name === toolName);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${toolName}`);
+        }
+        // Check required parameters
+        for (const required of tool.inputSchema.required) {
+            if (!(required in args)) {
+                throw new Error(`Missing required parameter: ${required}`);
+            }
+        }
+        // Validate query length
+        if (args.query) {
+            if (typeof args.query !== 'string') {
+                throw new Error('Query must be a string');
+            }
+            if (args.query.length > 400) {
+                throw new Error('Query too long (max 400 characters)');
+            }
+            if (args.query.split(' ').length > 50) {
+                throw new Error('Query too long (max 50 words)');
+            }
+        }
+    }
+}
+exports.SearchTools = SearchTools;
+//# sourceMappingURL=SearchTools.js.map

package/dist/tools/SearchTools.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Type definitions for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+export interface SearchOptions {
+    query: string;
+    num_results?: number;
+    country?: string;
+    search_lang?: string;
+    ui_lang?: string;
+    freshness?: 'pd' | 'pw' | 'pm' | 'py';
+    safesearch?: 'off' | 'moderate' | 'strict';
+    summary?: boolean;
+}
+export interface SearchResult {
+    title: string;
+    link: string;
+    snippet?: string;
+    imageUrl?: string;
+    source?: string;
+    channel?: string;
+    duration?: string;
+    date?: string;
+    price?: string;
+    rating?: string;
+}
+export interface SerperAPIResponse {
+    searchParameters?: {
+        q: string;
+        [key: string]: any;
+    };
+    organic?: SearchResult[];
+    images?: SearchResult[];
+    videos?: SearchResult[];
+    news?: SearchResult[];
+    shopping?: SearchResult[];
+    [key: string]: any;
+}
+export interface ServerConfig {
+    apiKey: string;
+    transport: 'stdio' | 'http';
+    port: number;
+    host: string;
+    logLevel: string;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required: string[];
+    };
+}
+export type SearchType = 'web' | 'images' | 'videos' | 'news' | 'shopping';
+export interface Transport {
+    run(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE;QACjB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB"}

package/dist/types/index.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Type definitions for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/utils/ResultFormatter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Result Formatter for Serper MCP Server v2.0.0 - Enterprise Edition
+ * Author: SMJAHID from SMLabs01
+ */
+import { SerperAPIResponse, SearchType } from '../types';
+export declare class ResultFormatter {
+    /**
+     * Format search results for display
+     */
+    static formatResults(results: SerperAPIResponse, maxResults: number, searchType: SearchType): string;
+    /**
+     * Format error message
+     */
+    static formatError(error: Error): string;
+    /**
+     * Format validation error
+     */
+    static formatValidationError(message: string): string;
+    /**
+     * Format server info
+     */
+    static formatServerInfo(): string;
+    /**
+     * Capitalize first letter of a string
+     */
+    private static capitalizeFirst;
+}
+//# sourceMappingURL=ResultFormatter.d.ts.map

package/dist/utils/ResultFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultFormatter.d.ts","sourceRoot":"","sources":["../../src/utils/ResultFormatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAgB,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvE,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM;IAqGpG;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAIxC;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIrD;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM;IAUjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CAG/B"}