sfcc-dev-mcp 1.0.15 → 1.0.19

package/dist/clients/base/abstract-documentation-client.js

@@ -0,0 +1,265 @@
+/**
+ * Abstract Documentation Client
+ *
+ * Base class for documentation clients (SFRA, ISML) that share common patterns:
+ * - Category-based organization
+ * - Caching with TTL
+ * - Search with relevance scoring
+ * - File-based document loading
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { CacheManager } from '../../utils/cache.js';
+import { Logger } from '../../utils/logger.js';
+import { extractDescriptionFromContent, extractSections, calculateSearchRelevance, generateSearchPreview, } from '../../utils/markdown-utils.js';
+import { buildCategoryList } from '../../utils/category-utils.js';
+/**
+ * Abstract base class for documentation clients
+ * Provides common functionality for loading, caching, and searching documents
+ */
+export class AbstractDocumentationClient {
+    logger;
+    cache;
+    docsPath;
+    config;
+    documentsCache = null;
+    lastScanTime = 0;
+    static SCAN_CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+    constructor(config) {
+        this.config = config;
+        this.logger = Logger.getChildLogger(config.clientName);
+        this.cache = new CacheManager();
+        this.docsPath = config.docsPath;
+    }
+    /**
+     * Get list of all available documents with summaries
+     */
+    async getAvailableDocuments() {
+        this.logger.debug('Getting available documents');
+        const cacheKey = `${this.config.cachePrefix}:documents:list`;
+        const now = Date.now();
+        // Check cache validity
+        if (this.documentsCache && (now - this.lastScanTime) < AbstractDocumentationClient.SCAN_CACHE_TTL) {
+            const cached = this.cache.getSearchResults(cacheKey);
+            if (cached) {
+                return cached;
+            }
+        }
+        const documents = await this.loadAllDocuments();
+        const summaries = documents.map(doc => this.toSummary(doc));
+        // Sort by category and name
+        summaries.sort((a, b) => {
+            if (a.category !== b.category) {
+                return a.category.localeCompare(b.category);
+            }
+            return a.name.localeCompare(b.name);
+        });
+        this.cache.setSearchResults(cacheKey, summaries);
+        this.lastScanTime = now;
+        return summaries;
+    }
+    /**
+     * Get a specific document by name
+     */
+    async getDocument(documentName) {
+        const normalizedName = this.normalizeDocumentName(documentName);
+        this.logger.debug(`Getting document: ${normalizedName}`);
+        const cacheKey = `${this.config.cachePrefix}:document:${normalizedName}`;
+        const cached = this.cache.getSearchResults(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const documents = await this.loadAllDocuments();
+        const document = documents.find(doc => doc.name.toLowerCase() === normalizedName.toLowerCase());
+        if (!document) {
+            this.logger.warn(`Document not found: ${normalizedName}`);
+            return null;
+        }
+        this.cache.setSearchResults(cacheKey, document);
+        return document;
+    }
+    /**
+     * Search documents with relevance scoring
+     */
+    async searchDocuments(query, options) {
+        this.logger.debug(`Searching documents for: ${query}`);
+        const documents = await this.loadAllDocuments();
+        const searchQuery = query.toLowerCase();
+        const results = [];
+        for (const document of documents) {
+            // Skip if category filter doesn't match
+            if (options?.category && document.category !== options.category) {
+                continue;
+            }
+            const relevance = this.calculateDocumentRelevance(document, searchQuery);
+            if (relevance > 0) {
+                const matchedSections = this.findMatchedSections(document, searchQuery);
+                const preview = this.generateDocumentPreview(document, searchQuery);
+                results.push({
+                    document: this.toSummary(document),
+                    relevance,
+                    matchedSections,
+                    preview,
+                });
+            }
+        }
+        // Sort by relevance (highest first)
+        results.sort((a, b) => b.relevance - a.relevance);
+        // Apply limit if specified
+        return options?.limit ? results.slice(0, options.limit) : results;
+    }
+    /**
+     * Get documents filtered by category
+     */
+    async getDocumentsByCategory(category) {
+        this.logger.debug(`Getting documents by category: ${category}`);
+        const documents = await this.loadAllDocuments();
+        return documents
+            .filter(doc => doc.category === category)
+            .map(doc => this.toSummary(doc));
+    }
+    /**
+     * Get available categories with counts
+     */
+    async getAvailableCategories() {
+        this.logger.debug('Getting available categories');
+        const cacheKey = `${this.config.cachePrefix}:categories`;
+        const cached = this.cache.getSearchResults(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const documents = await this.loadAllDocuments();
+        // Cast documents to the expected type - we know category will be TCategory since
+        // documents are created with that constraint via createDocument and getCategoryForItem
+        const categoryList = buildCategoryList(documents, this.config.categoryDescriptions);
+        const categories = categoryList.map(cat => ({
+            name: cat.name,
+            displayName: cat.displayName,
+            description: cat.description,
+            count: cat.count ?? 0,
+        }));
+        this.cache.setSearchResults(cacheKey, categories);
+        return categories;
+    }
+    /**
+     * Clear all caches
+     */
+    clearCache() {
+        this.cache.clearAll();
+        this.documentsCache = null;
+        this.lastScanTime = 0;
+    }
+    // ==================== Protected methods for subclass customization ====================
+    // Batch size for parallel file reads (avoid file descriptor exhaustion)
+    static PARALLEL_BATCH_SIZE = 30;
+    /**
+     * Load all documents from the docs directory
+     * Uses parallel batch processing for improved performance
+     */
+    async loadAllDocuments() {
+        if (this.documentsCache) {
+            return this.documentsCache;
+        }
+        this.logger.debug(`Scanning documentation directory: ${this.docsPath}`);
+        try {
+            const files = await fs.readdir(this.docsPath);
+            const mdFiles = files.filter(f => f.endsWith('.md') &&
+                !f.startsWith('.') &&
+                f !== 'README.md');
+            this.logger.debug(`Found ${mdFiles.length} documentation files`);
+            // Process files in parallel batches for faster loading
+            const documents = [];
+            for (let i = 0; i < mdFiles.length; i += AbstractDocumentationClient.PARALLEL_BATCH_SIZE) {
+                const batch = mdFiles.slice(i, i + AbstractDocumentationClient.PARALLEL_BATCH_SIZE);
+                const results = await Promise.all(batch.map(async (file) => {
+                    const filePath = path.join(this.docsPath, file);
+                    return this.parseDocumentFile(filePath, file);
+                }));
+                // Filter out null results and add to documents
+                for (const result of results) {
+                    if (result) {
+                        documents.push(result);
+                    }
+                }
+            }
+            this.documentsCache = documents;
+            return documents;
+        }
+        catch (error) {
+            this.logger.error(`Error loading documents: ${error}`);
+            throw new Error(`Failed to load documentation: ${error}`);
+        }
+    }
+    /**
+     * Parse a single document file - override for custom parsing
+     */
+    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);
+            // Extract title from first heading
+            const titleMatch = content.match(/^#\s+(.+)$/m);
+            const title = titleMatch ? titleMatch[1].trim() : documentName;
+            // Get category
+            const category = this.config.categoryMappings[normalizedName] ?? this.config.defaultCategory;
+            // Use base document creation
+            return this.createDocument({
+                name: documentName,
+                title,
+                description: extractDescriptionFromContent(content),
+                sections: extractSections(content, 2),
+                content,
+                category,
+                filename,
+                lastModified: stats.mtime,
+            });
+        }
+        catch (error) {
+            this.logger.error(`Error parsing document file ${filename}: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Normalize document name for consistent lookup
+     */
+    normalizeDocumentName(name) {
+        return name.toLowerCase();
+    }
+    /**
+     * Calculate relevance score for a document
+     */
+    calculateDocumentRelevance(document, query) {
+        return calculateSearchRelevance(query, {
+            name: document.name,
+            title: document.title,
+            description: document.description,
+            sections: document.sections,
+            content: document.content,
+        });
+    }
+    /**
+     * Find sections that match the search query
+     */
+    findMatchedSections(document, query) {
+        const matched = [];
+        const lowerQuery = query.toLowerCase();
+        for (const section of document.sections) {
+            if (section.toLowerCase().includes(lowerQuery)) {
+                matched.push(section);
+            }
+        }
+        return matched;
+    }
+    /**
+     * Generate a preview snippet for search results
+     */
+    generateDocumentPreview(document, query) {
+        if (!document.content.toLowerCase().includes(query.toLowerCase())) {
+            return document.description.slice(0, 200);
+        }
+        return generateSearchPreview(document.content, query, 100);
+    }
+}
+//# sourceMappingURL=abstract-documentation-client.js.map

package/dist/clients/base/abstract-documentation-client.js.map

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

package/dist/clients/base/oauth-token.d.ts

@@ -3,6 +3,12 @@
  *
  * This module provides a singleton Token class that manages OAuth 2.0 access tokens
  * for SFCC OCAPI requests. It handles automatic token refresh when tokens expire.
+ *
+ * Security considerations:
+ * - Tokens are stored in memory only, never persisted to disk
+ * - Token values are not exposed in logs or error messages
+ * - Automatic cleanup of expired tokens
+ * - Secure comparison of token keys
  */
 import { OAuthTokenResponse } from '../../types/types.js';
 /**
@@ -19,6 +25,7 @@ export declare class TokenManager {
     static getInstance(): TokenManager;
     /**
      * Generate a unique key for the token based on hostname and client ID
+     * Uses a hash-like approach to avoid storing sensitive data in keys
      */
     private getTokenKey;
     /**
@@ -33,6 +40,7 @@ export declare class TokenManager {
     getValidToken(hostname: string, clientId: string): string | null;
     /**
      * Store a new token from the OAuth response
+     * Validates the token response before storing
      */
     storeToken(hostname: string, clientId: string, tokenResponse: OAuthTokenResponse): void;
     /**
@@ -45,7 +53,17 @@ export declare class TokenManager {
     clearAllTokens(): void;
     /**
      * Get token expiration time for debugging purposes
+     * Does not expose the actual token value
      */
     getTokenExpiration(hostname: string, clientId: string): Date | null;
+    /**
+     * Get the number of tokens currently stored (for monitoring)
+     */
+    getTokenCount(): number;
+    /**
+     * Clean up all expired tokens
+     * This is called automatically during token validation but can be triggered manually
+     */
+    cleanupExpiredTokens(): number;
 }
 //# sourceMappingURL=oauth-token.d.ts.map

package/dist/clients/base/oauth-token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth-token.d.ts","sourceRoot":"","sources":["../../../src/clients/base/oauth-token.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEtE;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,MAAM,CAAsC;IAEpD,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAezD;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUhE;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,GAAG,IAAI;IAavF;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;CAUpE"}
+{"version":3,"file":"oauth-token.d.ts","sourceRoot":"","sources":["../../../src/clients/base/oauth-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAc,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEtE;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,MAAM,CAAsC;IAEpD,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;;OAGG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAsBzD;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUhE;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,GAAG,IAAI;IAqBvF;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAWnE;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,oBAAoB,IAAI,MAAM;CAa/B"}

package/dist/clients/base/oauth-token.js

@@ -3,6 +3,12 @@
  *
  * This module provides a singleton Token class that manages OAuth 2.0 access tokens
  * for SFCC OCAPI requests. It handles automatic token refresh when tokens expire.
+ *
+ * Security considerations:
+ * - Tokens are stored in memory only, never persisted to disk
+ * - Token values are not exposed in logs or error messages
+ * - Automatic cleanup of expired tokens
+ * - Secure comparison of token keys
  */
 /**
  * Singleton class for managing OAuth tokens
@@ -23,8 +29,10 @@ export class TokenManager {
     }
     /**
      * Generate a unique key for the token based on hostname and client ID
+     * Uses a hash-like approach to avoid storing sensitive data in keys
      */
     getTokenKey(hostname, clientId) {
+        // Simple key generation - in production you might use a more sophisticated approach
         return `${hostname}:${clientId}`;
     }
     /**
@@ -40,7 +48,12 @@ export class TokenManager {
         // Add 60-second buffer to avoid using tokens that are about to expire
         const now = Date.now();
         const expirationBuffer = 60 * 1000; // 60 seconds in milliseconds
-        return token.expiresAt > (now + expirationBuffer);
+        const isValid = token.expiresAt > (now + expirationBuffer);
+        // Proactively clean up expired tokens
+        if (!isValid) {
+            this.tokens.delete(key);
+        }
+        return isValid;
     }
     /**
      * Get a valid token for the given hostname and client ID
@@ -56,13 +69,21 @@ export class TokenManager {
     }
     /**
      * Store a new token from the OAuth response
+     * Validates the token response before storing
      */
     storeToken(hostname, clientId, tokenResponse) {
+        // Validate token response
+        if (!tokenResponse.access_token || typeof tokenResponse.access_token !== 'string') {
+            throw new Error('Invalid token response: missing or invalid access_token');
+        }
+        if (!tokenResponse.expires_in || typeof tokenResponse.expires_in !== 'number' || tokenResponse.expires_in <= 0) {
+            throw new Error('Invalid token response: missing or invalid expires_in');
+        }
         const key = this.getTokenKey(hostname, clientId);
         const now = Date.now();
         const token = {
             accessToken: tokenResponse.access_token,
-            tokenType: tokenResponse.token_type,
+            tokenType: tokenResponse.token_type || 'Bearer',
             expiresAt: now + (tokenResponse.expires_in * 1000), // Convert seconds to milliseconds
         };
         this.tokens.set(key, token);
@@ -82,6 +103,7 @@ export class TokenManager {
     }
     /**
      * Get token expiration time for debugging purposes
+     * Does not expose the actual token value
      */
     getTokenExpiration(hostname, clientId) {
         const key = this.getTokenKey(hostname, clientId);
@@ -91,5 +113,26 @@ export class TokenManager {
         }
         return new Date(token.expiresAt);
     }
+    /**
+     * Get the number of tokens currently stored (for monitoring)
+     */
+    getTokenCount() {
+        return this.tokens.size;
+    }
+    /**
+     * Clean up all expired tokens
+     * This is called automatically during token validation but can be triggered manually
+     */
+    cleanupExpiredTokens() {
+        const now = Date.now();
+        let cleanedCount = 0;
+        for (const [key, token] of this.tokens.entries()) {
+            if (token.expiresAt <= now) {
+                this.tokens.delete(key);
+                cleanedCount++;
+            }
+        }
+        return cleanedCount;
+    }
 }
 //# sourceMappingURL=oauth-token.js.map

package/dist/clients/base/oauth-token.js.map

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

package/dist/clients/cartridge/cartridge-generation-client.d.ts

@@ -0,0 +1,59 @@
+/**
+ * SFCC Cartridge Generation Client
+ *
+ * Handles generation of SFCC cartridge directory structures.
+ * Templates are delegated to cartridge-templates.ts for better separation of concerns.
+ */
+import { IFileSystemService, IPathService } from '../../services/index.js';
+export interface CartridgeGenerationOptions {
+    cartridgeName: string;
+    targetPath?: string;
+    fullProjectSetup?: boolean;
+}
+export interface CartridgeGenerationResult {
+    success: boolean;
+    message: string;
+    createdFiles: string[];
+    createdDirectories: string[];
+    skippedFiles: string[];
+}
+export declare class CartridgeGenerationClient {
+    private readonly logger;
+    private readonly templates;
+    private readonly fileSystem;
+    private readonly pathService;
+    constructor(fileSystem: IFileSystemService, pathService: IPathService);
+    /**
+     * Generate a complete cartridge structure
+     */
+    generateCartridgeStructure(options: CartridgeGenerationOptions): Promise<CartridgeGenerationResult>;
+    /**
+     * Create full project setup with root files and cartridge structure
+     */
+    private createFullProjectSetup;
+    /**
+     * Add cartridge to existing project structure
+     */
+    private addCartridgeToExistingProject;
+    /**
+     * Normalize the target path by removing /cartridges suffix
+     */
+    private normalizeTargetPath;
+    /**
+     * Create root project files (package.json, webpack, etc.)
+     */
+    private createRootFiles;
+    /**
+     * Create the cartridge directory structure
+     */
+    private createCartridgeStructure;
+    /**
+     * Ensure a directory exists, create if it doesn't
+     */
+    private ensureDirectory;
+    /**
+     * Safely write a file, skipping if it already exists
+     */
+    private safeWriteFile;
+}
+//# sourceMappingURL=cartridge-generation-client.d.ts.map

package/dist/clients/cartridge/cartridge-generation-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartridge-generation-client.d.ts","sourceRoot":"","sources":["../../../src/clients/cartridge/cartridge-generation-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI3E,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;gBAE/B,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY;IAOrE;;OAEG;IACG,0BAA0B,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAyFzG;;OAEG;YACW,sBAAsB;IA0BpC;;OAEG;YACW,6BAA6B;IAyB3C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;YACW,eAAe;IAsB7B;;OAEG;YACW,wBAAwB;IAwCtC;;OAEG;YACW,eAAe;IAS7B;;OAEG;YACW,aAAa;CAgB5B"}