@dollhousemcp/mcp-server 1.3.0

package/dist/test/src/elements/templates/TemplateManager.d.ts

@@ -0,0 +1,104 @@
+/**
+ * TemplateManager - Implementation of IElementManager for Template elements
+ * Handles CRUD operations and lifecycle management for templates implementing IElement
+ *
+ * SECURITY FIXES IMPLEMENTED (Following PR #319 patterns):
+ * 1. CRITICAL: Fixed race conditions in file operations by using FileLockManager for atomic reads/writes
+ * 2. CRITICAL: Fixed dynamic require() statements by using static imports
+ * 3. HIGH: Fixed unvalidated YAML parsing vulnerability by using SecureYamlParser
+ * 4. MEDIUM: All user inputs are now validated and sanitized
+ * 5. MEDIUM: Audit logging added for security operations
+ * 6. MEDIUM: Path traversal prevention for all file operations
+ */
+import { IElementManager } from '../../types/elements/IElementManager.js';
+import { ElementValidationResult } from '../../types/elements/IElement.js';
+import { Template } from './Template.js';
+import { ElementType } from '../../portfolio/types.js';
+export declare class TemplateManager implements IElementManager<Template> {
+    private portfolioManager;
+    private templatesDir;
+    private templates;
+    constructor();
+    /**
+     * Load a template from file
+     * SECURITY FIX #1: Uses FileLockManager.atomicReadFile() instead of fs.readFile()
+     * to prevent race conditions and ensure atomic file operations
+     */
+    load(filePath: string): Promise<Template>;
+    /**
+     * Save a template to file
+     * SECURITY FIX #1: Uses FileLockManager.atomicWriteFile() for atomic operations
+     */
+    save(template: Template, filePath: string): Promise<void>;
+    /**
+     * List all templates
+     * SECURITY FIX: Uses validated directory path
+     */
+    list(): Promise<Template[]>;
+    /**
+     * Find a template by predicate
+     */
+    find(predicate: (template: Template) => boolean): Promise<Template | undefined>;
+    /**
+     * Delete a template
+     * SECURITY FIX #6: Path validation to prevent deletion outside directory
+     */
+    delete(filePath: string): Promise<void>;
+    /**
+     * Import a template from external format
+     * SECURITY FIX #3: Uses SecureYamlParser for safe YAML parsing
+     */
+    importElement(data: string, format: 'json' | 'yaml' | 'markdown'): Promise<Template>;
+    /**
+     * Export a template to external format
+     * SECURITY FIX #3: Uses safe YAML serialization
+     */
+    exportElement(template: Template, format: 'json' | 'yaml' | 'markdown'): Promise<string>;
+    /**
+     * Validate and sanitize metadata
+     * SECURITY FIX #4: Comprehensive metadata validation
+     */
+    private validateMetadata;
+    /**
+     * Create YAML frontmatter from metadata
+     * SECURITY FIX #3: Safe YAML generation
+     */
+    private createFrontmatter;
+    /**
+     * Check if a template file exists
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Find multiple templates by predicate
+     */
+    findMany(predicate: (template: Template) => boolean): Promise<Template[]>;
+    /**
+     * Validate a template
+     */
+    validate(template: Template): ElementValidationResult;
+    /**
+     * Validate a file path
+     */
+    validatePath(filePath: string): boolean;
+    /**
+     * Get the element type
+     */
+    getElementType(): ElementType;
+    /**
+     * Get the file extension
+     */
+    getFileExtension(): string;
+    /**
+     * Find templates by category
+     */
+    findByCategory(category: string): Promise<Template[]>;
+    /**
+     * Find templates by tag
+     */
+    findByTag(tag: string): Promise<Template[]>;
+    /**
+     * Get most used templates
+     */
+    getMostUsed(limit?: number): Promise<Template[]>;
+}
+//# sourceMappingURL=TemplateManager.d.ts.map

package/dist/test/src/elements/templates/TemplateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateManager.d.ts","sourceRoot":"","sources":["../../../../../src/elements/templates/TemplateManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAoB,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAavD,qBAAa,eAAgB,YAAW,eAAe,CAAC,QAAQ,CAAC;IAC/D,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAoC;;IAOrD;;;;OAIG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA0D/C;;;OAGG;IACG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0D/D;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAyBjC;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAKrF;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC7C;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IA0D1F;;;OAGG;IACG,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IA6C9F;;;OAGG;YACW,gBAAgB;IAoE9B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAchD;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK/E;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,uBAAuB;IAIrD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAcvC;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAO3D;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOjD;;OAEG;IACG,WAAW,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAiB3D"}