@gracker/smartperfetto 1.0.13

package/dist/services/sqlTemplateEngine.d.ts

@@ -0,0 +1,134 @@
+/**
+ * SQL模板引擎 - 管理和执行Perfetto SQL模板
+ */
+export interface SQLTemplate {
+    name: string;
+    sql: string;
+    params: string[];
+    description: string;
+    category: 'launch' | 'cpu' | 'memory' | 'render' | 'general';
+    examples?: {
+        [key: string]: any;
+    };
+}
+export interface SQLValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+}
+/**
+ * Perfetto SQL 模板库
+ */
+export declare const PERFETTO_SQL_TEMPLATES: {
+    [key: string]: SQLTemplate;
+};
+/**
+ * SQL模板引擎类
+ */
+export declare class SQLTemplateEngine {
+    private templates;
+    constructor();
+    /**
+     * 加载所有模板
+     */
+    private loadTemplates;
+    /**
+     * 根据名称获取模板
+     */
+    getTemplate(name: string): SQLTemplate | undefined;
+    /**
+     * 根据分类获取模板
+     */
+    getTemplatesByCategory(category: string): SQLTemplate[];
+    /**
+     * 列出所有模板
+     */
+    listTemplates(): SQLTemplate[];
+    /**
+     * 渲染模板 - 将参数替换到SQL中
+     */
+    render(templateName: string, params: {
+        [key: string]: any;
+    }): string;
+    /**
+     * 智能匹配模板 - 根据用户查询匹配最合适的模板
+     */
+    matchTemplate(userQuery: string): SQLTemplate | null;
+    /**
+     * 验证SQL
+     */
+    validateSQL(sql: string): SQLValidationResult;
+    /**
+     * 尝试修正SQL错误
+     */
+    suggestFix(sql: string, error: string): string | null;
+}
+import { PerfettoSqlTemplate } from './sqlKnowledgeBase';
+/**
+ * 增强的 SQL 模板引擎 - 集成官方 SQL 库
+ */
+export declare class EnhancedSQLTemplateEngine extends SQLTemplateEngine {
+    private knowledgeBaseReady;
+    private officialTemplates;
+    constructor();
+    /**
+     * 初始化官方 SQL 库
+     */
+    initializeOfficialLibrary(): Promise<void>;
+    /**
+     * 搜索官方模板
+     */
+    searchOfficialTemplates(query: string, limit?: number): Promise<PerfettoSqlTemplate[]>;
+    /**
+     * 获取官方推荐 SQL
+     */
+    getRecommendedSQL(category: string): Promise<Array<{
+        name: string;
+        description: string;
+        sql: string;
+    }>>;
+    /**
+     * 根据用户意图智能匹配（优先官方模板）
+     */
+    smartMatchWithOfficial(userQuery: string): Promise<{
+        builtinTemplate: SQLTemplate | null;
+        officialTemplates: PerfettoSqlTemplate[];
+        recommendedSQL: Array<{
+            name: string;
+            description: string;
+            sql: string;
+        }>;
+    }>;
+    /**
+     * 检测查询意图对应的分类
+     */
+    private detectCategory;
+    /**
+     * 生成带有 INCLUDE 语句的完整 SQL
+     */
+    generateFullSQL(templateId: string): Promise<string | null>;
+    /**
+     * 获取为 AI 生成 SQL 提供的上下文
+     */
+    getAIContext(query: string): Promise<string>;
+    /**
+     * 列出所有分类
+     */
+    listCategories(): Promise<string[]>;
+    /**
+     * 获取分类下的模板列表
+     */
+    getTemplatesByOfficialCategory(category: string): Promise<PerfettoSqlTemplate[]>;
+    /**
+     * 获取统计信息
+     */
+    getStats(): Promise<{
+        builtinTemplates: number;
+        officialTemplates: number;
+        categories: string[];
+    }>;
+}
+export declare function getEnhancedSQLTemplateEngine(): Promise<EnhancedSQLTemplateEngine>;
+export default SQLTemplateEngine;
+//# sourceMappingURL=sqlTemplateEngine.d.ts.map

package/dist/services/sqlTemplateEngine.d.ts.map

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

package/dist/services/sqlTemplateEngine.js

@@ -0,0 +1,430 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnhancedSQLTemplateEngine = exports.SQLTemplateEngine = exports.PERFETTO_SQL_TEMPLATES = void 0;
+exports.getEnhancedSQLTemplateEngine = getEnhancedSQLTemplateEngine;
+/**
+ * Perfetto SQL 模板库
+ */
+exports.PERFETTO_SQL_TEMPLATES = {
+    // 1. 应用启动时间
+    APP_LAUNCH_TIME: {
+        name: 'APP_LAUNCH_TIME',
+        sql: `SELECT slice.name AS phase, MIN(slice.ts) / 1e9 AS start_time_s, slice.dur / 1e6 AS duration_ms FROM slice JOIN thread_track ON slice.track_id = thread_track.id JOIN thread USING (utid) JOIN process USING (upid) WHERE process.name = '{app_package}' AND (slice.name = 'activityStart' OR slice.name = 'activityResume') ORDER BY slice.ts ASC;`,
+        params: ['app_package'],
+        description: '获取应用启动的activityStart和activityResume阶段时间',
+        category: 'launch',
+        examples: {
+            app_package: 'com.example.app'
+        }
+    },
+    // 2. 总启动时间
+    TOTAL_LAUNCH_TIME: {
+        name: 'TOTAL_LAUNCH_TIME',
+        sql: `SELECT MIN(slice.ts) / 1e9 AS launch_start_s, MAX(slice.ts + slice.dur) / 1e9 AS launch_end_s, (MAX(slice.ts + slice.dur) - MIN(slice.ts)) / 1e6 AS total_launch_time_ms FROM slice JOIN thread_track ON slice.track_id = thread_track.id JOIN thread USING (utid) JOIN process USING (upid) WHERE process.name = '{app_package}' AND (slice.name = 'activityStart' OR slice.name = 'activityResume');`,
+        params: ['app_package'],
+        description: '计算应用的总启动时间',
+        category: 'launch',
+        examples: {
+            app_package: 'com.example.app'
+        }
+    },
+    // 3. Top耗时操作
+    TOP_OPERATIONS: {
+        name: 'TOP_OPERATIONS',
+        sql: `SELECT slice.name AS operation, slice.dur / 1e6 AS duration_ms, slice.ts / 1e9 AS timestamp_s, thread.name AS thread_name FROM slice JOIN thread_track ON slice.track_id = thread_track.id JOIN thread USING (utid) JOIN process USING (upid) WHERE process.name = '{app_package}' AND slice.ts >= {start_ts} AND slice.ts <= {end_ts} AND slice.dur > {min_duration_ns} ORDER BY slice.dur DESC LIMIT {limit};`,
+        params: ['app_package', 'start_ts', 'end_ts', 'min_duration_ns', 'limit'],
+        description: '获取指定时间范围内的Top耗时操作',
+        category: 'general',
+        examples: {
+            app_package: 'com.example.app',
+            start_ts: '40919970000000',
+            end_ts: '40920200000000',
+            min_duration_ns: '1000000',
+            limit: '20'
+        }
+    },
+    // 4. 主线程CPU核心分布
+    MAIN_THREAD_CPU_DISTRIBUTION: {
+        name: 'MAIN_THREAD_CPU_DISTRIBUTION',
+        sql: `SELECT sched.cpu AS cpu_core, COUNT(*) AS schedule_count, SUM(sched.dur) / 1e6 AS total_time_ms, AVG(sched.dur) / 1e6 AS avg_time_ms FROM sched JOIN thread USING (utid) JOIN process USING (upid) WHERE process.name = '{app_package}' AND thread.is_main_thread = 1 AND sched.ts >= {start_ts} AND sched.ts <= {end_ts} GROUP BY sched.cpu ORDER BY sched.cpu;`,
+        params: ['app_package', 'start_ts', 'end_ts'],
+        description: '分析主线程在各CPU核心上的运行时间分布',
+        category: 'cpu',
+        examples: {
+            app_package: 'com.example.app',
+            start_ts: '40919970000000',
+            end_ts: '40920200000000'
+        }
+    },
+    // 5. CPU频率分布
+    CPU_FREQUENCY_DISTRIBUTION: {
+        name: 'CPU_FREQUENCY_DISTRIBUTION',
+        sql: `SELECT counter_track.name AS cpu, AVG(counter.value) / 1000000 AS avg_freq_ghz, MIN(counter.value) / 1000000 AS min_freq_ghz, MAX(counter.value) / 1000000 AS max_freq_ghz FROM counter JOIN counter_track ON counter.track_id = counter_track.id WHERE counter_track.name LIKE 'cpufreq%' AND counter.ts >= {start_ts} AND counter.ts <= {end_ts} GROUP BY counter_track.name ORDER BY counter_track.name;`,
+        params: ['start_ts', 'end_ts'],
+        description: '获取指定时间范围内的CPU频率统计',
+        category: 'cpu',
+        examples: {
+            start_ts: '40919970000000',
+            end_ts: '40920200000000'
+        }
+    },
+    // 6. CPU负载
+    CPU_LOAD: {
+        name: 'CPU_LOAD',
+        sql: `SELECT cpu AS cpu_core, COUNT(*) AS total_schedules, SUM(dur) / 1e6 AS total_run_time_ms, ROUND((SUM(dur) * 100.0 / {window_ns}), 2) AS utilization_percent FROM sched WHERE ts >= {start_ts} AND ts <= {end_ts} GROUP BY cpu ORDER BY cpu;`,
+        params: ['start_ts', 'end_ts', 'window_ns'],
+        description: '分析各CPU核心的负载情况',
+        category: 'cpu',
+        examples: {
+            start_ts: '40919970000000',
+            end_ts: '40920200000000',
+            window_ns: '230000000'
+        }
+    },
+    // 7. 查找应用的所有slice
+    APP_ALL_SLICES: {
+        name: 'APP_ALL_SLICES',
+        sql: `SELECT slice.name, COUNT(*) AS count, AVG(slice.dur) / 1e6 AS avg_duration_ms, MAX(slice.dur) / 1e6 AS max_duration_ms FROM slice JOIN thread_track ON slice.track_id = thread_track.id JOIN thread USING (utid) JOIN process USING (upid) WHERE process.name = '{app_package}' GROUP BY slice.name HAVING COUNT(*) > {min_count} ORDER BY avg_duration_ms DESC LIMIT {limit};`,
+        params: ['app_package', 'min_count', 'limit'],
+        description: '获取应用的所有slice及其统计信息',
+        category: 'general',
+        examples: {
+            app_package: 'com.example.app',
+            min_count: '5',
+            limit: '50'
+        }
+    },
+    // 8. 帧渲染分析
+    FRAME_RENDERING: {
+        name: 'FRAME_RENDERING',
+        sql: `SELECT slice.name, slice.ts / 1e9 AS timestamp_s, slice.dur / 1e6 AS duration_ms FROM slice JOIN thread_track ON slice.track_id = thread_track.id JOIN thread USING (utid) JOIN process USING (upid) WHERE process.name = '{app_package}' AND (slice.name LIKE '%DrawFrame%' OR slice.name LIKE '%Choreographer%') AND slice.ts >= {start_ts} AND slice.ts <= {end_ts} ORDER BY slice.ts ASC;`,
+        params: ['app_package', 'start_ts', 'end_ts'],
+        description: '分析应用的帧渲染性能',
+        category: 'render',
+        examples: {
+            app_package: 'com.example.app',
+            start_ts: '40919970000000',
+            end_ts: '40920200000000'
+        }
+    }
+};
+/**
+ * SQL模板引擎类
+ */
+class SQLTemplateEngine {
+    constructor() {
+        this.templates = new Map();
+        this.loadTemplates();
+    }
+    /**
+     * 加载所有模板
+     */
+    loadTemplates() {
+        Object.entries(exports.PERFETTO_SQL_TEMPLATES).forEach(([key, template]) => {
+            this.templates.set(key, template);
+        });
+    }
+    /**
+     * 根据名称获取模板
+     */
+    getTemplate(name) {
+        return this.templates.get(name);
+    }
+    /**
+     * 根据分类获取模板
+     */
+    getTemplatesByCategory(category) {
+        return Array.from(this.templates.values()).filter(t => t.category === category);
+    }
+    /**
+     * 列出所有模板
+     */
+    listTemplates() {
+        return Array.from(this.templates.values());
+    }
+    /**
+     * 渲染模板 - 将参数替换到SQL中
+     */
+    render(templateName, params) {
+        const template = this.getTemplate(templateName);
+        if (!template) {
+            throw new Error(`Template not found: ${templateName}`);
+        }
+        // 检查所需参数
+        const missingParams = template.params.filter(p => !(p in params));
+        if (missingParams.length > 0) {
+            throw new Error(`Missing parameters: ${missingParams.join(', ')}`);
+        }
+        // 替换参数
+        let sql = template.sql;
+        template.params.forEach(param => {
+            const value = params[param];
+            sql = sql.replace(new RegExp(`\\{${param}\\}`, 'g'), value.toString());
+        });
+        return sql;
+    }
+    /**
+     * 智能匹配模板 - 根据用户查询匹配最合适的模板
+     */
+    matchTemplate(userQuery) {
+        const query = userQuery.toLowerCase();
+        // 关键词匹配规则
+        const matchRules = {
+            'APP_LAUNCH_TIME': ['启动时间', '启动阶段', 'launch time', 'activity start'],
+            'TOTAL_LAUNCH_TIME': ['总启动时间', '完整启动', 'total launch'],
+            'TOP_OPERATIONS': ['耗时操作', '慢操作', 'slow operations', 'top operations'],
+            'MAIN_THREAD_CPU_DISTRIBUTION': ['主线程', '核心分布', 'main thread', 'cpu distribution'],
+            'CPU_FREQUENCY_DISTRIBUTION': ['cpu频率', 'frequency', '频率分布'],
+            'CPU_LOAD': ['cpu负载', 'cpu load', 'cpu utilization'],
+            'FRAME_RENDERING': ['帧渲染', '渲染性能', 'frame', 'rendering']
+        };
+        // 遍历规则，找到匹配的模板
+        for (const [templateName, keywords] of Object.entries(matchRules)) {
+            if (keywords.some(keyword => query.includes(keyword))) {
+                return this.getTemplate(templateName) || null;
+            }
+        }
+        return null;
+    }
+    /**
+     * 验证SQL
+     */
+    validateSQL(sql) {
+        const result = {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: []
+        };
+        // 1. 检查是否为空
+        if (!sql || sql.trim().length === 0) {
+            result.isValid = false;
+            result.errors.push('SQL不能为空');
+            return result;
+        }
+        // 2. 检查是否包含多行（trace_processor要求单行）
+        if (sql.includes('\n') && sql.split('\n').filter(l => l.trim()).length > 1) {
+            result.warnings.push('SQL包含多行，trace_processor可能不支持');
+            result.suggestions.push('请将SQL合并为单行');
+        }
+        // 3. 检查表名
+        const validTables = ['slice', 'thread', 'process', 'thread_track', 'sched', 'counter', 'counter_track', 'track'];
+        const sqlLower = sql.toLowerCase();
+        const invalidTables = ['app_launch', 'performance', 'metrics']; // 常见错误
+        invalidTables.forEach(table => {
+            if (sqlLower.includes(`from ${table}`) || sqlLower.includes(`join ${table}`)) {
+                result.isValid = false;
+                result.errors.push(`表 '${table}' 不存在于Perfetto schema中`);
+                result.suggestions.push(`可能需要使用 'slice' 或其他有效表: ${validTables.join(', ')}`);
+            }
+        });
+        // 4. 检查时间单位转换
+        if (sqlLower.includes('ts') && !sqlLower.includes('/ 1e')) {
+            result.warnings.push('时间戳(ts)的单位是纳秒，建议转换单位');
+            result.suggestions.push('使用 ts / 1e9 转换为秒，或 ts / 1e6 转换为毫秒');
+        }
+        if (sqlLower.includes('dur') && !sqlLower.includes('/ 1e')) {
+            result.warnings.push('持续时间(dur)的单位是纳秒，建议转换单位');
+            result.suggestions.push('使用 dur / 1e6 转换为毫秒，或 dur / 1e9 转换为秒');
+        }
+        // 5. 检查JOIN语法
+        if (sqlLower.includes('join slice') && !sqlLower.includes('thread_track')) {
+            result.warnings.push('直接JOIN slice可能缺少中间表');
+            result.suggestions.push('slice通常需要通过thread_track -> thread -> process来JOIN');
+        }
+        // 6. 检查常见字段错误
+        if (sqlLower.includes('cpu') && sqlLower.includes('from counter')) {
+            result.errors.push('counter表没有cpu字段');
+            result.suggestions.push('CPU信息在sched表中，或从counter_track.name中提取');
+            result.isValid = false;
+        }
+        return result;
+    }
+    /**
+     * 尝试修正SQL错误
+     */
+    suggestFix(sql, error) {
+        // 简单的错误修正规则
+        let fixed = sql;
+        // 修正常见表名错误
+        fixed = fixed.replace(/FROM\s+app_launch/gi, 'FROM slice');
+        fixed = fixed.replace(/JOIN\s+app_launch/gi, 'JOIN slice');
+        // 添加时间单位转换
+        if (error.includes('时间戳') || error.includes('timestamp')) {
+            fixed = fixed.replace(/SELECT\s+ts\s/gi, 'SELECT ts / 1e9 AS timestamp_s ');
+            fixed = fixed.replace(/SELECT\s+dur\s/gi, 'SELECT dur / 1e6 AS duration_ms ');
+        }
+        return fixed !== sql ? fixed : null;
+    }
+}
+exports.SQLTemplateEngine = SQLTemplateEngine;
+// ============================================================================
+// 官方 SQL 库集成的增强模板
+// ============================================================================
+const sqlKnowledgeBase_1 = require("./sqlKnowledgeBase");
+/**
+ * 增强的 SQL 模板引擎 - 集成官方 SQL 库
+ */
+class EnhancedSQLTemplateEngine extends SQLTemplateEngine {
+    constructor() {
+        super();
+        this.knowledgeBaseReady = false;
+        this.officialTemplates = new Map();
+    }
+    /**
+     * 初始化官方 SQL 库
+     */
+    async initializeOfficialLibrary() {
+        if (this.knowledgeBaseReady)
+            return;
+        try {
+            const kb = await (0, sqlKnowledgeBase_1.getExtendedKnowledgeBase)();
+            const categories = kb.getIndexCategories();
+            for (const category of categories) {
+                const templates = kb.getIndexTemplatesByCategory(category);
+                for (const template of templates) {
+                    this.officialTemplates.set(template.id, template);
+                }
+            }
+            this.knowledgeBaseReady = true;
+            console.log(`EnhancedSQLTemplateEngine: 加载了 ${this.officialTemplates.size} 个官方模板`);
+        }
+        catch (error) {
+            console.error('加载官方 SQL 库失败:', error);
+        }
+    }
+    /**
+     * 搜索官方模板
+     */
+    async searchOfficialTemplates(query, limit = 10) {
+        if (!this.knowledgeBaseReady) {
+            await this.initializeOfficialLibrary();
+        }
+        const kb = await (0, sqlKnowledgeBase_1.getExtendedKnowledgeBase)();
+        const results = kb.smartMatch(query);
+        return results.slice(0, limit).map(r => r.template);
+    }
+    /**
+     * 获取官方推荐 SQL
+     */
+    async getRecommendedSQL(category) {
+        if (!this.knowledgeBaseReady) {
+            await this.initializeOfficialLibrary();
+        }
+        const kb = await (0, sqlKnowledgeBase_1.getExtendedKnowledgeBase)();
+        return kb.getRecommendedQueries(category);
+    }
+    /**
+     * 根据用户意图智能匹配（优先官方模板）
+     */
+    async smartMatchWithOfficial(userQuery) {
+        // 1. 检查内置模板
+        const builtinTemplate = this.matchTemplate(userQuery);
+        // 2. 搜索官方模板
+        const officialTemplates = await this.searchOfficialTemplates(userQuery, 5);
+        // 3. 获取推荐 SQL
+        const category = this.detectCategory(userQuery);
+        const recommendedSQL = category ? await this.getRecommendedSQL(category) : [];
+        return {
+            builtinTemplate,
+            officialTemplates,
+            recommendedSQL
+        };
+    }
+    /**
+     * 检测查询意图对应的分类
+     */
+    detectCategory(query) {
+        const categoryKeywords = {
+            'startup': ['启动', 'launch', 'startup', 'start', 'cold', 'warm', 'hot'],
+            'frame': ['帧', 'frame', 'jank', '卡顿', 'render', 'choreographer'],
+            'cpu': ['cpu', '调度', 'sched', 'frequency', '频率'],
+            'memory': ['内存', 'memory', 'heap', 'gc', 'dmabuf'],
+            'binder': ['binder', 'ipc', '通信'],
+            'battery': ['电池', 'battery', 'power', '功耗'],
+            'gpu': ['gpu', 'graphics', '图形'],
+            'io': ['io', 'disk', '磁盘', 'file']
+        };
+        const queryLower = query.toLowerCase();
+        for (const [category, keywords] of Object.entries(categoryKeywords)) {
+            if (keywords.some(kw => queryLower.includes(kw))) {
+                return category;
+            }
+        }
+        return null;
+    }
+    /**
+     * 生成带有 INCLUDE 语句的完整 SQL
+     */
+    async generateFullSQL(templateId) {
+        if (!this.knowledgeBaseReady) {
+            await this.initializeOfficialLibrary();
+        }
+        const kb = await (0, sqlKnowledgeBase_1.getExtendedKnowledgeBase)();
+        const fullTemplate = await kb.loadFullTemplate(templateId);
+        if (!fullTemplate || !fullTemplate.sql) {
+            return null;
+        }
+        return fullTemplate.sql;
+    }
+    /**
+     * 获取为 AI 生成 SQL 提供的上下文
+     */
+    async getAIContext(query) {
+        if (!this.knowledgeBaseReady) {
+            await this.initializeOfficialLibrary();
+        }
+        const kb = await (0, sqlKnowledgeBase_1.getExtendedKnowledgeBase)();
+        return kb.getContextForAI(query, 5);
+    }
+    /**
+     * 列出所有分类
+     */
+    async listCategories() {
+        if (!this.knowledgeBaseReady) {
+            await this.initializeOfficialLibrary();
+        }
+        const kb = await (0, sqlKnowledgeBase_1.getExtendedKnowledgeBase)();
+        return kb.getIndexCategories();
+    }
+    /**
+     * 获取分类下的模板列表
+     */
+    async getTemplatesByOfficialCategory(category) {
+        if (!this.knowledgeBaseReady) {
+            await this.initializeOfficialLibrary();
+        }
+        const kb = await (0, sqlKnowledgeBase_1.getExtendedKnowledgeBase)();
+        return kb.getIndexTemplatesByCategory(category);
+    }
+    /**
+     * 获取统计信息
+     */
+    async getStats() {
+        if (!this.knowledgeBaseReady) {
+            await this.initializeOfficialLibrary();
+        }
+        const kb = await (0, sqlKnowledgeBase_1.getExtendedKnowledgeBase)();
+        const stats = kb.getIndexStats();
+        return {
+            builtinTemplates: this.listTemplates().length,
+            officialTemplates: stats?.totalTemplates || 0,
+            categories: kb.getIndexCategories()
+        };
+    }
+}
+exports.EnhancedSQLTemplateEngine = EnhancedSQLTemplateEngine;
+// 单例实例
+let enhancedEngineInstance = null;
+async function getEnhancedSQLTemplateEngine() {
+    if (!enhancedEngineInstance) {
+        enhancedEngineInstance = new EnhancedSQLTemplateEngine();
+        await enhancedEngineInstance.initializeOfficialLibrary();
+    }
+    return enhancedEngineInstance;
+}
+exports.default = SQLTemplateEngine;
+//# sourceMappingURL=sqlTemplateEngine.js.map

package/dist/services/sqlTemplateEngine.js.map

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

package/dist/services/sqlValidator.d.ts

@@ -0,0 +1,21 @@
+interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+}
+export declare class SQLValidator {
+    private knownTables;
+    private tableColumns;
+    constructor();
+    private parseSchema;
+    validateSQL(sql: string): ValidationResult;
+    private extractTables;
+    private validateJoins;
+    private checkAntiPatterns;
+    private findSimilarTables;
+    private isSimilar;
+    suggestCorrection(sql: string): string;
+}
+export default SQLValidator;
+//# sourceMappingURL=sqlValidator.d.ts.map

package/dist/services/sqlValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlValidator.d.ts","sourceRoot":"","sources":["../../src/services/sqlValidator.ts"],"names":[],"mappings":"AAMA,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,YAAY,CAAoC;;IAMxD,OAAO,CAAC,WAAW;IAoBZ,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;IAsDjD,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,SAAS;IAYV,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAyB9C;AAED,eAAe,YAAY,CAAC"}