@enokdev/springdocs-mcp 1.2.7 → 1.4.1

package/build/services/diagnosis.js

@@ -0,0 +1,481 @@
+/**
+ * Local, deterministic and bounded analysis of Spring error messages and stack traces.
+ *
+ * The input is untrusted user text: every cap is applied BEFORE any processing, and the
+ * parsing is line based (startsWith / indexOf / slice). No backtracking regex is used;
+ * the only regexes are anchored, linear and without nested quantifiers.
+ */
+import { springProjectsConfig } from './spring-projects-config.js';
+// ---------------------------------------------------------------------------
+// Caps
+// ---------------------------------------------------------------------------
+const MAX_TRACE_LINES = 400;
+const MAX_TRACE_CHARS = 20000;
+const MAX_LINE_CHARS = 500;
+const MAX_ERROR_MESSAGE_CHARS = 2000;
+const MAX_LINK_MESSAGE_CHARS = 300;
+const IDENTIFIER = /^[A-Za-z0-9_.$]+$/;
+const EXCEPTION_SUFFIXES = ['Exception', 'Error', 'Throwable'];
+/** Qualified-name prefixes of framework / JDK frames, skipped when looking for application code */
+const FRAMEWORK_FRAME_PREFIXES = [
+    'java.', 'javax.', 'jakarta.', 'jdk.', 'sun.', 'com.sun.', 'org.springframework.', 'org.apache.',
+    'org.hibernate.', 'com.fasterxml.', 'io.netty.', 'reactor.', 'org.aspectj.', 'net.bytebuddy.',
+    'org.junit.', 'org.eclipse.', 'org.jboss.', 'org.slf4j.', 'ch.qos.', 'com.zaxxer.',
+];
+/** Ordered (needle in frame name -> component) pairs for component inference */
+const COMPONENT_HINTS = [
+    ['org.springframework.security', 'security'],
+    ['org.springframework.data', 'data'],
+    ['org.hibernate', 'data'],
+    ['jakarta.persistence', 'data'],
+    ['javax.persistence', 'data'],
+    ['org.springframework.jdbc', 'data'],
+    ['org.springframework.orm', 'data'],
+    ['org.springframework.boot.actuate', 'actuator'],
+    ['org.springframework.web', 'web'],
+    ['org.apache.catalina', 'web'],
+    ['org.apache.tomcat', 'web'],
+    ['com.fasterxml.jackson', 'web'],
+    ['org.springframework.boot.context.properties', 'configuration'],
+    ['org.springframework.boot.autoconfigure', 'configuration'],
+    ['org.springframework.beans', 'startup'],
+    ['org.springframework.context', 'startup'],
+    ['org.springframework.boot.SpringApplication', 'startup'],
+];
+/** Applies the size caps and returns the bounded, NUL-free lines of a trace. */
+function boundedLines(stackTrace) {
+    if (!stackTrace)
+        return [];
+    const text = stackTrace.slice(0, MAX_TRACE_CHARS).split('\0').join('');
+    const lines = [];
+    let start = 0;
+    while (lines.length < MAX_TRACE_LINES && start <= text.length) {
+        let end = text.indexOf('\n', start);
+        if (end === -1)
+            end = text.length;
+        let line = text.slice(start, Math.min(end, start + MAX_LINE_CHARS + 1)); // +1 room for a trailing \r
+        if (line.endsWith('\r'))
+            line = line.slice(0, -1);
+        lines.push(line.slice(0, MAX_LINE_CHARS).trim());
+        start = end + 1;
+    }
+    return lines;
+}
+/** Parses "at pkg.Class.method(File.java:12)"; undefined when the line is not a well-formed frame. */
+function parseFrame(line) {
+    if (!line.startsWith('at '))
+        return undefined;
+    const open = line.indexOf('(');
+    if (open < 0 || line.indexOf(')', open) < 0)
+        return undefined;
+    let name = line.slice(3, open).trim();
+    // JDK 9+ frames may carry a module prefix: "java.base/java.util.List.get"
+    // Hidden/lambda classes ("Foo$$Lambda/0x...") keep the qualified name before the "/"
+    const slash = name.indexOf('/');
+    if (slash >= 0) {
+        const before = name.slice(0, slash);
+        const after = name.slice(name.lastIndexOf('/') + 1);
+        // Hidden classes ("com.acme.Foo/0x0000...method") also keep the part before the "/"
+        name = before.includes('$$Lambda') || after.startsWith('0x') || !after.includes('.') ? before : after;
+    }
+    if (name.length === 0 || !IDENTIFIER.test(name.replace(/<(init|clinit)>/, 'x')))
+        return undefined;
+    return { text: line, name };
+}
+/** Parses an exception header line ("Caused by: x.YException: msg"); undefined when it is not one. */
+function parseHeader(line) {
+    if (line.length === 0 || line.startsWith('at ') || line.startsWith('...'))
+        return undefined;
+    let rest = line;
+    if (rest.startsWith('Caused by: ')) {
+        rest = rest.slice('Caused by: '.length);
+    }
+    else if (rest.startsWith('Exception in thread "')) {
+        const close = rest.indexOf('" ', 'Exception in thread "'.length);
+        if (close < 0)
+            return undefined;
+        rest = rest.slice(close + 2);
+    }
+    rest = rest.trimStart();
+    const colon = rest.indexOf(':');
+    const type = (colon < 0 ? rest : rest.slice(0, colon)).trim();
+    if (type.length === 0 || !IDENTIFIER.test(type))
+        return undefined;
+    const lastDot = type.lastIndexOf('.');
+    const simple = type.slice(lastDot + 1);
+    if (!EXCEPTION_SUFFIXES.some((s) => simple.endsWith(s)))
+        return undefined;
+    const message = colon < 0 ? '' : rest.slice(colon + 1).trim().slice(0, MAX_LINK_MESSAGE_CHARS);
+    return { type, message };
+}
+function parseTrace(stackTrace) {
+    const chain = [];
+    const frames = [];
+    for (const line of boundedLines(stackTrace)) {
+        const frame = parseFrame(line);
+        if (frame) {
+            frames.push(frame);
+            continue;
+        }
+        const header = parseHeader(line);
+        if (header)
+            chain.push(header);
+    }
+    return { chain, frames };
+}
+function isFrameworkFrame(name) {
+    return FRAMEWORK_FRAME_PREFIXES.some((p) => name.startsWith(p));
+}
+function inferComponent(frames) {
+    for (const frame of frames) {
+        for (const [needle, component] of COMPONENT_HINTS) {
+            if (frame.name.includes(needle))
+                return component;
+        }
+    }
+    return undefined;
+}
+export function analyzeStackTrace(stackTrace) {
+    const { chain, frames } = parseTrace(stackTrace);
+    const analysis = { chain };
+    if (chain.length > 0) {
+        analysis.top = chain[0];
+        analysis.root = chain[chain.length - 1];
+    }
+    const appFrame = frames.find((f) => !isFrameworkFrame(f.name));
+    if (appFrame)
+        analysis.applicationFrame = appFrame.text;
+    const inferred = inferComponent(frames);
+    if (inferred)
+        analysis.inferredComponent = inferred;
+    return analysis;
+}
+// ---------------------------------------------------------------------------
+// Rules
+// ---------------------------------------------------------------------------
+export const DIAGNOSIS_RULES = [
+    {
+        id: 'non-unique-bean',
+        needles: ['nouniquebeandefinitionexception', 'expected single matching bean but found'],
+        title: 'Several beans match the injection point',
+        checks: [
+            'mark one candidate `@Primary`',
+            'select explicitly with `@Qualifier` or a matching parameter name',
+            'inject `List<T>`/`Map<String, T>` to receive all candidates',
+        ],
+        references: [{ project: 'framework', section: 'core', subsection: 'beans' }],
+    },
+    {
+        id: 'missing-bean',
+        needles: ['nosuchbeandefinitionexception', 'no qualifying bean of type'],
+        title: 'A required bean is missing',
+        checks: [
+            'the class is outside the `@SpringBootApplication` package or lacks `@Component`/`@Service`/`@Repository`',
+            'the `@Bean` method or auto-configuration condition is not met (start with `--debug` to read the conditions report)',
+            'a profile or `@ConditionalOn…` excludes it',
+            'a starter dependency is missing',
+        ],
+        references: [
+            { project: 'framework', section: 'core', subsection: 'beans' },
+            { project: 'boot', section: 'using' },
+        ],
+    },
+    {
+        id: 'circular-dependency',
+        needles: ['beancurrentlyincreationexception', 'form a cycle', 'circular dependency', 'circular reference'],
+        title: 'Circular dependency between beans',
+        checks: [
+            'extract the shared logic into a third bean',
+            'break the cycle with `@Lazy` on one injection point or setter injection',
+            'Spring Boot 2.6+ forbids circular references by default — `spring.main.allow-circular-references=true` is a workaround, not a fix',
+        ],
+        references: [
+            { project: 'framework', section: 'core', subsection: 'beans' },
+            { project: 'boot', section: 'application-properties' },
+        ],
+    },
+    {
+        id: 'datasource',
+        needles: ['failed to configure a datasource', 'cannot determine embedded database driver class'],
+        title: 'No usable DataSource',
+        checks: [
+            'set `spring.datasource.url`, `username` and `password`',
+            'add the JDBC driver (or an embedded database such as H2) to the classpath',
+            'exclude `DataSourceAutoConfiguration` if the application needs no database',
+        ],
+        references: [
+            { project: 'boot', section: 'data' },
+            { project: 'boot', section: 'application-properties' },
+        ],
+    },
+    {
+        id: 'port-in-use',
+        needles: ['was already in use', 'port already in use', 'address already in use'],
+        title: 'The server port is already taken',
+        checks: [
+            'stop the process holding the port (for example `lsof -i :8080`)',
+            'change `server.port`, or use `server.port=0` for a random port',
+        ],
+        references: [
+            { project: 'boot', section: 'web' },
+            { project: 'boot', section: 'application-properties' },
+        ],
+    },
+    {
+        id: 'config-binding',
+        needles: ['configurationpropertiesbindexception', 'failed to bind properties', 'binding to target'],
+        title: 'Configuration properties cannot be bound',
+        checks: [
+            'check the property name and value type (kebab-case is the canonical form)',
+            'check `@Validated` constraints and required constructor-bound values',
+            'read the "Action" hint printed with the failure',
+        ],
+        references: [
+            { project: 'boot', section: 'features' },
+            { project: 'boot', section: 'application-properties' },
+        ],
+    },
+    {
+        id: 'http-message-not-readable',
+        needles: ['httpmessagenotreadableexception', 'json parse error', 'required request body is missing'],
+        title: 'The request body cannot be read',
+        checks: [
+            'the JSON does not match the target type (types, enums, unknown properties)',
+            'the `Content-Type` is not `application/json`',
+            'an empty body is sent to a `@RequestBody` that is required',
+        ],
+        references: [
+            { project: 'framework', section: 'web' },
+            { project: 'boot', section: 'web' },
+        ],
+    },
+    {
+        id: 'lazy-initialization',
+        needles: ['lazyinitializationexception', 'could not initialize proxy', 'no session'],
+        title: 'A lazy association is accessed outside a session',
+        checks: [
+            'access the association inside a `@Transactional` boundary',
+            'load it with a fetch join or `@EntityGraph`',
+            'return a DTO projection instead of entities',
+            'do not rely on open-in-view',
+        ],
+        references: [
+            { project: 'data-jpa', section: 'jpa' },
+            { project: 'boot', section: 'data' },
+        ],
+    },
+    {
+        id: 'no-transaction',
+        needles: ['no entitymanager with actual transaction available', 'transactionrequiredexception'],
+        title: 'A transaction is required',
+        checks: [
+            'annotate the service method with `@Transactional`',
+            'calls must go through the Spring proxy (no self-invocation, not a private method)',
+            'modifying queries need `@Modifying` and a transaction',
+        ],
+        references: [
+            { project: 'data-jpa', section: 'jpa', subsection: 'transactions' },
+            { project: 'framework', section: 'data-access' },
+        ],
+    },
+    {
+        id: 'classpath',
+        needles: ['classnotfoundexception', 'noclassdeffounderror', 'nosuchmethoderror', 'nosuchfielderror', 'abstractmethoderror'],
+        title: 'Missing class or incompatible library versions',
+        checks: [
+            'inspect the dependency tree (`mvn dependency:tree` or `gradle dependencies`)',
+            "let Spring Boot's dependency management choose versions instead of overriding them",
+            'do a clean build',
+            'if the text mentions `javax.`, it may be the Jakarta migration — see `get_migration_guide` with version `3.0` and section `jakarta`',
+        ],
+        references: [{ project: 'boot', section: 'using' }],
+    },
+    {
+        id: 'access-denied',
+        needles: ['accessdeniedexception', 'invalid csrf token', 'could not verify the provided csrf token'],
+        title: 'Access denied by Spring Security',
+        checks: [
+            'state-changing requests need the CSRF token unless CSRF is deliberately disabled for a stateless API',
+            'check the order of the `requestMatchers` rules',
+            'roles need the `ROLE_` prefix as an authority and `hasRole` adds it for you',
+        ],
+        references: [
+            { project: 'security', section: 'authorization' },
+            { project: 'security', section: 'exploits' },
+        ],
+    },
+    {
+        id: 'unsatisfied-dependency',
+        needles: ['unsatisfieddependencyexception'],
+        title: 'Dependency injection failed',
+        checks: [
+            'this exception only wraps the real failure: read the root cause above',
+            'typical causes are a missing or ambiguous bean, or a failing `@Bean` method',
+        ],
+        references: [{ project: 'framework', section: 'core', subsection: 'beans' }],
+    },
+    {
+        id: 'bean-creation',
+        needles: ['beancreationexception'],
+        title: 'A bean could not be created',
+        checks: [
+            'the exception wraps the cause: read the root cause above',
+            'check the constructor, `@PostConstruct` and the `@Bean` method for failures',
+        ],
+        references: [{ project: 'framework', section: 'core', subsection: 'beans' }],
+    },
+];
+/** References appended per component, after those of the matched rules */
+const COMPONENT_REFERENCES = {
+    startup: [{ project: 'boot', section: 'using' }],
+    web: [{ project: 'boot', section: 'web' }],
+    data: [{ project: 'boot', section: 'data' }],
+    security: [{ project: 'security', section: 'servlet' }],
+    actuator: [{ project: 'boot', section: 'actuator' }],
+    configuration: [
+        { project: 'boot', section: 'features' },
+        { project: 'boot', section: 'application-properties' },
+    ],
+};
+/** Display titles of every reference the module can emit (keyed "project/section[/subsection]") */
+const REFERENCE_TITLES = {
+    'boot/features': 'Spring Boot: Core Features',
+    'boot/using': 'Spring Boot: Using Spring Boot',
+    'boot/web': 'Spring Boot: Web',
+    'boot/data': 'Spring Boot: Data',
+    'boot/actuator': 'Spring Boot: Actuator',
+    'boot/application-properties': 'Spring Boot: Application Properties',
+    'boot/deployment': 'Spring Boot: Deployment',
+    'framework/core/beans': 'Spring Framework: Core — Beans',
+    'framework/web': 'Spring Framework: Web',
+    'framework/data-access': 'Spring Framework: Data Access',
+    'data-jpa/jpa': 'Spring Data JPA: Reference',
+    'data-jpa/jpa/transactions': 'Spring Data JPA: Transactionality',
+    'security/servlet': 'Spring Security: Servlet Applications',
+    'security/authentication': 'Spring Security: Authentication',
+    'security/authorization': 'Spring Security: Authorization',
+    'security/exploits': 'Spring Security: Protection Against Exploits',
+};
+/**
+ * "forbidden" alone is too broad (a 403 from an external API is not a Spring Security issue):
+ * it only counts when the exception header mentioning it is thrown from a Spring Security frame.
+ */
+function hasSecurityForbidden(stackTrace) {
+    let forbiddenHeader = false;
+    for (const line of boundedLines(stackTrace)) {
+        const frame = parseFrame(line);
+        if (frame) {
+            if (forbiddenHeader && frame.name.startsWith('org.springframework.security.'))
+                return true;
+            forbiddenHeader = false; // only the first frame of the exception counts
+        }
+        else if (parseHeader(line)) {
+            forbiddenHeader = line.toLowerCase().includes('forbidden');
+        }
+    }
+    return false;
+}
+/**
+ * Returns the rules whose needles appear (lower-cased) in the analyzed text:
+ * the error message plus the exception header lines of the trace. Order = table order.
+ */
+export function matchRules(errorMessage, analysis, stackTrace) {
+    const parts = [(errorMessage ?? '').slice(0, MAX_ERROR_MESSAGE_CHARS)];
+    if (stackTrace) {
+        // Use the full (capped) header lines so legacy "; nested exception is X" text is searchable
+        for (const line of boundedLines(stackTrace)) {
+            if (parseHeader(line))
+                parts.push(line);
+        }
+    }
+    else {
+        for (const link of analysis.chain)
+            parts.push(`${link.type}: ${link.message}`);
+    }
+    const text = parts.join('\n').toLowerCase();
+    const securityForbidden = stackTrace !== undefined && hasSecurityForbidden(stackTrace);
+    const matched = DIAGNOSIS_RULES.filter((rule) => rule.needles.some((n) => text.includes(n)) || (rule.id === 'access-denied' && securityForbidden));
+    // NoUniqueBeanDefinitionException messages also read "No qualifying bean of type ...":
+    // that is not a missing bean.
+    if (matched.some((r) => r.id === 'non-unique-bean')) {
+        return matched.filter((r) => r.id !== 'missing-bean');
+    }
+    return matched;
+}
+// ---------------------------------------------------------------------------
+// Rendering
+// ---------------------------------------------------------------------------
+const BOOT_DOCS_URL = 'https://docs.spring.io/spring-boot/index.html';
+function referenceKey(ref) {
+    return `${ref.project}/${ref.section}${ref.subsection ? `/${ref.subsection}` : ''}`;
+}
+function renderReferences(refs, config) {
+    const seen = new Set();
+    const lines = [];
+    for (const ref of refs) {
+        if (!config.validateSection(ref.project, ref.section))
+            continue;
+        const url = config.buildReferenceUrl(ref.project, ref.section, ref.subsection);
+        if (seen.has(url))
+            continue;
+        seen.add(url);
+        const title = REFERENCE_TITLES[referenceKey(ref)] ?? `${ref.project}: ${ref.section}`;
+        const sub = ref.subsection ? `, subsection="${ref.subsection}"` : '';
+        lines.push(`- ${title} — ${url} (get_spring_reference: project="${ref.project}", section="${ref.section}"${sub})`);
+    }
+    return lines;
+}
+function formatLink(link) {
+    return link.message ? `${link.type}: ${link.message}` : link.type;
+}
+export function renderDiagnosis(input, config = springProjectsConfig) {
+    const errorMessage = (input.errorMessage ?? '').slice(0, MAX_ERROR_MESSAGE_CHARS);
+    const analysis = analyzeStackTrace(input.stackTrace);
+    const rules = matchRules(errorMessage, analysis, input.stackTrace);
+    let component = input.component?.trim() ? input.component.trim().slice(0, 100) : undefined;
+    let inferred = false;
+    if (!component && analysis.inferredComponent) {
+        component = analysis.inferredComponent;
+        inferred = true;
+    }
+    const out = ['# Spring Boot Issue Diagnosis', '', `**Error:** ${errorMessage}`];
+    if (component) {
+        out.push(`**Component:** ${component}${inferred ? ' (inferred from the stack trace)' : ''}`);
+    }
+    out.push('');
+    if (analysis.top && analysis.root) {
+        out.push('## Exception Summary', '', `**Exception:** ${formatLink(analysis.top)}`);
+        if (analysis.chain.length > 1)
+            out.push(`**Root cause:** ${formatLink(analysis.root)}`);
+        if (analysis.applicationFrame)
+            out.push(`**Your code:** \`${analysis.applicationFrame}\``);
+        out.push('');
+    }
+    out.push('## Likely Cause', '');
+    if (rules.length === 0) {
+        out.push('No known pattern matched this error. Read the root cause above (or the error message) and use the references below.', '');
+    }
+    else {
+        for (const rule of rules) {
+            out.push(`### ${rule.title}`, '', 'The error text matches a known pattern for this problem.', '', 'What to check:');
+            for (const check of rule.checks)
+                out.push(`- ${check}`);
+            out.push('');
+        }
+    }
+    const refs = rules.flatMap((r) => r.references);
+    const componentRefs = component ? COMPONENT_REFERENCES[component.toLowerCase()] : undefined;
+    if (componentRefs && Object.prototype.hasOwnProperty.call(COMPONENT_REFERENCES, component.toLowerCase())) {
+        refs.push(...componentRefs);
+    }
+    const refLines = renderReferences(refs, config);
+    out.push('## Reference Documentation', '');
+    if (refLines.length > 0)
+        out.push(...refLines);
+    else
+        out.push(`- Spring Boot documentation — ${BOOT_DOCS_URL}`);
+    out.push('');
+    out.push('## General Troubleshooting Steps', '', `1. Check the Spring Boot documentation: ${BOOT_DOCS_URL}`, '2. Search Spring Boot issues: https://github.com/spring-projects/spring-boot/issues', '3. Enable debug logging: `logging.level.org.springframework=DEBUG`', '4. Check actuator health endpoint: `/actuator/health`', '');
+    return out.join('\n');
+}
+//# sourceMappingURL=diagnosis.js.map

package/build/services/diagnosis.js.map

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

package/build/services/guides-list.d.ts

@@ -0,0 +1,16 @@
+export declare const SPRING_GUIDES_DATA_URL = "https://spring.io/page-data/guides/page-data.json";
+export interface SpringGuideEntry {
+    type: 'spring-guide';
+    title: string;
+    description: string;
+    category: string;
+    url: string;
+}
+/**
+ * Lists the spring.io guides, optionally filtered on category (case-insensitive substring).
+ * The /guides page is rendered client-side (Gatsby): its HTML holds no guide links, the list
+ * lives in the page-data JSON that the page itself loads. Entries without title or path are
+ * skipped; an unexpected payload throws (callers must not cache it).
+ */
+export declare function fetchSpringGuidesList(category?: string): Promise<SpringGuideEntry[]>;
+//# sourceMappingURL=guides-list.d.ts.map

package/build/services/guides-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides-list.d.ts","sourceRoot":"","sources":["../../src/services/guides-list.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,sDAAsD,CAAC;AAE1F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoC1F"}

package/build/services/guides-list.js

@@ -0,0 +1,45 @@
+import { fetchWithRetry } from './http.js';
+import { absoluteSpringUrl } from './url.js';
+export const SPRING_GUIDES_DATA_URL = 'https://spring.io/page-data/guides/page-data.json';
+/**
+ * Lists the spring.io guides, optionally filtered on category (case-insensitive substring).
+ * The /guides page is rendered client-side (Gatsby): its HTML holds no guide links, the list
+ * lives in the page-data JSON that the page itself loads. Entries without title or path are
+ * skipped; an unexpected payload throws (callers must not cache it).
+ */
+export async function fetchSpringGuidesList(category) {
+    const response = await fetchWithRetry(SPRING_GUIDES_DATA_URL);
+    if (!response.ok) {
+        throw new Error('Unable to access Spring guides page');
+    }
+    let nodes;
+    try {
+        nodes = JSON.parse(await response.text())?.result?.data?.guides?.nodes;
+    }
+    catch {
+        nodes = undefined;
+    }
+    if (!Array.isArray(nodes)) {
+        throw new Error('Unexpected format of the Spring guides data (no guides list found)');
+    }
+    const guides = [];
+    for (const node of nodes) {
+        const title = typeof node?.title === 'string' ? node.title.trim() : '';
+        const url = absoluteSpringUrl(typeof node?.path === 'string' ? node.path : undefined);
+        if (!title || !url)
+            continue;
+        const categories = Array.isArray(node.category) ? node.category.map(String) : [];
+        const guideCategory = categories.join(', ');
+        if (category && !guideCategory.toLowerCase().includes(category.toLowerCase()))
+            continue;
+        guides.push({
+            type: 'spring-guide',
+            title,
+            description: (typeof node.description === 'string' && node.description.trim()) || 'Spring guide',
+            category: guideCategory || 'General',
+            url,
+        });
+    }
+    return guides;
+}
+//# sourceMappingURL=guides-list.js.map

package/build/services/guides-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides-list.js","sourceRoot":"","sources":["../../src/services/guides-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,mDAAmD,CAAC;AAU1F;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,QAAiB;IAC3D,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,sBAAsB,CAAC,CAAC;IAE9D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,GAAG,SAAS,CAAC;IACpB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAc,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACtF,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG;YAAE,SAAS;QAE7B,MAAM,UAAU,GAAa,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,QAAQ,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAAE,SAAS;QAExF,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,cAAc;YACpB,KAAK;YACL,WAAW,EAAE,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,cAAc;YAChG,QAAQ,EAAE,aAAa,IAAI,SAAS;YACpC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/services/http.d.ts

@@ -0,0 +1,21 @@
+export interface FetchResult {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<any>;
+    /** Set for an api.github.com response refused because of a rate limit (never retried). */
+    rateLimit?: GitHubRateLimit;
+}
+export interface GitHubRateLimit {
+    retryAfterSeconds?: number;
+    resetAt?: string;
+}
+/** Clear message for a GitHub rate-limited response (no waiting, no secret in it). */
+export declare function githubRateLimitMessage(rateLimit?: GitHubRateLimit): string;
+export declare const REQUEST_TIMEOUT = 10000;
+export declare const MAX_RETRIES = 3;
+export declare const MAX_RESPONSE_BYTES: number;
+export declare const MAX_REDIRECTS = 5;
+export declare const ALLOWED_REDIRECT_HOSTS: ReadonlySet<string>;
+export declare function fetchWithRetry(url: string, timeout?: number, retries?: number): Promise<FetchResult>;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/services/http.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,MAAM,CAY1E;AAcD,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAMrD,CAAC;AAYH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAkB,EAAE,OAAO,SAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAyGxH"}