@atomic-ehr/codegen 0.0.1-canary.20251006070905.fb6ed98 → 0.0.1-canary.20251006094042.7f0be72

package/dist/api/generators/base/BaseGenerator.d.ts

@@ -1,186 +0,0 @@
-/**
- * Abstract base generator class
- *
- * This is the foundation of the generator system. All language-specific generators
- * extend this class to inherit common functionality while implementing their own
- * specific logic for type mapping, content generation, and validation.
- */
-import type { TypeSchema } from "@typeschema/types";
-import type { CodegenLogger } from "../../../utils/codegen-logger";
-import { ErrorHandler, GeneratorErrorBoundary } from "./error-handler";
-import { FileManager } from "./FileManager";
-import type { BaseGeneratorOptions, GeneratedFile, GeneratorCapabilities, ProgressCallback, TemplateContext, TemplateEngine, TypeMapper } from "./types";
-/**
- * Abstract base generator class with comprehensive functionality
- *
- * Provides common functionality for all generators including:
- * - Schema validation and processing
- * - File management with fluent API
- * - Template processing
- * - Error handling and recovery
- * - Progress monitoring
- * - Performance optimization
- */
-export declare abstract class BaseGenerator<TOptions extends BaseGeneratorOptions = BaseGeneratorOptions, TResult extends GeneratedFile[] = GeneratedFile[]> {
-    /** Validated and merged options */
-    protected options: Required<TOptions>;
-    /** Logger instance for this generator */
-    protected readonly logger: CodegenLogger;
-    /** File manager for all file operations */
-    protected readonly fileManager: FileManager;
-    /** Template engine for content generation (optional) */
-    protected readonly templateEngine?: TemplateEngine;
-    /** Language-specific type mapper */
-    protected readonly typeMapper: TypeMapper;
-    /** Enhanced error handler for comprehensive error reporting */
-    protected readonly errorHandler: ErrorHandler;
-    /** Error boundary for catching and handling all generator errors */
-    protected readonly errorBoundary: GeneratorErrorBoundary;
-    /** Progress callback if provided */
-    private progressCallback?;
-    /** Generated files tracking */
-    private generatedFiles;
-    /** Generation start time for performance metrics */
-    private generationStartTime;
-    /** Cache for expensive operations */
-    private readonly cache;
-    constructor(options: TOptions);
-    /**
-     * Get the name of the target language (e.g., "TypeScript", "Python", "Rust")
-     */
-    protected abstract getLanguageName(): string;
-    /**
-     * Get the file extension for the target language (e.g., ".ts", ".py", ".rs")
-     */
-    protected abstract getFileExtension(): string;
-    /**
-     * Create a language-specific type mapper
-     */
-    protected abstract createTypeMapper(): TypeMapper;
-    /**
-     * Generate content for a single schema
-     * @param schema - The TypeSchema to generate code for
-     * @param context - Additional context for generation
-     */
-    protected abstract generateSchemaContent(schema: TypeSchema, context: TemplateContext): Promise<string>;
-    /**
-     * Validate generated content before writing
-     * @param content - The generated content
-     * @param context - The generation context
-     */
-    protected abstract validateContent(content: string, context: TemplateContext): Promise<void>;
-    /**
-     * Filter and sort schemas with language-specific logic
-     * @param schemas - Input schemas
-     */
-    protected abstract filterAndSortSchemas(schemas: TypeSchema[]): TypeSchema[];
-    /**
-     * Get generator capabilities - can be overridden for introspection
-     */
-    getCapabilities(): GeneratorCapabilities;
-    /**
-     * Create file manager instance - can be overridden for custom file handling
-     */
-    protected createFileManager(): FileManager;
-    /**
-     * Create template engine instance - can be overridden for custom templates
-     * Returns undefined if template engine is not needed
-     */
-    protected createTemplateEngine(): TemplateEngine | undefined;
-    /**
-     * Generate code from TypeSchema documents
-     * This is the main method that orchestrates the entire generation process
-     * @param schemas - Array of TypeSchema documents
-     */
-    generate(schemas: TypeSchema[]): Promise<TResult>;
-    /**
-     * Generate and return content without writing files (useful for testing)
-     * @param schemas - Array of TypeSchema documents
-     */
-    build(schemas: TypeSchema[]): Promise<TResult>;
-    /**
-     * Create a file builder for fluent file generation
-     * @param filename - Name of the file to create
-     */
-    file(filename: string): import("./builders/FileBuilder").FileBuilder;
-    /**
-     * Create a directory builder for batch operations
-     * @param path - Directory path relative to output directory
-     */
-    directory(path: string): import("./builders/DirectoryBuilder").DirectoryBuilder;
-    /**
-     * Create an index file builder
-     * @param directory - Directory to create index for
-     */
-    index(directory?: string): import("./builders/IndexBuilder").IndexBuilder;
-    /**
-     * Set progress callback for monitoring generation
-     * @param callback - Progress callback function
-     */
-    onProgress(callback: ProgressCallback): this;
-    /**
-     * Validate generator configuration
-     */
-    private validateConfiguration;
-    /**
-     * Merge options with defaults
-     */
-    private mergeWithDefaults;
-    /**
-     * Validate schemas before processing
-     */
-    private validateSchemas;
-    /**
-     * Validate individual schema
-     */
-    protected validateSchema(schema: TypeSchema): Promise<void>;
-    /**
-     * Detect circular references in schema dependencies
-     */
-    private detectCircularReferences;
-    /**
-     * Generate files from processed schemas
-     */
-    private generateFiles;
-    /**
-     * Generate a single file from a schema
-     */
-    private generateFileForSchema;
-    /**
-     * Ensure filename has correct extension
-     */
-    private ensureFileExtension;
-    /**
-     * Extract exported symbols from generated content
-     * Can be overridden by language-specific implementations
-     */
-    protected extractExports(content: string): string[];
-    /**
-     * Report progress to callback if provided
-     */
-    protected reportProgress(phase: "validation" | "generation" | "writing" | "complete", current: number, total: number, message?: string, schema?: TypeSchema): void;
-    /**
-     * Run post-generation hooks
-     * Can be overridden to add custom post-processing
-     */
-    protected runPostGenerationHooks(): Promise<void>;
-    /**
-     * Get cached value or compute and cache it
-     */
-    protected getCachedOrCompute<T>(key: string, computeFn: () => T | Promise<T>): T | Promise<T>;
-    /**
-     * Clear internal cache
-     */
-    protected clearCache(): void;
-    /**
-     * Get generation statistics
-     */
-    getGenerationStats(): {
-        filesGenerated: number;
-        totalSize: number;
-        averageFileSize: number;
-        generationTime: number;
-        averageTimePerFile: number;
-        cacheHitRate: number;
-    };
-}