rawsql-ts 0.12.0 → 0.13.0

package/dist/transformers/DDLToFixtureConverter.js.map

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

package/dist/transformers/DeleteResultSelectConverter.js

@@ -0,0 +1,414 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteResultSelectConverter = void 0;
+const Clause_1 = require("../models/Clause");
+const SelectQuery_1 = require("../models/SelectQuery");
+const ValueComponent_1 = require("../models/ValueComponent");
+const TableSourceCollector_1 = require("./TableSourceCollector");
+const FixtureCteBuilder_1 = require("./FixtureCteBuilder");
+const SelectQueryWithClauseHelper_1 = require("../utils/SelectQueryWithClauseHelper");
+const ValueComponentRewriter_1 = require("../utils/ValueComponentRewriter");
+const TableNameUtils_1 = require("../utils/TableNameUtils");
+const FullNameParser_1 = require("../parsers/FullNameParser");
+class DeleteResultSelectConverter {
+    /**
+     * Converts a DELETE (with optional RETURNING) into a SELECT that mirrors its output rows.
+     */
+    static toSelectQuery(deleteQuery, options) {
+        var _a, _b, _c, _d;
+        const targetTableName = this.extractTargetTableName(deleteQuery.deleteClause);
+        const tableDefinition = this.resolveTableDefinition(targetTableName, options);
+        const targetAlias = deleteQuery.deleteClause.getSourceAliasName();
+        // Build the SELECT structure that mirrors the DELETE source/join semantics.
+        const returningContext = deleteQuery.returningClause
+            ? this.buildReturningContext(deleteQuery.deleteClause, deleteQuery.usingClause, targetAlias, tableDefinition, options)
+            : null;
+        const selectClause = deleteQuery.returningClause
+            ? this.buildReturningSelectClause(deleteQuery.returningClause, returningContext)
+            : this.buildCountSelectClause();
+        const fromClause = this.buildFromClause(deleteQuery.deleteClause, deleteQuery.usingClause);
+        const whereClause = (_a = deleteQuery.whereClause) !== null && _a !== void 0 ? _a : null;
+        const selectQuery = new SelectQuery_1.SimpleSelectQuery({
+            withClause: (_b = deleteQuery.withClause) !== null && _b !== void 0 ? _b : undefined,
+            selectClause,
+            fromClause,
+            whereClause
+        });
+        // Ensure fixture coverage before weaving CTEs back into the SELECT.
+        const fixtureTables = (_c = options === null || options === void 0 ? void 0 : options.fixtureTables) !== null && _c !== void 0 ? _c : [];
+        const fixtureMap = this.buildFixtureTableMap(fixtureTables);
+        const missingStrategy = (_d = options === null || options === void 0 ? void 0 : options.missingFixtureStrategy) !== null && _d !== void 0 ? _d : this.DEFAULT_MISSING_FIXTURE_STRATEGY;
+        const originalWithClause = SelectQueryWithClauseHelper_1.SelectQueryWithClauseHelper.detachWithClause(selectQuery);
+        const referencedTables = this.collectPhysicalTableReferences(selectQuery, originalWithClause);
+        const cteNames = this.collectCteNamesFromWithClause(originalWithClause);
+        const targetVariants = (0, TableNameUtils_1.tableNameVariants)(targetTableName);
+        for (const variant of targetVariants) {
+            if (!cteNames.has(variant)) {
+                referencedTables.add(variant);
+            }
+        }
+        this.ensureFixtureCoverage(referencedTables, fixtureMap, missingStrategy);
+        const filteredFixtures = this.filterFixtureTablesForReferences(fixtureTables, referencedTables);
+        const fixtureCtes = this.buildFixtureCtes(filteredFixtures);
+        const mergedWithClause = this.mergeWithClause(originalWithClause, fixtureCtes);
+        SelectQueryWithClauseHelper_1.SelectQueryWithClauseHelper.setWithClause(selectQuery, mergedWithClause);
+        return selectQuery;
+    }
+    static buildReturningSelectClause(returning, context) {
+        const selectItems = this.buildReturningSelectItems(returning, context);
+        return new Clause_1.SelectClause(selectItems);
+    }
+    static buildReturningSelectItems(returning, context) {
+        // Build SELECT entries from RETURNING items, expanding wildcards before expression rewriting.
+        const selectItems = [];
+        for (const item of returning.items) {
+            if (this.isWildcardReturningItem(item)) {
+                selectItems.push(...this.expandReturningWildcard(context));
+                continue;
+            }
+            selectItems.push(this.buildDeleteReturningSelectItem(item, context));
+        }
+        return selectItems;
+    }
+    static isWildcardReturningItem(item) {
+        return (item.value instanceof ValueComponent_1.ColumnReference &&
+            item.value.column.name === '*');
+    }
+    static expandReturningWildcard(context) {
+        if (!context.targetDefinition) {
+            throw new Error('Cannot expand RETURNING * without table definition.');
+        }
+        return context.targetDefinition.columns.map((column) => {
+            const expression = this.composeDeleteColumnReference({ namespaces: null, column: column.name }, context);
+            return new Clause_1.SelectItem(expression, column.name);
+        });
+    }
+    static buildDeleteReturningSelectItem(item, context) {
+        const expression = (0, ValueComponentRewriter_1.rewriteValueComponentWithColumnResolver)(item.value, (column) => this.buildDeleteColumnReference(column, context));
+        const alias = this.getReturningAlias(item);
+        return new Clause_1.SelectItem(expression, alias);
+    }
+    static buildDeleteColumnReference(column, context) {
+        const parsed = this.parseReturningColumnName(column.toString());
+        return this.composeDeleteColumnReference(parsed, context);
+    }
+    static composeDeleteColumnReference(parsedColumn, context) {
+        var _a;
+        const tableContext = this.findTableContextForNamespaces(parsedColumn.namespaces, context);
+        const definitionToValidate = (_a = tableContext === null || tableContext === void 0 ? void 0 : tableContext.tableDefinition) !== null && _a !== void 0 ? _a : (parsedColumn.namespaces ? undefined : context.targetDefinition);
+        if (definitionToValidate) {
+            this.ensureColumnExists(parsedColumn.column, definitionToValidate);
+        }
+        const columnNamespace = parsedColumn.namespaces && parsedColumn.namespaces.length > 0
+            ? [...parsedColumn.namespaces]
+            : context.targetAlias
+                ? [context.targetAlias]
+                : null;
+        return new ValueComponent_1.ColumnReference(columnNamespace, parsedColumn.column);
+    }
+    static getReturningAlias(item) {
+        var _a;
+        if ((_a = item.identifier) === null || _a === void 0 ? void 0 : _a.name) {
+            return item.identifier.name;
+        }
+        if (item.value instanceof ValueComponent_1.ColumnReference) {
+            return item.value.toString();
+        }
+        return null;
+    }
+    static buildCountSelectClause() {
+        // Count rows when no RETURNING clause is present.
+        const countFunction = new ValueComponent_1.FunctionCall(null, 'count', new ValueComponent_1.RawString('*'), null);
+        const selectItem = new Clause_1.SelectItem(countFunction, 'count');
+        return new Clause_1.SelectClause([selectItem]);
+    }
+    static buildFromClause(deleteClause, usingClause) {
+        var _a;
+        if (!((_a = usingClause === null || usingClause === void 0 ? void 0 : usingClause.sources) === null || _a === void 0 ? void 0 : _a.length)) {
+            return new Clause_1.FromClause(deleteClause.source, null);
+        }
+        // Cross join each USING source so their columns remain available for predicates.
+        const joins = usingClause.sources.map((source) => new Clause_1.JoinClause('cross join', source, null, false));
+        return new Clause_1.FromClause(deleteClause.source, joins);
+    }
+    static buildReturningContext(deleteClause, usingClause, targetAlias, targetDefinition, options) {
+        const { aliasMap, tableNameMap } = this.buildTableContexts(deleteClause, usingClause, options);
+        return {
+            aliasMap,
+            tableNameMap,
+            targetAlias,
+            targetDefinition
+        };
+    }
+    static buildTableContexts(deleteClause, usingClause, options) {
+        const aliasMap = new Map();
+        const tableNameMap = new Map();
+        // Capture alias and table name contexts to resolve metadata for both identifiers.
+        const collectSource = (source) => {
+            const alias = source.getAliasName();
+            if (!alias || !(source.datasource instanceof Clause_1.TableSource)) {
+                return;
+            }
+            const normalizedAlias = this.normalizeIdentifier(alias);
+            if (aliasMap.has(normalizedAlias)) {
+                return;
+            }
+            const tableName = source.datasource.getSourceName();
+            const tableDefinition = this.resolveTableDefinition(tableName, options);
+            const context = {
+                alias,
+                tableName,
+                tableDefinition
+            };
+            aliasMap.set(normalizedAlias, context);
+            for (const variant of (0, TableNameUtils_1.tableNameVariants)(tableName)) {
+                if (!tableNameMap.has(variant)) {
+                    tableNameMap.set(variant, context);
+                }
+            }
+        };
+        collectSource(deleteClause.source);
+        if (usingClause) {
+            for (const source of usingClause.sources) {
+                collectSource(source);
+            }
+        }
+        return { aliasMap, tableNameMap };
+    }
+    static parseReturningColumnName(columnName) {
+        const trimmed = columnName.trim();
+        if (!trimmed) {
+            throw new Error('Returning column name cannot be empty.');
+        }
+        try {
+            const parsed = FullNameParser_1.FullNameParser.parse(trimmed);
+            return {
+                namespaces: parsed.namespaces,
+                column: parsed.name.name
+            };
+        }
+        catch {
+            const parts = trimmed.split('.').map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+            if (parts.length === 0) {
+                return { namespaces: null, column: trimmed };
+            }
+            const column = parts.pop();
+            return {
+                namespaces: parts.length > 0 ? parts : null,
+                column
+            };
+        }
+    }
+    static findTableContextForNamespaces(namespaces, context) {
+        if (!(namespaces === null || namespaces === void 0 ? void 0 : namespaces.length)) {
+            return undefined;
+        }
+        for (let depth = namespaces.length; depth > 0; depth--) {
+            const candidateParts = namespaces.slice(namespaces.length - depth);
+            const identifier = candidateParts.join('.');
+            const normalized = this.normalizeIdentifier(identifier);
+            const aliasContext = context.aliasMap.get(normalized);
+            if (aliasContext) {
+                return aliasContext;
+            }
+            const tableContext = context.tableNameMap.get(normalized);
+            if (tableContext) {
+                return tableContext;
+            }
+        }
+        return undefined;
+    }
+    static ensureColumnExists(columnName, tableDefinition) {
+        if (!tableDefinition) {
+            return;
+        }
+        const normalized = this.normalizeIdentifier(columnName);
+        const exists = tableDefinition.columns.some((column) => this.normalizeIdentifier(column.name) === normalized);
+        if (!exists) {
+            throw new Error(`Column '${columnName}' cannot be resolved for RETURNING output.`);
+        }
+    }
+    static resolveTableDefinition(tableName, options) {
+        if (options === null || options === void 0 ? void 0 : options.tableDefinitionResolver) {
+            const resolved = options.tableDefinitionResolver(tableName);
+            if (resolved !== undefined) {
+                return resolved;
+            }
+        }
+        const normalizedVariants = new Set((0, TableNameUtils_1.tableNameVariants)(tableName));
+        if (options === null || options === void 0 ? void 0 : options.tableDefinitions) {
+            const map = this.buildTableDefinitionMap(options.tableDefinitions);
+            for (const variant of normalizedVariants) {
+                const definition = map.get(variant);
+                if (definition) {
+                    return definition;
+                }
+            }
+        }
+        if (options === null || options === void 0 ? void 0 : options.fixtureTables) {
+            const fixture = options.fixtureTables.find((f) => (0, TableNameUtils_1.tableNameVariants)(f.tableName).some((variant) => normalizedVariants.has(variant)));
+            if (fixture) {
+                return this.convertFixtureToTableDefinition(fixture);
+            }
+        }
+        return undefined;
+    }
+    static convertFixtureToTableDefinition(fixture) {
+        return {
+            name: fixture.tableName,
+            columns: fixture.columns.map(col => {
+                var _a;
+                return ({
+                    name: col.name,
+                    typeName: col.typeName,
+                    required: false,
+                    defaultValue: (_a = col.defaultValue) !== null && _a !== void 0 ? _a : null
+                });
+            })
+        };
+    }
+    static buildTableDefinitionMap(registry) {
+        const map = new Map();
+        for (const definition of Object.values(registry)) {
+            for (const variant of (0, TableNameUtils_1.tableNameVariants)(definition.name)) {
+                map.set(variant, definition);
+            }
+        }
+        return map;
+    }
+    static extractTargetTableName(deleteClause) {
+        const datasource = deleteClause.source.datasource;
+        if (datasource instanceof Clause_1.TableSource) {
+            return datasource.getSourceName();
+        }
+        throw new Error('Delete target must be a table source for conversion.');
+    }
+    static buildFixtureCtes(fixtures) {
+        if (!fixtures || fixtures.length === 0) {
+            return [];
+        }
+        return FixtureCteBuilder_1.FixtureCteBuilder.buildFixtures(fixtures);
+    }
+    static collectPhysicalTableReferences(selectQuery, withClause) {
+        const referencedTables = this.collectReferencedTables(selectQuery);
+        const ignoredTables = this.collectCteNamesFromWithClause(withClause);
+        const tablesToShadow = new Set();
+        // Keep only concrete tables that are not defined via WITH clause aliases.
+        for (const table of referencedTables) {
+            if (ignoredTables.has(table)) {
+                continue;
+            }
+            tablesToShadow.add(table);
+        }
+        const cteReferencedTables = this.collectReferencedTablesFromWithClause(withClause);
+        for (const table of cteReferencedTables) {
+            if (ignoredTables.has(table)) {
+                continue;
+            }
+            tablesToShadow.add(table);
+        }
+        return tablesToShadow;
+    }
+    static buildFixtureTableMap(fixtures) {
+        const map = new Map();
+        for (const fixture of fixtures) {
+            for (const variant of (0, TableNameUtils_1.tableNameVariants)(fixture.tableName)) {
+                map.set(variant, fixture);
+            }
+        }
+        return map;
+    }
+    static filterFixtureTablesForReferences(fixtures, referencedTables) {
+        if (!fixtures.length || referencedTables.size === 0) {
+            return [];
+        }
+        const filtered = [];
+        for (const fixture of fixtures) {
+            const fixtureVariants = (0, TableNameUtils_1.tableNameVariants)(fixture.tableName);
+            if (fixtureVariants.some((variant) => referencedTables.has(variant))) {
+                filtered.push(fixture);
+            }
+        }
+        return filtered;
+    }
+    static collectReferencedTablesFromWithClause(withClause) {
+        const tables = new Set();
+        if (!(withClause === null || withClause === void 0 ? void 0 : withClause.tables)) {
+            return tables;
+        }
+        for (const cte of withClause.tables) {
+            for (const table of this.collectReferencedTables(cte.query)) {
+                tables.add(table);
+            }
+        }
+        return tables;
+    }
+    static ensureFixtureCoverage(referencedTables, fixtureMap, strategy) {
+        if (referencedTables.size === 0) {
+            return;
+        }
+        const missingTables = this.getMissingFixtureTables(referencedTables, fixtureMap);
+        if (missingTables.length === 0) {
+            return;
+        }
+        if (strategy === 'error') {
+            throw new Error(`Delete SELECT refers to tables without fixture coverage: ${missingTables.join(', ')}.`);
+        }
+    }
+    static collectReferencedTables(query) {
+        const collector = new TableSourceCollector_1.TableSourceCollector(false);
+        const sources = collector.collect(query);
+        const normalized = new Set();
+        for (const source of sources) {
+            for (const variant of (0, TableNameUtils_1.tableNameVariants)(source.getSourceName())) {
+                normalized.add(variant);
+            }
+        }
+        return normalized;
+    }
+    static collectCteNamesFromWithClause(withClause) {
+        const names = new Set();
+        if (!(withClause === null || withClause === void 0 ? void 0 : withClause.tables)) {
+            return names;
+        }
+        for (const table of withClause.tables) {
+            for (const variant of (0, TableNameUtils_1.tableNameVariants)(table.getSourceAliasName())) {
+                names.add(variant);
+            }
+        }
+        return names;
+    }
+    static getMissingFixtureTables(referencedTables, fixtureMap) {
+        const missing = [];
+        for (const table of referencedTables) {
+            const covered = (0, TableNameUtils_1.tableNameVariants)(table).some((variant) => fixtureMap.has(variant));
+            if (!covered) {
+                missing.push(table);
+            }
+        }
+        return missing;
+    }
+    static mergeWithClause(original, fixtureCtes) {
+        var _a;
+        if (!fixtureCtes.length && !original) {
+            return null;
+        }
+        const combinedTables = [...fixtureCtes];
+        if (original === null || original === void 0 ? void 0 : original.tables) {
+            combinedTables.push(...original.tables);
+        }
+        if (!combinedTables.length) {
+            return null;
+        }
+        const merged = new Clause_1.WithClause((_a = original === null || original === void 0 ? void 0 : original.recursive) !== null && _a !== void 0 ? _a : false, combinedTables);
+        merged.globalComments = (original === null || original === void 0 ? void 0 : original.globalComments) ? [...original.globalComments] : null;
+        merged.trailingComments = (original === null || original === void 0 ? void 0 : original.trailingComments) ? [...original.trailingComments] : null;
+        return merged;
+    }
+    static normalizeIdentifier(value) {
+        return value.trim().toLowerCase();
+    }
+}
+exports.DeleteResultSelectConverter = DeleteResultSelectConverter;
+DeleteResultSelectConverter.DEFAULT_MISSING_FIXTURE_STRATEGY = 'error';
+//# sourceMappingURL=DeleteResultSelectConverter.js.map

package/dist/transformers/DeleteResultSelectConverter.js.map

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

package/dist/transformers/DynamicQueryBuilder.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamicQueryBuilder = void 0;
+const SelectQueryParser_1 = require("../parsers/SelectQueryParser");
+const SqlParamInjector_1 = require("./SqlParamInjector");
+const SqlSortInjector_1 = require("./SqlSortInjector");
+const SqlPaginationInjector_1 = require("./SqlPaginationInjector");
+const PostgresJsonQueryBuilder_1 = require("./PostgresJsonQueryBuilder");
+const QueryBuilder_1 = require("./QueryBuilder");
+const SqlParameterBinder_1 = require("./SqlParameterBinder");
+const ParameterDetector_1 = require("../utils/ParameterDetector");
+/**
+ * DynamicQueryBuilder combines SQL parsing with dynamic condition injection (filters, sorts, paging, JSON serialization).
+ *
+ * Key behaviours verified in packages/core/tests/transformers/DynamicQueryBuilder.test.ts:
+ * - Preserves the input SQL when no options are supplied.
+ * - Applies filter, sort, and pagination in a deterministic order.
+ * - Supports JSON serialization for hierarchical projections.
+ */
+class DynamicQueryBuilder {
+    /**
+     * Creates a new DynamicQueryBuilder instance
+     * @param tableColumnResolver Optional function to resolve table columns for wildcard queries
+     */
+    constructor(tableColumnResolver) {
+        this.tableColumnResolver = tableColumnResolver;
+    }
+    /**
+     * Builds a SelectQuery from SQL content with dynamic conditions.
+     * This is a pure function that does not perform any I/O operations.
+     * @param sqlContent Raw SQL string to parse and modify
+     * @param options Dynamic conditions to apply (filter, sort, paging, serialize)
+     * @returns Modified SelectQuery with all dynamic conditions applied
+     * @example
+     * ```typescript
+     * const builder = new DynamicQueryBuilder();
+     * const query = builder.buildQuery(
+     *   'SELECT id, name FROM users WHERE active = true',
+     *   {
+     *     filter: { status: 'premium' },
+     *     sort: { created_at: { desc: true } },
+     *     paging: { page: 2, pageSize: 10 },
+     *     serialize: { rootName: 'user', rootEntity: { id: 'user', name: 'User', columns: { id: 'id', name: 'name' } }, nestedEntities: [] }
+     *   }
+     * );
+     * ```
+     */
+    buildQuery(sqlContent, options = {}) {
+        // Parse the base SQL
+        let parsedQuery;
+        try {
+            parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sqlContent);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse SQL: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        // Apply dynamic modifications in the correct order
+        let modifiedQuery = parsedQuery;
+        // 1. Bind hardcoded parameters first (before any other transformations)
+        if (options.filter && Object.keys(options.filter).length > 0) {
+            const { hardcodedParams, dynamicFilters } = ParameterDetector_1.ParameterDetector.separateFilters(modifiedQuery, options.filter);
+            // Bind hardcoded parameters if any exist
+            if (Object.keys(hardcodedParams).length > 0) {
+                const parameterBinder = new SqlParameterBinder_1.SqlParameterBinder({ requireAllParameters: false });
+                modifiedQuery = parameterBinder.bind(modifiedQuery, hardcodedParams);
+            }
+            // Apply dynamic filtering only if there are non-hardcoded filters
+            if (Object.keys(dynamicFilters).length > 0) {
+                const paramInjector = new SqlParamInjector_1.SqlParamInjector(this.tableColumnResolver);
+                // Ensure we have a SimpleSelectQuery for the injector
+                const simpleQuery = QueryBuilder_1.QueryBuilder.buildSimpleQuery(modifiedQuery);
+                modifiedQuery = paramInjector.inject(simpleQuery, dynamicFilters);
+            }
+        }
+        // 2. Apply sorting second (after filtering to sort smaller dataset)
+        if (options.sort && Object.keys(options.sort).length > 0) {
+            const sortInjector = new SqlSortInjector_1.SqlSortInjector(this.tableColumnResolver);
+            // Ensure we have a SimpleSelectQuery for the injector
+            const simpleQuery = QueryBuilder_1.QueryBuilder.buildSimpleQuery(modifiedQuery);
+            modifiedQuery = sortInjector.inject(simpleQuery, options.sort);
+        } // 3. Apply pagination third (after filtering and sorting)
+        if (options.paging) {
+            const { page = 1, pageSize } = options.paging;
+            if (pageSize !== undefined) {
+                const paginationInjector = new SqlPaginationInjector_1.SqlPaginationInjector();
+                const paginationOptions = { page, pageSize };
+                // Ensure we have a SimpleSelectQuery for the injector
+                const simpleQuery = QueryBuilder_1.QueryBuilder.buildSimpleQuery(modifiedQuery);
+                modifiedQuery = paginationInjector.inject(simpleQuery, paginationOptions);
+            }
+        }
+        // 4. Apply serialization last (transform the final query structure to JSON)
+        // Note: boolean values are handled at RawSqlClient level for auto-loading
+        if (options.serialize && typeof options.serialize === 'object') {
+            const jsonBuilder = new PostgresJsonQueryBuilder_1.PostgresJsonQueryBuilder();
+            // Ensure we have a SimpleSelectQuery for the JSON builder
+            const simpleQuery = QueryBuilder_1.QueryBuilder.buildSimpleQuery(modifiedQuery);
+            modifiedQuery = jsonBuilder.buildJsonQuery(simpleQuery, options.serialize);
+        }
+        return modifiedQuery;
+    }
+    /**
+     * Builds a SelectQuery with only filtering applied.
+     * Convenience method for when you only need dynamic WHERE conditions.
+     *
+     * @param sqlContent Raw SQL string to parse and modify
+     * @param filter Filter conditions to apply
+     * @returns Modified SelectQuery with filter conditions applied
+     */
+    buildFilteredQuery(sqlContent, filter) {
+        return this.buildQuery(sqlContent, { filter });
+    }
+    /**
+     * Builds a SelectQuery with only sorting applied.
+     * Convenience method for when you only need dynamic ORDER BY clauses.
+     *
+     * @param sqlContent Raw SQL string to parse and modify
+     * @param sort Sort conditions to apply
+     * @returns Modified SelectQuery with sort conditions applied
+     */
+    buildSortedQuery(sqlContent, sort) {
+        return this.buildQuery(sqlContent, { sort });
+    } /**
+     * Builds a SelectQuery with only pagination applied.
+     * Convenience method for when you only need LIMIT/OFFSET clauses.
+     *
+     * @param sqlContent Raw SQL string to parse and modify
+     * @param paging Pagination options to apply
+     * @returns Modified SelectQuery with pagination applied
+     */
+    buildPaginatedQuery(sqlContent, paging) {
+        return this.buildQuery(sqlContent, { paging });
+    }
+    /**
+     * Builds a SelectQuery with only JSON serialization applied.
+     * Convenience method for when you only need hierarchical JSON transformation.
+     *
+     * @param sqlContent Raw SQL string to parse and modify
+     * @param serialize JSON mapping configuration to apply
+     * @returns Modified SelectQuery with JSON serialization applied
+     */
+    buildSerializedQuery(sqlContent, serialize) {
+        return this.buildQuery(sqlContent, { serialize });
+    }
+    /**
+     * Validates SQL content by attempting to parse it.
+     * Useful for testing SQL validity without applying any modifications.
+     *
+     * @param sqlContent Raw SQL string to validate
+     * @returns true if SQL is valid, throws error if invalid
+     * @throws Error if SQL cannot be parsed
+     */
+    validateSql(sqlContent) {
+        try {
+            SelectQueryParser_1.SelectQueryParser.parse(sqlContent);
+            return true;
+        }
+        catch (error) {
+            throw new Error(`Invalid SQL: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+exports.DynamicQueryBuilder = DynamicQueryBuilder;
+//# sourceMappingURL=DynamicQueryBuilder.js.map

package/dist/transformers/DynamicQueryBuilder.js.map

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