sfcc-dev-mcp 1.0.15 → 1.0.19

package/dist/clients/sfra-client.d.ts

@@ -5,45 +5,25 @@
  * core classes like Server, Request, Response, QueryString, render module, and comprehensive
  * model documentation for account, cart, products, pricing, billing, shipping, and more.
  */
-export interface SFRADocument {
-    title: string;
-    description: string;
-    sections: string[];
-    content: string;
-    type: 'class' | 'module' | 'model';
-    category: 'core' | 'product' | 'order' | 'customer' | 'pricing' | 'store' | 'other';
+import { AbstractDocumentationClient, BaseDocument, DocumentSummary } from './base/abstract-documentation-client.js';
+export type SFRACategory = 'core' | 'product' | 'order' | 'customer' | 'pricing' | 'store' | 'other';
+export type SFRADocumentType = 'class' | 'module' | 'model';
+export interface SFRADocument extends BaseDocument {
+    type: SFRADocumentType;
+    category: SFRACategory;
     properties?: string[];
     methods?: string[];
-    filename: string;
-    lastModified?: Date;
 }
-export interface SFRADocumentSummary {
-    name: string;
-    title: string;
-    description: string;
+export interface SFRADocumentSummary extends DocumentSummary {
     type: string;
     category: string;
-    filename: string;
 }
 /**
- * Enhanced client for accessing SFRA documentation with dynamic discovery
+ * Client for accessing SFRA documentation
+ * Extends AbstractDocumentationClient for shared functionality
  */
-export declare class SFRAClient {
-    private cache;
-    private docsPath;
-    private documentsCache;
-    private lastScanTime;
-    private static readonly SCAN_CACHE_TTL;
-    private logger;
+export declare class SFRAClient extends AbstractDocumentationClient<SFRADocument, SFRADocumentSummary, SFRACategory> {
     constructor();
-    /**
-     * Dynamically discover all available SFRA documentation files
-     */
-    getAvailableDocuments(): Promise<SFRADocumentSummary[]>;
-    /**
-     * Get lightweight metadata for a document without loading full content
-     */
-    private getSFRADocumentMetadata;
     /**
      * Get a specific SFRA document with full content
      */
@@ -67,41 +47,12 @@ export declare class SFRAClient {
      * Get documents by category
      */
     getDocumentsByCategory(category: string): Promise<SFRADocumentSummary[]>;
-    /**
-     * Get all available categories
-     */
-    getAvailableCategories(): Promise<Array<{
-        category: string;
-        count: number;
-        description: string;
-    }>>;
-    /**
-     * Enhanced path validation and construction
-     */
-    private validateAndConstructPath;
+    protected createDocument(baseData: BaseDocument): SFRADocument;
+    protected toSummary(document: SFRADocument): SFRADocumentSummary;
+    protected parseDocumentFile(filePath: string, filename: string): Promise<SFRADocument | null>;
     /**
      * Determine document type from title and content
      */
     private determineDocumentType;
-    /**
-     * Extract description from document lines
-     */
-    private extractDescription;
-    /**
-     * Extract properties from document content
-     */
-    private extractProperties;
-    /**
-     * Extract methods from document content
-     */
-    private extractMethods;
-    /**
-     * Format document name for display
-     */
-    private formatDocumentName;
-    /**
-     * Clear all caches
-     */
-    clearCache(): void;
 }
 //# sourceMappingURL=sfra-client.d.ts.map

package/dist/clients/sfra-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sfra-client.d.ts","sourceRoot":"","sources":["../../src/clients/sfra-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACpF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6CD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAiB;IACvD,OAAO,CAAC,MAAM,CAAS;;IAQvB;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA8D7D;;OAEG;YACW,uBAAuB;IAwErC;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAkCzE;;OAEG;IACG,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1D,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,KAAK,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KACxE,CAAC,CAAC;IA4FH;;OAEG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAK9E;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAyBtG;;OAEG;YACW,wBAAwB;IAkCtC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiD1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,UAAU,IAAI,IAAI;CAKnB"}
+{"version":3,"file":"sfra-client.d.ts","sourceRoot":"","sources":["../../src/clients/sfra-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,2BAA2B,EAC3B,YAAY,EACZ,eAAe,EAEhB,MAAM,yCAAyC,CAAC;AAWjD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AACrG,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5D,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+ED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,2BAA2B,CAAC,YAAY,EAAE,mBAAmB,EAAE,YAAY,CAAC;;IAe1G;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAIzE;;OAEG;IACG,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1D,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,KAAK,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KACxE,CAAC,CAAC;IAuFH;;OAEG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAM9E,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY;IAU9D,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,mBAAmB;cAWhD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA6CnG;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAmB9B"}

package/dist/clients/sfra-client.js

@@ -6,12 +6,11 @@
  * model documentation for account, cart, products, pricing, billing, shipping, and more.
  */
 import * as fs from 'fs/promises';
-import * as path from 'path';
 import { PathResolver } from '../utils/path-resolver.js';
-import { CacheManager } from '../utils/cache.js';
-import { Logger } from '../utils/logger.js';
-// Document categorization rules
-const CATEGORY_MAPPINGS = {
+import { AbstractDocumentationClient, } from './base/abstract-documentation-client.js';
+import { extractDescriptionFromLines, extractSections, extractProperties, extractMethods, formatDocumentName, } from '../utils/markdown-utils.js';
+// ==================== Configuration ====================
+const SFRA_CATEGORY_MAPPINGS = {
     // Core SFRA classes and modules
     'server': 'core',
     'request': 'core',
@@ -46,175 +45,59 @@ const CATEGORY_MAPPINGS = {
     'content': 'other',
     'locale': 'other',
 };
+const SFRA_CATEGORY_DESCRIPTIONS = {
+    'core': {
+        displayName: 'Core',
+        description: 'Core SFRA classes and modules (Server, Request, Response, QueryString, render)',
+    },
+    'product': {
+        displayName: 'Product',
+        description: 'Product-related models and functionality',
+    },
+    'order': {
+        displayName: 'Order',
+        description: 'Order, cart, billing, shipping, and payment models',
+    },
+    'customer': {
+        displayName: 'Customer',
+        description: 'Customer account and address models',
+    },
+    'pricing': {
+        displayName: 'Pricing',
+        description: 'Pricing and discount models',
+    },
+    'store': {
+        displayName: 'Store',
+        description: 'Store and location models',
+    },
+    'other': {
+        displayName: 'Other',
+        description: 'Other models and utilities',
+    },
+};
+// ==================== Client Implementation ====================
 /**
- * Enhanced client for accessing SFRA documentation with dynamic discovery
+ * Client for accessing SFRA documentation
+ * Extends AbstractDocumentationClient for shared functionality
  */
-export class SFRAClient {
-    cache;
-    docsPath;
-    documentsCache = new Map();
-    lastScanTime = 0;
-    static SCAN_CACHE_TTL = 5 * 60 * 1000; // 5 minutes
-    logger;
+export class SFRAClient extends AbstractDocumentationClient {
     constructor() {
-        this.cache = new CacheManager();
-        this.docsPath = PathResolver.getSFRADocsPath();
-        this.logger = Logger.getChildLogger('SFRAClient');
-    }
-    /**
-     * Dynamically discover all available SFRA documentation files
-     */
-    async getAvailableDocuments() {
-        const cacheKey = 'sfra:available-documents-v2';
-        const cached = this.cache.getSearchResults(cacheKey);
-        // Check if we need to rescan the filesystem
-        const now = Date.now();
-        if (cached && (now - this.lastScanTime) < SFRAClient.SCAN_CACHE_TTL) {
-            return cached;
-        }
-        try {
-            const files = await fs.readdir(this.docsPath);
-            const mdFiles = files.filter(file => file.endsWith('.md') &&
-                file !== 'README.md' &&
-                !file.startsWith('.'));
-            const documents = [];
-            for (const filename of mdFiles) {
-                try {
-                    const documentName = path.basename(filename, '.md');
-                    const document = await this.getSFRADocumentMetadata(documentName);
-                    if (document) {
-                        documents.push({
-                            name: documentName,
-                            title: document.title,
-                            description: document.description,
-                            type: document.type,
-                            category: document.category,
-                            filename: document.filename,
-                        });
-                    }
-                }
-                catch (error) {
-                    this.logger.error(`Error processing SFRA document ${filename}:`, error);
-                    // Continue processing other files
-                }
-            }
-            // Sort documents by category and then by name
-            documents.sort((a, b) => {
-                if (a.category !== b.category) {
-                    // Prioritize core documents
-                    if (a.category === 'core') {
-                        return -1;
-                    }
-                    if (b.category === 'core') {
-                        return 1;
-                    }
-                    return a.category.localeCompare(b.category);
-                }
-                return a.name.localeCompare(b.name);
-            });
-            this.cache.setSearchResults(cacheKey, documents);
-            this.lastScanTime = now;
-            return documents;
-        }
-        catch (error) {
-            this.logger.error('Error scanning SFRA documents directory:', error);
-            return [];
-        }
-    }
-    /**
-     * Get lightweight metadata for a document without loading full content
-     */
-    async getSFRADocumentMetadata(documentName) {
-        // Normalize document name for consistent caching and lookup
-        const normalizedDocumentName = documentName.toLowerCase();
-        // Check if we already have this document cached
-        if (this.documentsCache.has(normalizedDocumentName)) {
-            return this.documentsCache.get(normalizedDocumentName);
-        }
-        try {
-            const filePath = await this.validateAndConstructPath(documentName);
-            const stats = await fs.stat(filePath);
-            // Check if we have a cached version that's still valid
-            const cacheKey = `sfra:metadata:${normalizedDocumentName}`;
-            const cached = this.cache.getFileContent(cacheKey);
-            if (cached) {
-                const cachedData = JSON.parse(cached);
-                if (cachedData.lastModified && new Date(cachedData.lastModified) >= stats.mtime) {
-                    return cachedData;
-                }
-            }
-            // Read only the first part of the file to extract metadata
-            const content = await fs.readFile(filePath, 'utf-8');
-            const lines = content.split('\n');
-            // Extract title
-            const titleLine = lines.find(line => line.startsWith('#'));
-            const title = titleLine?.replace(/^#+\s*/, '').trim() ?? this.formatDocumentName(normalizedDocumentName);
-            // Determine type based on title and content
-            const type = this.determineDocumentType(title, content);
-            // Determine category - use normalized name for consistent mapping
-            const category = (CATEGORY_MAPPINGS[normalizedDocumentName] || 'other');
-            // Extract description (first substantial paragraph after title)
-            const description = this.extractDescription(lines, title);
-            // Extract sections (## headers)
-            const sections = lines
-                .filter(line => line.startsWith('##'))
-                .map(line => line.replace(/^##\s*/, '').trim())
-                .filter(section => section.length > 0);
-            const document = {
-                title,
-                description,
-                sections,
-                content, // Keep full content for now, optimize later if needed
-                type,
-                category,
-                filename: `${normalizedDocumentName}.md`,
-                lastModified: stats.mtime,
-                ...(type === 'class' || type === 'model' ? {
-                    properties: this.extractProperties(lines),
-                    methods: this.extractMethods(lines),
-                } : {}),
-            };
-            // Cache the metadata using normalized name
-            this.cache.setFileContent(cacheKey, JSON.stringify(document));
-            this.documentsCache.set(normalizedDocumentName, document);
-            return document;
-        }
-        catch (error) {
-            this.logger.error(`Error loading SFRA document metadata ${normalizedDocumentName}:`, error);
-            return null;
-        }
+        const config = {
+            clientName: 'SFRAClient',
+            docsPath: PathResolver.getSFRADocsPath(),
+            categoryMappings: SFRA_CATEGORY_MAPPINGS,
+            categoryDescriptions: SFRA_CATEGORY_DESCRIPTIONS,
+            defaultCategory: 'other',
+            cachePrefix: 'sfra',
+        };
+        super(config);
     }
+    // ==================== Public API (preserves existing interface) ====================
     /**
      * Get a specific SFRA document with full content
      */
     async getSFRADocument(documentName) {
-        // Normalize document name for consistent lookup
-        const normalizedDocumentName = documentName.toLowerCase();
-        // First try to get from metadata cache
-        const metadata = await this.getSFRADocumentMetadata(documentName);
-        if (!metadata) {
-            return null;
-        }
-        // If the content is already loaded, return it
-        if (metadata.content?.trim()) {
-            return metadata;
-        }
-        // Otherwise, load the full content
-        try {
-            const filePath = await this.validateAndConstructPath(documentName);
-            const content = await fs.readFile(filePath, 'utf-8');
-            const fullDocument = {
-                ...metadata,
-                content,
-            };
-            // Update cache using normalized name
-            this.documentsCache.set(normalizedDocumentName, fullDocument);
-            return fullDocument;
-        }
-        catch (error) {
-            this.logger.error(`Error loading full SFRA document ${normalizedDocumentName}:`, error);
-            return metadata; // Return metadata even if content loading failed
-        }
+        return this.getDocument(documentName);
     }
     /**
      * Enhanced search across all SFRA documentation with better categorization
@@ -230,7 +113,7 @@ export class SFRAClient {
         const queryLower = query.toLowerCase();
         const queryWords = queryLower.split(/\s+/).filter(word => word.length > 1);
         for (const doc of documents) {
-            const documentContent = await this.getSFRADocument(doc.name);
+            const documentContent = await this.getDocument(doc.name);
             if (!documentContent) {
                 continue;
             }
@@ -252,7 +135,6 @@ export class SFRAClient {
                 if (line.startsWith('##')) {
                     currentSection = line.replace(/^##\s*/, '').trim();
                 }
-                // Check for query matches
                 let matchFound = false;
                 let lineRelevance = 0;
                 if (lineLower.includes(queryLower)) {
@@ -260,7 +142,6 @@ export class SFRAClient {
                     lineRelevance += 3;
                 }
                 else {
-                    // Check for partial matches with query words
                     const wordMatches = queryWords.filter(word => lineLower.includes(word));
                     if (wordMatches.length > 0) {
                         matchFound = true;
@@ -268,7 +149,6 @@ export class SFRAClient {
                     }
                 }
                 if (matchFound) {
-                    // Get context around the match
                     const contextStart = Math.max(0, i - 2);
                     const contextEnd = Math.min(lines.length, i + 3);
                     const context = lines.slice(contextStart, contextEnd)
@@ -296,7 +176,6 @@ export class SFRAClient {
                 });
             }
         }
-        // Sort by relevance score (highest first)
         results.sort((a, b) => b.relevanceScore - a.relevanceScore);
         this.cache.setSearchResults(cacheKey, results);
         return results;
@@ -305,62 +184,66 @@ export class SFRAClient {
      * Get documents by category
      */
     async getDocumentsByCategory(category) {
-        const allDocuments = await this.getAvailableDocuments();
-        return allDocuments.filter(doc => doc.category === category);
+        return super.getDocumentsByCategory(category);
     }
-    /**
-     * Get all available categories
-     */
-    async getAvailableCategories() {
-        const documents = await this.getAvailableDocuments();
-        const categoryMap = new Map();
-        documents.forEach(doc => {
-            categoryMap.set(doc.category, (categoryMap.get(doc.category) ?? 0) + 1);
-        });
-        const categoryDescriptions = {
-            'core': 'Core SFRA classes and modules (Server, Request, Response, QueryString, render)',
-            'product': 'Product-related models and functionality',
-            'order': 'Order, cart, billing, shipping, and payment models',
-            'customer': 'Customer account and address models',
-            'pricing': 'Pricing and discount models',
-            'store': 'Store and location models',
-            'other': 'Other models and utilities',
+    // ==================== Protected overrides ====================
+    createDocument(baseData) {
+        return {
+            ...baseData,
+            type: 'model',
+            category: baseData.category,
+            properties: [],
+            methods: [],
         };
-        return Array.from(categoryMap.entries()).map(([category, count]) => ({
-            category,
-            count,
-            description: categoryDescriptions[category] || 'Other documentation',
-        }));
     }
-    /**
-     * Enhanced path validation and construction
-     */
-    async validateAndConstructPath(documentName) {
-        if (!documentName || typeof documentName !== 'string') {
-            throw new Error('Invalid document name: must be a non-empty string');
-        }
-        if (documentName.includes('\0') || documentName.includes('\x00')) {
-            throw new Error('Invalid document name: contains null bytes');
-        }
-        if (documentName.includes('..') || documentName.includes('/') || documentName.includes('\\')) {
-            throw new Error('Invalid document name: contains path traversal sequences');
-        }
-        if (!/^[a-zA-Z0-9_-]+$/.test(documentName)) {
-            throw new Error('Invalid document name: contains invalid characters');
-        }
-        // Normalize document name to lowercase for case-insensitive lookup
-        const normalizedDocumentName = documentName.toLowerCase();
-        const filePath = path.join(this.docsPath, `${normalizedDocumentName}.md`);
-        const resolvedPath = path.resolve(filePath);
-        const resolvedDocsPath = path.resolve(this.docsPath);
-        if (!resolvedPath.startsWith(resolvedDocsPath)) {
-            throw new Error('Invalid document name: path outside allowed directory');
+    toSummary(document) {
+        return {
+            name: document.name,
+            title: document.title,
+            description: document.description,
+            type: document.type,
+            category: document.category,
+            filename: document.filename,
+        };
+    }
+    async parseDocumentFile(filePath, filename) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const stats = await fs.stat(filePath);
+            const documentName = filename.replace('.md', '');
+            const normalizedName = this.normalizeDocumentName(documentName);
+            const lines = content.split('\n');
+            // Extract title
+            const titleLine = lines.find(line => line.startsWith('#'));
+            const title = titleLine?.replace(/^#+\s*/, '').trim() ?? formatDocumentName(normalizedName);
+            // Determine type based on title and content
+            const type = this.determineDocumentType(title, content);
+            // Get category
+            const category = SFRA_CATEGORY_MAPPINGS[normalizedName] ?? 'other';
+            // Extract description
+            const description = extractDescriptionFromLines(lines, title);
+            return {
+                name: documentName,
+                title,
+                description,
+                sections: extractSections(content),
+                content,
+                type,
+                category,
+                filename: `${normalizedName}.md`,
+                lastModified: stats.mtime,
+                ...(type === 'class' || type === 'model' ? {
+                    properties: extractProperties(lines),
+                    methods: extractMethods(lines),
+                } : {}),
+            };
         }
-        if (!resolvedPath.toLowerCase().endsWith('.md')) {
-            throw new Error('Invalid document name: must reference a markdown file');
+        catch (error) {
+            this.logger.error(`Error loading SFRA document ${filename}:`, error);
+            return null;
         }
-        return resolvedPath;
     }
+    // ==================== Private helpers ====================
     /**
      * Determine document type from title and content
      */
@@ -377,111 +260,7 @@ export class SFRAClient {
             contentLower.includes('constructor') || contentLower.includes('properties')) {
             return 'model';
         }
-        return 'model'; // Default for most SFRA docs
-    }
-    /**
-     * Extract description from document lines
-     */
-    extractDescription(lines, title) {
-        const titleIndex = lines.findIndex(line => line.trim() === `# ${title}` || line.startsWith('#'));
-        if (titleIndex === -1) {
-            return 'No description available';
-        }
-        // Look for overview section first
-        const overviewIndex = lines.findIndex((line, index) => index > titleIndex && line.toLowerCase().includes('## overview'));
-        if (overviewIndex !== -1) {
-            // Get content under Overview section
-            let descriptionEnd = lines.findIndex((line, index) => index > overviewIndex + 1 && line.startsWith('##'));
-            if (descriptionEnd === -1) {
-                descriptionEnd = Math.min(lines.length, overviewIndex + 10);
-            }
-            const overviewContent = lines.slice(overviewIndex + 1, descriptionEnd)
-                .filter(line => line.trim() && !line.startsWith('#'))
-                .join(' ')
-                .trim();
-            if (overviewContent) {
-                return overviewContent.substring(0, 300) + (overviewContent.length > 300 ? '...' : '');
-            }
-        }
-        // Fallback to first paragraph after title
-        let descriptionStart = titleIndex + 1;
-        while (descriptionStart < lines.length && !lines[descriptionStart].trim()) {
-            descriptionStart++;
-        }
-        const descriptionEnd = lines.findIndex((line, index) => index > descriptionStart && (line.startsWith('#') || line.trim() === ''));
-        const description = lines
-            .slice(descriptionStart, descriptionEnd > -1 ? descriptionEnd : descriptionStart + 3)
-            .filter(line => line.trim() && !line.startsWith('#'))
-            .join(' ')
-            .trim();
-        return description || 'No description available';
-    }
-    /**
-     * Extract properties from document content
-     */
-    extractProperties(lines) {
-        const properties = [];
-        let inPropertiesSection = false;
-        for (const line of lines) {
-            if (line.toLowerCase().includes('## properties') ||
-                line.toLowerCase().includes('## property')) {
-                inPropertiesSection = true;
-                continue;
-            }
-            if (inPropertiesSection && line.startsWith('#') && !line.includes('properties')) {
-                break;
-            }
-            if (inPropertiesSection && line.startsWith('### ')) {
-                const property = line.replace('### ', '').trim();
-                if (!properties.includes(property)) {
-                    properties.push(property);
-                }
-            }
-        }
-        return properties;
-    }
-    /**
-     * Extract methods from document content
-     */
-    extractMethods(lines) {
-        const methods = [];
-        let inMethodSection = false;
-        for (const line of lines) {
-            if (line.toLowerCase().includes('## method') ||
-                line.toLowerCase().includes('## function')) {
-                inMethodSection = true;
-                continue;
-            }
-            if (inMethodSection && line.startsWith('#') &&
-                !line.toLowerCase().includes('method') &&
-                !line.toLowerCase().includes('function')) {
-                break;
-            }
-            if (inMethodSection && line.startsWith('### ')) {
-                const method = line.replace('### ', '').trim();
-                if (!methods.includes(method)) {
-                    methods.push(method);
-                }
-            }
-        }
-        return methods;
-    }
-    /**
-     * Format document name for display
-     */
-    formatDocumentName(documentName) {
-        return documentName
-            .split('-')
-            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-            .join(' ');
-    }
-    /**
-     * Clear all caches
-     */
-    clearCache() {
-        this.cache.clearAll();
-        this.documentsCache.clear();
-        this.lastScanTime = 0;
+        return 'model';
     }
 }
 //# sourceMappingURL=sfra-client.js.map