@rawsql-ts/ztd-cli 0.20.0 → 0.20.2

package/dist/query/analysis.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertSupportedStatement = assertSupportedStatement;
+exports.analyzeStatement = analyzeStatement;
+exports.detectQueryType = detectQueryType;
+exports.buildDependencyMap = buildDependencyMap;
+exports.collectRootDependencies = collectRootDependencies;
+exports.collectReachableCtes = collectReachableCtes;
+exports.collectDependencyClosure = collectDependencyClosure;
+exports.collectDirectSources = collectDirectSources;
+exports.isSelectStatement = isSelectStatement;
+exports.uniquePreservingOrder = uniquePreservingOrder;
+const rawsql_ts_1 = require("rawsql-ts");
+function assertSupportedStatement(parsed, commandName) {
+    if (parsed instanceof rawsql_ts_1.SimpleSelectQuery ||
+        parsed instanceof rawsql_ts_1.BinarySelectQuery ||
+        parsed instanceof rawsql_ts_1.ValuesQuery ||
+        parsed instanceof rawsql_ts_1.InsertQuery ||
+        parsed instanceof rawsql_ts_1.UpdateQuery ||
+        parsed instanceof rawsql_ts_1.DeleteQuery) {
+        return parsed;
+    }
+    throw new Error(`${commandName} supports SELECT/INSERT/UPDATE/DELETE statements only.`);
+}
+function analyzeStatement(statement) {
+    const cteCollector = new rawsql_ts_1.CTECollector();
+    const ctes = cteCollector.collect(statement);
+    const cteNames = ctes.map((cte) => cte.aliasExpression.table.name);
+    const dependencyMap = buildDependencyMap(statement, ctes);
+    const rootDependencies = collectRootDependencies(statement, cteNames);
+    return {
+        statement,
+        ctes,
+        cteNames,
+        dependencyMap,
+        rootDependencies
+    };
+}
+function detectQueryType(statement) {
+    if (statement instanceof rawsql_ts_1.InsertQuery) {
+        return 'INSERT';
+    }
+    if (statement instanceof rawsql_ts_1.UpdateQuery) {
+        return 'UPDATE';
+    }
+    if (statement instanceof rawsql_ts_1.DeleteQuery) {
+        return 'DELETE';
+    }
+    return 'SELECT';
+}
+function buildDependencyMap(statement, ctes) {
+    const cteNames = ctes.map((cte) => cte.aliasExpression.table.name);
+    if (statement instanceof rawsql_ts_1.SimpleSelectQuery) {
+        const analyzer = new rawsql_ts_1.CTEDependencyAnalyzer();
+        analyzer.analyzeDependencies(statement);
+        return new Map(cteNames.map((name) => [name, analyzer.getDependencies(name).filter((dependency) => cteNames.includes(dependency))]));
+    }
+    const collector = new rawsql_ts_1.CTETableReferenceCollector();
+    const cteNameSet = new Set(cteNames);
+    return new Map(ctes.map((cte) => {
+        const references = collector.collect(cte.query).map((source) => source.table.name);
+        const dependencies = Array.from(new Set(references.filter((reference) => cteNameSet.has(reference) && reference !== cte.aliasExpression.table.name)));
+        return [cte.aliasExpression.table.name, dependencies];
+    }));
+}
+function collectRootDependencies(statement, cteNames) {
+    const cteNameSet = new Set(cteNames);
+    if (isSelectStatement(statement)) {
+        return collectReferencedCteNames(cteNameSet, statement);
+    }
+    if (statement instanceof rawsql_ts_1.InsertQuery) {
+        return statement.selectQuery
+            ? collectReferencedCteNames(cteNameSet, assertSelectStatement(statement.selectQuery))
+            : [];
+    }
+    if (statement instanceof rawsql_ts_1.UpdateQuery) {
+        return collectReferencedCteNames(cteNameSet, statement.updateClause.source, statement.fromClause, statement.whereClause);
+    }
+    return collectReferencedCteNames(cteNameSet, statement.deleteClause.source, statement.usingClause, statement.whereClause);
+}
+function collectReachableCtes(rootDependencies, dependencyMap, stopSet = new Set()) {
+    var _a;
+    const visited = new Set();
+    const queue = [...rootDependencies];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current || visited.has(current)) {
+            continue;
+        }
+        visited.add(current);
+        // Treat already-satisfied CTEs as traversal stops so downstream slices stay minimal.
+        if (stopSet.has(current)) {
+            continue;
+        }
+        for (const dependency of (_a = dependencyMap.get(current)) !== null && _a !== void 0 ? _a : []) {
+            if (!visited.has(dependency)) {
+                queue.push(dependency);
+            }
+        }
+    }
+    return visited;
+}
+function collectDependencyClosure(targetName, dependencyMap, stopSet = new Set()) {
+    const ordered = [];
+    const visiting = new Set();
+    const visited = new Set();
+    function visit(name) {
+        var _a;
+        if (visited.has(name) || visiting.has(name)) {
+            return;
+        }
+        visiting.add(name);
+        // Preserve the stop node itself, but do not recurse into its upstream dependencies.
+        if (!stopSet.has(name)) {
+            for (const dependency of (_a = dependencyMap.get(name)) !== null && _a !== void 0 ? _a : []) {
+                visit(dependency);
+            }
+        }
+        visiting.delete(name);
+        visited.add(name);
+        ordered.push(name);
+    }
+    visit(targetName);
+    return ordered;
+}
+function collectDirectSources(statement) {
+    var _a, _b;
+    if (isSelectStatement(statement)) {
+        return collectSelectSources(statement);
+    }
+    if (statement instanceof rawsql_ts_1.InsertQuery) {
+        return statement.selectQuery
+            ? collectDirectSources(assertSelectStatement(statement.selectQuery))
+            : [statement.insertClause.source];
+    }
+    if (statement instanceof rawsql_ts_1.UpdateQuery) {
+        return [statement.updateClause.source, ...collectSourcesFromFromClause(statement.fromClause)];
+    }
+    return [statement.deleteClause.source, ...((_b = (_a = statement.usingClause) === null || _a === void 0 ? void 0 : _a.getSources()) !== null && _b !== void 0 ? _b : [])];
+}
+function isSelectStatement(statement) {
+    return statement instanceof rawsql_ts_1.SimpleSelectQuery || statement instanceof rawsql_ts_1.BinarySelectQuery || statement instanceof rawsql_ts_1.ValuesQuery;
+}
+function collectReferencedCteNames(cteNameSet, ...components) {
+    const collector = new rawsql_ts_1.CTETableReferenceCollector();
+    const names = components.flatMap((component) => {
+        if (!component) {
+            return [];
+        }
+        return collector.collect(component).map((source) => source.table.name);
+    });
+    return uniquePreservingOrder(names.filter((name) => cteNameSet.has(name)));
+}
+function uniquePreservingOrder(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        if (seen.has(value)) {
+            continue;
+        }
+        seen.add(value);
+        result.push(value);
+    }
+    return result;
+}
+function collectSelectSources(statement) {
+    if (statement instanceof rawsql_ts_1.BinarySelectQuery) {
+        return [
+            ...collectSelectSources(assertSelectStatement(statement.left)),
+            ...collectSelectSources(assertSelectStatement(statement.right))
+        ];
+    }
+    if (statement instanceof rawsql_ts_1.ValuesQuery) {
+        return [];
+    }
+    return collectSourcesFromFromClause(statement.fromClause);
+}
+function assertSelectStatement(statement) {
+    if (statement instanceof rawsql_ts_1.SimpleSelectQuery ||
+        statement instanceof rawsql_ts_1.BinarySelectQuery ||
+        statement instanceof rawsql_ts_1.ValuesQuery) {
+        return statement;
+    }
+    throw new Error('Expected a SELECT-compatible statement.');
+}
+function collectSourcesFromFromClause(fromClause) {
+    if (!fromClause) {
+        return [];
+    }
+    return fromClause.getSources();
+}
+//# sourceMappingURL=analysis.js.map

package/dist/query/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/query/analysis.ts"],"names":[],"mappings":";;AAyBA,4DAaC;AAED,4CAcC;AAED,0CAWC;AAED,gDAyBC;AAED,0DAkBC;AAED,oDA6BC;AAED,4DA8BC;AAED,oDAaC;AAED,8CAEC;AAeD,sDAWC;AA9ND,yCAYmB;AAanB,SAAgB,wBAAwB,CAAC,MAA0C,EAAE,WAAmB;IACtG,IACE,MAAM,YAAY,6BAAiB;QACnC,MAAM,YAAY,6BAAiB;QACnC,MAAM,YAAY,uBAAW;QAC7B,MAAM,YAAY,uBAAW;QAC7B,MAAM,YAAY,uBAAW;QAC7B,MAAM,YAAY,uBAAW,EAC7B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,wDAAwD,CAAC,CAAC;AAC1F,CAAC;AAED,SAAgB,gBAAgB,CAAC,SAA6B;IAC5D,MAAM,YAAY,GAAG,IAAI,wBAAY,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEtE,OAAO;QACL,SAAS;QACT,IAAI;QACJ,QAAQ;QACR,aAAa;QACb,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe,CAAC,SAA6B;IAC3D,IAAI,SAAS,YAAY,uBAAW,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,SAAS,YAAY,uBAAW,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,SAAS,YAAY,uBAAW,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,kBAAkB,CAChC,SAA6B,EAC7B,IAAyC;IAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnE,IAAI,SAAS,YAAY,6BAAiB,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,iCAAqB,EAAE,CAAC;QAC7C,QAAQ,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,IAAI,GAAG,CACZ,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CACrH,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,sCAA0B,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,IAAI,GAAG,CACZ,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnF,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,SAAS,KAAK,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACrH,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACxD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAgB,uBAAuB,CAAC,SAA6B,EAAE,QAAkB;IACvF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO,yBAAyB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,SAAS,YAAY,uBAAW,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC,WAAW;YAC1B,CAAC,CAAC,yBAAyB,CAAC,UAAU,EAAE,qBAAqB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACrF,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAED,IAAI,SAAS,YAAY,uBAAW,EAAE,CAAC;QACrC,OAAO,yBAAyB,CAAC,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3H,CAAC;IAED,OAAO,yBAAyB,CAAC,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;AAC5H,CAAC;AAED,SAAgB,oBAAoB,CAClC,gBAA0B,EAC1B,aAAoC,EACpC,UAA+B,IAAI,GAAG,EAAU;;IAEhD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAEpC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAErB,qFAAqF;QACrF,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,MAAA,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,mCAAI,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,wBAAwB,CACtC,UAAkB,EAClB,aAAoC,EACpC,UAA+B,IAAI,GAAG,EAAU;IAEhD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,SAAS,KAAK,CAAC,IAAY;;QACzB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEnB,oFAAoF;QACpF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,KAAK,MAAM,UAAU,IAAI,MAAA,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,mCAAI,EAAE,EAAE,CAAC;gBACvD,KAAK,CAAC,UAAU,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,oBAAoB,CAAC,SAA6B;;IAChE,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,SAAS,YAAY,uBAAW,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC,WAAW;YAC1B,CAAC,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,SAAS,YAAY,uBAAW,EAAE,CAAC;QACrC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,4BAA4B,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,MAAA,MAAA,SAAS,CAAC,WAAW,0CAAE,UAAU,EAAE,mCAAI,EAAE,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,SAAgB,iBAAiB,CAAC,SAA6B;IAC7D,OAAO,SAAS,YAAY,6BAAiB,IAAI,SAAS,YAAY,6BAAiB,IAAI,SAAS,YAAY,uBAAW,CAAC;AAC9H,CAAC;AAED,SAAS,yBAAyB,CAAC,UAAuB,EAAE,GAAG,UAA0F;IACvJ,MAAM,SAAS,GAAG,IAAI,sCAA0B,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,OAAO,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAgB;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,SAA8D;IAC1F,IAAI,SAAS,YAAY,6BAAiB,EAAE,CAAC;QAC3C,OAAO;YACL,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC9D,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;SAChE,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,YAAY,uBAAW,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,4BAA4B,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAkB;IAC/C,IACE,SAAS,YAAY,6BAAiB;QACtC,SAAS,YAAY,6BAAiB;QACtC,SAAS,YAAY,uBAAW,EAChC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,4BAA4B,CAAC,UAAyC;IAC7E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC;AACjC,CAAC"}

package/dist/query/analyzeColumnUsage.d.ts

@@ -0,0 +1,10 @@
+import type { CatalogStatement } from '../utils/sqlCatalogStatements';
+import type { QueryUsageAnalyzerResult, QueryUsageMode, QueryUsageTarget } from './types';
+/**
+ * Analyze column usage for a single statement using AST traversal with explicit uncertainty labeling.
+ */
+export declare function analyzeColumnUsage(params: {
+    statement: CatalogStatement;
+    target: QueryUsageTarget;
+    mode: QueryUsageMode;
+}): QueryUsageAnalyzerResult;

package/dist/query/analyzeColumnUsage.js

@@ -0,0 +1,451 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeColumnUsage = analyzeColumnUsage;
+const rawsql_ts_1 = require("rawsql-ts");
+const location_1 = require("./location");
+/**
+ * Analyze column usage for a single statement using AST traversal with explicit uncertainty labeling.
+ */
+function analyzeColumnUsage(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 = collectColumnOccurrences(parsed, params.target, params.mode);
+    return {
+        matches: occurrences.map((occurrence) => toColumnMatch(params.statement, occurrence)),
+        warnings: []
+    };
+}
+function collectColumnOccurrences(parsed, target, mode, context = {}) {
+    var _a, _b, _c, _d;
+    if (parsed instanceof rawsql_ts_1.SimpleSelectQuery) {
+        const matches = [];
+        if (parsed.withClause) {
+            for (const table of parsed.withClause.tables) {
+                matches.push(...collectColumnOccurrences(table.query, target, mode, { inCte: true }));
+            }
+        }
+        const scope = buildScope((_a = parsed.fromClause) !== null && _a !== void 0 ? _a : undefined, target, mode);
+        if (parsed.fromClause) {
+            matches.push(...collectNestedSourceQueryMatches(parsed.fromClause.source, target, mode));
+        }
+        for (const item of parsed.selectClause.items) {
+            matches.push(...collectSelectItemMatches(item, target, mode, scope, context));
+        }
+        if (parsed.whereClause) {
+            matches.push(...collectExpressionMatches(parsed.whereClause.condition, target, mode, scope, context, 'where', []));
+        }
+        if (parsed.groupByClause) {
+            for (const group of parsed.groupByClause.grouping) {
+                matches.push(...collectExpressionMatches(group, target, mode, scope, context, 'group-by', []));
+            }
+        }
+        if (parsed.havingClause) {
+            matches.push(...collectExpressionMatches(parsed.havingClause.condition, target, mode, scope, context, 'having', []));
+        }
+        if (parsed.orderByClause) {
+            for (const order of parsed.orderByClause.order) {
+                matches.push(...collectExpressionMatches(order instanceof rawsql_ts_1.OrderByItem ? order.value : order, target, mode, scope, context, 'order-by', []));
+            }
+        }
+        if ((_b = parsed.fromClause) === null || _b === void 0 ? void 0 : _b.joins) {
+            for (const join of parsed.fromClause.joins) {
+                matches.push(...collectNestedSourceQueryMatches(join.source, target, mode));
+                matches.push(...collectJoinMatches(join, target, mode, scope, context));
+            }
+        }
+        return matches;
+    }
+    if (parsed instanceof rawsql_ts_1.UpdateQuery) {
+        const matches = [];
+        if (parsed.withClause) {
+            for (const table of parsed.withClause.tables) {
+                matches.push(...collectColumnOccurrences(table.query, target, mode, { inCte: true }));
+            }
+        }
+        const scope = buildScope((_c = parsed.fromClause) !== null && _c !== void 0 ? _c : undefined, target, mode, parsed.updateClause.source);
+        for (const item of parsed.setClause.items) {
+            if (matchesColumnName(item.column.name, target)) {
+                matches.push(buildExplicitOccurrence(item.column.name, mode, 'update-set', [], context));
+            }
+            matches.push(...collectExpressionMatches(item.value, target, mode, scope, context, 'update-set', []));
+        }
+        if (parsed.whereClause) {
+            matches.push(...collectExpressionMatches(parsed.whereClause.condition, target, mode, scope, context, 'where', []));
+        }
+        if (parsed.returningClause) {
+            for (const item of parsed.returningClause.items) {
+                matches.push(...collectSelectItemMatches(item, target, mode, scope, context, 'returning'));
+            }
+        }
+        if ((_d = parsed.fromClause) === null || _d === void 0 ? void 0 : _d.joins) {
+            for (const join of parsed.fromClause.joins) {
+                matches.push(...collectJoinMatches(join, target, mode, scope, context));
+            }
+        }
+        return matches;
+    }
+    if (parsed instanceof rawsql_ts_1.DeleteQuery) {
+        const matches = [];
+        if (parsed.withClause) {
+            for (const table of parsed.withClause.tables) {
+                matches.push(...collectColumnOccurrences(table.query, target, mode, { inCte: true }));
+            }
+        }
+        const scope = buildScope(undefined, target, mode, parsed.deleteClause.source);
+        if (parsed.whereClause) {
+            matches.push(...collectExpressionMatches(parsed.whereClause.condition, target, mode, scope, context, 'where', []));
+        }
+        if (parsed.returningClause) {
+            for (const item of parsed.returningClause.items) {
+                matches.push(...collectSelectItemMatches(item, target, mode, scope, context, 'returning'));
+            }
+        }
+        return matches;
+    }
+    if (parsed instanceof rawsql_ts_1.InsertQuery) {
+        const scope = buildScope(undefined, target, mode, parsed.insertClause.source);
+        const matches = [];
+        if (parsed.insertClause.columns) {
+            for (const column of parsed.insertClause.columns) {
+                if (matchesColumnName(column.name, target)) {
+                    matches.push(buildExplicitOccurrence(column.name, mode, 'insert-column', [], context));
+                }
+            }
+        }
+        if (parsed.selectQuery) {
+            matches.push(...collectColumnOccurrences(parsed.selectQuery, target, mode, { inSubquery: true }));
+        }
+        if (parsed.returningClause) {
+            for (const item of parsed.returningClause.items) {
+                matches.push(...collectSelectItemMatches(item, target, mode, scope, context, 'returning'));
+            }
+        }
+        return matches;
+    }
+    return [];
+}
+function buildScope(fromClause, target, mode, primarySource) {
+    const scope = {
+        targetTablePresent: mode === 'any-schema-any-table',
+        aliases: new Set()
+    };
+    if (primarySource) {
+        collectScopeFromSource(primarySource, target, mode, scope);
+    }
+    if (fromClause) {
+        collectScopeFromSource(fromClause.source, target, mode, scope);
+        if (fromClause.joins) {
+            for (const join of fromClause.joins) {
+                collectScopeFromSource(join.source, target, mode, scope);
+            }
+        }
+    }
+    return scope;
+}
+function collectScopeFromSource(source, target, mode, scope) {
+    var _a;
+    if (!(source.datasource instanceof rawsql_ts_1.TableSource)) {
+        return;
+    }
+    const schema = ((_a = source.datasource.namespaces) === null || _a === void 0 ? void 0 : _a.map((value) => value.name).join('.')) || undefined;
+    const table = source.datasource.table.name;
+    const matches = mode === 'exact'
+        ? target.schema !== undefined && target.table !== undefined && `${schema}.${table}`.toLowerCase() === `${target.schema}.${target.table}`.toLowerCase()
+        : mode === 'any-schema'
+            ? target.table !== undefined && table.toLowerCase() === target.table.toLowerCase()
+            : true;
+    if (!matches) {
+        return;
+    }
+    scope.targetTablePresent = true;
+    if (source.aliasExpression) {
+        scope.aliases.add(source.aliasExpression.table.name.toLowerCase());
+    }
+    scope.aliases.add(table.toLowerCase());
+    if (schema) {
+        scope.aliases.add(`${schema}.${table}`.toLowerCase());
+    }
+}
+function collectSelectItemMatches(item, target, mode, scope, context, rootUsageKind = 'select') {
+    return collectExpressionMatches(item.value, target, mode, scope, context, rootUsageKind, ['projection']);
+}
+function collectJoinMatches(join, target, mode, scope, context) {
+    if (!join.condition) {
+        return [];
+    }
+    if (join.condition instanceof rawsql_ts_1.JoinOnClause) {
+        return collectExpressionMatches(join.condition.condition, target, mode, scope, context, 'join-on', []);
+    }
+    if (join.condition instanceof rawsql_ts_1.JoinUsingClause) {
+        return collectExpressionMatches(join.condition.condition, target, mode, scope, context, 'join-using', []);
+    }
+    return [];
+}
+function collectNestedSourceQueryMatches(source, target, mode) {
+    let current = source.datasource;
+    while (current instanceof rawsql_ts_1.ParenSource) {
+        current = current.source;
+    }
+    if (current instanceof rawsql_ts_1.SubQuerySource) {
+        return collectColumnOccurrences(current.query, target, mode, { inSubquery: true });
+    }
+    return [];
+}
+function collectExpressionMatches(value, target, mode, scope, context, rootUsageKind, exprHints) {
+    if (value instanceof rawsql_ts_1.ColumnReference) {
+        return collectColumnReferenceMatch(value, target, mode, scope, context, rootUsageKind, exprHints);
+    }
+    if (value instanceof rawsql_ts_1.BinaryExpression) {
+        return [
+            ...collectExpressionMatches(value.left, target, mode, scope, context, rootUsageKind, [...exprHints, 'comparison']),
+            ...collectExpressionMatches(value.right, target, mode, scope, context, rootUsageKind, [...exprHints, 'comparison'])
+        ];
+    }
+    if (value instanceof rawsql_ts_1.UnaryExpression) {
+        return collectExpressionMatches(value.expression, target, mode, scope, context, rootUsageKind, exprHints);
+    }
+    if (value instanceof rawsql_ts_1.FunctionCall) {
+        const nestedHints = [...exprHints, 'function'];
+        const functionName = value.name instanceof rawsql_ts_1.IdentifierString ? value.name.name : value.name.value;
+        if (['count', 'sum', 'avg', 'min', 'max'].includes(functionName.toLowerCase())) {
+            nestedHints.push('aggregate');
+        }
+        const matches = [];
+        if (value.argument) {
+            matches.push(...collectExpressionMatches(value.argument, target, mode, scope, context, rootUsageKind, nestedHints));
+        }
+        if (value.filterCondition) {
+            matches.push(...collectExpressionMatches(value.filterCondition, target, mode, scope, context, rootUsageKind, nestedHints));
+        }
+        if (value.internalOrderBy) {
+            for (const order of value.internalOrderBy.order) {
+                matches.push(...collectExpressionMatches(order instanceof rawsql_ts_1.OrderByItem ? order.value : order, target, mode, scope, context, rootUsageKind, nestedHints));
+            }
+        }
+        return matches;
+    }
+    if (value instanceof rawsql_ts_1.CastExpression) {
+        return collectExpressionMatches(value.input, target, mode, scope, context, rootUsageKind, [...exprHints, 'cast']);
+    }
+    if (value instanceof rawsql_ts_1.ParenExpression) {
+        return collectExpressionMatches(value.expression, target, mode, scope, context, rootUsageKind, exprHints);
+    }
+    if (value instanceof rawsql_ts_1.InlineQuery) {
+        return collectColumnOccurrences(value.selectQuery, target, mode, { inSubquery: true });
+    }
+    if (value instanceof rawsql_ts_1.ArrayQueryExpression) {
+        return collectColumnOccurrences(value.query, target, mode, { inSubquery: true });
+    }
+    if (value instanceof rawsql_ts_1.ArrayExpression) {
+        return collectExpressionMatches(value.expression, target, mode, scope, context, rootUsageKind, exprHints);
+    }
+    if (value instanceof rawsql_ts_1.ArraySliceExpression) {
+        return [
+            ...collectExpressionMatches(value.array, target, mode, scope, context, rootUsageKind, exprHints),
+            ...(value.startIndex ? collectExpressionMatches(value.startIndex, target, mode, scope, context, rootUsageKind, exprHints) : []),
+            ...(value.endIndex ? collectExpressionMatches(value.endIndex, target, mode, scope, context, rootUsageKind, exprHints) : [])
+        ];
+    }
+    if (value instanceof rawsql_ts_1.ArrayIndexExpression) {
+        return [
+            ...collectExpressionMatches(value.array, target, mode, scope, context, rootUsageKind, exprHints),
+            ...collectExpressionMatches(value.index, target, mode, scope, context, rootUsageKind, exprHints)
+        ];
+    }
+    if (value instanceof rawsql_ts_1.ValueList) {
+        return value.values.flatMap((entry) => collectExpressionMatches(entry, target, mode, scope, context, rootUsageKind, exprHints));
+    }
+    if (value instanceof rawsql_ts_1.BetweenExpression) {
+        return [
+            ...collectExpressionMatches(value.expression, target, mode, scope, context, rootUsageKind, [...exprHints, 'comparison']),
+            ...collectExpressionMatches(value.lower, target, mode, scope, context, rootUsageKind, [...exprHints, 'comparison']),
+            ...collectExpressionMatches(value.upper, target, mode, scope, context, rootUsageKind, [...exprHints, 'comparison'])
+        ];
+    }
+    if (value instanceof rawsql_ts_1.CaseExpression) {
+        return [
+            ...(value.condition ? collectExpressionMatches(value.condition, target, mode, scope, context, rootUsageKind, exprHints) : []),
+            ...collectExpressionMatches(value.switchCase, target, mode, scope, context, rootUsageKind, exprHints)
+        ];
+    }
+    if (value instanceof rawsql_ts_1.SwitchCaseArgument) {
+        return [
+            ...value.cases.flatMap((item) => collectExpressionMatches(item, target, mode, scope, context, rootUsageKind, exprHints)),
+            ...(value.elseValue ? collectExpressionMatches(value.elseValue, target, mode, scope, context, rootUsageKind, exprHints) : [])
+        ];
+    }
+    if (value instanceof rawsql_ts_1.CaseKeyValuePair) {
+        return [
+            ...collectExpressionMatches(value.key, target, mode, scope, context, rootUsageKind, exprHints),
+            ...collectExpressionMatches(value.value, target, mode, scope, context, rootUsageKind, exprHints)
+        ];
+    }
+    if (value instanceof rawsql_ts_1.TupleExpression) {
+        return value.values.flatMap((entry) => collectExpressionMatches(entry, target, mode, scope, context, rootUsageKind, exprHints));
+    }
+    if (value instanceof rawsql_ts_1.StringSpecifierExpression || value instanceof rawsql_ts_1.IdentifierString || value instanceof rawsql_ts_1.RawString) {
+        return [];
+    }
+    return [];
+}
+function collectColumnReferenceMatch(value, target, mode, scope, context, rootUsageKind, exprHints) {
+    var _a;
+    const usageKind = context.inCte ? 'cte' : context.inSubquery ? 'subquery' : rootUsageKind;
+    const notes = new Set();
+    const hints = new Set(exprHints);
+    let confidence = mode === 'exact' ? 'high' : 'low';
+    let searchTerms = [];
+    const namespace = (_a = value.namespaces) === null || _a === void 0 ? void 0 : _a.map((entry) => entry.name).join('.').toLowerCase();
+    const columnName = value.column.name;
+    const wildcard = columnName === '*';
+    if (wildcard) {
+        hints.add('wildcard');
+        notes.add('wildcard-select');
+        confidence = 'low';
+        if (!scope.targetTablePresent) {
+            return [];
+        }
+        searchTerms = [namespace ? `${namespace}.*` : '*'];
+    }
+    else {
+        if (!matchesColumnName(columnName, target)) {
+            return [];
+        }
+        if (usageKind === 'join-using') {
+            notes.add('join-using-column');
+            confidence = 'low';
+        }
+        if (!namespace) {
+            notes.add('unqualified-column');
+            confidence = 'low';
+            if (!scope.targetTablePresent && mode !== 'any-schema-any-table') {
+                return [];
+            }
+            searchTerms = [columnName];
+        }
+        else {
+            const matchesNamespace = mode === 'any-schema-any-table' ||
+                scope.aliases.has(namespace) ||
+                (target.table ? namespace === target.table.toLowerCase() : false) ||
+                (target.schema && target.table ? namespace === `${target.schema}.${target.table}`.toLowerCase() : false);
+            if (!matchesNamespace) {
+                return [];
+            }
+            searchTerms = [`${namespace}.${columnName}`, columnName];
+        }
+    }
+    if (context.inSubquery && rootUsageKind === 'select') {
+        notes.add('subquery-projection');
+    }
+    if (context.inCte && rootUsageKind === 'select') {
+        notes.add('cte-projection');
+    }
+    if (mode !== 'exact') {
+        notes.add('relaxed-match-any-schema');
+        if (mode === 'any-schema-any-table') {
+            notes.add('relaxed-match-any-table');
+        }
+        confidence = 'low';
+    }
+    return [{
+            usageKind,
+            searchTerms,
+            confidence,
+            notes: Array.from(notes),
+            exprHints: Array.from(hints),
+            clauseAnchor: resolveClauseAnchor(usageKind)
+        }];
+}
+function buildExplicitOccurrence(columnName, mode, usageKind, exprHints, context) {
+    const notes = new Set();
+    if (mode !== 'exact') {
+        notes.add('relaxed-match-any-schema');
+        if (mode === 'any-schema-any-table') {
+            notes.add('relaxed-match-any-table');
+        }
+    }
+    return {
+        usageKind: context.inCte ? 'cte' : context.inSubquery ? 'subquery' : usageKind,
+        searchTerms: [columnName],
+        confidence: notes.size > 0 ? 'low' : 'high',
+        notes: Array.from(notes),
+        exprHints,
+        clauseAnchor: resolveClauseAnchor(context.inCte ? 'cte' : context.inSubquery ? 'subquery' : usageKind)
+    };
+}
+function matchesColumnName(columnName, target) {
+    return target.column !== undefined && columnName.toLowerCase() === target.column.toLowerCase();
+}
+function toColumnMatch(statement, occurrence) {
+    const located = (0, location_1.locateUsageText)({
+        statementText: statement.statementText,
+        statementStartOffsetInFile: statement.statementStartOffsetInFile,
+        candidates: occurrence.searchTerms,
+        clauseAnchor: occurrence.clauseAnchor
+    });
+    const notes = [...occurrence.notes];
+    let confidence = occurrence.confidence;
+    if (located.ambiguous && !notes.includes('ambiguous-multiple-occurrences')) {
+        notes.push('ambiguous-multiple-occurrences');
+        confidence = 'low';
+    }
+    return {
+        kind: 'detail',
+        catalog_id: statement.catalogId,
+        query_id: statement.queryId,
+        statement_fingerprint: statement.statementFingerprint,
+        sql_file: statement.sqlFile,
+        usage_kind: occurrence.usageKind,
+        exprHints: occurrence.exprHints.length > 0 ? occurrence.exprHints.sort() : undefined,
+        location: located.location,
+        snippet: located.snippet,
+        confidence,
+        notes: notes.sort(),
+        source: 'ast'
+    };
+}
+function resolveClauseAnchor(usageKind) {
+    switch (usageKind) {
+        case 'where':
+            return { kind: usageKind, tokens: ['WHERE'] };
+        case 'order-by':
+            return { kind: usageKind, tokens: ['ORDER', 'BY'] };
+        case 'group-by':
+            return { kind: usageKind, tokens: ['GROUP', 'BY'] };
+        case 'having':
+            return { kind: usageKind, tokens: ['HAVING'] };
+        case 'returning':
+            return { kind: usageKind, tokens: ['RETURNING'] };
+        case 'update-set':
+            return { kind: usageKind, tokens: ['SET'] };
+        case 'join-on':
+            return { kind: usageKind, tokens: ['ON'] };
+        case 'join-using':
+            return { kind: usageKind, tokens: ['USING'] };
+        case 'insert-column':
+            return { kind: usageKind, tokens: ['INSERT', 'INTO'] };
+        case 'select':
+        case 'subquery':
+        case 'cte':
+        case 'unknown':
+        default:
+            return { kind: usageKind, tokens: ['SELECT'] };
+    }
+}
+//# sourceMappingURL=analyzeColumnUsage.js.map