rawsql-ts 0.24.4 → 0.26.0

package/dist/esm/transformers/NamedQueryDefinitionExtractor.js

@@ -0,0 +1,370 @@
+import { CommonTable, DeleteClause, FromClause, FunctionSource, GroupByClause, HavingClause, InsertClause, JoinClause, JoinOnClause, JoinUsingClause, LimitClause, OnConflictClause, OrderByClause, OrderByItem, ParenSource, ReturningClause, SelectClause, SelectItem, SetClause, SourceExpression, SubQuerySource, UpdateClause, UsingClause, WhereClause, WindowFrameClause, WindowsClause, WithClause } from "../models/Clause";
+import { DeleteQuery } from "../models/DeleteQuery";
+import { InsertQuery } from "../models/InsertQuery";
+import { MergeDeleteAction, MergeInsertAction, MergeQuery, MergeUpdateAction, MergeWhenClause } from "../models/MergeQuery";
+import { BinarySelectQuery, SimpleSelectQuery, ValuesQuery } from "../models/SelectQuery";
+import { UpdateQuery } from "../models/UpdateQuery";
+import { ArrayExpression, ArrayIndexExpression, ArrayQueryExpression, ArraySliceExpression, BetweenExpression, BinaryExpression, CaseExpression, CaseKeyValuePair, CastExpression, FunctionCall, InlineQuery, JsonPredicateExpression, ParenExpression, SwitchCaseArgument, TupleExpression, TypeValue, UnaryExpression, ValueList, WindowFrameBoundaryValue, WindowFrameExpression, WindowFrameSpec } from "../models/ValueComponent";
+import { SelectQueryWithClauseHelper } from "../utils/SelectQueryWithClauseHelper";
+/**
+ * Extracts named query definitions, starting with CTE definitions from `WITH` clauses.
+ *
+ * @remarks Definitions are emitted in SQL source order. For nested CTEs, the outer
+ * CTE definition is emitted when its name is encountered, then definitions inside
+ * that CTE body are emitted before later sibling CTE definitions.
+ */
+export class NamedQueryDefinitionExtractor {
+    constructor() {
+        this.definitions = [];
+        this.visited = new Set();
+    }
+    /**
+     * Extract named query definitions from an AST component.
+     */
+    static extract(input) {
+        if (!input) {
+            return [];
+        }
+        const extractor = new NamedQueryDefinitionExtractor();
+        extractor.visit(input);
+        return extractor.definitions;
+    }
+    visit(value) {
+        if (!value || typeof value !== "object") {
+            return;
+        }
+        if (this.visited.has(value)) {
+            return;
+        }
+        this.visited.add(value);
+        if (value instanceof WithClause) {
+            this.visitWithClause(value);
+            return;
+        }
+        if (value instanceof CommonTable) {
+            this.visitCommonTable(value);
+            return;
+        }
+        if (value instanceof SimpleSelectQuery || value instanceof BinarySelectQuery || value instanceof ValuesQuery) {
+            this.visitSelectQuery(value);
+            return;
+        }
+        if (value instanceof InsertQuery) {
+            this.visitInsertQuery(value);
+            return;
+        }
+        if (value instanceof UpdateQuery) {
+            this.visitUpdateQuery(value);
+            return;
+        }
+        if (value instanceof DeleteQuery) {
+            this.visitDeleteQuery(value);
+            return;
+        }
+        if (value instanceof MergeQuery) {
+            this.visitMergeQuery(value);
+            return;
+        }
+        if (this.visitKnownValueComponent(value)) {
+            return;
+        }
+        if (this.visitKnownSqlComponent(value)) {
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                this.visit(item);
+            }
+            return;
+        }
+        for (const key of Object.keys(value)) {
+            this.visit(value[key]);
+        }
+    }
+    visitSelectQuery(query, includeWith = true) {
+        if (query instanceof SimpleSelectQuery) {
+            this.visitSimpleSelectQuery(query, includeWith);
+            return;
+        }
+        if (query instanceof BinarySelectQuery) {
+            this.visitSelectQuery(query.left, includeWith);
+            this.visitSelectQuery(query.right);
+            return;
+        }
+        if (query instanceof ValuesQuery) {
+            if (includeWith) {
+                this.visit(query.withClause);
+            }
+            this.visit(query.tuples);
+        }
+    }
+    visitSimpleSelectQuery(query, includeWith) {
+        if (includeWith) {
+            this.visit(query.withClause);
+        }
+        this.visit(query.selectClause);
+        this.visit(query.fromClause);
+        this.visit(query.whereClause);
+        this.visit(query.groupByClause);
+        this.visit(query.havingClause);
+        this.visit(query.windowClause);
+        this.visit(query.orderByClause);
+        this.visit(query.limitClause);
+        this.visit(query.offsetClause);
+        this.visit(query.fetchClause);
+        this.visit(query.forClause);
+    }
+    visitInsertQuery(query) {
+        const withClause = SelectQueryWithClauseHelper.getWithClause(query.selectQuery);
+        this.visit(withClause);
+        this.visit(query.insertClause);
+        if (query.selectQuery) {
+            this.visitSelectQuery(query.selectQuery, false);
+        }
+        this.visit(query.onConflictClause);
+        this.visit(query.returningClause);
+    }
+    visitUpdateQuery(query) {
+        this.visit(query.withClause);
+        this.visit(query.updateClause);
+        this.visit(query.setClause);
+        this.visit(query.fromClause);
+        this.visit(query.whereClause);
+        this.visit(query.returningClause);
+    }
+    visitDeleteQuery(query) {
+        this.visit(query.withClause);
+        this.visit(query.deleteClause);
+        this.visit(query.usingClause);
+        this.visit(query.whereClause);
+        this.visit(query.returningClause);
+    }
+    visitMergeQuery(query) {
+        this.visit(query.withClause);
+        this.visit(query.target);
+        this.visit(query.source);
+        this.visit(query.onCondition);
+        this.visit(query.whenClauses);
+        this.visit(query.returningClause);
+    }
+    visitWithClause(withClause) {
+        for (const commonTable of withClause.tables) {
+            this.visitCommonTable(commonTable, withClause.recursive);
+        }
+    }
+    visitCommonTable(commonTable, recursive) {
+        const definition = {
+            name: commonTable.getSourceAliasName(),
+            query: commonTable.query,
+            range: null,
+            nameRange: null
+        };
+        if (recursive !== undefined) {
+            definition.recursive = recursive;
+        }
+        this.definitions.push(definition);
+        this.visit(commonTable.query);
+    }
+    visitKnownSqlComponent(value) {
+        if (value instanceof SelectClause) {
+            this.visit(value.distinct);
+            this.visit(value.hints);
+            this.visit(value.items);
+            return true;
+        }
+        if (value instanceof SelectItem) {
+            this.visit(value.value);
+            return true;
+        }
+        if (value instanceof FromClause) {
+            this.visit(value.source);
+            this.visit(value.joins);
+            return true;
+        }
+        if (value instanceof JoinClause) {
+            this.visit(value.source);
+            this.visit(value.condition);
+            return true;
+        }
+        if (value instanceof JoinOnClause || value instanceof JoinUsingClause) {
+            this.visit(value.condition);
+            return true;
+        }
+        if (value instanceof SourceExpression) {
+            this.visit(value.datasource);
+            return true;
+        }
+        if (value instanceof SubQuerySource) {
+            this.visitSelectQuery(value.query);
+            return true;
+        }
+        if (value instanceof FunctionSource) {
+            this.visit(value.argument);
+            return true;
+        }
+        if (value instanceof ParenSource) {
+            this.visit(value.source);
+            return true;
+        }
+        if (value instanceof WhereClause || value instanceof HavingClause) {
+            this.visit(value.condition);
+            return true;
+        }
+        if (value instanceof LimitClause) {
+            this.visit(value.value);
+            return true;
+        }
+        if (value instanceof GroupByClause) {
+            this.visit(value.grouping);
+            return true;
+        }
+        if (value instanceof WindowsClause) {
+            this.visit(value.windows);
+            return true;
+        }
+        if (value instanceof WindowFrameClause) {
+            this.visit(value.expression);
+            return true;
+        }
+        if (value instanceof OrderByClause) {
+            this.visit(value.order);
+            return true;
+        }
+        if (value instanceof OrderByItem) {
+            this.visit(value.value);
+            return true;
+        }
+        if (value instanceof ReturningClause) {
+            this.visit(value.items);
+            return true;
+        }
+        if (value instanceof OnConflictClause) {
+            this.visit(value.setClause);
+            this.visit(value.whereClause);
+            this.visit(value.forClause);
+            return true;
+        }
+        if (value instanceof SetClause) {
+            for (const item of value.items) {
+                this.visit(item.value);
+            }
+            return true;
+        }
+        if (value instanceof UpdateClause || value instanceof DeleteClause || value instanceof InsertClause) {
+            this.visit(value.source);
+            return true;
+        }
+        if (value instanceof UsingClause) {
+            this.visit(value.sources);
+            return true;
+        }
+        if (value instanceof MergeWhenClause) {
+            this.visit(value.condition);
+            this.visit(value.action);
+            return true;
+        }
+        if (value instanceof MergeUpdateAction) {
+            this.visit(value.setClause);
+            this.visit(value.whereClause);
+            return true;
+        }
+        if (value instanceof MergeDeleteAction) {
+            this.visit(value.whereClause);
+            return true;
+        }
+        if (value instanceof MergeInsertAction) {
+            this.visit(value.values);
+            return true;
+        }
+        return false;
+    }
+    visitKnownValueComponent(value) {
+        if (value instanceof ValueList || value instanceof TupleExpression) {
+            this.visit(value.values);
+            return true;
+        }
+        if (value instanceof FunctionCall) {
+            this.visit(value.argument);
+            this.visit(value.internalOrderBy);
+            this.visit(value.withinGroup);
+            this.visit(value.filterCondition);
+            this.visit(value.over);
+            return true;
+        }
+        if (value instanceof WindowFrameExpression) {
+            this.visit(value.partition);
+            this.visit(value.order);
+            this.visit(value.frameSpec);
+            return true;
+        }
+        if (value instanceof WindowFrameSpec) {
+            this.visit(value.startBound);
+            this.visit(value.endBound);
+            return true;
+        }
+        if (value instanceof WindowFrameBoundaryValue) {
+            this.visit(value.value);
+            return true;
+        }
+        if (value instanceof UnaryExpression || value instanceof ParenExpression || value instanceof ArrayExpression || value instanceof JsonPredicateExpression) {
+            this.visit(value.expression);
+            return true;
+        }
+        if (value instanceof BinaryExpression) {
+            this.visit(value.left);
+            this.visit(value.right);
+            return true;
+        }
+        if (value instanceof SwitchCaseArgument) {
+            this.visit(value.cases);
+            this.visit(value.elseValue);
+            return true;
+        }
+        if (value instanceof CaseKeyValuePair) {
+            this.visit(value.key);
+            this.visit(value.value);
+            return true;
+        }
+        if (value instanceof CastExpression) {
+            this.visit(value.input);
+            this.visit(value.castType);
+            return true;
+        }
+        if (value instanceof CaseExpression) {
+            this.visit(value.condition);
+            this.visit(value.switchCase);
+            return true;
+        }
+        if (value instanceof ArrayQueryExpression) {
+            this.visitSelectQuery(value.query);
+            return true;
+        }
+        if (value instanceof InlineQuery) {
+            this.visitSelectQuery(value.selectQuery);
+            return true;
+        }
+        if (value instanceof BetweenExpression) {
+            this.visit(value.expression);
+            this.visit(value.lower);
+            this.visit(value.upper);
+            return true;
+        }
+        if (value instanceof TypeValue) {
+            this.visit(value.argument);
+            return true;
+        }
+        if (value instanceof ArraySliceExpression) {
+            this.visit(value.array);
+            this.visit(value.startIndex);
+            this.visit(value.endIndex);
+            return true;
+        }
+        if (value instanceof ArrayIndexExpression) {
+            this.visit(value.array);
+            this.visit(value.index);
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=NamedQueryDefinitionExtractor.js.map

package/dist/esm/transformers/NamedQueryDefinitionExtractor.js.map

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

package/dist/esm/transformers/ParameterConditionPlacementOptimizer.d.ts

@@ -0,0 +1,85 @@
+import { SelectQuery, SimpleSelectQuery } from "../models/SelectQuery";
+export type ParameterConditionOptimizationInput = string | SelectQuery | SimpleSelectQuery;
+/**
+ * First-phase safe-only placement for ordinary parameter predicates.
+ *
+ * The optimizer intentionally handles only root top-level AND predicates and one
+ * CTE/derived-table hop where the destination output is a direct column reference.
+ * Unsupported boundaries such as OR, UNION, DISTINCT, GROUP BY, WINDOW, OUTER
+ * JOIN, expression outputs, and function predicates are reported as skipped.
+ */
+export interface ParameterConditionOptimizationOptions {
+    dryRun?: boolean;
+}
+export interface ParameterConditionOptimizationWarning {
+    code: string;
+    message: string;
+    detail?: unknown;
+}
+export interface ParameterConditionOptimizationError {
+    code: string;
+    message: string;
+    detail?: unknown;
+}
+export interface ParameterConditionMove {
+    kind: "move_condition";
+    conditionSql: string;
+    fromScopeId: string;
+    toScopeId: string;
+    reason: string;
+    parameterNames: readonly string[];
+    columnReferences: readonly string[];
+}
+export interface ParameterConditionSkipped {
+    conditionSql: string;
+    scopeId: string;
+    reason: string;
+    code: string;
+}
+export interface ParameterConditionOptimizationSafety {
+    mode: "safe_only";
+    unsafeRewriteApplied: false;
+    dryRun: boolean;
+    formatterGeneratedSource: boolean;
+}
+export interface ParameterConditionOptimizationResult {
+    ok: boolean;
+    sql: string;
+    applied: readonly ParameterConditionMove[];
+    skipped: readonly ParameterConditionSkipped[];
+    warnings: readonly ParameterConditionOptimizationWarning[];
+    errors: readonly ParameterConditionOptimizationError[];
+    safety: ParameterConditionOptimizationSafety;
+    conditionMoves: readonly ParameterConditionMove[];
+}
+export declare class ParameterConditionPlacementOptimizer {
+    plan(input: ParameterConditionOptimizationInput, options?: ParameterConditionOptimizationOptions): ParameterConditionOptimizationResult;
+    optimize(input: ParameterConditionOptimizationInput, options?: ParameterConditionOptimizationOptions): ParameterConditionOptimizationResult;
+    private parseInput;
+    private analyzeCandidate;
+    private findUnsupportedExpression;
+    private isSupportedInPredicate;
+    private resolveTarget;
+    private findCurrentQueryBoundary;
+    private findTargetQueryBoundary;
+    private resolveSourceBinding;
+    private resolveUpstreamQuery;
+    private resolveTargetColumn;
+    private verifyColumnResolvableInQuery;
+    private rebaseCondition;
+    private getSourceBindings;
+    private findNullableSideBoundary;
+    private hasOuterJoin;
+    private getOutputColumnMatchCount;
+    private resolveSourceQueryForColumns;
+    private getSelectItemOutputName;
+    private findCte;
+    private countTableSourceReferences;
+    private hasWindowUsage;
+    private collectColumnReferences;
+    private collectParameterNames;
+    private makeSkipped;
+    private buildResult;
+}
+export declare const planParameterConditionOptimization: (input: ParameterConditionOptimizationInput, options?: ParameterConditionOptimizationOptions) => ParameterConditionOptimizationResult;
+export declare const optimizeParameterConditionPlacement: (input: ParameterConditionOptimizationInput, options?: ParameterConditionOptimizationOptions) => ParameterConditionOptimizationResult;