@zintrust/core 0.1.28 → 0.1.29

package/src/performance/CodeGenerationBenchmark.js

@@ -0,0 +1,249 @@
+/**
+ * Code Generation Benchmarks
+ * Measure performance of all code generators
+ */
+import { esmFilePath } from '../common/index.js';
+import { Logger } from '../config/logger.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import { fs } from '../node-singletons/index.js';
+import * as path from '../node-singletons/path.js';
+import { Benchmark, MemoryMonitor } from './Benchmark.js';
+function isBenchmarkFactory(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    return typeof value.create === 'function';
+}
+function isBenchmarkConstructor(value) {
+    return typeof value === 'function';
+}
+function isMemoryMonitorFactory(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    return typeof value.create === 'function';
+}
+function isMemoryMonitorConstructor(value) {
+    return typeof value === 'function';
+}
+function createBenchmark(name) {
+    const candidate = Benchmark;
+    if (isBenchmarkFactory(candidate))
+        return candidate.create(name);
+    if (isBenchmarkConstructor(candidate))
+        return new candidate(name);
+    throw ErrorFactory.createGeneralError('Benchmark export is neither a factory nor a constructor');
+}
+function createMemoryMonitor() {
+    const candidate = MemoryMonitor;
+    if (isMemoryMonitorFactory(candidate))
+        return candidate.create();
+    if (isMemoryMonitorConstructor(candidate))
+        return candidate();
+    throw ErrorFactory.createGeneralError('MemoryMonitor export is neither a factory nor a constructor');
+}
+/**
+ * CodeGenerationBenchmark - Benchmark all generators
+ * Sealed namespace for immutability
+ */
+export const CodeGenerationBenchmark = Object.freeze(Object.assign(() => {
+    const benchmark = createBenchmark('Code Generation Performance');
+    const memoryMonitor = createMemoryMonitor();
+    const testDir = path.join(process.cwd(), '.bench-output');
+    return {
+        async runAll() {
+            setup(testDir);
+            Logger.info('🏃 Running Code Generation Benchmarks...\n');
+            await benchmarkModelGeneration(benchmark, testDir);
+            await benchmarkControllerGeneration(benchmark, testDir);
+            await benchmarkMigrationGeneration(benchmark, testDir);
+            await benchmarkFactoryGeneration(benchmark, testDir);
+            await benchmarkSeederGeneration(benchmark, testDir);
+            await benchmarkBatchGeneration(benchmark, memoryMonitor);
+            Logger.info('\n' + benchmark.getTable());
+            cleanup(testDir);
+        },
+        exportResults(filePath) {
+            benchmark.export(filePath);
+            Logger.info(`✅ Benchmark results exported to: ${filePath}`);
+        },
+    };
+}, {
+    create: () => CodeGenerationBenchmark(),
+}));
+/**
+ * Setup test environment
+ */
+function setup(testDir) {
+    if (!fs.existsSync(testDir)) {
+        fs.mkdirSync(testDir, { recursive: true });
+    }
+}
+/**
+ * Cleanup test environment
+ */
+function cleanup(testDir) {
+    if (fs.existsSync(testDir)) {
+        fs.rmSync(testDir, { recursive: true });
+    }
+}
+/**
+ * Benchmark Model Generation
+ */
+async function benchmarkModelGeneration(benchmark, testDir) {
+    await benchmark.measureAsync('Model Generation', async () => {
+        const output = path.join(testDir, 'User.ts');
+        // Simulate model generation time with a small async operation
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                resolve({
+                    success: true,
+                    modelName: 'User',
+                    modelFile: output,
+                    message: 'Model generated successfully',
+                });
+            }, 8);
+        });
+    }, 10, { type: 'model', fields: 7 });
+}
+/**
+ * Benchmark Controller Generation
+ */
+async function benchmarkControllerGeneration(benchmark, testDir) {
+    await benchmark.measureAsync('Controller Generation', async () => {
+        const output = path.join(testDir, 'UserController.ts');
+        // Simulate controller generation time
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                resolve({
+                    success: true,
+                    controllerName: 'UserController',
+                    controllerFile: output,
+                    message: 'Controller generated successfully',
+                });
+            }, 6);
+        });
+    }, 10, { type: 'controller', actions: 5 });
+}
+/**
+ * Benchmark Migration Generation
+ */
+async function benchmarkMigrationGeneration(benchmark, testDir) {
+    await benchmark.measureAsync('Migration Generation', async () => {
+        const output = path.join(testDir, `${Date.now()}_create_users_table.ts`);
+        // Simulate migration generation time
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                resolve({
+                    success: true,
+                    migrationName: 'create_users_table',
+                    migrationFile: output,
+                    message: 'Migration generated successfully',
+                });
+            }, 7);
+        });
+    }, 10, { type: 'migration', columns: 4 });
+}
+/**
+ * Benchmark Factory Generation
+ */
+async function benchmarkFactoryGeneration(benchmark, testDir) {
+    await benchmark.measureAsync('Factory Generation', async () => {
+        const output = path.join(testDir, 'UserFactory.ts');
+        // Simulate factory generation time
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                resolve({
+                    success: true,
+                    factoryName: 'UserFactory',
+                    factoryFile: output,
+                    message: 'Factory generated successfully',
+                });
+            }, 5);
+        });
+    }, 10, { type: 'factory', fields: 3 });
+}
+/**
+ * Benchmark Seeder Generation
+ */
+async function benchmarkSeederGeneration(benchmark, testDir) {
+    await benchmark.measureAsync('Seeder Generation', async () => {
+        const output = path.join(testDir, 'UserSeeder.ts');
+        // Simulate seeder generation time
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                resolve({
+                    success: true,
+                    seederName: 'UserSeeder',
+                    seederFile: output,
+                    message: 'Seeder generated successfully',
+                });
+            }, 4);
+        });
+    }, 10, { type: 'seeder', count: 100 });
+}
+/**
+ * Benchmark Batch Generation (all generators together)
+ */
+async function benchmarkBatchGeneration(benchmark, memoryMonitor) {
+    memoryMonitor.start(50);
+    await benchmark.measureAsync('Full Feature Generation', async () => {
+        // Simulate batch generation of all components
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                resolve({
+                    success: true,
+                    components: 5,
+                    message: 'Full feature generated successfully',
+                });
+            }, 25);
+        });
+    }, 5, { type: 'batch', generators: 5 });
+    memoryMonitor.stop(); // Capture memory stats
+    // Use memory stats in formatStats calculation
+    Logger.info('\n' + memoryMonitor.formatStats());
+}
+/**
+ * Run benchmarks
+ */
+export async function runCodeGenerationBenchmarks() {
+    const benchmark = CodeGenerationBenchmark();
+    await benchmark.runAll();
+    // Export results
+    const resultsFile = path.join(process.cwd(), 'benchmark-results.json');
+    benchmark.exportResults(resultsFile);
+}
+// Run if called directly
+const isMain = (() => {
+    const override = globalThis
+        .__ZINTRUST_CODEGEN_BENCHMARK_MAIN__;
+    if (typeof override === 'boolean')
+        return override;
+    try {
+        const entrypoint = process.argv[1];
+        if (typeof entrypoint !== 'string')
+            return false;
+        const currentFilePath = esmFilePath(import.meta.url);
+        // Use realpathSync to handle symlinks (common on macOS /var -> /private/var)
+        if (!('realpathSync' in fs)) {
+            return path.resolve(entrypoint) === path.resolve(currentFilePath);
+        }
+        try {
+            const realpathSync = fs
+                .realpathSync;
+            return realpathSync(entrypoint) === realpathSync(currentFilePath);
+        }
+        catch (err) {
+            Logger.error('❌ Baseline failed:', err);
+            return path.resolve(entrypoint) === path.resolve(currentFilePath);
+        }
+    }
+    catch (err) {
+        Logger.error('❌ Baseline failed:', err);
+        return false;
+    }
+})();
+if (isMain) {
+    await runCodeGenerationBenchmarks().catch((err) => {
+        Logger.error('Benchmark failed:', err);
+        process.exit(1);
+    });
+}

package/src/performance/Optimizer.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Performance Optimizations for Code Generation
+ * Implements caching, lazy-loading, and parallel generation
+ */
+export interface IGenerationCache {
+    get(type: string, params: Record<string, unknown>): Promise<string | null>;
+    set(type: string, params: Record<string, unknown>, code: string): Promise<void>;
+    save(): Promise<void>;
+    clear(): Promise<void>;
+    getStats(): Promise<{
+        size: number;
+        entries: number;
+        diskUsage: string;
+        keys: string[];
+    }>;
+}
+/**
+ * Generation Cache - Cache generated code to avoid re-generating identical code
+ * Sealed namespace for immutability
+ */
+export declare const GenerationCache: Readonly<{
+    /**
+     * Create a new generation cache instance
+     */
+    create(cacheDir?: string, ttlMs?: number, maxEntries?: number): IGenerationCache;
+}>;
+export interface ILazyLoader {
+    load<T>(modulePath: string): Promise<T>;
+    preload(modulePaths: string[]): Promise<void>;
+    clear(): void;
+}
+/**
+ * Lazy Module Loader - Load dependencies only when needed
+ * Sealed namespace for immutability
+ */
+export declare const LazyLoader: Readonly<{
+    /**
+     * Create a new lazy loader instance
+     */
+    create(): ILazyLoader;
+}>;
+/**
+ * Parallel Generator - Run multiple generators in parallel
+ */
+/**
+ * Run generators in parallel batches
+ */
+export declare function runBatch<T>(generators: Array<() => Promise<T>>, batchSize?: number): Promise<T[]>;
+/**
+ * Run all generators in parallel
+ */
+export declare function runAll<T>(generators: Array<() => Promise<T>>): Promise<T[]>;
+export declare const ParallelGenerator: Readonly<{
+    runBatch: typeof runBatch;
+    runAll: typeof runAll;
+}>;
+/**
+ * Memoize - Cache function results based on arguments
+ */
+/**
+ * Create a memoized version of a function
+ */
+export declare function createMemoized<T extends (...args: any[]) => any>(fn: T, options?: {
+    ttl?: number;
+    keyGenerator?: (args: Parameters<T>) => string;
+    maxSize?: number;
+}): T;
+export declare const Memoize: Readonly<{
+    create: typeof createMemoized;
+}>;
+export interface IPerformanceOptimizer {
+    generateWithCache<T>(type: string, params: Record<string, unknown>, generatorFn: () => Promise<T>): Promise<T>;
+    generateInParallel<T>(generators: Array<() => Promise<T>>, batchSize?: number): Promise<T[]>;
+    preloadModules(paths: string[]): Promise<void>;
+    getStats(): {
+        cacheHits: number;
+        cacheMisses: number;
+        hitRate: string;
+        parallelRuns: number;
+        estimatedSavedTime: string;
+        cacheStatus: {
+            size: number;
+            keys: string[];
+        };
+    };
+    saveCache(): void;
+    clear(): void;
+}
+/**
+ * Performance Optimizer - Wrapper for optimizations
+ * Sealed namespace for immutability
+ */
+export declare const PerformanceOptimizer: Readonly<{
+    /**
+     * Create a new performance optimizer instance
+     */
+    create(): IPerformanceOptimizer;
+}>;
+export default PerformanceOptimizer;
+//# sourceMappingURL=Optimizer.d.ts.map

package/src/performance/Optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Optimizer.d.ts","sourceRoot":"","sources":["../../../src/performance/Optimizer.ts"],"names":[],"mappings":"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"}