rawsql-ts 0.12.0 → 0.13.0

package/dist/utils/SchemaManager.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Central schema management utility for rawsql-ts.
+ * Converts user-defined table definitions into resolvers and JSON mappings consumed by collectors and builders.
+ *
+ * @example
+ * ```typescript
+ * const manager = new SchemaManager({
+ *   users: {
+ *     name: 'users',
+ *     columns: {
+ *       id: { name: 'id', isPrimaryKey: true },
+ *       email: { name: 'email' }
+ *     }
+ *   }
+ * });
+ *
+ * const resolver = manager.createTableColumnResolver();
+ * const collector = new SchemaCollector(resolver);
+ * const schemas = collector.collect(SelectQueryParser.parse('SELECT * FROM users'));
+ * ```
+ * Related tests: packages/core/tests/transformers/SchemaCollector.test.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaManager = void 0;
+exports.createSchemaManager = createSchemaManager;
+exports.createTableColumnResolver = createTableColumnResolver;
+exports.createJsonMappingFromSchema = createJsonMappingFromSchema;
+// === Schema Manager Class ===
+/**
+ * Central schema management utility for rawsql-ts
+ * Converts user-defined schemas to various internal formats
+ */
+class SchemaManager {
+    constructor(schemas) {
+        this.schemas = schemas;
+        this.validateSchemas();
+    }
+    /**
+     * Validate schema definitions for consistency
+     * Ensures each table has a primary key (required for UPDATE/DELETE operations)
+     * and validates relationship references
+     */
+    validateSchemas() {
+        const tableNames = Object.keys(this.schemas);
+        const errors = [];
+        // Validate each table
+        Object.entries(this.schemas).forEach(([tableName, table]) => {
+            var _a;
+            // Check primary key exists (required for UPDATE/DELETE WHERE conditions)
+            const primaryKeys = Object.entries(table.columns)
+                .filter(([_, col]) => col.isPrimaryKey)
+                .map(([name, _]) => name);
+            if (primaryKeys.length === 0) {
+                errors.push(`Table '${tableName}' has no primary key defined`);
+            }
+            // Validate foreign key references
+            (_a = table.relationships) === null || _a === void 0 ? void 0 : _a.forEach(rel => {
+                if (!tableNames.includes(rel.table)) {
+                    errors.push(`Table '${tableName}' references unknown table '${rel.table}' in relationship`);
+                }
+            });
+        });
+        if (errors.length > 0) {
+            throw new Error(`Schema validation failed:\\n${errors.join('\\n')}`);
+        }
+    }
+    /**
+     * Get table column names for SqlParamInjector TableColumnResolver
+     * @param tableName Name of the table
+     * @returns Array of column names
+     */
+    getTableColumns(tableName) {
+        const table = this.schemas[tableName];
+        if (!table) {
+            return [];
+        }
+        return Object.keys(table.columns);
+    }
+    /**
+     * Create TableColumnResolver function for SqlParamInjector
+     * @returns Function compatible with SqlParamInjector
+     */
+    createTableColumnResolver() {
+        return (tableName) => this.getTableColumns(tableName);
+    }
+    /**
+     * Generate JSON mapping configuration for PostgresJsonQueryBuilder
+     * @param rootTableName Root table for the JSON structure
+     * @returns JSON mapping configuration
+     */
+    createJsonMapping(rootTableName) {
+        var _a;
+        const rootTable = this.schemas[rootTableName];
+        if (!rootTable) {
+            throw new Error(`Table '${rootTableName}' not found in schema registry`);
+        }
+        // Build root entity columns mapping
+        const rootColumns = {};
+        Object.entries(rootTable.columns).forEach(([columnName, column]) => {
+            rootColumns[columnName] = column.jsonAlias || column.name;
+        });
+        // Build nested entities from relationships
+        const nestedEntities = [];
+        (_a = rootTable.relationships) === null || _a === void 0 ? void 0 : _a.forEach(rel => {
+            const relatedTable = this.schemas[rel.table];
+            if (!relatedTable) {
+                throw new Error(`Related table '${rel.table}' not found in schema registry`);
+            }
+            // Build columns mapping for related table
+            const relatedColumns = {};
+            Object.entries(relatedTable.columns).forEach(([columnName, column]) => {
+                relatedColumns[columnName] = column.jsonAlias || column.name;
+            });
+            // Determine relationship type for JSON builder
+            const relationshipType = rel.type;
+            nestedEntities.push({
+                id: rel.propertyName,
+                name: relatedTable.displayName || rel.table,
+                parentId: rootTableName,
+                propertyName: rel.propertyName,
+                relationshipType: relationshipType,
+                columns: relatedColumns
+            });
+        });
+        return {
+            rootName: rootTableName,
+            rootEntity: {
+                id: rootTableName,
+                name: rootTable.displayName || rootTableName,
+                columns: rootColumns
+            },
+            nestedEntities,
+            resultFormat: "single"
+        };
+    }
+    /**
+     * Get all table names in the schema
+     * @returns Array of table names
+     */
+    getTableNames() {
+        return Object.keys(this.schemas);
+    }
+    /**
+     * Get table definition by name
+     * @param tableName Name of the table
+     * @returns Table definition or undefined
+     */
+    getTable(tableName) {
+        return this.schemas[tableName];
+    }
+    /**
+     * Get primary key column name for a table
+     * Used by QueryBuilder.buildUpdateQuery for WHERE clause conditions
+     * @param tableName Name of the table
+     * @returns Primary key column name or undefined
+     */
+    getPrimaryKey(tableName) {
+        const table = this.schemas[tableName];
+        if (!table)
+            return undefined;
+        const primaryKeyEntry = Object.entries(table.columns)
+            .find(([_, col]) => col.isPrimaryKey);
+        return primaryKeyEntry ? primaryKeyEntry[0] : undefined;
+    }
+    /**
+     * Get foreign key relationships for a table
+     * @param tableName Name of the table
+     * @returns Array of foreign key relationships
+     */
+    getForeignKeys(tableName) {
+        const table = this.schemas[tableName];
+        if (!table)
+            return [];
+        const foreignKeys = [];
+        Object.entries(table.columns).forEach(([columnName, column]) => {
+            if (column.foreignKey) {
+                foreignKeys.push({
+                    column: columnName,
+                    referencedTable: column.foreignKey.table,
+                    referencedColumn: column.foreignKey.column
+                });
+            }
+        });
+        return foreignKeys;
+    }
+}
+exports.SchemaManager = SchemaManager;
+// === Convenience Functions ===
+/**
+ * Create a SchemaManager instance from schema definitions
+ * @param schemas Schema registry object
+ * @returns SchemaManager instance
+ */
+function createSchemaManager(schemas) {
+    return new SchemaManager(schemas);
+}
+/**
+ * Create TableColumnResolver function from schema definitions
+ * @param schemas Schema registry object
+ * @returns TableColumnResolver function for SqlParamInjector
+ */
+function createTableColumnResolver(schemas) {
+    const manager = new SchemaManager(schemas);
+    return manager.createTableColumnResolver();
+}
+/**
+ * Create JSON mapping from schema definitions
+ * @param schemas Schema registry object
+ * @param rootTableName Root table name
+ * @returns JSON mapping for PostgresJsonQueryBuilder
+ */
+function createJsonMappingFromSchema(schemas, rootTableName) {
+    const manager = new SchemaManager(schemas);
+    return manager.createJsonMapping(rootTableName);
+}
+//# sourceMappingURL=SchemaManager.js.map

package/dist/utils/SchemaManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaManager.js","sourceRoot":"","sources":["../../src/utils/SchemaManager.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAyPH,kDAEC;AAOD,8DAGC;AAQD,kEAGC;AArND,+BAA+B;AAE/B;;;GAGG;AACH,MAAa,aAAa;IAGtB,YAAY,OAAuB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,eAAe,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACK,eAAe;QACnB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,sBAAsB;QACtB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE;;YACxD,yEAAyE;YACzE,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;iBAC5C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC;iBACtC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YAE9B,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,UAAU,SAAS,8BAA8B,CAAC,CAAC;YACnE,CAAC;YAED,kCAAkC;YAClC,MAAA,KAAK,CAAC,aAAa,0CAAE,OAAO,CAAC,GAAG,CAAC,EAAE;gBAC/B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClC,MAAM,CAAC,IAAI,CAAC,UAAU,SAAS,+BAA+B,GAAG,CAAC,KAAK,mBAAmB,CAAC,CAAC;gBAChG,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,SAAiB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACI,yBAAyB;QAC5B,OAAO,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACI,iBAAiB,CAAC,aAAqB;;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,UAAU,aAAa,gCAAgC,CAAC,CAAC;QAC7E,CAAC;QAED,oCAAoC;QACpC,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE;YAC/D,WAAW,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,2CAA2C;QAC3C,MAAM,cAAc,GAAkC,EAAE,CAAC;QAEzD,MAAA,SAAS,CAAC,aAAa,0CAAE,OAAO,CAAC,GAAG,CAAC,EAAE;YACnC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,KAAK,gCAAgC,CAAC,CAAC;YACjF,CAAC;YAED,0CAA0C;YAC1C,MAAM,cAAc,GAA2B,EAAE,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE;gBAClE,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC;YACjE,CAAC,CAAC,CAAC;YAEH,+CAA+C;YAC/C,MAAM,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC;YAElC,cAAc,CAAC,IAAI,CAAC;gBAChB,EAAE,EAAE,GAAG,CAAC,YAAY;gBACpB,IAAI,EAAE,YAAY,CAAC,WAAW,IAAI,GAAG,CAAC,KAAK;gBAC3C,QAAQ,EAAE,aAAa;gBACvB,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,gBAAgB,EAAE,gBAAsC;gBACxD,OAAO,EAAE,cAAc;aAC1B,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,OAAO;YACH,QAAQ,EAAE,aAAa;YACvB,UAAU,EAAE;gBACR,EAAE,EAAE,aAAa;gBACjB,IAAI,EAAE,SAAS,CAAC,WAAW,IAAI,aAAa;gBAC5C,OAAO,EAAE,WAAW;aACvB;YACD,cAAc;YACd,YAAY,EAAE,QAAiB;SAClC,CAAC;IACN,CAAC;IAED;;;OAGG;IACI,aAAa;QAChB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,SAAiB;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;aAChD,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAE1C,OAAO,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACI,cAAc,CAAC,SAAiB;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,MAAM,WAAW,GAAiF,EAAE,CAAC;QAErG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE;YAC3D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACpB,WAAW,CAAC,IAAI,CAAC;oBACb,MAAM,EAAE,UAAU;oBAClB,eAAe,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK;oBACxC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM;iBAC7C,CAAC,CAAC;YACP,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACvB,CAAC;CACJ;AA/KD,sCA+KC;AAED,gCAAgC;AAEhC;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,OAAuB;IACvD,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CAAC,OAAuB;IAC7D,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC,yBAAyB,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,2BAA2B,CAAC,OAAuB,EAAE,aAAqB;IACtF,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;AACpD,CAAC"}

package/dist/utils/ScopeResolver.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeResolver = void 0;
+const SelectQuery_1 = require("../models/SelectQuery");
+const Clause_1 = require("../models/Clause");
+const CTECollector_1 = require("../transformers/CTECollector");
+const TextPositionUtils_1 = require("./TextPositionUtils");
+/**
+ * Resolves scope information at cursor positions for SQL IntelliSense
+ *
+ * Provides comprehensive scope analysis including table availability, CTE resolution,
+ * and column visibility for intelligent code completion suggestions.
+ *
+ * @example
+ * ```typescript
+ * const sql = `
+ *   WITH users AS (SELECT id, name FROM accounts)
+ *   SELECT u.name FROM users u
+ *   LEFT JOIN orders o ON u.id = o.user_id
+ *   WHERE u.|
+ * `;
+ * const scope = ScopeResolver.resolveAt(sql, { line: 4, column: 12 });
+ *
+ * console.log(scope.availableTables); // [{ name: 'users', alias: 'u' }, { name: 'orders', alias: 'o' }]
+ * console.log(scope.availableCTEs); // [{ name: 'users', columns: ['id', 'name'] }]
+ * ```
+ */
+class ScopeResolver {
+    /**
+     * Resolve scope information at the specified cursor position
+     *
+     * @param sql - SQL text to analyze
+     * @param cursorPosition - Character position of cursor (0-based)
+     * @returns Complete scope information
+     */
+    static resolve(sql, cursorPosition) {
+        // Simplified for suggestion-only focus - return basic scope information
+        // Complex SQL parsing removed to avoid issues with incomplete SQL syntax
+        return this.createEmptyScope();
+    }
+    /**
+     * Resolve scope information at line/column position
+     *
+     * @param sql - SQL text to analyze
+     * @param position - Line and column position (1-based)
+     * @returns Complete scope information
+     */
+    static resolveAt(sql, position) {
+        const charOffset = TextPositionUtils_1.TextPositionUtils.lineColumnToCharOffset(sql, position);
+        if (charOffset === -1) {
+            return this.createEmptyScope();
+        }
+        return this.resolve(sql, charOffset);
+    }
+    /**
+     * Get available columns for a specific table or alias
+     *
+     * @param sql - SQL text containing the query
+     * @param cursorPosition - Cursor position for scope resolution
+     * @param tableOrAlias - Table name or alias to get columns for
+     * @returns Array of available columns for the specified table
+     */
+    static getColumnsForTable(sql, cursorPosition, tableOrAlias) {
+        const scope = this.resolve(sql, cursorPosition);
+        // Find matching table
+        const table = scope.availableTables.find(t => t.name === tableOrAlias || t.alias === tableOrAlias);
+        if (!table) {
+            return [];
+        }
+        // Return columns for this table
+        return scope.visibleColumns.filter(col => col.tableName === table.name ||
+            (table.alias && col.tableAlias === table.alias));
+    }
+    static analyzeScopeFromQuery(query) {
+        const scope = {
+            availableTables: [],
+            availableCTEs: [],
+            subqueryLevel: 0,
+            visibleColumns: [],
+            currentQuery: query,
+            parentQueries: []
+        };
+        if (query instanceof SelectQuery_1.SimpleSelectQuery) {
+            // Collect CTEs
+            scope.availableCTEs = this.collectCTEs(query);
+            // Collect tables from FROM and JOINs
+            scope.availableTables = this.collectTablesFromQuery(query);
+            // Collect visible columns
+            scope.visibleColumns = this.collectVisibleColumns(scope.availableTables, scope.availableCTEs);
+        }
+        else if (query instanceof SelectQuery_1.BinarySelectQuery) {
+            // For UNION queries, analyze both sides
+            const leftScope = this.analyzeScopeFromQuery(query.left);
+            const rightScope = this.analyzeScopeFromQuery(query.right);
+            // Merge scopes (tables from both sides available)
+            scope.availableTables = [...leftScope.availableTables, ...rightScope.availableTables];
+            scope.availableCTEs = [...leftScope.availableCTEs, ...rightScope.availableCTEs];
+            scope.visibleColumns = [...leftScope.visibleColumns, ...rightScope.visibleColumns];
+        }
+        return scope;
+    }
+    static collectCTEs(query) {
+        const ctes = [];
+        if (query.withClause) {
+            const cteCollector = new CTECollector_1.CTECollector();
+            const collectedCTEs = cteCollector.collect(query);
+            for (const cte of collectedCTEs) {
+                ctes.push({
+                    name: cte.getSourceAliasName(),
+                    query: cte.query,
+                    columns: this.extractCTEColumns(cte.query),
+                    materialized: cte.materialized || false
+                });
+            }
+        }
+        return ctes;
+    }
+    static collectTablesFromQuery(query) {
+        const tables = [];
+        // Collect from FROM clause
+        if (query.fromClause) {
+            const fromTables = this.extractTablesFromFromClause(query.fromClause);
+            tables.push(...fromTables);
+        }
+        return tables;
+    }
+    static extractTablesFromFromClause(fromClause) {
+        var _a, _b, _c, _d;
+        const tables = [];
+        // Extract main source table
+        if (fromClause.source.datasource instanceof Clause_1.TableSource) {
+            const table = {
+                name: this.extractTableName(fromClause.source.datasource.qualifiedName),
+                alias: (_a = fromClause.source.aliasExpression) === null || _a === void 0 ? void 0 : _a.table.name,
+                schema: this.extractSchemaName(fromClause.source.datasource.qualifiedName),
+                fullName: this.getQualifiedNameString(fromClause.source.datasource.qualifiedName),
+                sourceType: 'table'
+            };
+            tables.push(table);
+        }
+        else if (fromClause.source.datasource instanceof Clause_1.SubQuerySource) {
+            const table = {
+                name: ((_b = fromClause.source.aliasExpression) === null || _b === void 0 ? void 0 : _b.table.name) || 'subquery',
+                alias: (_c = fromClause.source.aliasExpression) === null || _c === void 0 ? void 0 : _c.table.name,
+                fullName: ((_d = fromClause.source.aliasExpression) === null || _d === void 0 ? void 0 : _d.table.name) || 'subquery',
+                sourceType: 'subquery',
+                originalQuery: fromClause.source.datasource.query
+            };
+            tables.push(table);
+        }
+        // Collect from JOINs
+        if (fromClause.joins) {
+            for (const join of fromClause.joins) {
+                const joinTables = this.extractTablesFromJoin(join);
+                tables.push(...joinTables);
+            }
+        }
+        return tables;
+    }
+    static extractTablesFromJoin(join) {
+        var _a, _b, _c, _d;
+        const tables = [];
+        if (join.source.datasource instanceof Clause_1.TableSource) {
+            const table = {
+                name: this.extractTableName(join.source.datasource.qualifiedName),
+                alias: (_a = join.source.aliasExpression) === null || _a === void 0 ? void 0 : _a.table.name,
+                schema: this.extractSchemaName(join.source.datasource.qualifiedName),
+                fullName: this.getQualifiedNameString(join.source.datasource.qualifiedName),
+                sourceType: 'table'
+            };
+            tables.push(table);
+        }
+        else if (join.source.datasource instanceof Clause_1.SubQuerySource) {
+            const table = {
+                name: ((_b = join.source.aliasExpression) === null || _b === void 0 ? void 0 : _b.table.name) || 'subquery',
+                alias: (_c = join.source.aliasExpression) === null || _c === void 0 ? void 0 : _c.table.name,
+                fullName: ((_d = join.source.aliasExpression) === null || _d === void 0 ? void 0 : _d.table.name) || 'subquery',
+                sourceType: 'subquery',
+                originalQuery: join.source.datasource.query
+            };
+            tables.push(table);
+        }
+        return tables;
+    }
+    static getQualifiedNameString(qualifiedName) {
+        // Use the existing method from QualifiedName to get the string representation
+        return qualifiedName.toString();
+    }
+    static extractTableName(qualifiedName) {
+        const fullName = this.getQualifiedNameString(qualifiedName);
+        const parts = fullName.split('.');
+        return parts[parts.length - 1]; // Last part is table name
+    }
+    static extractSchemaName(qualifiedName) {
+        const fullName = this.getQualifiedNameString(qualifiedName);
+        const parts = fullName.split('.');
+        return parts.length > 1 ? parts[parts.length - 2] : undefined;
+    }
+    static extractCTEColumns(query) {
+        // Try to extract column names from CTE SELECT clause
+        try {
+            if (query instanceof SelectQuery_1.SimpleSelectQuery && query.selectClause) {
+                const columns = [];
+                for (const item of query.selectClause.items) {
+                    // Use alias if available, otherwise try to extract from expression
+                    if (item.identifier) {
+                        columns.push(item.identifier.name);
+                    }
+                    else {
+                        // Try to extract column name from expression
+                        const columnName = this.extractColumnNameFromExpression(item.value);
+                        if (columnName) {
+                            columns.push(columnName);
+                        }
+                    }
+                }
+                return columns;
+            }
+        }
+        catch (error) {
+            // If extraction fails, return undefined
+        }
+        return undefined;
+    }
+    static extractColumnNameFromExpression(expression) {
+        // Simple extraction - can be enhanced based on ValueComponent types
+        if (expression && typeof expression === 'object' && 'value' in expression) {
+            return expression.value;
+        }
+        return undefined;
+    }
+    static collectVisibleColumns(tables, ctes) {
+        const columns = [];
+        // Add columns from CTEs
+        for (const cte of ctes) {
+            if (cte.columns) {
+                for (const columnName of cte.columns) {
+                    columns.push({
+                        name: columnName,
+                        tableName: cte.name,
+                        fullReference: `${cte.name}.${columnName}`
+                    });
+                }
+            }
+        }
+        // For regular tables, we would need schema information to determine columns
+        // This is a placeholder - in practice, this would integrate with database metadata
+        for (const table of tables) {
+            if (table.sourceType === 'table') {
+                // Placeholder - would query database schema
+                columns.push({
+                    name: '*',
+                    tableName: table.name,
+                    tableAlias: table.alias,
+                    fullReference: `${table.alias || table.name}.*`
+                });
+            }
+        }
+        return columns;
+    }
+    static createEmptyScope() {
+        return {
+            availableTables: [],
+            availableCTEs: [],
+            subqueryLevel: 0,
+            visibleColumns: [],
+            parentQueries: []
+        };
+    }
+}
+exports.ScopeResolver = ScopeResolver;
+//# sourceMappingURL=ScopeResolver.js.map

package/dist/utils/ScopeResolver.js.map

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

package/dist/utils/SelectQueryWithClauseHelper.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelectQueryWithClauseHelper = void 0;
+const SelectQuery_1 = require("../models/SelectQuery");
+/**
+ * Utility to manage WITH clause placement for statements that promote the
+ * CTE definitions outside of the SELECT body (for example, INSERT).
+ */
+class SelectQueryWithClauseHelper {
+    static getWithClause(selectQuery) {
+        const owner = this.findClauseOwner(selectQuery);
+        if (!owner) {
+            return null;
+        }
+        return owner.withClause;
+    }
+    static setWithClause(selectQuery, withClause) {
+        const owner = this.findClauseOwner(selectQuery);
+        if (!owner) {
+            throw new Error("Cannot attach WITH clause to the provided select query.");
+        }
+        owner.withClause = withClause;
+    }
+    static detachWithClause(selectQuery) {
+        const owner = this.findClauseOwner(selectQuery);
+        if (!owner) {
+            return null;
+        }
+        const clause = owner.withClause;
+        owner.withClause = null;
+        return clause;
+    }
+    static findClauseOwner(selectQuery) {
+        if (!selectQuery) {
+            return null;
+        }
+        if (selectQuery instanceof SelectQuery_1.SimpleSelectQuery || selectQuery instanceof SelectQuery_1.ValuesQuery) {
+            return selectQuery;
+        }
+        if (selectQuery instanceof SelectQuery_1.BinarySelectQuery) {
+            return this.findClauseOwner(selectQuery.left);
+        }
+        throw new Error("Unsupported select query type for WITH clause management.");
+    }
+}
+exports.SelectQueryWithClauseHelper = SelectQueryWithClauseHelper;
+//# sourceMappingURL=SelectQueryWithClauseHelper.js.map

package/dist/utils/SelectQueryWithClauseHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectQueryWithClauseHelper.js","sourceRoot":"","sources":["../../src/utils/SelectQueryWithClauseHelper.ts"],"names":[],"mappings":";;;AAAA,uDAAuG;AAGvG;;;GAGG;AACH,MAAa,2BAA2B;IAC7B,MAAM,CAAC,aAAa,CAAC,WAA+B;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC,UAAU,CAAC;IAC5B,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,WAAwB,EAAE,UAA6B;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;IAClC,CAAC;IAEM,MAAM,CAAC,gBAAgB,CAAC,WAAwB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;QAChC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,OAAO,MAAM,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,eAAe,CAAC,WAA+B;QAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,WAAW,YAAY,+BAAiB,IAAI,WAAW,YAAY,yBAAW,EAAE,CAAC;YACjF,OAAO,WAAW,CAAC;QACvB,CAAC;QACD,IAAI,WAAW,YAAY,+BAAiB,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACjF,CAAC;CACJ;AAvCD,kEAuCC"}

package/dist/utils/SqlSchemaValidator.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqlSchemaValidator = void 0;
+const SchemaCollector_1 = require("../transformers/SchemaCollector");
+const SelectQueryParser_1 = require("../parsers/SelectQueryParser");
+/**
+ * Validates SQL query structures against known tables and columns.
+ *
+ * @example
+ * ```typescript
+ * const tables = [
+ *   { name: 'users', columns: ['id', 'email'] }
+ * ];
+ *
+ * SqlSchemaValidator.validate('SELECT id FROM users', tables);
+ * ```
+ * Related tests: packages/core/tests/utils/SqlSchemaValidator.validate.test.ts
+ */
+class SqlSchemaValidator {
+    /**
+     * Validates a SQL query structure against a provided TableColumnResolver or TableSchema array.
+     * @param sql The SQL query structure to validate, can be a SQL string or a SqlComponent.
+     * @param tableResolver The TableColumnResolver or TableSchema array to validate against.
+     * @throws Error if the query contains undefined tables or columns.
+     */
+    static validate(sql, tableResolver) {
+        const sqlComponent = typeof sql === 'string' ? SelectQueryParser_1.SelectQueryParser.parse(sql) : sql;
+        // Convert TableSchema[] to a resolver function if necessary
+        const resolver = Array.isArray(tableResolver)
+            ? (tableName) => {
+                const schema = tableResolver.find((t) => t.name === tableName);
+                return schema ? schema.columns : [];
+            }
+            : tableResolver;
+        const schemaCollector = new SchemaCollector_1.SchemaCollector(resolver);
+        const tableSchemas = schemaCollector.collect(sqlComponent);
+        const errors = [];
+        for (const tableSchema of tableSchemas) {
+            const resolvedColumns = resolver(tableSchema.name);
+            if (resolvedColumns.length === 0) {
+                errors.push(`Table '${tableSchema.name}' is not defined.`);
+                continue;
+            }
+            const undefinedColumns = tableSchema.columns.filter(column => !resolvedColumns.includes(column));
+            if (undefinedColumns.length > 0) {
+                errors.push(`Table '${tableSchema.name}' contains undefined columns: ${undefinedColumns.join(', ')}.`);
+            }
+        }
+        if (errors.length > 0) {
+            throw new Error(errors.join('\n'));
+        }
+    }
+}
+exports.SqlSchemaValidator = SqlSchemaValidator;
+//# sourceMappingURL=SqlSchemaValidator.js.map

package/dist/utils/SqlSchemaValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlSchemaValidator.js","sourceRoot":"","sources":["../../src/utils/SqlSchemaValidator.ts"],"names":[],"mappings":";;;AAAA,qEAA+E;AAG/E,oEAAiE;AAEjE;;;;;;;;;;;;GAYG;AAEH,MAAa,kBAAkB;IAC3B;;;;;OAKG;IACI,MAAM,CAAC,QAAQ,CAClB,GAA0B,EAC1B,aAAkD;QAElD,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,qCAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAElF,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;YACzC,CAAC,CAAC,CAAC,SAAiB,EAAE,EAAE;gBACpB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;gBAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,CAAC;YACD,CAAC,CAAC,aAAa,CAAC;QAEpB,MAAM,eAAe,GAAG,IAAI,iCAAe,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACrC,MAAM,eAAe,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,UAAU,WAAW,CAAC,IAAI,mBAAmB,CAAC,CAAC;gBAC3D,SAAS;YACb,CAAC;YAED,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YACjG,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CACP,UAAU,WAAW,CAAC,IAAI,iCAAiC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC5F,CAAC;YACN,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ;AA5CD,gDA4CC"}

package/dist/utils/TableNameUtils.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tableNameVariants = exports.normalizeTableName = void 0;
+const FullNameParser_1 = require("../parsers/FullNameParser");
+/**
+ * Parses a table name through the SQL parser so all supported identifier
+ * syntaxes (quoted, bracketed, backtick) converge to a consistent key.
+ */
+const normalizeTableName = (tableName) => {
+    var _a;
+    // Parse with the same rules as the main AST to avoid regex-based drift.
+    const parsed = FullNameParser_1.FullNameParser.parse(tableName);
+    const namespaces = (_a = parsed.namespaces) !== null && _a !== void 0 ? _a : [];
+    const parts = [...namespaces, parsed.name.name];
+    return parts.join('.').toLowerCase();
+};
+exports.normalizeTableName = normalizeTableName;
+/**
+ * For schema-sensitive matching we no longer drop qualifiers; a single
+ * normalized key is sufficient and safer than heuristic variants.
+ */
+const tableNameVariants = (tableName) => {
+    var _a;
+    const parsed = FullNameParser_1.FullNameParser.parse(tableName);
+    const namespaces = (_a = parsed.namespaces) !== null && _a !== void 0 ? _a : [];
+    const normalized = (0, exports.normalizeTableName)(tableName);
+    // Return the parsed-normalized key alone when no schema qualifier is present.
+    if (namespaces.length === 0) {
+        return [normalized];
+    }
+    // DONOT return an unqualified variant; schema-qualified normalization is required to avoid mixing distinct tables.
+    return [normalized];
+};
+exports.tableNameVariants = tableNameVariants;
+//# sourceMappingURL=TableNameUtils.js.map

package/dist/utils/TableNameUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableNameUtils.js","sourceRoot":"","sources":["../../src/utils/TableNameUtils.ts"],"names":[],"mappings":";;;AAAA,8DAA2D;AAE3D;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAU,EAAE;;IAC9D,wEAAwE;IACxE,MAAM,MAAM,GAAG,+BAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAA,MAAM,CAAC,UAAU,mCAAI,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACvC,CAAC,CAAC;AANW,QAAA,kBAAkB,sBAM7B;AAEF;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAY,EAAE;;IAC/D,MAAM,MAAM,GAAG,+BAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAA,MAAM,CAAC,UAAU,mCAAI,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAA,0BAAkB,EAAC,SAAS,CAAC,CAAC;IACjD,8EAA8E;IAC9E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IAED,mHAAmH;IACnH,OAAO,CAAC,UAAU,CAAC,CAAC;AACtB,CAAC,CAAC;AAXW,QAAA,iBAAiB,qBAW5B"}