@atomic-ehr/codegen 0.0.1-canary.20250821160126.c552195 → 0.0.1-canary.20250822150706.c3b8669

package/dist/api/generators/base/builders/FileBuilder.js

@@ -0,0 +1,408 @@
+/**
+ * Fluent file builder with lifecycle hooks and validation
+ *
+ * This provides a clean, chainable API for building files with imports,
+ * exports, content generation, and lifecycle hooks for customization.
+ */
+import { FileOperationError, TemplateError } from "../errors";
+/**
+ * Fluent builder for creating files with lifecycle hooks
+ *
+ * Features:
+ * - Fluent API for content building
+ * - Template integration
+ * - Import/export management
+ * - Lifecycle hooks (before/after save, error handling)
+ * - Content validation
+ * - Automatic import path resolution
+ */
+export class FileBuilder {
+    config;
+    content = "";
+    imports = new Map();
+    exports = new Set();
+    metadata = new Map();
+    // Lifecycle hooks
+    beforeSaveHooks = [];
+    afterSaveHooks = [];
+    errorHooks = [];
+    // Options
+    options = {
+        template: undefined,
+        importStrategy: "auto",
+        validation: "strict",
+        prettify: true,
+        formatting: {
+            indentSize: 2,
+            useTabs: false,
+            maxLineLength: 100,
+        },
+        encoding: "utf-8",
+    };
+    constructor(config) {
+        this.config = config;
+    }
+    // ==========================================
+    // Content Building Methods
+    // ==========================================
+    /**
+     * Set content directly
+     * @param content File content
+     */
+    withContent(content) {
+        this.content = typeof content === "string" ? content : content();
+        return this;
+    }
+    /**
+     * Generate content from template
+     * @param templateName Template to use
+     * @param context Template context
+     */
+    withTemplate(templateName, context) {
+        if (!this.config.templateEngine) {
+            throw new TemplateError(`Template engine is required for template rendering. Template: '${templateName}'`, templateName, context);
+        }
+        this.options.template = templateName;
+        try {
+            this.content = this.config.templateEngine.render(templateName, {
+                ...context,
+                imports: this.imports,
+                exports: this.exports,
+                filename: this.config.filename,
+            });
+        }
+        catch (_error) {
+            throw new TemplateError(`Failed to render template '${templateName}'`, templateName, context, {
+                availableTemplates: this.config.templateEngine.getAvailableTemplates?.() || [],
+            });
+        }
+        return this;
+    }
+    /**
+     * Append content to existing content
+     * @param content Content to append
+     */
+    appendContent(content) {
+        this.content += content;
+        return this;
+    }
+    /**
+     * Prepend content to existing content
+     * @param content Content to prepend
+     */
+    prependContent(content) {
+        this.content = content + this.content;
+        return this;
+    }
+    // ==========================================
+    // Import/Export Management
+    // ==========================================
+    /**
+     * Set all imports at once
+     * @param imports Map of symbol name to import path
+     */
+    withImports(imports) {
+        this.imports.clear();
+        for (const [symbol, path] of imports) {
+            this.imports.set(symbol, path);
+        }
+        return this;
+    }
+    /**
+     * Add a single import
+     * @param symbol Symbol to import
+     * @param from Import path
+     */
+    addImport(symbol, from) {
+        this.imports.set(symbol, from);
+        return this;
+    }
+    /**
+     * Add multiple imports from the same path
+     * @param symbols Symbols to import
+     * @param from Import path
+     */
+    addImports(symbols, from) {
+        for (const symbol of symbols) {
+            this.imports.set(symbol, from);
+        }
+        return this;
+    }
+    /**
+     * Set all exports at once
+     * @param exports Array of export names
+     */
+    withExports(exports) {
+        this.exports.clear();
+        for (const exp of exports) {
+            this.exports.add(exp);
+        }
+        return this;
+    }
+    /**
+     * Add a single export
+     * @param name Export name
+     */
+    addExport(name) {
+        this.exports.add(name);
+        return this;
+    }
+    /**
+     * Add multiple exports
+     * @param names Export names
+     */
+    addExports(names) {
+        for (const name of names) {
+            this.exports.add(name);
+        }
+        return this;
+    }
+    // ==========================================
+    // Metadata and Options
+    // ==========================================
+    /**
+     * Set metadata for the file
+     * @param key Metadata key
+     * @param value Metadata value
+     */
+    withMetadata(key, value) {
+        this.metadata.set(key, value);
+        return this;
+    }
+    /**
+     * Set file builder options
+     * @param options Options to set
+     */
+    withOptions(options) {
+        this.options = { ...this.options, ...options };
+        return this;
+    }
+    // ==========================================
+    // Lifecycle Hooks
+    // ==========================================
+    /**
+     * Add hook to run before saving
+     * @param hook Hook function
+     */
+    onBeforeSave(hook) {
+        this.beforeSaveHooks.push(hook);
+        return this;
+    }
+    /**
+     * Add hook to run after successful save
+     * @param hook Hook function
+     */
+    onAfterSave(hook) {
+        this.afterSaveHooks.push(hook);
+        return this;
+    }
+    /**
+     * Add hook to run when error occurs
+     * @param hook Hook function
+     */
+    onError(hook) {
+        this.errorHooks.push(hook);
+        return this;
+    }
+    // ==========================================
+    // Execution Methods
+    // ==========================================
+    /**
+     * Build final content without saving
+     * @returns File context with final content
+     */
+    build() {
+        const finalContent = this.buildFinalContent();
+        return {
+            filename: this.config.filename,
+            content: finalContent,
+            imports: new Map(this.imports),
+            exports: new Set(this.exports),
+            metadata: Object.fromEntries(this.metadata),
+            templateName: this.options.template,
+        };
+    }
+    /**
+     * Save the file
+     * @returns Promise resolving to file path
+     */
+    async save() {
+        const context = this.build();
+        try {
+            // Run before-save hooks
+            for (const hook of this.beforeSaveHooks) {
+                await hook(context);
+            }
+            // Validate content if enabled
+            if (this.options.validation !== "none") {
+                await this.validateContent(context.content);
+            }
+            // Write file
+            const result = await this.config.fileManager.writeFile(this.config.filename, context.content, { encoding: this.options.encoding });
+            const stats = {
+                size: result.size,
+                generationTime: 0, // Set by caller if needed
+                writeTime: result.writeTime,
+            };
+            // Run after-save hooks
+            for (const hook of this.afterSaveHooks) {
+                await hook(result.path, stats);
+            }
+            this.config.logger.debug(`Saved ${this.config.filename} successfully`);
+            return result.path;
+        }
+        catch (error) {
+            // Run error hooks
+            for (const hook of this.errorHooks) {
+                try {
+                    await hook(error instanceof Error ? error : new Error(String(error)), context);
+                }
+                catch (hookError) {
+                    this.config.logger.warn(`Error hook failed: ${hookError instanceof Error ? hookError.message : String(hookError)}`);
+                }
+            }
+            throw error;
+        }
+    }
+    // ==========================================
+    // Private Helper Methods
+    // ==========================================
+    /**
+     * Build final content with imports and exports
+     */
+    buildFinalContent() {
+        const parts = [];
+        // Add imports
+        if (this.imports.size > 0 && this.options.importStrategy !== "none") {
+            parts.push(this.generateImportStatements());
+            parts.push(""); // Empty line after imports
+        }
+        // Add main content
+        if (this.content) {
+            parts.push(this.content);
+        }
+        // Add exports if not already in content
+        if (this.exports.size > 0 && !this.content.includes("export")) {
+            parts.push(""); // Empty line before exports
+            parts.push(this.generateExportStatements());
+        }
+        let finalContent = parts.join("\n");
+        // Prettify if enabled
+        if (this.options.prettify) {
+            finalContent = this.prettifyContent(finalContent);
+        }
+        return finalContent;
+    }
+    /**
+     * Generate import statements
+     */
+    generateImportStatements() {
+        const lines = [];
+        // Group imports by path
+        const importsByPath = new Map();
+        for (const [symbol, path] of this.imports) {
+            const resolvedPath = this.options.importStrategy === "auto"
+                ? this.config.fileManager.getRelativeImportPath(this.config.filename, path)
+                : path;
+            if (!importsByPath.has(resolvedPath)) {
+                importsByPath.set(resolvedPath, []);
+            }
+            importsByPath.get(resolvedPath)?.push(symbol);
+        }
+        // Generate import statements
+        for (const [path, symbols] of importsByPath) {
+            if (symbols.length === 1) {
+                lines.push(`import type { ${symbols[0]} } from '${path}';`);
+            }
+            else {
+                const sortedSymbols = symbols.sort();
+                if (sortedSymbols.length <= 3) {
+                    lines.push(`import type { ${sortedSymbols.join(", ")} } from '${path}';`);
+                }
+                else {
+                    lines.push(`import type {`);
+                    const indent = "\t";
+                    sortedSymbols.forEach((symbol, index) => {
+                        const isLast = index === sortedSymbols.length - 1;
+                        lines.push(`${indent}${symbol}${isLast ? "" : ","}`);
+                    });
+                    lines.push(`} from '${path}';`);
+                }
+            }
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Generate export statements
+     */
+    generateExportStatements() {
+        const exports = Array.from(this.exports).sort();
+        return exports.map((exp) => `export { ${exp} };`).join("\n");
+    }
+    /**
+     * Prettify content (basic implementation)
+     */
+    prettifyContent(content) {
+        // Basic prettification
+        return content
+            .replace(/\n{3,}/g, "\n\n") // Max 2 consecutive newlines
+            .replace(/\t/g, this.options.formatting?.useTabs
+            ? "\t"
+            : " ".repeat(this.options.formatting?.indentSize || 2))
+            .trim();
+    }
+    /**
+     * Validate generated content
+     */
+    async validateContent(content) {
+        if (this.options.validation === "none")
+            return;
+        // Basic validation - check for syntax errors
+        const issues = [];
+        // Check for unmatched braces
+        const openBraces = (content.match(/\{/g) || []).length;
+        const closeBraces = (content.match(/\}/g) || []).length;
+        if (openBraces !== closeBraces) {
+            issues.push(`Unmatched braces: ${openBraces} open, ${closeBraces} close`);
+        }
+        // Check for unmatched parentheses
+        const openParens = (content.match(/\(/g) || []).length;
+        const closeParens = (content.match(/\)/g) || []).length;
+        if (openParens !== closeParens) {
+            issues.push(`Unmatched parentheses: ${openParens} open, ${closeParens} close`);
+        }
+        // Check for basic TypeScript syntax issues
+        if (this.config.filename.endsWith(".ts") ||
+            this.config.filename.endsWith(".tsx")) {
+            if (content.includes("interface") &&
+                !content.match(/interface\s+\w+\s*\{/)) {
+                issues.push("Invalid interface syntax detected");
+            }
+        }
+        if (issues.length > 0 && this.options.validation === "strict") {
+            throw new FileOperationError(`Content validation failed for ${this.config.filename}: ${issues.join(", ")}`, "write", this.config.filename);
+        }
+        else if (issues.length > 0) {
+            // Just warn for non-strict validation
+            this.config.logger.warn(`Validation issues in ${this.config.filename}: ${issues.join(", ")}`);
+        }
+    }
+    /**
+     * Get current content (for testing/debugging)
+     */
+    getContent() {
+        return this.content;
+    }
+    /**
+     * Get current imports (for testing/debugging)
+     */
+    getImports() {
+        return new Map(this.imports);
+    }
+    /**
+     * Get current exports (for testing/debugging)
+     */
+    getExports() {
+        return new Set(this.exports);
+    }
+}

package/dist/api/generators/base/builders/IndexBuilder.d.ts

@@ -4,8 +4,8 @@
  * Automatically generates index files that export all types and functions
  * from a directory, with support for grouping and namespaces.
  */
-import type { CodegenLogger } from "../../../../utils/codegen-logger";
-import type { FileManager } from "../FileManager";
+import type { CodegenLogger } from "../../../../utils/codegen-logger.js";
+import type { FileManager } from "../FileManager.js";
 import type { TemplateEngine } from "../types";
 export interface IndexBuilderConfig {
     directory: string;

package/dist/api/generators/base/builders/IndexBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IndexBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/api/generators/base/builders/IndexBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,MAAM,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,gBAAgB,CAAC,CAAiC;IAC1D,OAAO,CAAC,YAAY,CAAC,CAAuD;gBAEhE,MAAM,EAAE,kBAAkB;IAItC;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAOlE;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAK9D;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY;IAOhE;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY;IAK5D;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY;IAO5C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAKxC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAKxC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAKxC;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,YAAY;IAKzD;;;OAGG;IACH,MAAM,CACL,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GACtD,YAAY;IAKf;;;OAGG;IACG,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkBhE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAU7B;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,OAAO,CAAC,eAAe;IAmDvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0C7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0C9B;;OAEG;IACH,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIjC;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAGnC"}
+{"version":3,"file":"IndexBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/api/generators/base/builders/IndexBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,MAAM,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,gBAAgB,CAAC,CAAiC;IAC1D,OAAO,CAAC,YAAY,CAAC,CAAuD;gBAEhE,MAAM,EAAE,kBAAkB;IAItC;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAOlE;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAK9D;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY;IAOhE;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY;IAK5D;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY;IAO5C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAKxC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAKxC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAKxC;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,YAAY;IAKzD;;;OAGG;IACH,MAAM,CACL,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GACtD,YAAY;IAKf;;;OAGG;IACG,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkBhE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAU7B;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,OAAO,CAAC,eAAe;IAmDvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0C7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0C9B;;OAEG;IACH,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIjC;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAGnC"}