@enokdev/springdocs-mcp 1.2.3 → 1.2.4

package/build/services/advanced-features.js

@@ -0,0 +1,574 @@
+import { CacheService } from './cache.js';
+/**
+ * Advanced features service for Spring documentation
+ */
+export class AdvancedFeaturesService {
+    cache;
+    constructor() {
+        this.cache = new CacheService();
+    }
+    /**
+     * Search across the entire Spring ecosystem
+     */
+    async searchEcosystem(query, scope = 'all', limit = 5) {
+        const cacheKey = `ecosystem:${query}:${scope}:${limit}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const results = {
+            query,
+            scope,
+            totalResults: 0,
+            categories: {}
+        };
+        try {
+            if (scope === 'all' || scope === 'projects') {
+                results.categories.projects = await this.searchProjects(query, limit);
+            }
+            if (scope === 'all' || scope === 'guides') {
+                results.categories.guides = await this.searchGuides(query, limit);
+            }
+            if (scope === 'all' || scope === 'docs') {
+                results.categories.documentation = await this.searchDocumentation(query, limit);
+            }
+            if (scope === 'all' || scope === 'api') {
+                results.categories.api = await this.searchAPI(query, limit);
+            }
+            results.totalResults = Object.values(results.categories)
+                .reduce((total, category) => total + (category?.length || 0), 0);
+            this.cache.set(cacheKey, results);
+            return results;
+        }
+        catch (error) {
+            console.error('Error in ecosystem search:', error);
+            throw new Error('Failed to search Spring ecosystem');
+        }
+    }
+    /**
+     * Get step-by-step tutorials
+     */
+    async getTutorial(topic, level = 'beginner') {
+        const cacheKey = `tutorial:${topic}:${level}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const tutorials = this.getTutorialDatabase();
+        const tutorial = tutorials[topic]?.[level];
+        if (!tutorial) {
+            const availableTopics = Object.keys(tutorials).join(', ');
+            return `# Tutorial Not Found
+
+The tutorial for "${topic}" at "${level}" level is not available.
+
+## Available Topics:
+${availableTopics}
+
+## Available Levels:
+- beginner
+- intermediate
+- advanced
+
+Please use one of the available topics and levels.`;
+        }
+        this.cache.setLongTerm(cacheKey, tutorial);
+        return tutorial;
+    }
+    /**
+     * Compare Spring Boot versions
+     */
+    async compareVersions(version1, version2, focus = 'all') {
+        const cacheKey = `compare:${version1}:${version2}:${focus}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        try {
+            const comparison = await this.generateVersionComparison(version1, version2, focus);
+            this.cache.setLongTerm(cacheKey, comparison);
+            return comparison;
+        }
+        catch (error) {
+            console.error('Error comparing versions:', error);
+            throw new Error(`Failed to compare Spring Boot versions ${version1} and ${version2}`);
+        }
+    }
+    /**
+     * Get best practices
+     */
+    async getBestPractices(category, experienceLevel = 'intermediate') {
+        const cacheKey = `practices:${category}:${experienceLevel}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const practices = this.getBestPracticesDatabase();
+        const categoryPractices = practices[category];
+        if (!categoryPractices) {
+            const availableCategories = Object.keys(practices).join(', ');
+            return `# Best Practices Not Found
+
+Best practices for "${category}" category are not available.
+
+## Available Categories:
+${availableCategories}
+
+Please use one of the available categories.`;
+        }
+        const result = this.formatBestPractices(categoryPractices, category, experienceLevel);
+        this.cache.setLongTerm(cacheKey, result);
+        return result;
+    }
+    /**
+     * Diagnose Spring issues
+     */
+    async diagnoseIssues(errorMessage, component, stackTrace) {
+        const cacheKey = `diagnose:${this.hashString(errorMessage)}:${component || 'general'}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const diagnosis = this.performIssueDiagnosis(errorMessage, component, stackTrace);
+        this.cache.set(cacheKey, diagnosis, 60 * 60 * 1000); // 1 hour cache
+        return diagnosis;
+    }
+    // Private helper methods
+    async searchProjects(query, limit) {
+        // Simplified project search - in real implementation, this would fetch from Spring.io
+        const mockProjects = [
+            { name: 'Spring Boot', description: 'Create stand-alone, production-grade Spring applications', url: 'https://spring.io/projects/spring-boot' },
+            { name: 'Spring Security', description: 'Powerful and highly customizable security framework', url: 'https://spring.io/projects/spring-security' },
+            { name: 'Spring Data', description: 'Consistent programming model for data access', url: 'https://spring.io/projects/spring-data' },
+        ];
+        return mockProjects
+            .filter(p => p.name.toLowerCase().includes(query.toLowerCase()) ||
+            p.description.toLowerCase().includes(query.toLowerCase()))
+            .slice(0, limit);
+    }
+    async searchGuides(query, limit) {
+        const mockGuides = [
+            { title: 'Building a RESTful Web Service', url: 'https://spring.io/guides/gs/rest-service/', type: 'Getting Started' },
+            { title: 'Accessing Data with JPA', url: 'https://spring.io/guides/gs/accessing-data-jpa/', type: 'Getting Started' },
+            { title: 'Securing a Web Application', url: 'https://spring.io/guides/gs/securing-web/', type: 'Getting Started' },
+        ];
+        return mockGuides
+            .filter(g => g.title.toLowerCase().includes(query.toLowerCase()))
+            .slice(0, limit);
+    }
+    async searchDocumentation(query, limit) {
+        const mockDocs = [
+            { title: 'Spring Boot Reference Documentation', url: 'https://docs.spring.io/spring-boot/docs/current/reference/', type: 'Reference' },
+            { title: 'Spring Framework Documentation', url: 'https://docs.spring.io/spring-framework/docs/current/reference/', type: 'Reference' },
+        ];
+        return mockDocs
+            .filter(d => d.title.toLowerCase().includes(query.toLowerCase()))
+            .slice(0, limit);
+    }
+    async searchAPI(query, limit) {
+        const mockAPI = [
+            { title: 'Spring Boot API Documentation', url: 'https://docs.spring.io/spring-boot/docs/current/api/', type: 'API' },
+            { title: 'Spring Framework API', url: 'https://docs.spring.io/spring-framework/docs/current/javadoc-api/', type: 'API' },
+        ];
+        return mockAPI
+            .filter(a => a.title.toLowerCase().includes(query.toLowerCase()))
+            .slice(0, limit);
+    }
+    getTutorialDatabase() {
+        return {
+            'rest-api': {
+                beginner: `# Building Your First REST API with Spring Boot
+
+## Prerequisites
+- Java 11 or higher
+- Basic understanding of Java
+- Maven or Gradle
+
+## Step 1: Create a New Spring Boot Project
+\`\`\`bash
+curl https://start.spring.io/starter.zip \\
+  -d dependencies=web \\
+  -d name=my-rest-api \\
+  -d packageName=com.example.api \\
+  -o my-rest-api.zip
+\`\`\`
+
+## Step 2: Create a Simple Controller
+\`\`\`java
+@RestController
+@RequestMapping("/api")
+public class HelloController {
+
+    @GetMapping("/hello")
+    public String hello() {
+        return "Hello, World!";
+    }
+
+    @GetMapping("/hello/{name}")
+    public String helloName(@PathVariable String name) {
+        return "Hello, " + name + "!";
+    }
+}
+\`\`\`
+
+## Step 3: Run the Application
+\`\`\`bash
+./mvnw spring-boot:run
+\`\`\`
+
+## Step 4: Test Your API
+\`\`\`bash
+curl http://localhost:8080/api/hello
+curl http://localhost:8080/api/hello/John
+\`\`\`
+
+## Next Steps
+- Add request/response DTOs
+- Implement POST, PUT, DELETE methods
+- Add input validation
+- Handle exceptions properly`,
+                intermediate: `# Advanced REST API Development with Spring Boot
+
+## Data Transfer Objects (DTOs)
+\`\`\`java
+public class UserDto {
+    @NotBlank
+    private String name;
+
+    @Email
+    private String email;
+
+    // getters and setters
+}
+\`\`\`
+
+## Service Layer
+\`\`\`java
+@Service
+public class UserService {
+
+    @Autowired
+    private UserRepository userRepository;
+
+    public UserDto createUser(UserDto userDto) {
+        User user = mapToEntity(userDto);
+        User savedUser = userRepository.save(user);
+        return mapToDto(savedUser);
+    }
+}
+\`\`\`
+
+## Exception Handling
+\`\`\`java
+@ControllerAdvice
+public class GlobalExceptionHandler {
+
+    @ExceptionHandler(ValidationException.class)
+    public ResponseEntity<ErrorResponse> handleValidation(ValidationException ex) {
+        return ResponseEntity.badRequest()
+            .body(new ErrorResponse("Validation failed", ex.getMessage()));
+    }
+}
+\`\`\`
+
+## Testing
+\`\`\`java
+@SpringBootTest
+@AutoConfigureTestDatabase
+class UserControllerTest {
+
+    @Autowired
+    private TestRestTemplate restTemplate;
+
+    @Test
+    void shouldCreateUser() {
+        UserDto user = new UserDto("John", "john@example.com");
+        ResponseEntity<UserDto> response = restTemplate.postForEntity(
+            "/api/users", user, UserDto.class);
+
+        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
+    }
+}
+\`\`\``,
+                advanced: `# Production-Ready REST API with Spring Boot
+
+## Advanced Features Implementation
+
+### 1. API Versioning
+\`\`\`java
+@RestController
+@RequestMapping("/api/v1/users")
+public class UserControllerV1 {
+    // Version 1 implementation
+}
+
+@RestController
+@RequestMapping("/api/v2/users")
+public class UserControllerV2 {
+    // Version 2 with breaking changes
+}
+\`\`\`
+
+### 2. HATEOAS Implementation
+\`\`\`java
+@GetMapping("/{id}")
+public EntityModel<UserDto> getUser(@PathVariable Long id) {
+    UserDto user = userService.findById(id);
+    return EntityModel.of(user)
+        .add(linkTo(methodOn(UserController.class).getUser(id)).withSelfRel())
+        .add(linkTo(UserController.class).withRel("users"));
+}
+\`\`\`
+
+### 3. Advanced Security
+\`\`\`java
+@Configuration
+@EnableWebSecurity
+public class SecurityConfig {
+
+    @Bean
+    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
+        http.oauth2ResourceServer(oauth2 -> oauth2.jwt(withDefaults()))
+            .authorizeHttpRequests(authz -> authz
+                .requestMatchers("/api/public/**").permitAll()
+                .requestMatchers(HttpMethod.GET, "/api/users").hasRole("USER")
+                .requestMatchers("/api/admin/**").hasRole("ADMIN")
+                .anyRequest().authenticated()
+            );
+        return http.build();
+    }
+}
+\`\`\`
+
+### 4. Metrics and Monitoring
+\`\`\`java
+@Component
+public class ApiMetrics {
+
+    private final MeterRegistry meterRegistry;
+    private final Counter apiCallCounter;
+
+    public ApiMetrics(MeterRegistry meterRegistry) {
+        this.meterRegistry = meterRegistry;
+        this.apiCallCounter = Counter.builder("api.calls")
+            .description("Number of API calls")
+            .register(meterRegistry);
+    }
+}
+\`\`\`
+
+### 5. Rate Limiting
+\`\`\`java
+@Component
+public class RateLimitingFilter implements Filter {
+
+    private final RedisTemplate<String, String> redisTemplate;
+
+    @Override
+    public void doFilter(ServletRequest request, ServletResponse response,
+                        FilterChain chain) throws IOException, ServletException {
+
+        String clientId = getClientId(request);
+        if (isRateLimited(clientId)) {
+            ((HttpServletResponse) response).setStatus(429);
+            return;
+        }
+
+        chain.doFilter(request, response);
+    }
+}
+\`\`\``
+            },
+            // Add more tutorials for other topics
+        };
+    }
+    async generateVersionComparison(version1, version2, focus) {
+        // This would fetch actual version data in a real implementation
+        return `# Spring Boot Version Comparison: ${version1} vs ${version2}
+
+## Overview
+Comparing Spring Boot ${version1} with ${version2}
+
+## Major Changes
+${focus === 'all' || focus === 'breaking-changes' ? `
+### Breaking Changes
+- Java version requirements updated
+- Configuration property changes
+- Deprecated APIs removed
+` : ''}
+
+${focus === 'all' || focus === 'new-features' ? `
+### New Features
+- Enhanced auto-configuration
+- New starters available
+- Improved monitoring capabilities
+` : ''}
+
+${focus === 'all' || focus === 'deprecations' ? `
+### Deprecations
+- Legacy configuration support
+- Outdated dependencies
+- Old API patterns
+` : ''}
+
+## Migration Guide
+1. Update Java version if required
+2. Update dependency versions
+3. Review configuration changes
+4. Test thoroughly
+
+## Recommendation
+${this.getUpgradeRecommendation(version1, version2)}`;
+    }
+    getBestPracticesDatabase() {
+        return {
+            architecture: {
+                title: 'Spring Boot Architecture Best Practices',
+                practices: [
+                    {
+                        title: 'Layer Separation',
+                        description: 'Maintain clear separation between presentation, business, and data layers',
+                        examples: ['Controller → Service → Repository pattern', 'Use DTOs for data transfer'],
+                        level: ['beginner', 'intermediate', 'expert']
+                    },
+                    {
+                        title: 'Dependency Injection',
+                        description: 'Use constructor injection and avoid field injection',
+                        examples: ['@Autowired on constructors', 'Final fields for dependencies'],
+                        level: ['intermediate', 'expert']
+                    }
+                ]
+            },
+            performance: {
+                title: 'Performance Optimization',
+                practices: [
+                    {
+                        title: 'Lazy Loading',
+                        description: 'Use lazy loading for JPA relationships',
+                        examples: ['@OneToMany(fetch = FetchType.LAZY)', 'Use @EntityGraph for specific queries'],
+                        level: ['intermediate', 'expert']
+                    },
+                    {
+                        title: 'Connection Pooling',
+                        description: 'Configure proper database connection pooling',
+                        examples: ['HikariCP configuration', 'Monitor connection usage'],
+                        level: ['expert']
+                    }
+                ]
+            }
+            // Add more categories...
+        };
+    }
+    formatBestPractices(practices, category, level) {
+        const filtered = practices.practices.filter((p) => p.level.includes(level));
+        let result = `# ${practices.title}\n\n`;
+        result += `**Experience Level:** ${level}\n\n`;
+        filtered.forEach((practice, index) => {
+            result += `## ${index + 1}. ${practice.title}\n\n`;
+            result += `${practice.description}\n\n`;
+            result += `**Examples:**\n`;
+            practice.examples.forEach((example) => {
+                result += `- ${example}\n`;
+            });
+            result += '\n';
+        });
+        return result;
+    }
+    performIssueDiagnosis(errorMessage, component, stackTrace) {
+        const commonIssues = {
+            'Port 8080 was already in use': {
+                cause: 'Another application is using the default Spring Boot port',
+                solutions: [
+                    'Change port in application.properties: server.port=8081',
+                    'Kill the process using port 8080',
+                    'Use a different port for your application'
+                ]
+            },
+            'Failed to configure a DataSource': {
+                cause: 'Database configuration is missing or incorrect',
+                solutions: [
+                    'Add database dependency to pom.xml/build.gradle',
+                    'Configure datasource properties in application.properties',
+                    'Use @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class}) if no database needed'
+                ]
+            },
+            'NoSuchBeanDefinitionException': {
+                cause: 'Required bean is not found in the application context',
+                solutions: [
+                    'Check if the class is annotated with @Component, @Service, @Repository, or @Controller',
+                    'Ensure the class is in a package scanned by @ComponentScan',
+                    'Verify @Autowired dependencies are correctly configured'
+                ]
+            }
+        };
+        for (const [pattern, issue] of Object.entries(commonIssues)) {
+            if (errorMessage.includes(pattern)) {
+                return `# Spring Boot Issue Diagnosis
+
+## Error Analysis
+**Error:** ${errorMessage}
+${component ? `**Component:** ${component}` : ''}
+
+## Root Cause
+${issue.cause}
+
+## Recommended Solutions
+${issue.solutions.map((solution, index) => `${index + 1}. ${solution}`).join('\n')}
+
+${stackTrace ? `
+## Stack Trace Analysis
+The provided stack trace shows:
+\`\`\`
+${stackTrace.substring(0, 500)}${stackTrace.length > 500 ? '...' : ''}
+\`\`\`
+` : ''}
+
+## Additional Resources
+- [Spring Boot Documentation](https://docs.spring.io/spring-boot/docs/current/reference/html/)
+- [Common Application Properties](https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html)`;
+            }
+        }
+        return `# Spring Boot Issue Diagnosis
+
+## Error Analysis
+**Error:** ${errorMessage}
+${component ? `**Component:** ${component}` : ''}
+
+## Diagnosis
+This appears to be a custom or less common error. Here are general troubleshooting steps:
+
+1. **Check Logs:** Review the full stack trace for more context
+2. **Verify Configuration:** Ensure all properties are correctly set
+3. **Dependencies:** Check if all required dependencies are included
+4. **Version Compatibility:** Verify Spring Boot and dependency versions are compatible
+
+## Recommended Actions
+1. Enable debug logging: \`logging.level.org.springframework=DEBUG\`
+2. Check Spring Boot documentation for the specific component
+3. Search Spring Boot GitHub issues for similar problems
+4. Consider posting on Stack Overflow with the full stack trace
+
+${stackTrace ? `
+## Stack Trace Analysis
+\`\`\`
+${stackTrace.substring(0, 500)}${stackTrace.length > 500 ? '...' : ''}
+\`\`\`
+` : ''}`;
+    }
+    getUpgradeRecommendation(version1, version2) {
+        // Simplified version comparison logic
+        const v1Major = parseInt(version1.split('.')[0]);
+        const v2Major = parseInt(version2.split('.')[0]);
+        if (v2Major > v1Major) {
+            return `🚨 Major version upgrade detected. This may include breaking changes. Plan for thorough testing and potential code modifications.`;
+        }
+        else {
+            return `✅ Minor/patch version upgrade. Generally safe to upgrade with minimal breaking changes expected.`;
+        }
+    }
+    hashString(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString();
+    }
+}
+//# sourceMappingURL=advanced-features.js.map

package/build/services/advanced-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-features.js","sourceRoot":"","sources":["../../src/services/advanced-features.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,KAAK,CAAe;IAE5B;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,KAAa,EAAE,QAAgB,KAAK,EAAE,QAAgB,CAAC;QAC3E,MAAM,QAAQ,GAAG,aAAa,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,QAAQ,CAAC,CAAC;QAC7C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,OAAO,GAAQ;YACnB,KAAK;YACL,KAAK;YACL,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,EAAE;SACf,CAAC;QAEF,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC5C,OAAO,CAAC,UAAU,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACxE,CAAC;YAED,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC1C,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACpE,CAAC;YAED,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACxC,OAAO,CAAC,UAAU,CAAC,aAAa,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAClF,CAAC;YAED,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBACvC,OAAO,CAAC,UAAU,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;iBACrD,MAAM,CAAC,CAAC,KAAa,EAAE,QAAa,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAEhF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClC,OAAO,OAAO,CAAC;QAEjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,QAAgB,UAAU;QACzD,MAAM,QAAQ,GAAG,YAAY,KAAK,IAAI,KAAK,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAS,QAAQ,CAAC,CAAC;QAChD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,OAAO;;oBAEO,KAAK,SAAS,KAAK;;;EAGrC,eAAe;;;;;;;mDAOkC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAgB,KAAK;QAC7E,MAAM,QAAQ,GAAG,WAAW,QAAQ,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAS,QAAQ,CAAC,CAAC;QAChD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YACnF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC7C,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,0CAA0C,QAAQ,QAAQ,QAAQ,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE,kBAA0B,cAAc;QAC/E,MAAM,QAAQ,GAAG,aAAa,QAAQ,IAAI,eAAe,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAS,QAAQ,CAAC,CAAC;QAChD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAClD,MAAM,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,OAAO;;sBAES,QAAQ;;;EAG5B,mBAAmB;;4CAEuB,CAAC;QACzC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QACtF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,YAAoB,EAAE,SAAkB,EAAE,UAAmB;QAChF,MAAM,QAAQ,GAAG,YAAY,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QACvF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAS,QAAQ,CAAC,CAAC;QAChD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAClF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,yBAAyB;IAEjB,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,KAAa;QACvD,sFAAsF;QACtF,MAAM,YAAY,GAAG;YACnB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,0DAA0D,EAAE,GAAG,EAAE,wCAAwC,EAAE;YAC/I,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,qDAAqD,EAAE,GAAG,EAAE,4CAA4C,EAAE;YAClJ,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,8CAA8C,EAAE,GAAG,EAAE,wCAAwC,EAAE;SACpI,CAAC;QAEF,OAAO,YAAY;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAClD,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;aACtE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,KAAa;QACrD,MAAM,UAAU,GAAG;YACjB,EAAE,KAAK,EAAE,gCAAgC,EAAE,GAAG,EAAE,2CAA2C,EAAE,IAAI,EAAE,iBAAiB,EAAE;YACtH,EAAE,KAAK,EAAE,yBAAyB,EAAE,GAAG,EAAE,iDAAiD,EAAE,IAAI,EAAE,iBAAiB,EAAE;YACrH,EAAE,KAAK,EAAE,4BAA4B,EAAE,GAAG,EAAE,2CAA2C,EAAE,IAAI,EAAE,iBAAiB,EAAE;SACnH,CAAC;QAEF,OAAO,UAAU;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;aAChE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,KAAa,EAAE,KAAa;QAC5D,MAAM,QAAQ,GAAG;YACf,EAAE,KAAK,EAAE,qCAAqC,EAAE,GAAG,EAAE,4DAA4D,EAAE,IAAI,EAAE,WAAW,EAAE;YACtI,EAAE,KAAK,EAAE,gCAAgC,EAAE,GAAG,EAAE,iEAAiE,EAAE,IAAI,EAAE,WAAW,EAAE;SACvI,CAAC;QAEF,OAAO,QAAQ;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;aAChE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,KAAa;QAClD,MAAM,OAAO,GAAG;YACd,EAAE,KAAK,EAAE,+BAA+B,EAAE,GAAG,EAAE,sDAAsD,EAAE,IAAI,EAAE,KAAK,EAAE;YACpH,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,mEAAmE,EAAE,IAAI,EAAE,KAAK,EAAE;SACzH,CAAC;QAEF,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;aAChE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAEO,mBAAmB;QACzB,OAAO;YACL,UAAU,EAAE;gBACV,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAiDW;gBAErB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8Df;gBAEC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuFX;aACA;YACD,sCAAsC;SACvC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,yBAAyB,CAAC,QAAgB,EAAE,QAAgB,EAAE,KAAa;QACvF,gEAAgE;QAChE,OAAO,qCAAqC,QAAQ,OAAO,QAAQ;;;wBAG/C,QAAQ,SAAS,QAAQ;;;EAG/C,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,kBAAkB,CAAC,CAAC,CAAC;;;;;CAKnD,CAAC,CAAC,CAAC,EAAE;;EAEJ,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC;;;;;CAK/C,CAAC,CAAC,CAAC,EAAE;;EAEJ,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC;;;;;CAK/C,CAAC,CAAC,CAAC,EAAE;;;;;;;;;EASJ,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;IACpD,CAAC;IAEO,wBAAwB;QAC9B,OAAO;YACL,YAAY,EAAE;gBACZ,KAAK,EAAE,yCAAyC;gBAChD,SAAS,EAAE;oBACT;wBACE,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,2EAA2E;wBACxF,QAAQ,EAAE,CAAC,2CAA2C,EAAE,4BAA4B,CAAC;wBACrF,KAAK,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC;qBAC9C;oBACD;wBACE,KAAK,EAAE,sBAAsB;wBAC7B,WAAW,EAAE,qDAAqD;wBAClE,QAAQ,EAAE,CAAC,4BAA4B,EAAE,+BAA+B,CAAC;wBACzE,KAAK,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC;qBAClC;iBACF;aACF;YACD,WAAW,EAAE;gBACX,KAAK,EAAE,0BAA0B;gBACjC,SAAS,EAAE;oBACT;wBACE,KAAK,EAAE,cAAc;wBACrB,WAAW,EAAE,wCAAwC;wBACrD,QAAQ,EAAE,CAAC,oCAAoC,EAAE,uCAAuC,CAAC;wBACzF,KAAK,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC;qBAClC;oBACD;wBACE,KAAK,EAAE,oBAAoB;wBAC3B,WAAW,EAAE,8CAA8C;wBAC3D,QAAQ,EAAE,CAAC,wBAAwB,EAAE,0BAA0B,CAAC;wBAChE,KAAK,EAAE,CAAC,QAAQ,CAAC;qBAClB;iBACF;aACF;YACD,yBAAyB;SAC1B,CAAC;IACJ,CAAC;IAEO,mBAAmB,CAAC,SAAc,EAAE,QAAgB,EAAE,KAAa;QACzE,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAEjF,IAAI,MAAM,GAAG,KAAK,SAAS,CAAC,KAAK,MAAM,CAAC;QACxC,MAAM,IAAI,yBAAyB,KAAK,MAAM,CAAC;QAE/C,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAa,EAAE,KAAa,EAAE,EAAE;YAChD,MAAM,IAAI,MAAM,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,KAAK,MAAM,CAAC;YACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,MAAM,CAAC;YACxC,MAAM,IAAI,iBAAiB,CAAC;YAC5B,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAe,EAAE,EAAE;gBAC5C,MAAM,IAAI,KAAK,OAAO,IAAI,CAAC;YAC7B,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,qBAAqB,CAAC,YAAoB,EAAE,SAAkB,EAAE,UAAmB;QACzF,MAAM,YAAY,GAAG;YACnB,8BAA8B,EAAE;gBAC9B,KAAK,EAAE,2DAA2D;gBAClE,SAAS,EAAE;oBACT,yDAAyD;oBACzD,kCAAkC;oBAClC,2CAA2C;iBAC5C;aACF;YACD,kCAAkC,EAAE;gBAClC,KAAK,EAAE,gDAAgD;gBACvD,SAAS,EAAE;oBACT,iDAAiD;oBACjD,2DAA2D;oBAC3D,iGAAiG;iBAClG;aACF;YACD,+BAA+B,EAAE;gBAC/B,KAAK,EAAE,uDAAuD;gBAC9D,SAAS,EAAE;oBACT,wFAAwF;oBACxF,4DAA4D;oBAC5D,yDAAyD;iBAC1D;aACF;SACF,CAAC;QAEF,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5D,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,OAAO;;;aAGF,YAAY;EACvB,SAAS,CAAC,CAAC,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAG9C,KAAK,CAAC,KAAK;;;EAGX,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;EAEhF,UAAU,CAAC,CAAC,CAAC;;;;EAIb,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;;CAEpE,CAAC,CAAC,CAAC,EAAE;;;;8HAIwH,CAAC;YACzH,CAAC;QACH,CAAC;QAED,OAAO;;;aAGE,YAAY;EACvB,SAAS,CAAC,CAAC,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;EAgB9C,UAAU,CAAC,CAAC,CAAC;;;EAGb,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;;CAEpE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACP,CAAC;IAEO,wBAAwB,CAAC,QAAgB,EAAE,QAAgB;QACjE,sCAAsC;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjD,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;YACtB,OAAO,mIAAmI,CAAC;QAC7I,CAAC;aAAM,CAAC;YACN,OAAO,kGAAkG,CAAC;QAC5G,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YACnC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,4BAA4B;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;CACF"}

package/build/services/cache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Intelligent caching service for Spring documentation
+ */
+export declare class CacheService {
+    private cache;
+    private readonly DEFAULT_TTL;
+    private readonly LONG_TTL;
+    /**
+     * Get cached data if available and not expired
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Store data in cache with optional custom TTL
+     */
+    set<T>(key: string, data: T, ttl?: number): void;
+    /**
+     * Store data with long TTL for stable content
+     */
+    setLongTerm<T>(key: string, data: T): void;
+    /**
+     * Clear expired entries
+     */
+    cleanup(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        expired: number;
+    };
+    /**
+     * Clear all cache
+     */
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/build/services/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAoE;IACjF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAEhD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAY7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQhD;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAa7C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}