noormme 1.1.0 → 1.2.0

package/dist/esm/noormme.js

@@ -81,7 +81,9 @@ export class NOORMME {
         this.dialect = this.createDialect();
         this.db = new Kysely({
             dialect: this.dialect,
-            log: this.config.logging?.enabled ? this.logger.createKyselyLogger() : undefined
+            log: this.config.logging?.enabled
+                ? this.logger.createKyselyLogger()
+                : undefined,
         });
         // Initialize core components
         this.schemaDiscovery = new SchemaDiscovery(this.db, this.config.introspection, this.dialect);
@@ -95,7 +97,7 @@ export class NOORMME {
                 : null,
             schema: new AgentSchemaHelper(this.db, agenticConfig),
             cortex: new Cortex(this.db, this.config),
-            evolution: new SchemaEvolutionHelper(this.db)
+            evolution: new SchemaEvolutionHelper(this.db),
         };
         this.repositoryFactory = new RepositoryFactory(this.db, this.config.performance, this.agent.cortex);
         this.relationshipEngine = new RelationshipEngine(this.db, this.config.performance);
@@ -162,7 +164,7 @@ export class NOORMME {
                 schemaInfo = {
                     tables: [],
                     relationships: [],
-                    views: []
+                    views: [],
                 };
             }
             // Generate types - handle empty schema gracefully
@@ -178,7 +180,7 @@ export class NOORMME {
                 generatedTypes = {
                     entities: [],
                     relationships: [],
-                    types: {}
+                    types: {},
                 };
             }
             // Cache schema and types - handle caching errors gracefully
@@ -202,7 +204,7 @@ export class NOORMME {
                 slowQueryThreshold: 1000,
                 nPlusOneDetection: true,
                 missingIndexDetection: true,
-                persistPath: process.env.NOORMME_METRICS_PATH || '.noormme/metrics.json'
+                persistPath: process.env.NOORMME_METRICS_PATH || '.noormme/metrics.json',
             }, this.logger);
             // Initialize SQLite-specific auto-optimization features
             if (this.config.dialect === 'sqlite') {
@@ -240,15 +242,15 @@ export class NOORMME {
             const result = await this.sqliteAutoOptimizer.optimizeDatabase(this.db, config);
             if (result.appliedOptimizations.length > 0) {
                 this.logger.info(`Applied ${result.appliedOptimizations.length} SQLite optimizations`);
-                result.appliedOptimizations.forEach(opt => this.logger.debug(`  ✓ ${opt}`));
+                result.appliedOptimizations.forEach((opt) => this.logger.debug(`  ✓ ${opt}`));
             }
             if (result.recommendations.length > 0) {
                 this.logger.info(`Generated ${result.recommendations.length} recommendations`);
-                result.recommendations.forEach(rec => this.logger.debug(`  💡 ${rec}`));
+                result.recommendations.forEach((rec) => this.logger.debug(`  💡 ${rec}`));
             }
             if (result.warnings.length > 0) {
                 this.logger.warn(`Found ${result.warnings.length} warnings`);
-                result.warnings.forEach(warning => this.logger.warn(`  ⚠️ ${warning}`));
+                result.warnings.forEach((warning) => this.logger.warn(`  ⚠️ ${warning}`));
             }
         }
         catch (error) {
@@ -333,9 +335,9 @@ export class NOORMME {
         if (!schemaInfo) {
             throw new Error('Schema not found. Please reinitialize NOORMME.');
         }
-        const table = schemaInfo.tables.find(t => t.name === tableName);
+        const table = schemaInfo.tables.find((t) => t.name === tableName);
         if (!table) {
-            const availableTables = schemaInfo.tables.map(t => t.name);
+            const availableTables = schemaInfo.tables.map((t) => t.name);
             throw new TableNotFoundError(tableName, availableTables);
         }
         const repository = this.repositoryFactory.createRepository(table, schemaInfo.relationships);
@@ -406,7 +408,7 @@ export class NOORMME {
         // Auto-refresh schema when changes detected
         this.schemaWatcher.onSchemaChange(async (changes) => {
             this.logger.info(`Schema changes detected: ${changes.length} changes`);
-            changes.forEach(change => {
+            changes.forEach((change) => {
                 this.logger.info(`  - ${change.type}: ${change.table}`);
             });
             try {
@@ -447,12 +449,12 @@ export class NOORMME {
             queryCount: this.logger.getQueryCount(),
             averageQueryTime: this.logger.getAverageQueryTime(),
             cacheHitRate: this.cacheManager.getHitRate(),
-            repositoryCount: this.repositories.size
+            repositoryCount: this.repositories.size,
         };
         if (this.metricsCollector) {
             return {
                 ...baseMetrics,
-                ...this.metricsCollector.getPerformanceStats()
+                ...this.metricsCollector.getPerformanceStats(),
             };
         }
         return baseMetrics;
@@ -472,7 +474,7 @@ export class NOORMME {
             enabled: true,
             slowQueryThreshold: options?.slowQueryThreshold || 1000,
             nPlusOneDetection: true,
-            missingIndexDetection: true
+            missingIndexDetection: true,
         }, this.logger);
         this.logger.info('Query performance monitoring enabled');
     }
@@ -532,27 +534,27 @@ export class NOORMME {
                 includeViews: false,
                 excludeTables: [],
                 customTypeMappings: {},
-                ...config.introspection
+                ...config.introspection,
             },
             cache: {
                 ttl: 300000, // 5 minutes
                 maxSize: 1000,
                 strategy: 'lru',
-                ...config.cache
+                ...config.cache,
             },
             logging: {
                 level: 'info',
                 enabled: true,
-                ...config.logging
+                ...config.logging,
             },
             performance: {
                 enableQueryOptimization: true,
                 enableBatchLoading: true,
                 maxBatchSize: 100,
-                ...config.performance
+                ...config.performance,
             },
             agentic: config.agentic,
-            automation: config.automation
+            automation: config.automation,
         };
     }
     /**
@@ -576,7 +578,7 @@ export class NOORMME {
                 default:
                     throw new NoormError(`Unsupported database protocol: ${url.protocol}`, {
                         operation: 'connection_string_parsing',
-                        suggestion: 'Supported protocols: sqlite, postgresql, postgres, mysql'
+                        suggestion: 'Supported protocols: sqlite, postgresql, postgres, mysql',
                     });
             }
             if (dialect === 'sqlite') {
@@ -587,8 +589,8 @@ export class NOORMME {
                         host: '',
                         port: 0,
                         username: '',
-                        password: ''
-                    }
+                        password: '',
+                    },
                 };
             }
             if (dialect === 'postgresql' || dialect === 'mysql') {
@@ -605,23 +607,31 @@ export class NOORMME {
                     }
                     else {
                         // For other SSL modes, we'll need more configuration
-                        ssl = { rejectUnauthorized: sslParam !== 'allow' && sslParam !== 'prefer' };
+                        ssl = {
+                            rejectUnauthorized: sslParam !== 'allow' && sslParam !== 'prefer',
+                        };
                     }
                 }
                 return {
                     dialect,
                     connection: {
                         host: url.hostname || 'localhost',
-                        port: url.port ? parseInt(url.port, 10) : this.getDefaultPort(dialect),
+                        port: url.port
+                            ? parseInt(url.port, 10)
+                            : this.getDefaultPort(dialect),
                         database: url.pathname.replace(/^\//, ''),
                         username: url.username || undefined,
                         password: url.password || undefined,
                         ssl,
                         pool: {
-                            max: searchParams.get('pool_max') ? parseInt(searchParams.get('pool_max'), 10) : 10,
-                            min: searchParams.get('pool_min') ? parseInt(searchParams.get('pool_min'), 10) : 0,
-                        }
-                    }
+                            max: searchParams.get('pool_max')
+                                ? parseInt(searchParams.get('pool_max'), 10)
+                                : 10,
+                            min: searchParams.get('pool_min')
+                                ? parseInt(searchParams.get('pool_min'), 10)
+                                : 0,
+                        },
+                    },
                 };
             }
             return {
@@ -632,14 +642,15 @@ export class NOORMME {
                     database: url.pathname.slice(1), // Remove leading slash
                     username: url.username || '',
                     password: url.password || '',
-                    ssl: url.searchParams.get('ssl') === 'true' || url.searchParams.get('sslmode') === 'require'
-                }
+                    ssl: url.searchParams.get('ssl') === 'true' ||
+                        url.searchParams.get('sslmode') === 'require',
+                },
             };
         }
         catch (error) {
             throw new NoormError(`Failed to parse connection string: ${error instanceof Error ? error.message : String(error)}`, {
                 operation: 'connection_string_parsing',
-                suggestion: 'Ensure connection string format is: protocol://username:password@host:port/database'
+                suggestion: 'Ensure connection string format is: protocol://username:password@host:port/database',
             });
         }
     }
@@ -648,10 +659,14 @@ export class NOORMME {
      */
     getDefaultPort(dialect) {
         switch (dialect) {
-            case 'sqlite': return 0;
-            case 'postgresql': return 5432;
-            case 'mysql': return 3306;
-            default: return 0;
+            case 'sqlite':
+                return 0;
+            case 'postgresql':
+                return 5432;
+            case 'mysql':
+                return 3306;
+            default:
+                return 0;
         }
     }
     createDialect() {
@@ -659,7 +674,7 @@ export class NOORMME {
         switch (dialect) {
             case 'sqlite':
                 return new SqliteDialect({
-                    database: new Database(connection.database)
+                    database: new Database(connection.database),
                 });
             case 'postgresql':
                 return new PostgresDialect({
@@ -673,7 +688,7 @@ export class NOORMME {
                         max: connection.pool?.max ?? 10,
                         min: connection.pool?.min ?? 0,
                         idleTimeoutMillis: connection.pool?.idleTimeoutMillis ?? 10000,
-                    }
+                    },
                 });
             default:
                 throw new Error(`Unsupported dialect: ${dialect}`);

package/dist/esm/performance/index.js

@@ -19,7 +19,7 @@ export const defaultPerformanceConfig = {
         maxSize: 1000,
         defaultTtl: 300000, // 5 minutes
         cleanupInterval: 60000, // 1 minute
-        enableMetrics: true
+        enableMetrics: true,
     },
     metrics: {
         enabled: true,
@@ -28,14 +28,14 @@ export const defaultPerformanceConfig = {
         missingIndexDetection: true,
         largeResultSetThreshold: 1000,
         maxHistorySize: 10000,
-        warningRetentionDays: 7
+        warningRetentionDays: 7,
     },
     connectionPool: {
         minConnections: 2,
         maxConnections: 10,
         acquireTimeout: 30000,
         idleTimeout: 300000,
-        validationInterval: 60000
+        validationInterval: 60000,
     },
     optimizer: {
         enableQueryCache: true,
@@ -43,6 +43,6 @@ export const defaultPerformanceConfig = {
         enableQueryRewriting: true,
         slowQueryThreshold: 1000,
         cacheSize: 1000,
-        maxCacheAge: 300000
-    }
+        maxCacheAge: 300000,
+    },
 };

package/dist/esm/performance/query-optimizer.js

@@ -25,20 +25,20 @@ export class QueryOptimizer {
             slowQueryThreshold: 1000,
             cacheSize: 1000,
             maxCacheAge: 300000,
-            ...options
+            ...options,
         };
         // Initialize services
         this.cacheService = new QueryCacheService({
             maxSize: this.options.cacheSize,
             defaultTtl: this.options.maxCacheAge,
-            enableMetrics: true
+            enableMetrics: true,
         }, this.logger);
         this.metricsCollector = new MetricsCollector({
             enabled: true,
             slowQueryThreshold: this.options.slowQueryThreshold,
             nPlusOneDetection: true,
             missingIndexDetection: this.options.enableIndexRecommendations,
-            largeResultSetThreshold: 1000
+            largeResultSetThreshold: 1000,
         }, this.logger);
     }
     /**
@@ -59,7 +59,7 @@ export class QueryOptimizer {
                         executionTime,
                         improvement: 100,
                         suggestions: ['Query served from cache'],
-                        result: cachedResult
+                        result: cachedResult,
                     };
                 }
             }
@@ -79,7 +79,7 @@ export class QueryOptimizer {
             this.metricsCollector.recordQuery(query, executionTime, {
                 table: context?.table,
                 operation: context?.operation,
-                resultCount: Array.isArray(result) ? result.length : 1
+                resultCount: Array.isArray(result) ? result.length : 1,
             });
             // Generate suggestions
             const suggestions = this.generateSuggestions(parsedQuery, executionTime, context);
@@ -90,7 +90,7 @@ export class QueryOptimizer {
                 executionTime,
                 improvement: optimization.improvement,
                 suggestions,
-                result
+                result,
             };
         }
         catch (error) {
@@ -100,11 +100,11 @@ export class QueryOptimizer {
             this.metricsCollector.recordQuery(query, executionTime, {
                 table: context?.table,
                 operation: context?.operation,
-                error: errorMessage
+                error: errorMessage,
             });
             this.logger.error(`Query optimization failed: ${errorMessage}`, {
                 query,
-                executionTime
+                executionTime,
             });
             throw error;
         }
@@ -134,7 +134,7 @@ export class QueryOptimizer {
         return {
             ...metricsStats,
             cache: cacheStats,
-            indexRecommendations: 0 // Would be populated by recommendations
+            indexRecommendations: 0, // Would be populated by recommendations
         };
     }
     /**
@@ -195,7 +195,7 @@ export class QueryOptimizer {
         return {
             optimizedQuery,
             type,
-            improvement
+            improvement,
         };
     }
     /**
@@ -205,7 +205,8 @@ export class QueryOptimizer {
         let optimizedQuery = originalQuery;
         let improvement = 0;
         // Add LIMIT if missing and query could return many rows
-        if (!parsedQuery.hasLimit && QueryParser.couldReturnManyRows(originalQuery)) {
+        if (!parsedQuery.hasLimit &&
+            QueryParser.couldReturnManyRows(originalQuery)) {
             optimizedQuery = `${originalQuery} LIMIT 1000`;
             improvement = 10;
         }
@@ -219,7 +220,7 @@ export class QueryOptimizer {
         }
         return {
             optimizedQuery,
-            improvement
+            improvement,
         };
     }
     /**
@@ -244,13 +245,14 @@ export class QueryOptimizer {
         // Check for missing indexes on GROUP BY columns
         if (parsedQuery.hasAggregates && parsedQuery.groupByColumns.length > 0) {
             const table = parsedQuery.tables[0];
-            if (table && parsedQuery.groupByColumns.every(col => this.hasIndexOnColumn(table, col))) {
+            if (table &&
+                parsedQuery.groupByColumns.every((col) => this.hasIndexOnColumn(table, col))) {
                 improvement = Math.max(improvement, 25);
             }
         }
         return {
             optimizedQuery,
-            improvement
+            improvement,
         };
     }
     /**
@@ -271,7 +273,7 @@ export class QueryOptimizer {
                     type: 'btree',
                     reason: `WHERE clause on ${column}`,
                     estimatedImprovement: 20,
-                    priority: 'medium'
+                    priority: 'medium',
                 });
             }
         }
@@ -284,7 +286,7 @@ export class QueryOptimizer {
                     type: 'btree',
                     reason: `JOIN condition on ${column}`,
                     estimatedImprovement: 30,
-                    priority: 'high'
+                    priority: 'high',
                 });
             }
         }
@@ -297,7 +299,7 @@ export class QueryOptimizer {
                     type: 'btree',
                     reason: `ORDER BY clause on ${column}`,
                     estimatedImprovement: 15,
-                    priority: 'medium'
+                    priority: 'medium',
                 });
             }
         }
@@ -356,7 +358,10 @@ export class QueryOptimizer {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            this.logger.error(`Query execution failed: ${errorMessage}`, { query, params });
+            this.logger.error(`Query execution failed: ${errorMessage}`, {
+                query,
+                params,
+            });
             throw error;
         }
     }
@@ -364,15 +369,15 @@ export class QueryOptimizer {
      * Check if column has an index
      */
     hasIndexOnColumn(table, column) {
-        const tableInfo = this.schemaInfo.tables.find(t => t.name === table);
+        const tableInfo = this.schemaInfo.tables.find((t) => t.name === table);
         if (!tableInfo)
             return false;
         // Check if column is primary key
-        const columnInfo = tableInfo.columns.find(col => col.name === column);
+        const columnInfo = tableInfo.columns.find((col) => col.name === column);
         if (columnInfo?.isPrimaryKey)
             return true;
         // Check if column has an index
-        return tableInfo.indexes.some(idx => idx.columns.includes(column));
+        return tableInfo.indexes.some((idx) => idx.columns.includes(column));
     }
 }
 /**

package/dist/esm/performance/services/cache-service.js

@@ -18,7 +18,7 @@ export class CacheService {
             cleanupInterval: 60000, // 1 minute
             enableCompression: false,
             enableMetrics: true,
-            ...config
+            ...config,
         };
         this.stats = {
             size: 0,
@@ -28,25 +28,25 @@ export class CacheService {
             hitRate: 0,
             totalSize: 0,
             evictions: 0,
-            lastCleanup: new Date()
+            lastCleanup: new Date(),
         };
         this.metrics = {
             operations: {
                 get: 0,
                 set: 0,
                 delete: 0,
-                clear: 0
+                clear: 0,
             },
             performance: {
                 averageGetTime: 0,
                 averageSetTime: 0,
-                slowestOperation: 0
+                slowestOperation: 0,
             },
             memory: {
                 totalSize: 0,
                 averageEntrySize: 0,
-                largestEntry: 0
-            }
+                largestEntry: 0,
+            },
         };
         this.startCleanupTimer();
     }
@@ -103,7 +103,7 @@ export class CacheService {
                 timestamp: Date.now(),
                 ttl: entryTtl,
                 hitCount: 0,
-                size: entrySize
+                size: entrySize,
             };
             this.cache.set(key, entry);
             this.updateStats();
@@ -189,7 +189,10 @@ export class CacheService {
      * Get cache entries (for debugging)
      */
     entries() {
-        return Array.from(this.cache.entries()).map(([key, entry]) => ({ key, entry }));
+        return Array.from(this.cache.entries()).map(([key, entry]) => ({
+            key,
+            entry,
+        }));
     }
     /**
      * Warm cache with multiple entries
@@ -216,19 +219,23 @@ export class CacheService {
             recommendations.push('Consider increasing TTL or cache size');
         }
         // Check memory usage
-        if (this.stats.totalSize > 100 * 1024 * 1024) { // 100MB
+        if (this.stats.totalSize > 100 * 1024 * 1024) {
+            // 100MB
             issues.push(`High memory usage: ${(this.stats.totalSize / 1024 / 1024).toFixed(1)}MB`);
             recommendations.push('Consider reducing cache size or enabling compression');
         }
         // Check eviction rate
-        const evictionRate = this.stats.evictions / Math.max(this.stats.hitCount + this.stats.missCount, 1);
+        const evictionRate = this.stats.evictions /
+            Math.max(this.stats.hitCount + this.stats.missCount, 1);
         if (evictionRate > 0.1) {
             issues.push(`High eviction rate: ${(evictionRate * 100).toFixed(1)}%`);
             recommendations.push('Consider increasing cache size');
         }
         let status = 'healthy';
         if (issues.length > 0) {
-            status = issues.some(issue => issue.includes('critical')) ? 'critical' : 'warning';
+            status = issues.some((issue) => issue.includes('critical'))
+                ? 'critical'
+                : 'warning';
         }
         return { status, issues, recommendations };
     }
@@ -297,7 +304,8 @@ export class CacheService {
         this.stats.totalSize = totalSize;
         this.metrics.memory.totalSize = totalSize;
         this.metrics.memory.largestEntry = largestEntry;
-        this.metrics.memory.averageEntrySize = this.cache.size > 0 ? totalSize / this.cache.size : 0;
+        this.metrics.memory.averageEntrySize =
+            this.cache.size > 0 ? totalSize / this.cache.size : 0;
     }
     /**
      * Update hit rate
@@ -316,12 +324,14 @@ export class CacheService {
         if (operation === 'get') {
             const totalGets = this.metrics.operations.get;
             this.metrics.performance.averageGetTime =
-                (this.metrics.performance.averageGetTime * (totalGets - 1) + duration) / totalGets;
+                (this.metrics.performance.averageGetTime * (totalGets - 1) + duration) /
+                    totalGets;
         }
         else if (operation === 'set') {
             const totalSets = this.metrics.operations.set;
             this.metrics.performance.averageSetTime =
-                (this.metrics.performance.averageSetTime * (totalSets - 1) + duration) / totalSets;
+                (this.metrics.performance.averageSetTime * (totalSets - 1) + duration) /
+                    totalSets;
         }
     }
     /**
@@ -367,7 +377,7 @@ export class QueryCacheService extends CacheService {
             defaultTtl: 300000, // 5 minutes
             cleanupInterval: 60000, // 1 minute
             enableMetrics: true,
-            ...config
+            ...config,
         }, logger);
     }
     /**
@@ -389,7 +399,7 @@ export class QueryCacheService extends CacheService {
      */
     generateQueryKey(query, params) {
         const normalizedQuery = query.replace(/\s+/g, ' ').trim();
-        const paramsKey = params.map(p => String(p)).join('|');
+        const paramsKey = params.map((p) => String(p)).join('|');
         return `query:${normalizedQuery}:${paramsKey}`;
     }
     /**