@zintrust/core 0.1.28 → 0.1.30

package/src/boot/bootstrap.js

@@ -0,0 +1,232 @@
+/**
+ * Application Bootstrap
+ * Entry point for running the ZinTrust server
+ * Sealed namespace for immutability
+ */
+import { Application } from './Application.js';
+import { Server } from './Server.js';
+import { appConfig } from '../config/app.js';
+import { Env } from '../config/env.js';
+import { Logger } from '../config/logger.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+let appInstance;
+let serverInstance;
+let isShuttingDown = false;
+let shutdownHandlersRegistered = false;
+const logBootstrapErrorDetails = (error) => {
+    // Best-effort: surface startup config validation details (already redacted)
+    // so container runs show which env vars are missing/misconfigured.
+    try {
+        const details = error?.details;
+        if (details?.errors !== undefined) {
+            Logger.error('Startup configuration errors:', details.errors);
+        }
+    }
+    catch {
+        // best-effort logging
+    }
+    // Best-effort: surface startup health-check report details.
+    try {
+        const details = error?.details;
+        if (details?.report !== undefined) {
+            Logger.error('Startup health report:', details.report);
+        }
+    }
+    catch {
+        // best-effort logging
+    }
+};
+const startSchedulesIfNeeded = async (app) => {
+    try {
+        const runtime = appConfig.detectRuntime();
+        if (runtime !== 'nodejs' && runtime !== 'fargate')
+            return;
+        const { create: createScheduleRunner } = await import('../scheduler/ScheduleRunner.js');
+        const schedules = await import('../schedules/index.js');
+        const runner = createScheduleRunner();
+        for (const schedule of Object.values(schedules)) {
+            // Each schedule is expected to export a default ISchedule
+            // @ts-ignore
+            runner.register(schedule);
+        }
+        runner.start();
+        // Add shutdown hook to stop schedules gracefully
+        const shutdownManager = app.getContainer().get('shutdownManager');
+        if ((typeof shutdownManager === 'object' || typeof shutdownManager === 'function') &&
+            shutdownManager !== null &&
+            'add' in shutdownManager &&
+            typeof shutdownManager.add === 'function') {
+            shutdownManager.add(async () => {
+                const scheduleTimeoutMs = Env.getInt('SCHEDULE_SHUTDOWN_TIMEOUT_MS', 30000);
+                await runner.stop(scheduleTimeoutMs);
+            });
+        }
+    }
+    catch (err) {
+        Logger.warn('Failed to start schedules:', err);
+    }
+};
+const withTimeout = async (promise, timeoutMs, label) => {
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0)
+        return promise;
+    let timeoutId;
+    try {
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = globalThis.setTimeout(() => {
+                reject(ErrorFactory.createGeneralError(label, { timeoutMs }));
+            }, timeoutMs);
+        });
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        if (timeoutId !== undefined)
+            globalThis.clearTimeout(timeoutId);
+    }
+};
+const gracefulShutdown = async (signal) => {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    const shutdownBudgetMs = Env.getInt('SHUTDOWN_TIMEOUT', 1500);
+    const minForceExitMs = shutdownBudgetMs + 250;
+    const forceExitMs = Math.max(Env.getInt('SHUTDOWN_FORCE_EXIT_MS', 10000), minForceExitMs);
+    const deadlineMs = Date.now() + shutdownBudgetMs;
+    const remainingMs = () => Math.max(0, deadlineMs - Date.now());
+    Logger.info(`${signal} received, shutting down gracefully...`);
+    try {
+        const forceExitTimer = globalThis.setTimeout(() => {
+            process.exit(0);
+        }, forceExitMs);
+        // Best-effort: don't keep the process alive just for this timer
+        forceExitTimer.unref?.();
+        await withTimeout((async () => {
+            // Shutdown worker management system FIRST (before database closes)
+            if (appConfig.detectRuntime() === 'nodejs' || appConfig.detectRuntime() === 'lambda') {
+                try {
+                    const { WorkerShutdown } = await import('../../packages/workers/src/index.js');
+                    const workerBudgetMs = Math.min(15000, remainingMs());
+                    await withTimeout(WorkerShutdown.shutdown({ signal, timeout: workerBudgetMs, forceExit: false }), workerBudgetMs, 'Worker shutdown timed out');
+                }
+                catch (error) {
+                    Logger.warn('Worker shutdown failed (continuing with app shutdown)', error);
+                }
+            }
+            if (serverInstance !== undefined) {
+                await serverInstance.close();
+            }
+            if (appInstance !== undefined) {
+                try {
+                    const appBudgetMs = Math.min(5000, remainingMs());
+                    await withTimeout(appInstance.shutdown(), appBudgetMs, 'App shutdown timed out');
+                }
+                catch (error) {
+                    Logger.warn('App shutdown failed or timed out, forcing exit', error);
+                }
+            }
+        })(), shutdownBudgetMs, 'Graceful shutdown timed out');
+        globalThis.clearTimeout(forceExitTimer);
+        process.exit(0);
+    }
+    catch (error) {
+        Logger.error('Graceful shutdown failed:', error);
+        process.exit(1);
+    }
+};
+async function useWorkerStarter() {
+    // Initialize worker management system
+    let workerInit = null;
+    try {
+        const { WorkerInit } = await import('../../packages/workers/src/index.js');
+        workerInit = WorkerInit;
+        await WorkerInit.initialize({
+            enableResourceMonitoring: true,
+            enableHealthMonitoring: true,
+            enableAutoScaling: false, // Disabled by default, enable via config
+            registerShutdownHandlers: true,
+            resourceMonitoringInterval: 60000,
+        });
+        Logger.info('Worker management system initialized');
+    }
+    catch (error) {
+        Logger.warn('Worker management system initialization failed (non-fatal)', error);
+        // Non-fatal - application can still run without worker management
+    }
+    if (workerInit?.autoStartPersistedWorkers) {
+        await workerInit.autoStartPersistedWorkers();
+    }
+}
+/**
+ * Bootstrap implementation
+ */
+const BootstrapFunctions = Object.freeze({
+    /**
+     * Bootstrap and start the server
+     */
+    async start() {
+        try {
+            // Ensure project-installed adapters/drivers are registered for web server.
+            // (This is driven by src/zintrust.plugins.ts generated by `zin plugin install`.)
+            try {
+                const { PluginAutoImports } = await import('../runtime/PluginAutoImports.js');
+                await PluginAutoImports.tryImportProjectAutoImports();
+            }
+            catch (error) {
+                // best-effort; run without plugins if loader fails (e.g. non-Node runtime)
+                Logger.debug('Plugin auto-imports loader skipped:', error);
+            }
+            // Create application instance
+            // if (Env.ZINTRUST_PROJECT_ROOT) {
+            // }
+            const app = Application.create(Env.ZINTRUST_PROJECT_ROOT || undefined);
+            appInstance = app;
+            // Boot application
+            await app.boot();
+            // Get port and host from environment
+            const port = Env.getInt('PORT', 7777);
+            const host = Env.get('HOST', 'localhost');
+            // Create and start server
+            const server = Server.create(app, port, host);
+            serverInstance = server;
+            // Start listening
+            await server.listen();
+            Logger.info(`Server running at http://${host}:${port}`);
+            Logger.info(`ZinTrust documentation at http://${host}:${port}/doc`);
+            // Start schedules for long-running runtimes (Node.js / Fargate)
+            await startSchedulesIfNeeded(app);
+            if (appConfig.detectRuntime() === 'nodejs' || appConfig.detectRuntime() === 'lambda') {
+                await useWorkerStarter();
+            }
+        }
+        catch (error) {
+            Logger.error('Failed to bootstrap application:', error);
+            logBootstrapErrorDetails(error);
+            process.exit(1);
+        }
+    },
+    /**
+     * Handle graceful shutdown
+     */
+    setupShutdownHandler() {
+        if (shutdownHandlersRegistered)
+            return;
+        shutdownHandlersRegistered = true;
+        process.on('SIGTERM', async () => {
+            await gracefulShutdown('SIGTERM');
+        });
+        process.on('SIGINT', async () => {
+            await gracefulShutdown('SIGINT');
+        });
+    },
+});
+// Run bootstrap
+await BootstrapFunctions.start().catch((error) => {
+    try {
+        Logger.error('Failed to bootstrap application:', error);
+    }
+    catch {
+        // best-effort logging
+    }
+    process.exit(1);
+});
+// Handle graceful shutdown
+BootstrapFunctions.setupShutdownHandler();

package/src/builder/BundleOptimizer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Bundle Optimizer for ZinTrust Framework
+ * Reduces deployment package size by:
+ * - Tree-shaking unused ORM adapters
+ * - Minifying compiled JavaScript
+ * - Removing dev dependencies
+ * - Inlining configuration
+ */
+export interface OptimizationOptions {
+    platform: 'lambda' | 'cloudflare' | 'deno' | 'fargate';
+    targetSize?: number;
+    analyzeOnly?: boolean;
+    verbose?: boolean;
+}
+export interface BundleAnalysis {
+    platform: string;
+    totalSize: number;
+    files: Array<{
+        path: string;
+        size: number;
+        percentage: number;
+    }>;
+    recommendations: string[];
+}
+export interface IBundleOptimizer {
+    optimize(): Promise<BundleAnalysis>;
+}
+/**
+ * Bundle optimizer - reduces deployed package size
+ * Sealed namespace for immutability
+ */
+export declare const BundleOptimizer: Readonly<{
+    /**
+     * Create a new bundle optimizer instance
+     */
+    create(options: OptimizationOptions): IBundleOptimizer;
+}>;
+/**
+ * CLI command for bundle optimization
+ */
+export declare function runOptimizer(): Promise<void>;
+//# sourceMappingURL=BundleOptimizer.d.ts.map

package/src/builder/BundleOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BundleOptimizer.d.ts","sourceRoot":"","sources":["../../../src/builder/BundleOptimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;oBACa,mBAAmB,GAAG,gBAAgB;EA0CtD,CAAC;AA4XH;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAclD"}

package/src/builder/BundleOptimizer.js

@@ -0,0 +1,352 @@
+/**
+ * Bundle Optimizer for ZinTrust Framework
+ * Reduces deployment package size by:
+ * - Tree-shaking unused ORM adapters
+ * - Minifying compiled JavaScript
+ * - Removing dev dependencies
+ * - Inlining configuration
+ */
+import { Logger } from '../config/logger.js';
+import fs from '../node-singletons/fs.js';
+import * as path from '../node-singletons/path.js';
+/**
+ * Bundle optimizer - reduces deployed package size
+ * Sealed namespace for immutability
+ */
+export const BundleOptimizer = Object.freeze({
+    /**
+     * Create a new bundle optimizer instance
+     */
+    create(options) {
+        const distDir = path.resolve('dist');
+        return {
+            /**
+             * Run optimization for target platform
+             */
+            async optimize() {
+                Logger.info(`\n🔧 Optimizing bundle for ${options.platform} platform...`);
+                // Analyze current bundle
+                const analysis = await analyze(distDir, options);
+                if (options.analyzeOnly === true) {
+                    printAnalysis(analysis);
+                    return analysis;
+                }
+                // Apply platform-specific optimizations
+                switch (options.platform) {
+                    case 'lambda':
+                        await optimizeForLambda(distDir, options);
+                        break;
+                    case 'cloudflare':
+                        await optimizeForCloudflare(distDir, options);
+                        break;
+                    case 'deno':
+                        await optimizeForDeno(distDir, options);
+                        break;
+                    case 'fargate':
+                        await optimizeForFargate(distDir, options);
+                        break;
+                }
+                // Re-analyze after optimizations
+                const optimized = await analyze(distDir, options);
+                printAnalysis(optimized);
+                return optimized;
+            },
+        };
+    },
+});
+/**
+ * Get all files recursively
+ */
+async function getFilesRecursive(dir) {
+    if (!fs.existsSync(dir)) {
+        return [];
+    }
+    const entries = await fs.promises.readdir(dir, { withFileTypes: true });
+    const nested = await Promise.all(entries.map(async (entry) => {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            return getFilesRecursive(fullPath);
+        }
+        return [fullPath];
+    }));
+    return nested.flat();
+}
+/**
+ * Generate optimization recommendations
+ */
+function generateRecommendations(files, totalSize, options) {
+    const recommendations = [];
+    const sizeInMb = totalSize / (1024 * 1024);
+    if (sizeInMb > 100) {
+        recommendations.push('❌ Bundle exceeds 100 MB - remove unnecessary files');
+    }
+    // Find largest files
+    const largest = files.slice(0, 3);
+    for (const file of largest) {
+        if (file.percentage > 20) {
+            recommendations.push(`⚠️  ${file.path} is ${file.percentage.toFixed(1)}% of bundle`);
+        }
+    }
+    if (options.platform === 'cloudflare' && sizeInMb > 1) {
+        recommendations.push('⚠️  Cloudflare Workers: Bundle > 1 MB, consider upgrading plan');
+    }
+    if (recommendations.length === 0) {
+        recommendations.push('✅ Bundle is well-optimized');
+    }
+    return recommendations;
+}
+/**
+ * Print analysis report
+ */
+function printAnalysis(analysis) {
+    const sizeInMb = (analysis.totalSize / (1024 * 1024)).toFixed(2);
+    const sizeInKb = (analysis.totalSize / 1024).toFixed(2);
+    Logger.info(`\n📊 Bundle Analysis (${analysis.platform})`);
+    Logger.info(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+    Logger.info(`Total Size: ${sizeInMb} MB (${sizeInKb} KB)`);
+    Logger.info(`Files: ${analysis.files.length}\n`);
+    // Show top 10 largest files
+    const topFiles = analysis.files.slice(0, 10);
+    for (const file of topFiles) {
+        const bar = '█'.repeat(Math.round(file.percentage / 2));
+        Logger.info(`  ${file.path.padEnd(40)} ${(file.size / 1024).toFixed(1).padStart(8)} KB  ${bar}`);
+    }
+    // Recommendations
+    if (analysis.recommendations.length > 0) {
+        Logger.info('\n💡 Recommendations:');
+        for (const rec of analysis.recommendations) {
+            Logger.info(`  ${rec}`);
+        }
+    }
+    Logger.info('\n');
+}
+/**
+ * Analyze bundle structure
+ */
+async function analyze(distDir, options) {
+    const files = await getFilesRecursive(distDir);
+    // Collect sizes concurrently but avoid shared mutable state by computing sizes
+    // and then reducing the total afterwards to avoid race conditions.
+    const fileAnalysis = await Promise.all(files.map(async (file) => {
+        const stats = await fs.promises.stat(file);
+        const size = stats.size;
+        return {
+            path: path.relative(distDir, file),
+            size,
+            percentage: 0,
+        };
+    }));
+    // Compute total size in a single pass (no shared mutation)
+    const totalSize = fileAnalysis.reduce((acc, f) => acc + f.size, 0);
+    // Calculate percentages
+    fileAnalysis.forEach((f) => {
+        f.percentage = totalSize > 0 ? (f.size / totalSize) * 100 : 0;
+    });
+    // Sort by size descending
+    fileAnalysis.sort((a, b) => b.size - a.size);
+    return {
+        platform: options.platform,
+        totalSize,
+        files: fileAnalysis,
+        recommendations: generateRecommendations(fileAnalysis, totalSize, options),
+    };
+}
+/**
+ * Remove unused ORM adapters
+ */
+async function removeUnusedAdapters(distDir, options, ...adapters) {
+    const adapterDir = path.join(distDir, 'orm', 'adapters');
+    await Promise.all(adapters.map(async (adapter) => {
+        const files = [`${adapter}Adapter.js`, `${adapter}Adapter.d.ts`];
+        await Promise.all(files.map(async (file) => {
+            const filePath = path.join(adapterDir, file);
+            if (fs.existsSync(filePath)) {
+                await fs.promises.unlink(filePath);
+                if (options.verbose === true) {
+                    Logger.info(`  ✓ Removed ${adapter} adapter`);
+                }
+            }
+        }));
+    }));
+}
+/**
+ * Remove dev dependencies from node_modules
+ */
+async function removeDevDependencies(distDir, options) {
+    const nmDir = path.join(distDir, '..', 'node_modules');
+    const devDeps = [
+        '@types',
+        '@typescript-eslint',
+        'typescript',
+        'eslint',
+        'prettier',
+        'vitest',
+        '@vitest/coverage-v8',
+        'sonar-scanner',
+        'tsx',
+    ];
+    if (!fs.existsSync(nmDir))
+        return;
+    await Promise.all(devDeps.map(async (dep) => {
+        const depPath = path.join(nmDir, dep);
+        if (fs.existsSync(depPath)) {
+            await fs.promises.rm(depPath, { recursive: true });
+            if (options.verbose === true) {
+                Logger.info(`  ✓ Removed ${dep}`);
+            }
+        }
+    }));
+}
+/**
+ * Minify JavaScript files
+ */
+// eslint-disable-next-line @typescript-eslint/require-await
+async function minifyJavaScript(_aggressive = false) {
+    Logger.info('  → Minifying JavaScript...');
+    // In production, would use esbuild or terser
+    // This is a placeholder showing the pattern
+    Logger.info('  ✓ JavaScript minified');
+}
+/**
+ * Remove a specific module
+ */
+async function removeModule(distDir, options, modulePath) {
+    const distModule = modulePath.replace('src/', `${distDir}/`).replace('.ts', '.js');
+    if (fs.existsSync(distModule)) {
+        await fs.promises.unlink(distModule);
+        const dtsPath = distModule.replace('.js', '.d.ts');
+        if (fs.existsSync(dtsPath)) {
+            await fs.promises.unlink(dtsPath);
+        }
+        if (options.verbose === true) {
+            Logger.info(`  ✓ Removed module: ${modulePath}`);
+        }
+    }
+}
+/**
+ * Check if module is used
+ */
+function hasUsedModule(_moduleName) {
+    // Placeholder - would check imports in compiled code
+    return true;
+}
+/**
+ * Remove unused middleware
+ */
+async function removeUnusedMiddleware(distDir, options) {
+    const middlewareDir = path.join(distDir, 'middleware');
+    // Keep only essential middleware, remove optional ones
+    const optionalMiddleware = ['logging.js', 'profiling.js', 'rateLimit.js'];
+    if (!fs.existsSync(middlewareDir))
+        return;
+    await Promise.all(optionalMiddleware.map(async (file) => {
+        const filePath = path.join(middlewareDir, file);
+        if (fs.existsSync(filePath)) {
+            await fs.promises.unlink(filePath);
+            if (options.verbose === true) {
+                Logger.info(`  ✓ Removed middleware: ${file}`);
+            }
+        }
+    }));
+}
+/**
+ * Inline small files to reduce overhead
+ */
+function inlineSmallFiles(threshold) {
+    Logger.info(`  → Inlining files smaller than ${(threshold / 1024).toFixed(0)} KB...`);
+    // Placeholder for actual inlining logic
+}
+/**
+ * Remove files matching patterns
+ */
+async function removeFiles(distDir, options, patterns) {
+    const files = await getFilesRecursive(distDir);
+    const filesToRemove = files.filter((file) => patterns.some((pattern) => file.includes(pattern)));
+    await Promise.all(filesToRemove.map(async (file) => {
+        await fs.promises.unlink(file);
+        if (options.verbose === true) {
+            Logger.info(`  ✓ Removed ${path.relative(distDir, file)}`);
+        }
+    }));
+}
+/**
+ * Optimize for AWS Lambda (2-3 MB limit for direct upload)
+ */
+async function optimizeForLambda(distDir, options) {
+    Logger.info('📦 Optimizing for Lambda...');
+    // Remove unused ORM adapters
+    await removeUnusedAdapters(distDir, options, 'mysql', 'sqlserver', 'd1');
+    // Remove dev dependencies from node_modules
+    await removeDevDependencies(distDir, options);
+    // Minify all JS files
+    await minifyJavaScript();
+    // Remove unused security modules if not needed
+    if (!hasUsedModule('CsrfTokenManager')) {
+        await removeModule(distDir, options, 'src/security/CsrfTokenManager.ts');
+    }
+    Logger.info('✅ Lambda optimization complete');
+}
+/**
+ * Optimize for Cloudflare Workers (<1 MB limit)
+ */
+async function optimizeForCloudflare(distDir, options) {
+    Logger.info('⚡ Optimizing for Cloudflare Workers (strict <1 MB limit)...');
+    // Remove ALL unused adapters except cloudflare
+    await removeUnusedAdapters(distDir, options, 'postgresql', 'mysql', 'sqlserver');
+    // Remove Node.js HTTP server adapter
+    await removeModule(distDir, options, 'src/runtime/adapters/NodeServerAdapter.ts');
+    // Minify aggressively
+    await minifyJavaScript(true);
+    // Tree-shake unused middleware
+    await removeUnusedMiddleware(distDir, options);
+    // Inline small files
+    inlineSmallFiles(10240); // 10 KB threshold
+    // Check size limit
+    const optimized = await analyze(distDir, options);
+    const sizeInMb = optimized.totalSize / (1024 * 1024);
+    if (sizeInMb > 1) {
+        Logger.warn(`⚠️  Bundle size ${sizeInMb.toFixed(2)} MB exceeds 1 MB limit. Consider using Workers paid plan.`);
+    }
+    Logger.info('✅ Cloudflare Workers optimization complete');
+}
+/**
+ * Optimize for Deno Deploy
+ */
+async function optimizeForDeno(distDir, options) {
+    Logger.info('🦕 Optimizing for Deno Deploy...');
+    // Remove Node.js-specific modules
+    await removeModule(distDir, options, 'src/runtime/adapters/NodeServerAdapter.ts');
+    await removeModule(distDir, options, 'src/runtime/adapters/LambdaAdapter.ts');
+    // Keep Deno adapter only
+    await removeModule(distDir, options, 'src/runtime/adapters/CloudflareAdapter.ts');
+    // Minify
+    await minifyJavaScript();
+    Logger.info('✅ Deno optimization complete');
+}
+/**
+ * Optimize for Fargate (can be larger, but faster startup)
+ */
+async function optimizeForFargate(distDir, options) {
+    Logger.info('🐳 Optimizing for Fargate...');
+    // Keep all adapters for flexibility
+    // Only remove unnecessary test files
+    await removeFiles(distDir, options, ['.test.ts', '.spec.ts', '.test.js', '.spec.js']);
+    // Light minification
+    await minifyJavaScript(false);
+    Logger.info('✅ Fargate optimization complete');
+}
+/**
+ * CLI command for bundle optimization
+ */
+export async function runOptimizer() {
+    const platform = process.argv[2] || 'lambda';
+    const targetSize = process.argv[3] ? Number.parseInt(process.argv[3], 10) : undefined;
+    const optimizer = BundleOptimizer.create({
+        platform,
+        targetSize,
+        verbose: true,
+    });
+    const analysis = await optimizer.optimize();
+    const sizeInMb = (analysis.totalSize / (1024 * 1024)).toFixed(2);
+    Logger.info(`\n✅ Optimization complete. Final size: ${sizeInMb} MB`);
+}

package/src/cache/Cache.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Cache Manager
+ * Central cache management and driver resolution
+ * Sealed namespace pattern - all exports through Cache namespace
+ */
+import type { CacheDriver } from './CacheDriver';
+type CacheStore = Readonly<{
+    get: <T>(key: string) => Promise<T | null>;
+    set: <T>(key: string, value: T, ttl?: number) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    clear: () => Promise<void>;
+    has: (key: string) => Promise<boolean>;
+    getDriver: () => CacheDriver;
+}>;
+export declare const Cache: Readonly<{
+    get: <T>(key: string) => Promise<T | null>;
+    set: <T>(key: string, value: T, ttl?: number) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    clear: () => Promise<void>;
+    has: (key: string) => Promise<boolean>;
+    getDriver: () => CacheDriver;
+    store: (name?: string) => CacheStore;
+    reset: () => void;
+}>;
+/**
+ * Helper alias for cache
+ */
+export declare const cache: Readonly<{
+    get: <T>(key: string) => Promise<T | null>;
+    set: <T>(key: string, value: T, ttl?: number) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    clear: () => Promise<void>;
+    has: (key: string) => Promise<boolean>;
+    getDriver: () => CacheDriver;
+    store: (name?: string) => CacheStore;
+    reset: () => void;
+}>;
+export {};
+//# sourceMappingURL=Cache.d.ts.map

package/src/cache/Cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmHtD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC,CAAC;AA0CH,eAAO,MAAM,KAAK;UA1FC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAQlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAOjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAOtB,OAAO,CAAC,IAAI,CAAC;eAOb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAQ3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAmCvB,IAAI;EAcpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UAxGC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAQlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAOjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAOtB,OAAO,CAAC,IAAI,CAAC;eAOb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAQ3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAmCvB,IAAI;EAmBI,CAAC"}