rawsql-ts 0.26.0 → 0.27.0

package/dist/esm/transformers/SqlComponentFormatter.js

@@ -0,0 +1,16 @@
+import { SqlFormatter } from "./SqlFormatter";
+let formatter = null;
+export const formatSqlComponent = (component, options = {}) => {
+    if (options.formatter) {
+        return options.formatter(component);
+    }
+    if (options.formatOptions) {
+        return new SqlFormatter(Object.assign({ exportComment: true }, options.formatOptions)).format(component).formattedSql;
+    }
+    formatter !== null && formatter !== void 0 ? formatter : (formatter = new SqlFormatter({ exportComment: true }));
+    return formatter.format(component).formattedSql;
+};
+export const hasSqlComponentFormatOverride = (options = {}) => {
+    return Boolean(options.formatter || options.formatOptions);
+};
+//# sourceMappingURL=SqlComponentFormatter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqlComponentFormatter.js","sourceRoot":"","sources":["../../../src/transformers/SqlComponentFormatter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAuB,MAAM,gBAAgB,CAAC;AAWnE,IAAI,SAAS,GAAwB,IAAI,CAAC;AAE1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAC9B,SAAkC,EAClC,UAAqC,EAAE,EACjC,EAAE;IACR,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QACxB,OAAO,IAAI,YAAY,iBAAG,aAAa,EAAE,IAAI,IAAK,OAAO,CAAC,aAAa,EAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC;IAC9G,CAAC;IAED,SAAS,aAAT,SAAS,cAAT,SAAS,IAAT,SAAS,GAAK,IAAI,YAAY,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAC;IACxD,OAAO,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC;AACpD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,UAAqC,EAAE,EAAW,EAAE;IAC9F,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;AAC/D,CAAC,CAAC"}

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

@@ -0,0 +1,103 @@
+import { SelectQuery, SimpleSelectQuery } from "../models/SelectQuery";
+import { SqlComponentFormatOptions } from "./SqlComponentFormatter";
+export type StaticPredicatePlacementInput = string | SelectQuery | SimpleSelectQuery;
+/**
+ * Safe-only placement for parameter-free static predicates.
+ *
+ * The optimizer only moves top-level AND terms whose outer column references can
+ * be mechanically rebased to direct outputs of a single-use simple CTE or
+ * derived table. Unsupported or ambiguous predicates stay in place.
+ */
+export interface StaticPredicatePlacementOptions extends SqlComponentFormatOptions {
+    dryRun?: boolean;
+    /**
+     * Whether AST/model inputs should be cloned before optimization.
+     * Defaults to true for public-call safety. Internal pipelines can pass false
+     * when they own the model and want to avoid AST -> SQL -> AST round trips.
+     */
+    cloneInput?: boolean;
+}
+export interface StaticPredicatePlacementWarning {
+    code: string;
+    message: string;
+    detail?: unknown;
+}
+export interface StaticPredicatePlacementError {
+    code: string;
+    message: string;
+    detail?: unknown;
+}
+export interface StaticPredicateMove {
+    kind: "move_static_predicate";
+    predicateSql: string;
+    fromScopeId: string;
+    toScopeId: string;
+    reason: string;
+    columnReferences: readonly string[];
+}
+export interface StaticPredicateSkipped {
+    predicateSql: string;
+    scopeId: string;
+    reason: string;
+    code: string;
+}
+export interface StaticPredicatePlacementSafety {
+    mode: "safe_only";
+    unsafeRewriteApplied: false;
+    dryRun: boolean;
+    formatterGeneratedSource: boolean;
+}
+export interface StaticPredicatePlacementResult {
+    ok: boolean;
+    sql: string;
+    query: SelectQuery | null;
+    applied: readonly StaticPredicateMove[];
+    skipped: readonly StaticPredicateSkipped[];
+    warnings: readonly StaticPredicatePlacementWarning[];
+    errors: readonly StaticPredicatePlacementError[];
+    safety: StaticPredicatePlacementSafety;
+    staticPredicateMoves: readonly StaticPredicateMove[];
+}
+export declare class StaticPredicatePlacementOptimizer {
+    plan(input: StaticPredicatePlacementInput, options?: StaticPredicatePlacementOptions): StaticPredicatePlacementResult;
+    optimize(input: StaticPredicatePlacementInput, options?: StaticPredicatePlacementOptions): StaticPredicatePlacementResult;
+    private parseInput;
+    private analyzeCandidate;
+    private isExistsPredicate;
+    private findUnsupportedExpression;
+    private resolveTarget;
+    private findRootQueryBoundary;
+    private resolveTargetPlacement;
+    private resolveSourceBinding;
+    private resolveUpstreamQuery;
+    private resolveUnionTarget;
+    private resolveTargetColumns;
+    private resolveDeepestBranchTarget;
+    private verifyColumnResolvableInQuery;
+    private isGroupKeyColumn;
+    private sameResolvableColumnInQuery;
+    private resolveColumnSourceAlias;
+    private rebasePredicate;
+    private getSourceBindings;
+    private findNullableSideBoundary;
+    private hasLaterJoinThatNullsPriorSources;
+    private hasOuterJoin;
+    private hasDistinctOnBoundary;
+    private hasOrdinaryDistinct;
+    private getOutputColumnMatchCount;
+    private collectUnionBranches;
+    private resolveUnionOutputIndex;
+    private resolveTargetColumnByOutputIndex;
+    private collectSelectOutputs;
+    private resolveSourceQueryForColumns;
+    private findCte;
+    private countTableSourceReferences;
+    private collectSourceAliases;
+    private collectRootColumnReferences;
+    private hasWindowUsage;
+    private collectParameterNames;
+    private makeSkipped;
+    private buildResult;
+}
+export declare const planStaticPredicatePlacement: (input: StaticPredicatePlacementInput, options?: StaticPredicatePlacementOptions) => StaticPredicatePlacementResult;
+export declare const optimizeStaticPredicatePlacement: (input: StaticPredicatePlacementInput, options?: StaticPredicatePlacementOptions) => StaticPredicatePlacementResult;