@rawsql-ts/sql-grep-core 0.1.1

package/dist/query/analyzeTableUsage.js

@@ -0,0 +1,321 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeTableUsage = analyzeTableUsage;
+const rawsql_ts_1 = require("rawsql-ts");
+const rawsql_ts_2 = require("rawsql-ts");
+const location_1 = require("./location");
+/**
+ * Analyze table usage for a single statement using AST-first traversal.
+ */
+function analyzeTableUsage(params) {
+    let parsed;
+    try {
+        parsed = rawsql_ts_1.SqlParser.parse(params.statement.statementText);
+    }
+    catch (error) {
+        return {
+            matches: [],
+            warnings: [
+                {
+                    catalog_id: params.statement.catalogId,
+                    query_id: params.statement.queryId,
+                    sql_file: params.statement.sqlFile,
+                    code: 'parse-failed',
+                    message: error instanceof Error ? error.message : String(error)
+                }
+            ]
+        };
+    }
+    const occurrences = collectTableOccurrences(parsed, params.target, params.mode);
+    return {
+        matches: occurrences.map((occurrence) => toTableMatch(params.statement, occurrence)),
+        warnings: []
+    };
+}
+function collectTableOccurrences(parsed, target, mode, context = {}) {
+    if (parsed instanceof rawsql_ts_1.SimpleSelectQuery) {
+        const matches = [];
+        if (parsed.withClause) {
+            for (const table of parsed.withClause.tables) {
+                matches.push(...collectTableOccurrences(table.query, target, mode, { inCte: true }));
+            }
+        }
+        for (const item of parsed.selectClause.items) {
+            matches.push(...collectExpressionQueryOccurrences(item.value, target, mode, context));
+        }
+        if (parsed.fromClause) {
+            matches.push(...collectFromClauseOccurrences(parsed.fromClause, target, mode, context));
+        }
+        if (parsed.whereClause) {
+            matches.push(...collectExpressionQueryOccurrences(parsed.whereClause.condition, target, mode, context));
+        }
+        if (parsed.havingClause) {
+            matches.push(...collectExpressionQueryOccurrences(parsed.havingClause.condition, target, mode, context));
+        }
+        if (parsed.groupByClause) {
+            for (const group of parsed.groupByClause.grouping) {
+                matches.push(...collectExpressionQueryOccurrences(group, target, mode, context));
+            }
+        }
+        if (parsed.orderByClause) {
+            for (const order of parsed.orderByClause.order) {
+                matches.push(...collectExpressionQueryOccurrences(order instanceof rawsql_ts_1.OrderByItem ? order.value : order, target, mode, context));
+            }
+        }
+        return matches;
+    }
+    if (parsed instanceof rawsql_ts_1.UpdateQuery) {
+        const matches = [];
+        if (parsed.withClause) {
+            for (const table of parsed.withClause.tables) {
+                matches.push(...collectTableOccurrences(table.query, target, mode, { inCte: true }));
+            }
+        }
+        matches.push(...collectSourceExpressionOccurrences(parsed.updateClause.source, target, mode, context, 'update-target'));
+        if (parsed.fromClause) {
+            matches.push(...collectFromClauseOccurrences(parsed.fromClause, target, mode, context));
+        }
+        if (parsed.whereClause) {
+            matches.push(...collectExpressionQueryOccurrences(parsed.whereClause.condition, target, mode, context));
+        }
+        for (const item of parsed.setClause.items) {
+            matches.push(...collectExpressionQueryOccurrences(item.value, target, mode, context));
+        }
+        return matches;
+    }
+    if (parsed instanceof rawsql_ts_1.DeleteQuery) {
+        const matches = [];
+        if (parsed.withClause) {
+            for (const table of parsed.withClause.tables) {
+                matches.push(...collectTableOccurrences(table.query, target, mode, { inCte: true }));
+            }
+        }
+        matches.push(...collectSourceExpressionOccurrences(parsed.deleteClause.source, target, mode, context, 'delete-target'));
+        if (parsed.usingClause) {
+            matches.push(...collectUsingOccurrences(parsed.usingClause, target, mode, context));
+        }
+        if (parsed.whereClause) {
+            matches.push(...collectExpressionQueryOccurrences(parsed.whereClause.condition, target, mode, context));
+        }
+        return matches;
+    }
+    if (parsed instanceof rawsql_ts_1.InsertQuery) {
+        const matches = [];
+        matches.push(...collectSourceExpressionOccurrences(parsed.insertClause.source, target, mode, context, 'insert-target'));
+        if (parsed.selectQuery) {
+            matches.push(...collectTableOccurrences(parsed.selectQuery, target, mode, { inSubquery: true }));
+        }
+        return matches;
+    }
+    return [];
+}
+function collectFromClauseOccurrences(fromClause, target, mode, context) {
+    const usageKind = context.inCte ? 'cte-body-from' : context.inSubquery ? 'subquery-from' : 'from';
+    const matches = collectSourceExpressionOccurrences(fromClause.source, target, mode, context, usageKind);
+    if (fromClause.joins) {
+        for (const join of fromClause.joins) {
+            matches.push(...collectJoinOccurrences(join, target, mode, context));
+        }
+    }
+    return matches;
+}
+function collectJoinOccurrences(join, target, mode, context) {
+    const usageKind = context.inCte ? 'cte-body-from' : context.inSubquery ? 'subquery-from' : 'join';
+    return collectSourceExpressionOccurrences(join.source, target, mode, context, usageKind);
+}
+function collectUsingOccurrences(usingClause, target, mode, context) {
+    return usingClause.getSources().flatMap((source) => collectSourceExpressionOccurrences(source, target, mode, context, 'using'));
+}
+function collectExpressionQueryOccurrences(value, target, mode, context) {
+    if (value instanceof rawsql_ts_1.InlineQuery) {
+        return collectTableOccurrences(value.selectQuery, target, mode, { ...context, inSubquery: true });
+    }
+    if (value instanceof rawsql_ts_1.ArrayQueryExpression) {
+        return collectTableOccurrences(value.query, target, mode, { ...context, inSubquery: true });
+    }
+    if (value instanceof rawsql_ts_1.BinaryExpression) {
+        return [
+            ...collectExpressionQueryOccurrences(value.left, target, mode, context),
+            ...collectExpressionQueryOccurrences(value.right, target, mode, context)
+        ];
+    }
+    if (value instanceof rawsql_ts_1.UnaryExpression) {
+        return collectExpressionQueryOccurrences(value.expression, target, mode, context);
+    }
+    if (value instanceof rawsql_ts_1.FunctionCall) {
+        const matches = [];
+        if (value.argument) {
+            matches.push(...collectExpressionQueryOccurrences(value.argument, target, mode, context));
+        }
+        if (value.filterCondition) {
+            matches.push(...collectExpressionQueryOccurrences(value.filterCondition, target, mode, context));
+        }
+        if (value.internalOrderBy) {
+            for (const order of value.internalOrderBy.order) {
+                matches.push(...collectExpressionQueryOccurrences(order instanceof rawsql_ts_1.OrderByItem ? order.value : order, target, mode, context));
+            }
+        }
+        return matches;
+    }
+    if (value instanceof rawsql_ts_1.CastExpression) {
+        return collectExpressionQueryOccurrences(value.input, target, mode, context);
+    }
+    if (value instanceof rawsql_ts_1.ParenExpression) {
+        return collectExpressionQueryOccurrences(value.expression, target, mode, context);
+    }
+    if (value instanceof rawsql_ts_1.ArrayExpression) {
+        return collectExpressionQueryOccurrences(value.expression, target, mode, context);
+    }
+    if (value instanceof rawsql_ts_1.ArraySliceExpression) {
+        return [
+            ...collectExpressionQueryOccurrences(value.array, target, mode, context),
+            ...(value.startIndex ? collectExpressionQueryOccurrences(value.startIndex, target, mode, context) : []),
+            ...(value.endIndex ? collectExpressionQueryOccurrences(value.endIndex, target, mode, context) : [])
+        ];
+    }
+    if (value instanceof rawsql_ts_1.ArrayIndexExpression) {
+        return [
+            ...collectExpressionQueryOccurrences(value.array, target, mode, context),
+            ...collectExpressionQueryOccurrences(value.index, target, mode, context)
+        ];
+    }
+    if (value instanceof rawsql_ts_1.ValueList) {
+        return value.values.flatMap((entry) => collectExpressionQueryOccurrences(entry, target, mode, context));
+    }
+    if (value instanceof rawsql_ts_1.BetweenExpression) {
+        return [
+            ...collectExpressionQueryOccurrences(value.expression, target, mode, context),
+            ...collectExpressionQueryOccurrences(value.lower, target, mode, context),
+            ...collectExpressionQueryOccurrences(value.upper, target, mode, context)
+        ];
+    }
+    if (value instanceof rawsql_ts_1.CaseExpression) {
+        return [
+            ...(value.condition ? collectExpressionQueryOccurrences(value.condition, target, mode, context) : []),
+            ...collectExpressionQueryOccurrences(value.switchCase, target, mode, context)
+        ];
+    }
+    if (value instanceof rawsql_ts_1.SwitchCaseArgument) {
+        return [
+            ...value.cases.flatMap((item) => collectExpressionQueryOccurrences(item, target, mode, context)),
+            ...(value.elseValue ? collectExpressionQueryOccurrences(value.elseValue, target, mode, context) : [])
+        ];
+    }
+    if (value instanceof rawsql_ts_1.CaseKeyValuePair) {
+        return [
+            ...collectExpressionQueryOccurrences(value.key, target, mode, context),
+            ...collectExpressionQueryOccurrences(value.value, target, mode, context)
+        ];
+    }
+    if (value instanceof rawsql_ts_1.TupleExpression) {
+        return value.values.flatMap((entry) => collectExpressionQueryOccurrences(entry, target, mode, context));
+    }
+    if (value instanceof rawsql_ts_1.StringSpecifierExpression || value instanceof rawsql_ts_1.IdentifierString || value instanceof rawsql_ts_1.RawString) {
+        return [];
+    }
+    return [];
+}
+function collectSourceExpressionOccurrences(source, target, mode, context, usageKind) {
+    if (source.datasource instanceof rawsql_ts_2.TableSource) {
+        const qualified = getQualifiedTable(source.datasource);
+        if (matchesTargetTable(qualified, target, mode)) {
+            return [{
+                    usageKind,
+                    searchTerms: buildTableSearchTerms({
+                        ...target,
+                        table: qualified.table,
+                        schema: qualified.schema
+                    }, mode),
+                    confidence: mode === 'exact' ? 'high' : 'low',
+                    notes: mode === 'exact' ? [] : ['relaxed-match-any-schema'],
+                    clauseAnchor: resolveClauseAnchor(usageKind),
+                    strongClauseMatch: mode === 'exact'
+                }];
+        }
+        return [];
+    }
+    if (source.datasource instanceof rawsql_ts_1.SubQuerySource) {
+        return collectTableOccurrences(source.datasource.query, target, mode, { ...context, inSubquery: true });
+    }
+    if (source.datasource instanceof rawsql_ts_1.ParenSource) {
+        return collectSourceExpressionOccurrences(new rawsql_ts_1.SourceExpression(source.datasource.source, source.aliasExpression), target, mode, context, usageKind);
+    }
+    return [];
+}
+function getQualifiedTable(source) {
+    var _a;
+    const schema = ((_a = source.namespaces) === null || _a === void 0 ? void 0 : _a.map((value) => value.name).join('.')) || undefined;
+    const table = source.table.name;
+    return {
+        schema,
+        table,
+        full: schema ? `${schema}.${table}` : table
+    };
+}
+function matchesTargetTable(table, target, mode) {
+    if (mode === 'exact') {
+        return target.schema !== undefined && target.table !== undefined && table.full.toLowerCase() === `${target.schema}.${target.table}`.toLowerCase();
+    }
+    return target.table !== undefined && table.table.toLowerCase() === target.table.toLowerCase();
+}
+function buildTableSearchTerms(target, mode) {
+    if (mode === 'exact') {
+        return target.schema && target.table ? [`${target.schema}.${target.table}`] : [];
+    }
+    if (mode === 'any-schema') {
+        return target.table ? [target.table] : [];
+    }
+    return target.table ? [target.table] : [];
+}
+function toTableMatch(statement, occurrence) {
+    const located = (0, location_1.locateUsageText)({
+        statementText: statement.statementText,
+        statementStartOffsetInFile: statement.statementStartOffsetInFile,
+        candidates: occurrence.searchTerms,
+        clauseAnchor: occurrence.clauseAnchor,
+        snippetMode: 'line'
+    });
+    const notes = [...occurrence.notes];
+    let confidence = occurrence.confidence;
+    if (located.ambiguous && !notes.includes('ambiguous-multiple-occurrences')) {
+        notes.push('ambiguous-multiple-occurrences');
+        confidence = 'low';
+    }
+    if (occurrence.strongClauseMatch && !located.ambiguous) {
+        confidence = 'high';
+    }
+    return {
+        kind: 'detail',
+        catalog_id: statement.catalogId,
+        query_id: statement.queryId,
+        statement_fingerprint: statement.statementFingerprint,
+        sql_file: statement.sqlFile,
+        usage_kind: occurrence.usageKind,
+        location: located.location,
+        snippet: located.snippet,
+        confidence,
+        notes: notes.sort(),
+        source: 'ast'
+    };
+}
+function resolveClauseAnchor(usageKind) {
+    switch (usageKind) {
+        case 'from':
+        case 'subquery-from':
+        case 'cte-body-from':
+            return { kind: usageKind, tokens: ['FROM'] };
+        case 'join':
+            return { kind: usageKind, tokens: ['JOIN'] };
+        case 'insert-target':
+            return { kind: usageKind, tokens: ['INSERT', 'INTO'] };
+        case 'update-target':
+            return { kind: usageKind, tokens: ['UPDATE'] };
+        case 'delete-target':
+            return { kind: usageKind, tokens: ['DELETE', 'FROM'] };
+        case 'using':
+            return { kind: usageKind, tokens: ['USING'] };
+        default:
+            return { kind: usageKind, tokens: ['FROM'] };
+    }
+}
+//# sourceMappingURL=analyzeTableUsage.js.map

package/dist/query/analyzeTableUsage.js.map

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

package/dist/query/format.d.ts

@@ -0,0 +1,17 @@
+import type { QueryUsageMatch, QueryUsageReport, QueryUsageWarning } from './types';
+/**
+ * Sort matches in a deterministic, machine-friendly order.
+ */
+export declare function sortQueryUsageMatches(matches: QueryUsageMatch[]): QueryUsageMatch[];
+/**
+ * Sort warnings in a deterministic order.
+ */
+export declare function sortQueryUsageWarnings(warnings: QueryUsageWarning[]): QueryUsageWarning[];
+/**
+ * Format query usage output for text or JSON output.
+ */
+export declare function formatQueryUsageReport(report: QueryUsageReport, format: 'text' | 'json'): string;
+export declare function applyQueryOutputControls(report: QueryUsageReport, options: {
+    limit?: number;
+    summaryOnly?: boolean;
+}): QueryUsageReport;

package/dist/query/format.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortQueryUsageMatches = sortQueryUsageMatches;
+exports.sortQueryUsageWarnings = sortQueryUsageWarnings;
+exports.formatQueryUsageReport = formatQueryUsageReport;
+exports.applyQueryOutputControls = applyQueryOutputControls;
+/**
+ * Sort matches in a deterministic, machine-friendly order.
+ */
+function sortQueryUsageMatches(matches) {
+    return [...matches].sort((a, b) => a.catalog_id.localeCompare(b.catalog_id) ||
+        a.sql_file.localeCompare(b.sql_file) ||
+        compareNullableNumber(getLocationStart(a), getLocationStart(b)) ||
+        a.query_id.localeCompare(b.query_id) ||
+        compareUsageKey(a).localeCompare(compareUsageKey(b)));
+}
+/**
+ * Sort warnings in a deterministic order.
+ */
+function sortQueryUsageWarnings(warnings) {
+    return [...warnings].sort((a, b) => {
+        var _a, _b, _c, _d, _e, _f;
+        return ((_a = a.catalog_id) !== null && _a !== void 0 ? _a : '').localeCompare((_b = b.catalog_id) !== null && _b !== void 0 ? _b : '') ||
+            ((_c = a.query_id) !== null && _c !== void 0 ? _c : '').localeCompare((_d = b.query_id) !== null && _d !== void 0 ? _d : '') ||
+            ((_e = a.sql_file) !== null && _e !== void 0 ? _e : '').localeCompare((_f = b.sql_file) !== null && _f !== void 0 ? _f : '') ||
+            a.code.localeCompare(b.code) ||
+            a.message.localeCompare(b.message);
+    });
+}
+/**
+ * Format query usage output for text or JSON output.
+ */
+function formatQueryUsageReport(report, format) {
+    var _a, _b, _c;
+    if (format === 'json') {
+        return `${JSON.stringify(report, null, 2)}\n`;
+    }
+    const lines = [
+        `mode: ${report.mode}`,
+        `view: ${report.view}`,
+        `target: ${report.target.kind} ${report.target.raw}`,
+        `catalogs: ${report.summary.catalogsScanned}`,
+        `statements: ${report.summary.statementsScanned}`,
+        `matches: ${report.summary.matches}`,
+        `fallback matches: ${report.summary.fallbackMatches}`,
+        `parse warnings: ${report.summary.parseWarnings}`,
+        `unresolved sql files: ${report.summary.unresolvedSqlFiles}`
+    ];
+    if (report.display) {
+        lines.push(`returned matches: ${report.display.returnedMatches}`);
+        lines.push(`returned warnings: ${report.display.returnedWarnings}`);
+        lines.push(`summary only: ${report.display.summaryOnly}`);
+        if (report.display.limit !== undefined) {
+            lines.push(`limit: ${report.display.limit}`);
+        }
+        lines.push(`truncated: ${report.display.truncated}`);
+    }
+    if (report.warnings.length > 0) {
+        lines.push('', 'Warnings:');
+        for (const warning of report.warnings) {
+            lines.push(`- [${warning.code}] ${((_a = warning.catalog_id) !== null && _a !== void 0 ? _a : '-')} ${((_b = warning.query_id) !== null && _b !== void 0 ? _b : '-')} ${((_c = warning.sql_file) !== null && _c !== void 0 ? _c : '-')}`);
+            lines.push(`  ${warning.message}`);
+        }
+    }
+    if (report.view === 'impact') {
+        lines.push('', 'Affected queries:');
+        appendImpactMatches(lines, report.matches);
+        return `${lines.join('\n')}\n`;
+    }
+    const primary = report.matches.filter((match) => match.source === 'ast');
+    const fallback = report.matches.filter((match) => match.source === 'fallback');
+    lines.push('', 'Primary matches:');
+    appendDetailMatches(lines, primary);
+    lines.push('', 'Fallback-derived matches:');
+    appendDetailMatches(lines, fallback);
+    return `${lines.join('\n')}\n`;
+}
+function applyQueryOutputControls(report, options) {
+    const summaryOnly = Boolean(options.summaryOnly);
+    const limit = options.limit;
+    const totalMatches = report.matches.length;
+    const totalWarnings = report.warnings.length;
+    let matches = summaryOnly ? [] : report.matches;
+    let warnings = summaryOnly ? [] : report.warnings;
+    if (!summaryOnly && limit !== undefined) {
+        matches = matches.slice(0, limit);
+        warnings = warnings.slice(0, limit);
+    }
+    return {
+        ...report,
+        matches,
+        warnings,
+        display: {
+            summaryOnly,
+            limit,
+            totalMatches,
+            returnedMatches: matches.length,
+            totalWarnings,
+            returnedWarnings: warnings.length,
+            truncated: summaryOnly || matches.length < totalMatches || warnings.length < totalWarnings
+        }
+    };
+}
+function appendImpactMatches(lines, matches) {
+    if (matches.length === 0) {
+        lines.push('(none)');
+        return;
+    }
+    for (const match of matches) {
+        lines.push(`- ${match.catalog_id} ${match.query_id} ${match.confidence}`);
+        lines.push(`  sql_file: ${match.sql_file}`);
+        lines.push(`  statement_fingerprint: ${match.statement_fingerprint}`);
+        lines.push(`  source: ${match.source}`);
+        lines.push(`  usageKinds: ${formatUsageKindCounts(match.usageKindCounts)}`);
+        lines.push(`  notes: ${match.notes.length > 0 ? match.notes.join(', ') : '(none)'}`);
+    }
+}
+function appendDetailMatches(lines, matches) {
+    if (matches.length === 0) {
+        lines.push('(none)');
+        return;
+    }
+    for (const match of matches) {
+        lines.push(`- ${match.catalog_id} ${match.query_id} ${match.usage_kind} ${match.confidence}`);
+        lines.push(`  sql_file: ${match.sql_file}`);
+        lines.push(`  statement_fingerprint: ${match.statement_fingerprint}`);
+        lines.push(`  source: ${match.source}`);
+        lines.push(`  snippet: ${match.snippet}`);
+        lines.push(`  notes: ${match.notes.length > 0 ? match.notes.join(', ') : '(none)'}`);
+        lines.push(`  exprHints: ${match.exprHints && match.exprHints.length > 0 ? match.exprHints.join(', ') : '(none)'}`);
+        lines.push(`  location: ${formatLocation(match)}`);
+    }
+}
+function formatUsageKindCounts(value) {
+    return Object.keys(value)
+        .sort()
+        .map((usageKind) => `${usageKind}=${value[usageKind]}`)
+        .join(', ');
+}
+function formatLocation(match) {
+    if (!match.location) {
+        return '(unresolved)';
+    }
+    return `${match.location.startLine}:${match.location.startColumn}-${match.location.endLine}:${match.location.endColumn} @ ${match.location.fileOffsetStart}-${match.location.fileOffsetEnd}`;
+}
+function getLocationStart(match) {
+    var _a, _b, _c, _d;
+    if (match.kind === 'impact') {
+        return (_c = (_b = (_a = match.representatives) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.location) === null || _c === void 0 ? void 0 : _c.fileOffsetStart;
+    }
+    return (_d = match.location) === null || _d === void 0 ? void 0 : _d.fileOffsetStart;
+}
+function compareUsageKey(match) {
+    if (match.kind === 'impact') {
+        return Object.keys(match.usageKindCounts).sort().join(',');
+    }
+    return match.usage_kind;
+}
+function compareNullableNumber(left, right) {
+    if (left === undefined && right === undefined) {
+        return 0;
+    }
+    if (left === undefined) {
+        return 1;
+    }
+    if (right === undefined) {
+        return -1;
+    }
+    return left - right;
+}
+//# sourceMappingURL=format.js.map

package/dist/query/format.js.map

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

package/dist/query/location.d.ts

@@ -0,0 +1,18 @@
+import type { QueryUsageClauseAnchor, QueryUsageLocation } from './types';
+interface LocatedText {
+    location: QueryUsageLocation | null;
+    snippet: string;
+    ambiguous: boolean;
+}
+export declare function clearStatementCache(): void;
+/**
+ * Locate the best matching occurrence in a statement and project it to file-relative coordinates.
+ */
+export declare function locateUsageText(params: {
+    statementText: string;
+    statementStartOffsetInFile: number;
+    candidates: string[];
+    clauseAnchor?: QueryUsageClauseAnchor;
+    snippetMode?: 'clause' | 'line';
+}): LocatedText;
+export {};