@enokdev/springdocs-mcp 1.2.2 → 1.2.4

package/build/services/cache.js

@@ -0,0 +1,68 @@
+/**
+ * Intelligent caching service for Spring documentation
+ */
+export class CacheService {
+    cache = new Map();
+    DEFAULT_TTL = 30 * 60 * 1000; // 30 minutes
+    LONG_TTL = 24 * 60 * 60 * 1000; // 24 hours for stable content
+    /**
+     * Get cached data if available and not expired
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() - entry.timestamp > entry.ttl) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.data;
+    }
+    /**
+     * Store data in cache with optional custom TTL
+     */
+    set(key, data, ttl) {
+        this.cache.set(key, {
+            data,
+            timestamp: Date.now(),
+            ttl: ttl || this.DEFAULT_TTL,
+        });
+    }
+    /**
+     * Store data with long TTL for stable content
+     */
+    setLongTerm(key, data) {
+        this.set(key, data, this.LONG_TTL);
+    }
+    /**
+     * Clear expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > entry.ttl) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const now = Date.now();
+        let expired = 0;
+        for (const entry of this.cache.values()) {
+            if (now - entry.timestamp > entry.ttl) {
+                expired++;
+            }
+        }
+        return { size: this.cache.size, expired };
+    }
+    /**
+     * Clear all cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/build/services/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAAyD,CAAC;IAChE,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;IAC3C,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,8BAA8B;IAE/E;;OAEG;IACH,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC,IAAS,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,GAAY;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,WAAW;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAI,GAAW,EAAE,IAAO;QACjC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;gBACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;gBACtC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/build/services/springboot-docs-optimized.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Optimized Spring Boot Documentation Service with caching and enhanced features
+ */
+export declare class SpringBootDocsServiceOptimized {
+    private readonly baseUrl;
+    private readonly springProjectsUrl;
+    private readonly springGuideUrl;
+    private readonly springBootVersion;
+    private turndownService;
+    private cache;
+    private readonly REQUEST_TIMEOUT;
+    private readonly MAX_RETRIES;
+    constructor();
+    /**
+     * Search Spring projects with caching and retry logic
+     */
+    searchSpringProjects(query: string, limit?: number): Promise<any[]>;
+    /**
+     * Get Spring project details with caching
+     */
+    getSpringProject(projectName: string): Promise<string>;
+    /**
+     * Get all Spring guides with caching
+     */
+    getAllSpringGuides(category?: string, limit?: number): Promise<any[]>;
+    /**
+     * Get specific guide with enhanced error handling and caching
+     */
+    getGuide(guideId: string): Promise<string>;
+    /**
+     * Get reference documentation with caching
+     */
+    getReference(section: string, subsection?: string): Promise<string>;
+    /**
+     * Search concepts with caching
+     */
+    searchConcepts(concept: string, category?: string): Promise<any>;
+    /**
+     * Enhanced documentation search with parallel processing
+     */
+    searchDocumentation(query: string, docType?: string, limit?: number): Promise<any[]>;
+    private fetchWithRetry;
+    private processHtmlGuide;
+    private processAsciiDocGuide;
+    private generateGuideNotFoundMessage;
+    private generateGuideErrorMessage;
+    private cleanHtml;
+    private getPopularSpringProjects;
+    private getPopularSpringGuides;
+    private searchGuides;
+    private searchReference;
+    private searchAPI;
+    private getSpringBootConcepts;
+}
+//# sourceMappingURL=springboot-docs-optimized.d.ts.map

package/build/services/springboot-docs-optimized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"springboot-docs-optimized.d.ts","sourceRoot":"","sources":["../../src/services/springboot-docs-optimized.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgC;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAW;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAK;;IAajC;;OAEG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAmE5D;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6C5D;;OAEG;IACG,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAuD9D;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkEhD;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6CzE;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAmCvD;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,EAAE,KAAK,GAAE,MAAW;YAsCtE,cAAc;IA2B5B,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,4BAA4B;IAuBpC,OAAO,CAAC,yBAAyB;IAqBjC,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,wBAAwB;IAwChC,OAAO,CAAC,sBAAsB;YA6BhB,YAAY;YAsBZ,eAAe;YAsBf,SAAS;IAoBvB,OAAO,CAAC,qBAAqB;CA0B9B"}