npm - metal-orm - Versions diffs - 1.0.85 → 1.0.87 - Mend

metal-orm 1.0.85 → 1.0.87

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/index.cjs +197 -138
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +14 -3
package/dist/index.d.ts +14 -3
package/dist/index.js +195 -138
package/dist/index.js.map +1 -1
package/package.json +1 -1
package/src/core/ast/ast-validation.ts +10 -5
package/src/core/ast/expression-visitor.ts +19 -0
package/src/core/ast/query-visitor.ts +171 -125
package/src/orm/execute.ts +45 -45
package/src/query-builder/select/select-operations.ts +24 -24
package/src/query-builder/select.ts +27 -15

package/dist/index.d.cts CHANGED Viewed

@@ -1446,6 +1446,8 @@ interface ExpressionVisitor<R> {
     visitBetweenExpression?(node: BetweenExpressionNode): R;
     visitArithmeticExpression?(node: ArithmeticExpressionNode): R;
     visitBitwiseExpression?(node: BitwiseExpressionNode): R;
+    visitOperand?(node: OperandNode): R;
+    visitSelectQuery?(node: SelectQueryNode): R;
     otherwise?(node: ExpressionNode): R;
 }
 /**
@@ -1461,6 +1463,10 @@ interface OperandVisitor<R> {
     visitCaseExpression?(node: CaseExpressionNode): R;
     visitCast?(node: CastExpressionNode): R;
     visitWindowFunction?(node: WindowFunctionNode): R;
+    visitArithmeticExpression?(node: ArithmeticExpressionNode): R;
+    visitBitwiseExpression?(node: BitwiseExpressionNode): R;
+    visitExpression?(node: ExpressionNode): R;
+    visitSelectQuery?(node: SelectQueryNode): R;
     visitCollate?(node: CollateExpressionNode): R;
     visitAliasRef?(node: AliasRefNode): R;
     otherwise?(node: OperandNode): R;
@@ -1477,6 +1483,8 @@ declare const registerExpressionDispatcher: (type: string, dispatcher: Expressio
  * Allows new node kinds without modifying the core switch.
  */
 declare const registerOperandDispatcher: (type: string, dispatcher: OperandDispatch) => void;
+declare const hasExpressionDispatcher: (type: string) => boolean;
+declare const hasOperandDispatcher: (type: string) => boolean;
 /**
  * Clears all registered dispatchers. Primarily for tests.
  */
@@ -3972,6 +3980,9 @@ type SelectionValueType<TValue> = TValue extends TypedExpression<infer TRuntime>
 type SelectionResult<TSelection extends Record<string, ColumnSelectionValue>> = {
     [K in keyof TSelection]: SelectionValueType<TSelection[K]>;
 };
+type ParamOperandCompileOptions = {
+    allowParamOperands?: boolean;
+};
 type SelectionFromKeys<TTable extends TableDef, K extends keyof TTable['columns'] & string> = Pick<InferRow<TTable>, K>;
 type DeepSelectEntry<TTable extends TableDef> = {
     type: 'root';
@@ -4565,7 +4576,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      *   .compile('postgres');
      * console.log(compiled.sql); // SELECT "id", "name" FROM "users" WHERE "active" = true
      */
-    compile(dialect: SelectDialectInput): CompiledQuery;
+    compile(dialect: SelectDialectInput, options?: ParamOperandCompileOptions): CompiledQuery;
     /**
      * Converts the query to SQL string for a specific dialect
      * @param dialect - Database dialect to generate SQL for
@@ -4576,7 +4587,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      *   .toSql('postgres');
      * console.log(sql); // SELECT "id", "name" FROM "users" WHERE "active" = true
      */
-    toSql(dialect: SelectDialectInput): string;
+    toSql(dialect: SelectDialectInput, options?: ParamOperandCompileOptions): string;
     /**
      * Gets hydration plan for query
      * @returns Hydration plan or undefined if none exists
@@ -7220,4 +7231,4 @@ type PooledExecutorFactoryOptions<TConn> = {
  */
 declare function createPooledExecutorFactory<TConn>(opts: PooledExecutorFactoryOptions<TConn>): DbExecutorFactory;
-export { type AliasRefNode, type AnyDomainEvent, type ArithmeticExpressionNode, type TableRef as AstTableRef, AsyncLocalStorage, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToManyRelation, type BelongsToOptions, type BelongsToReference, type BelongsToReferenceApi, type BelongsToRelation, type BetweenExpressionNode, type BinaryExpressionNode, type BitwiseExpressionNode, type CascadeMode, type CaseExpressionNode, type CastExpressionNode, type CheckConstraint, type CollateExpressionNode, Column, type ColumnDef, type ColumnDiff, type ColumnInput, type ColumnNode, type ColumnOptions, type ColumnRef, type ColumnSchemaOptions, type ColumnToTs, type ColumnType, ConstructorMaterializationStrategy, type CreateTediousClientOptions, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, type DbExecutor, type DbExecutorFactory, type DecoratedEntityInstance, DefaultBelongsToReference, DefaultEntityMaterializer, DefaultHasManyCollection, DefaultManyToManyCollection, type DefaultValue, DeleteQueryBuilder, type DialectName, type DomainEvent, DomainEventBus, type DomainEventHandler, Entity, type EntityContext, type EntityInstance, type EntityMaterializationStrategy, type EntityMaterializer, type EntityOptions, type PrimaryKey$1 as EntityPrimaryKey, EntityStatus, type ExecutionContext, type ExistsExpressionNode, type ExpressionNode, type ExpressionVisitor, type ForeignKeyReference, type FunctionNode, type GroupConcatOptions, type HasDomainEvents, HasMany, type HasManyCollection, type HasManyOptions, type HasManyRelation, HasOne, type HasOneOptions, type HasOneReference, type HasOneReferenceApi, type HasOneRelation, type HydrationContext, type HydrationMetadata, type HydrationPivotPlan, type HydrationPlan, type HydrationRelationPlan, type InExpressionNode, type InExpressionRight, type IndexColumn, type IndexDef, type InferRow, type InitialHandlers, type InputRelationMode, type InputSchemaMode, type InputSchemaOptions, InsertQueryBuilder, InterceptorPipeline, type IntrospectOptions, type JsonPathNode, type JsonSchemaFormat, type JsonSchemaProperty, type JsonSchemaType, type Jsonify, type JsonifyScalar, type LiteralNode, type LiteralValue, type LogicalExpressionNode, type ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, type NullExpressionNode, type OpenApiParameter, type OpenApiSchema, type OpenApiSchemaBundle, type OperandNode, type OperandVisitor, Orm, type OrmDomainEvent, type OrmInterceptor, type OrmOptions, OrmSession, type OrmSessionOptions, type OutputSchemaOptions, type PaginatedResult, type ParamNode, type ParamProxy, type ParamProxyRoot, Pool, type PoolAdapter, type PoolLease, type PoolOptions, type PooledConnectionAdapter, type PostgresClientLike, PostgresDialect, PrimaryKey, type Primitive, PrototypeMaterializationStrategy, type QueryContext, type QueryInterceptor, type QueryLogEntry, type QueryLogger, type QueryResult, type RawDefaultValue, type ReferentialAction, type RelationChange, type RelationChangeEntry, type RelationDef, type RelationKey$1 as RelationKey, RelationKinds, type RelationMap, type RelationTargetTable, type RelationType, type RenderColumnOptions, STANDARD_COLUMN_TYPES, type SaveGraphInputPayload, type SaveGraphInputScalar, type SaveGraphJsonScalar, type SaveGraphSessionOptions, type ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaExtractionContext, type SchemaGenerateResult, type SchemaIntrospector, type SchemaOptions, type SchemaPlan, SelectQueryBuilder, type SelectQueryInput, type SelectableKeys, type SimpleQueryRunner, SqlServerDialect, type SqliteClientLike, SqliteDialect, type StandardColumnType, type SynchronizeOptions, type TableDef, type TableHooks, type TableOptions, type TableRef$1 as TableRef, type TediousColumn, type TediousConnectionLike, type TediousModule, type TediousRequest, type TediousRequestCtor, type TediousTypes, type TrackedEntity, TypeScriptGenerator, type TypedExpression, type TypedLike, UpdateQueryBuilder, type ValueOperandInput, type WindowFunctionNode, abs, acos, add, addDomainEvent, age, aliasRef, and, arrayAppend, asType, ascii, asin, atan, atan2, avg, belongsTo, belongsToMany, between, bitAnd, bitLength, bitOr, bitXor, bootstrapEntities, buildFilterParameters, caseWhen, cast, cbrt, ceil, ceiling, char, charLength, chr, clearExpressionDispatchers, clearOperandDispatchers, coalesce, col, collate, columnOperand, concat, concatWs, correlateBy, cos, cot, count, countAll, createEntityFromRow, createEntityProxy, createExecutorFromQueryRunner, createMssqlExecutor, createMysqlExecutor, createParamProxy, createPooledExecutorFactory, createPostgresExecutor, createQueryLoggingExecutor, createSqliteExecutor, createTediousExecutor, createTediousMssqlClient, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, defineTable, degrees, deleteFrom, denseRank, diffSchema, div, endOfMonth, entityRef, entityRefs, eq, esel, executeHydrated, executeHydratedPlain, executeHydratedPlainWithContexts, executeHydratedWithContexts, executeSchemaSql, executeSchemaSqlFor, exists, exp, extract, extractSchema, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, generateSchemaSqlFor, getColumn, getDecoratorMetadata, getSchemaIntrospector, getTableDefFromEntity, getTemporalFormat, greatest, groupConcat, gt, gte, hasMany, hasOne, hour, hydrateRows, ifNull, inList, inSubquery, initcap, insertInto, instr, introspectSchema, isCaseExpressionNode, isCastExpressionNode, isCollateExpressionNode, isExpressionSelectionNode, isFunctionNode, isNotNull, isNull, isOperandNode, isValueOperandInput, isWindowFunctionNode, jsonArrayAgg, jsonContains, jsonLength, jsonPath, jsonSet, jsonify, lag, lastValue, lead, least, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, localTime, localTimestamp, locate, log, log10, log2, logBase, lower, lpad, lt, lte, ltrim, mapColumnType, mapRelationType, materializeAs, max, md5, min, minute, mod, month, mul, neq, normalizeColumnType, notBetween, notExists, notInList, notInSubquery, notLike, now, ntile, nullif, octetLength, or, outerRef, pi, position, pow, power, quarter, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, relationLoaderCache, renderColumnDefinition, renderTypeWithArgs, repeat, replace, reverse, right, round, rowNumber, rowsToQueryResult, rpad, rtrim, schemaToJson, second, sel, selectFrom, selectFromEntity, setRelations, sha1, sha2, shiftLeft, shiftRight, sign, sin, space, sqrt, stddev, sub, substr, sum, synchronizeSchema, tableRef, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, update, upper, utcNow, valueToOperand, variance, visitExpression, visitOperand, weekOfYear, windowFunction, year };
+export { type AliasRefNode, type AnyDomainEvent, type ArithmeticExpressionNode, type TableRef as AstTableRef, AsyncLocalStorage, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToManyRelation, type BelongsToOptions, type BelongsToReference, type BelongsToReferenceApi, type BelongsToRelation, type BetweenExpressionNode, type BinaryExpressionNode, type BitwiseExpressionNode, type CascadeMode, type CaseExpressionNode, type CastExpressionNode, type CheckConstraint, type CollateExpressionNode, Column, type ColumnDef, type ColumnDiff, type ColumnInput, type ColumnNode, type ColumnOptions, type ColumnRef, type ColumnSchemaOptions, type ColumnToTs, type ColumnType, ConstructorMaterializationStrategy, type CreateTediousClientOptions, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, type DbExecutor, type DbExecutorFactory, type DecoratedEntityInstance, DefaultBelongsToReference, DefaultEntityMaterializer, DefaultHasManyCollection, DefaultManyToManyCollection, type DefaultValue, DeleteQueryBuilder, type DialectName, type DomainEvent, DomainEventBus, type DomainEventHandler, Entity, type EntityContext, type EntityInstance, type EntityMaterializationStrategy, type EntityMaterializer, type EntityOptions, type PrimaryKey$1 as EntityPrimaryKey, EntityStatus, type ExecutionContext, type ExistsExpressionNode, type ExpressionNode, type ExpressionVisitor, type ForeignKeyReference, type FunctionNode, type GroupConcatOptions, type HasDomainEvents, HasMany, type HasManyCollection, type HasManyOptions, type HasManyRelation, HasOne, type HasOneOptions, type HasOneReference, type HasOneReferenceApi, type HasOneRelation, type HydrationContext, type HydrationMetadata, type HydrationPivotPlan, type HydrationPlan, type HydrationRelationPlan, type InExpressionNode, type InExpressionRight, type IndexColumn, type IndexDef, type InferRow, type InitialHandlers, type InputRelationMode, type InputSchemaMode, type InputSchemaOptions, InsertQueryBuilder, InterceptorPipeline, type IntrospectOptions, type JsonPathNode, type JsonSchemaFormat, type JsonSchemaProperty, type JsonSchemaType, type Jsonify, type JsonifyScalar, type LiteralNode, type LiteralValue, type LogicalExpressionNode, type ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, type NullExpressionNode, type OpenApiParameter, type OpenApiSchema, type OpenApiSchemaBundle, type OperandNode, type OperandVisitor, Orm, type OrmDomainEvent, type OrmInterceptor, type OrmOptions, OrmSession, type OrmSessionOptions, type OutputSchemaOptions, type PaginatedResult, type ParamNode, type ParamProxy, type ParamProxyRoot, Pool, type PoolAdapter, type PoolLease, type PoolOptions, type PooledConnectionAdapter, type PostgresClientLike, PostgresDialect, PrimaryKey, type Primitive, PrototypeMaterializationStrategy, type QueryContext, type QueryInterceptor, type QueryLogEntry, type QueryLogger, type QueryResult, type RawDefaultValue, type ReferentialAction, type RelationChange, type RelationChangeEntry, type RelationDef, type RelationKey$1 as RelationKey, RelationKinds, type RelationMap, type RelationTargetTable, type RelationType, type RenderColumnOptions, STANDARD_COLUMN_TYPES, type SaveGraphInputPayload, type SaveGraphInputScalar, type SaveGraphJsonScalar, type SaveGraphSessionOptions, type ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaExtractionContext, type SchemaGenerateResult, type SchemaIntrospector, type SchemaOptions, type SchemaPlan, SelectQueryBuilder, type SelectQueryInput, type SelectableKeys, type SimpleQueryRunner, SqlServerDialect, type SqliteClientLike, SqliteDialect, type StandardColumnType, type SynchronizeOptions, type TableDef, type TableHooks, type TableOptions, type TableRef$1 as TableRef, type TediousColumn, type TediousConnectionLike, type TediousModule, type TediousRequest, type TediousRequestCtor, type TediousTypes, type TrackedEntity, TypeScriptGenerator, type TypedExpression, type TypedLike, UpdateQueryBuilder, type ValueOperandInput, type WindowFunctionNode, abs, acos, add, addDomainEvent, age, aliasRef, and, arrayAppend, asType, ascii, asin, atan, atan2, avg, belongsTo, belongsToMany, between, bitAnd, bitLength, bitOr, bitXor, bootstrapEntities, buildFilterParameters, caseWhen, cast, cbrt, ceil, ceiling, char, charLength, chr, clearExpressionDispatchers, clearOperandDispatchers, coalesce, col, collate, columnOperand, concat, concatWs, correlateBy, cos, cot, count, countAll, createEntityFromRow, createEntityProxy, createExecutorFromQueryRunner, createMssqlExecutor, createMysqlExecutor, createParamProxy, createPooledExecutorFactory, createPostgresExecutor, createQueryLoggingExecutor, createSqliteExecutor, createTediousExecutor, createTediousMssqlClient, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, defineTable, degrees, deleteFrom, denseRank, diffSchema, div, endOfMonth, entityRef, entityRefs, eq, esel, executeHydrated, executeHydratedPlain, executeHydratedPlainWithContexts, executeHydratedWithContexts, executeSchemaSql, executeSchemaSqlFor, exists, exp, extract, extractSchema, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, generateSchemaSqlFor, getColumn, getDecoratorMetadata, getSchemaIntrospector, getTableDefFromEntity, getTemporalFormat, greatest, groupConcat, gt, gte, hasExpressionDispatcher, hasMany, hasOne, hasOperandDispatcher, hour, hydrateRows, ifNull, inList, inSubquery, initcap, insertInto, instr, introspectSchema, isCaseExpressionNode, isCastExpressionNode, isCollateExpressionNode, isExpressionSelectionNode, isFunctionNode, isNotNull, isNull, isOperandNode, isValueOperandInput, isWindowFunctionNode, jsonArrayAgg, jsonContains, jsonLength, jsonPath, jsonSet, jsonify, lag, lastValue, lead, least, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, localTime, localTimestamp, locate, log, log10, log2, logBase, lower, lpad, lt, lte, ltrim, mapColumnType, mapRelationType, materializeAs, max, md5, min, minute, mod, month, mul, neq, normalizeColumnType, notBetween, notExists, notInList, notInSubquery, notLike, now, ntile, nullif, octetLength, or, outerRef, pi, position, pow, power, quarter, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, relationLoaderCache, renderColumnDefinition, renderTypeWithArgs, repeat, replace, reverse, right, round, rowNumber, rowsToQueryResult, rpad, rtrim, schemaToJson, second, sel, selectFrom, selectFromEntity, setRelations, sha1, sha2, shiftLeft, shiftRight, sign, sin, space, sqrt, stddev, sub, substr, sum, synchronizeSchema, tableRef, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, update, upper, utcNow, valueToOperand, variance, visitExpression, visitOperand, weekOfYear, windowFunction, year };

package/dist/index.d.ts CHANGED Viewed

@@ -1446,6 +1446,8 @@ interface ExpressionVisitor<R> {
     visitBetweenExpression?(node: BetweenExpressionNode): R;
     visitArithmeticExpression?(node: ArithmeticExpressionNode): R;
     visitBitwiseExpression?(node: BitwiseExpressionNode): R;
+    visitOperand?(node: OperandNode): R;
+    visitSelectQuery?(node: SelectQueryNode): R;
     otherwise?(node: ExpressionNode): R;
 }
 /**
@@ -1461,6 +1463,10 @@ interface OperandVisitor<R> {
     visitCaseExpression?(node: CaseExpressionNode): R;
     visitCast?(node: CastExpressionNode): R;
     visitWindowFunction?(node: WindowFunctionNode): R;
+    visitArithmeticExpression?(node: ArithmeticExpressionNode): R;
+    visitBitwiseExpression?(node: BitwiseExpressionNode): R;
+    visitExpression?(node: ExpressionNode): R;
+    visitSelectQuery?(node: SelectQueryNode): R;
     visitCollate?(node: CollateExpressionNode): R;
     visitAliasRef?(node: AliasRefNode): R;
     otherwise?(node: OperandNode): R;
@@ -1477,6 +1483,8 @@ declare const registerExpressionDispatcher: (type: string, dispatcher: Expressio
  * Allows new node kinds without modifying the core switch.
  */
 declare const registerOperandDispatcher: (type: string, dispatcher: OperandDispatch) => void;
+declare const hasExpressionDispatcher: (type: string) => boolean;
+declare const hasOperandDispatcher: (type: string) => boolean;
 /**
  * Clears all registered dispatchers. Primarily for tests.
  */
@@ -3972,6 +3980,9 @@ type SelectionValueType<TValue> = TValue extends TypedExpression<infer TRuntime>
 type SelectionResult<TSelection extends Record<string, ColumnSelectionValue>> = {
     [K in keyof TSelection]: SelectionValueType<TSelection[K]>;
 };
+type ParamOperandCompileOptions = {
+    allowParamOperands?: boolean;
+};
 type SelectionFromKeys<TTable extends TableDef, K extends keyof TTable['columns'] & string> = Pick<InferRow<TTable>, K>;
 type DeepSelectEntry<TTable extends TableDef> = {
     type: 'root';
@@ -4565,7 +4576,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      *   .compile('postgres');
      * console.log(compiled.sql); // SELECT "id", "name" FROM "users" WHERE "active" = true
      */
-    compile(dialect: SelectDialectInput): CompiledQuery;
+    compile(dialect: SelectDialectInput, options?: ParamOperandCompileOptions): CompiledQuery;
     /**
      * Converts the query to SQL string for a specific dialect
      * @param dialect - Database dialect to generate SQL for
@@ -4576,7 +4587,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      *   .toSql('postgres');
      * console.log(sql); // SELECT "id", "name" FROM "users" WHERE "active" = true
      */
-    toSql(dialect: SelectDialectInput): string;
+    toSql(dialect: SelectDialectInput, options?: ParamOperandCompileOptions): string;
     /**
      * Gets hydration plan for query
      * @returns Hydration plan or undefined if none exists
@@ -7220,4 +7231,4 @@ type PooledExecutorFactoryOptions<TConn> = {
  */
 declare function createPooledExecutorFactory<TConn>(opts: PooledExecutorFactoryOptions<TConn>): DbExecutorFactory;
-export { type AliasRefNode, type AnyDomainEvent, type ArithmeticExpressionNode, type TableRef as AstTableRef, AsyncLocalStorage, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToManyRelation, type BelongsToOptions, type BelongsToReference, type BelongsToReferenceApi, type BelongsToRelation, type BetweenExpressionNode, type BinaryExpressionNode, type BitwiseExpressionNode, type CascadeMode, type CaseExpressionNode, type CastExpressionNode, type CheckConstraint, type CollateExpressionNode, Column, type ColumnDef, type ColumnDiff, type ColumnInput, type ColumnNode, type ColumnOptions, type ColumnRef, type ColumnSchemaOptions, type ColumnToTs, type ColumnType, ConstructorMaterializationStrategy, type CreateTediousClientOptions, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, type DbExecutor, type DbExecutorFactory, type DecoratedEntityInstance, DefaultBelongsToReference, DefaultEntityMaterializer, DefaultHasManyCollection, DefaultManyToManyCollection, type DefaultValue, DeleteQueryBuilder, type DialectName, type DomainEvent, DomainEventBus, type DomainEventHandler, Entity, type EntityContext, type EntityInstance, type EntityMaterializationStrategy, type EntityMaterializer, type EntityOptions, type PrimaryKey$1 as EntityPrimaryKey, EntityStatus, type ExecutionContext, type ExistsExpressionNode, type ExpressionNode, type ExpressionVisitor, type ForeignKeyReference, type FunctionNode, type GroupConcatOptions, type HasDomainEvents, HasMany, type HasManyCollection, type HasManyOptions, type HasManyRelation, HasOne, type HasOneOptions, type HasOneReference, type HasOneReferenceApi, type HasOneRelation, type HydrationContext, type HydrationMetadata, type HydrationPivotPlan, type HydrationPlan, type HydrationRelationPlan, type InExpressionNode, type InExpressionRight, type IndexColumn, type IndexDef, type InferRow, type InitialHandlers, type InputRelationMode, type InputSchemaMode, type InputSchemaOptions, InsertQueryBuilder, InterceptorPipeline, type IntrospectOptions, type JsonPathNode, type JsonSchemaFormat, type JsonSchemaProperty, type JsonSchemaType, type Jsonify, type JsonifyScalar, type LiteralNode, type LiteralValue, type LogicalExpressionNode, type ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, type NullExpressionNode, type OpenApiParameter, type OpenApiSchema, type OpenApiSchemaBundle, type OperandNode, type OperandVisitor, Orm, type OrmDomainEvent, type OrmInterceptor, type OrmOptions, OrmSession, type OrmSessionOptions, type OutputSchemaOptions, type PaginatedResult, type ParamNode, type ParamProxy, type ParamProxyRoot, Pool, type PoolAdapter, type PoolLease, type PoolOptions, type PooledConnectionAdapter, type PostgresClientLike, PostgresDialect, PrimaryKey, type Primitive, PrototypeMaterializationStrategy, type QueryContext, type QueryInterceptor, type QueryLogEntry, type QueryLogger, type QueryResult, type RawDefaultValue, type ReferentialAction, type RelationChange, type RelationChangeEntry, type RelationDef, type RelationKey$1 as RelationKey, RelationKinds, type RelationMap, type RelationTargetTable, type RelationType, type RenderColumnOptions, STANDARD_COLUMN_TYPES, type SaveGraphInputPayload, type SaveGraphInputScalar, type SaveGraphJsonScalar, type SaveGraphSessionOptions, type ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaExtractionContext, type SchemaGenerateResult, type SchemaIntrospector, type SchemaOptions, type SchemaPlan, SelectQueryBuilder, type SelectQueryInput, type SelectableKeys, type SimpleQueryRunner, SqlServerDialect, type SqliteClientLike, SqliteDialect, type StandardColumnType, type SynchronizeOptions, type TableDef, type TableHooks, type TableOptions, type TableRef$1 as TableRef, type TediousColumn, type TediousConnectionLike, type TediousModule, type TediousRequest, type TediousRequestCtor, type TediousTypes, type TrackedEntity, TypeScriptGenerator, type TypedExpression, type TypedLike, UpdateQueryBuilder, type ValueOperandInput, type WindowFunctionNode, abs, acos, add, addDomainEvent, age, aliasRef, and, arrayAppend, asType, ascii, asin, atan, atan2, avg, belongsTo, belongsToMany, between, bitAnd, bitLength, bitOr, bitXor, bootstrapEntities, buildFilterParameters, caseWhen, cast, cbrt, ceil, ceiling, char, charLength, chr, clearExpressionDispatchers, clearOperandDispatchers, coalesce, col, collate, columnOperand, concat, concatWs, correlateBy, cos, cot, count, countAll, createEntityFromRow, createEntityProxy, createExecutorFromQueryRunner, createMssqlExecutor, createMysqlExecutor, createParamProxy, createPooledExecutorFactory, createPostgresExecutor, createQueryLoggingExecutor, createSqliteExecutor, createTediousExecutor, createTediousMssqlClient, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, defineTable, degrees, deleteFrom, denseRank, diffSchema, div, endOfMonth, entityRef, entityRefs, eq, esel, executeHydrated, executeHydratedPlain, executeHydratedPlainWithContexts, executeHydratedWithContexts, executeSchemaSql, executeSchemaSqlFor, exists, exp, extract, extractSchema, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, generateSchemaSqlFor, getColumn, getDecoratorMetadata, getSchemaIntrospector, getTableDefFromEntity, getTemporalFormat, greatest, groupConcat, gt, gte, hasMany, hasOne, hour, hydrateRows, ifNull, inList, inSubquery, initcap, insertInto, instr, introspectSchema, isCaseExpressionNode, isCastExpressionNode, isCollateExpressionNode, isExpressionSelectionNode, isFunctionNode, isNotNull, isNull, isOperandNode, isValueOperandInput, isWindowFunctionNode, jsonArrayAgg, jsonContains, jsonLength, jsonPath, jsonSet, jsonify, lag, lastValue, lead, least, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, localTime, localTimestamp, locate, log, log10, log2, logBase, lower, lpad, lt, lte, ltrim, mapColumnType, mapRelationType, materializeAs, max, md5, min, minute, mod, month, mul, neq, normalizeColumnType, notBetween, notExists, notInList, notInSubquery, notLike, now, ntile, nullif, octetLength, or, outerRef, pi, position, pow, power, quarter, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, relationLoaderCache, renderColumnDefinition, renderTypeWithArgs, repeat, replace, reverse, right, round, rowNumber, rowsToQueryResult, rpad, rtrim, schemaToJson, second, sel, selectFrom, selectFromEntity, setRelations, sha1, sha2, shiftLeft, shiftRight, sign, sin, space, sqrt, stddev, sub, substr, sum, synchronizeSchema, tableRef, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, update, upper, utcNow, valueToOperand, variance, visitExpression, visitOperand, weekOfYear, windowFunction, year };
+export { type AliasRefNode, type AnyDomainEvent, type ArithmeticExpressionNode, type TableRef as AstTableRef, AsyncLocalStorage, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToManyRelation, type BelongsToOptions, type BelongsToReference, type BelongsToReferenceApi, type BelongsToRelation, type BetweenExpressionNode, type BinaryExpressionNode, type BitwiseExpressionNode, type CascadeMode, type CaseExpressionNode, type CastExpressionNode, type CheckConstraint, type CollateExpressionNode, Column, type ColumnDef, type ColumnDiff, type ColumnInput, type ColumnNode, type ColumnOptions, type ColumnRef, type ColumnSchemaOptions, type ColumnToTs, type ColumnType, ConstructorMaterializationStrategy, type CreateTediousClientOptions, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, type DbExecutor, type DbExecutorFactory, type DecoratedEntityInstance, DefaultBelongsToReference, DefaultEntityMaterializer, DefaultHasManyCollection, DefaultManyToManyCollection, type DefaultValue, DeleteQueryBuilder, type DialectName, type DomainEvent, DomainEventBus, type DomainEventHandler, Entity, type EntityContext, type EntityInstance, type EntityMaterializationStrategy, type EntityMaterializer, type EntityOptions, type PrimaryKey$1 as EntityPrimaryKey, EntityStatus, type ExecutionContext, type ExistsExpressionNode, type ExpressionNode, type ExpressionVisitor, type ForeignKeyReference, type FunctionNode, type GroupConcatOptions, type HasDomainEvents, HasMany, type HasManyCollection, type HasManyOptions, type HasManyRelation, HasOne, type HasOneOptions, type HasOneReference, type HasOneReferenceApi, type HasOneRelation, type HydrationContext, type HydrationMetadata, type HydrationPivotPlan, type HydrationPlan, type HydrationRelationPlan, type InExpressionNode, type InExpressionRight, type IndexColumn, type IndexDef, type InferRow, type InitialHandlers, type InputRelationMode, type InputSchemaMode, type InputSchemaOptions, InsertQueryBuilder, InterceptorPipeline, type IntrospectOptions, type JsonPathNode, type JsonSchemaFormat, type JsonSchemaProperty, type JsonSchemaType, type Jsonify, type JsonifyScalar, type LiteralNode, type LiteralValue, type LogicalExpressionNode, type ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, type NullExpressionNode, type OpenApiParameter, type OpenApiSchema, type OpenApiSchemaBundle, type OperandNode, type OperandVisitor, Orm, type OrmDomainEvent, type OrmInterceptor, type OrmOptions, OrmSession, type OrmSessionOptions, type OutputSchemaOptions, type PaginatedResult, type ParamNode, type ParamProxy, type ParamProxyRoot, Pool, type PoolAdapter, type PoolLease, type PoolOptions, type PooledConnectionAdapter, type PostgresClientLike, PostgresDialect, PrimaryKey, type Primitive, PrototypeMaterializationStrategy, type QueryContext, type QueryInterceptor, type QueryLogEntry, type QueryLogger, type QueryResult, type RawDefaultValue, type ReferentialAction, type RelationChange, type RelationChangeEntry, type RelationDef, type RelationKey$1 as RelationKey, RelationKinds, type RelationMap, type RelationTargetTable, type RelationType, type RenderColumnOptions, STANDARD_COLUMN_TYPES, type SaveGraphInputPayload, type SaveGraphInputScalar, type SaveGraphJsonScalar, type SaveGraphSessionOptions, type ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaExtractionContext, type SchemaGenerateResult, type SchemaIntrospector, type SchemaOptions, type SchemaPlan, SelectQueryBuilder, type SelectQueryInput, type SelectableKeys, type SimpleQueryRunner, SqlServerDialect, type SqliteClientLike, SqliteDialect, type StandardColumnType, type SynchronizeOptions, type TableDef, type TableHooks, type TableOptions, type TableRef$1 as TableRef, type TediousColumn, type TediousConnectionLike, type TediousModule, type TediousRequest, type TediousRequestCtor, type TediousTypes, type TrackedEntity, TypeScriptGenerator, type TypedExpression, type TypedLike, UpdateQueryBuilder, type ValueOperandInput, type WindowFunctionNode, abs, acos, add, addDomainEvent, age, aliasRef, and, arrayAppend, asType, ascii, asin, atan, atan2, avg, belongsTo, belongsToMany, between, bitAnd, bitLength, bitOr, bitXor, bootstrapEntities, buildFilterParameters, caseWhen, cast, cbrt, ceil, ceiling, char, charLength, chr, clearExpressionDispatchers, clearOperandDispatchers, coalesce, col, collate, columnOperand, concat, concatWs, correlateBy, cos, cot, count, countAll, createEntityFromRow, createEntityProxy, createExecutorFromQueryRunner, createMssqlExecutor, createMysqlExecutor, createParamProxy, createPooledExecutorFactory, createPostgresExecutor, createQueryLoggingExecutor, createSqliteExecutor, createTediousExecutor, createTediousMssqlClient, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, defineTable, degrees, deleteFrom, denseRank, diffSchema, div, endOfMonth, entityRef, entityRefs, eq, esel, executeHydrated, executeHydratedPlain, executeHydratedPlainWithContexts, executeHydratedWithContexts, executeSchemaSql, executeSchemaSqlFor, exists, exp, extract, extractSchema, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, generateSchemaSqlFor, getColumn, getDecoratorMetadata, getSchemaIntrospector, getTableDefFromEntity, getTemporalFormat, greatest, groupConcat, gt, gte, hasExpressionDispatcher, hasMany, hasOne, hasOperandDispatcher, hour, hydrateRows, ifNull, inList, inSubquery, initcap, insertInto, instr, introspectSchema, isCaseExpressionNode, isCastExpressionNode, isCollateExpressionNode, isExpressionSelectionNode, isFunctionNode, isNotNull, isNull, isOperandNode, isValueOperandInput, isWindowFunctionNode, jsonArrayAgg, jsonContains, jsonLength, jsonPath, jsonSet, jsonify, lag, lastValue, lead, least, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, localTime, localTimestamp, locate, log, log10, log2, logBase, lower, lpad, lt, lte, ltrim, mapColumnType, mapRelationType, materializeAs, max, md5, min, minute, mod, month, mul, neq, normalizeColumnType, notBetween, notExists, notInList, notInSubquery, notLike, now, ntile, nullif, octetLength, or, outerRef, pi, position, pow, power, quarter, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, relationLoaderCache, renderColumnDefinition, renderTypeWithArgs, repeat, replace, reverse, right, round, rowNumber, rowsToQueryResult, rpad, rtrim, schemaToJson, second, sel, selectFrom, selectFromEntity, setRelations, sha1, sha2, shiftLeft, shiftRight, sign, sin, space, sqrt, stddev, sub, substr, sum, synchronizeSchema, tableRef, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, update, upper, utcNow, valueToOperand, variance, visitExpression, visitOperand, weekOfYear, windowFunction, year };

package/dist/index.js CHANGED Viewed

@@ -770,6 +770,8 @@ var registerExpressionDispatcher = (type, dispatcher) => {
 var registerOperandDispatcher = (type, dispatcher) => {
   operandRegistry = operandRegistry.register(type, dispatcher);
 };
+var hasExpressionDispatcher = (type) => expressionRegistry.get(type) !== void 0;
+var hasOperandDispatcher = (type) => operandRegistry.get(type) !== void 0;
 var clearExpressionDispatchers = () => {
   expressionRegistry = expressionRegistry.clear();
 };
@@ -864,6 +866,12 @@ var visitOperand = (node, visitor) => {
     case "Collate":
       if (visitor.visitCollate) return visitor.visitCollate(node);
       break;
+    case "ArithmeticExpression":
+      if (visitor.visitArithmeticExpression) return visitor.visitArithmeticExpression(node);
+      break;
+    case "BitwiseExpression":
+      if (visitor.visitBitwiseExpression) return visitor.visitBitwiseExpression(node);
+      break;
     default:
       break;
   }
@@ -7367,7 +7375,7 @@ var collectFilterColumns = (expr, table, rootTables) => {
       columns.add(node.name);
     }
   };
-  const visitOrderingTerm2 = (term) => {
+  const visitOrderingTerm = (term) => {
     if (!term || typeof term !== "object") return;
     if (isOperandNode(term)) {
       visitOperand2(term);
@@ -7379,7 +7387,7 @@ var collectFilterColumns = (expr, table, rootTables) => {
   };
   const visitOrderBy = (orderBy) => {
     if (!orderBy) return;
-    orderBy.forEach((node) => visitOrderingTerm2(node.term));
+    orderBy.forEach((node) => visitOrderingTerm(node.term));
   };
   const visitOperand2 = (node) => {
     switch (node.type) {
@@ -7531,137 +7539,174 @@ var getNodeType3 = (value) => {
   }
   return void 0;
 };
-var visitOrderingTerm = (term, visitor) => {
-  if (isOperandNode(term)) {
-    visitOperandNode(term, visitor);
-    return;
-  }
-  visitExpressionNode(term, visitor);
-};
-var visitOrderByNode = (node, visitor) => {
-  visitor.visitOrderBy?.(node);
-  visitOrderingTerm(node.term, visitor);
-};
-var visitTableSource = (source, visitor) => {
-  visitor.visitTableSource?.(source);
-  if (source.type === "DerivedTable") {
-    visitor.visitDerivedTable?.(source);
-    visitSelectQuery(source.query, visitor);
-    return;
-  }
-  if (source.type === "FunctionTable") {
-    visitor.visitFunctionTable?.(source);
-    source.args?.forEach((arg) => visitOperandNode(arg, visitor));
-  }
-};
-var visitExpressionNode = (node, visitor) => {
-  visitor.visitExpression?.(node);
-  const type = getNodeType3(node);
-  if (!type) return;
-  switch (type) {
-    case "BinaryExpression":
-      visitOperandNode(node.left, visitor);
-      visitOperandNode(node.right, visitor);
-      if (node.escape) {
-        visitOperandNode(node.escape, visitor);
-      }
+var visitSelectQuery = (ast, visitor) => {
+  const visitExpressionNode = (node) => {
+    visitExpression(node, expressionVisitor);
+  };
+  const visitOperandNode = (node) => {
+    visitOperand(node, operandVisitor);
+  };
+  const visitOrderingTerm = (term) => {
+    if (!term || typeof term !== "object") return;
+    if (isOperandNode(term)) {
+      visitOperandNode(term);
       return;
-    case "LogicalExpression":
-      node.operands.forEach((operand) => visitExpressionNode(operand, visitor));
+    }
+    const type = getNodeType3(term);
+    if (type && hasOperandDispatcher(type)) {
+      visitOperandNode(term);
       return;
-    case "NullExpression":
-      visitOperandNode(node.left, visitor);
+    }
+    if (type) {
+      visitExpressionNode(term);
+    }
+  };
+  const visitOrderByNode = (node) => {
+    visitor.visitOrderBy?.(node);
+    visitOrderingTerm(node.term);
+  };
+  const visitTableSource = (source) => {
+    visitor.visitTableSource?.(source);
+    if (source.type === "DerivedTable") {
+      visitor.visitDerivedTable?.(source);
+      visitSelectQuery(source.query, visitor);
       return;
-    case "InExpression":
-      visitOperandNode(node.left, visitor);
+    }
+    if (source.type === "FunctionTable") {
+      visitor.visitFunctionTable?.(source);
+      source.args?.forEach((arg) => visitOperandNode(arg));
+    }
+  };
+  const expressionVisitor = {
+    visitBinaryExpression: (node) => {
+      visitor.visitExpression?.(node);
+      visitOperandNode(node.left);
+      visitOperandNode(node.right);
+      if (node.escape) {
+        visitOperandNode(node.escape);
+      }
+    },
+    visitLogicalExpression: (node) => {
+      visitor.visitExpression?.(node);
+      node.operands.forEach((operand) => visitExpressionNode(operand));
+    },
+    visitNullExpression: (node) => {
+      visitor.visitExpression?.(node);
+      visitOperandNode(node.left);
+    },
+    visitInExpression: (node) => {
+      visitor.visitExpression?.(node);
+      visitOperandNode(node.left);
       if (Array.isArray(node.right)) {
-        node.right.forEach((operand) => visitOperandNode(operand, visitor));
+        node.right.forEach((operand) => visitOperandNode(operand));
       } else {
-        visitOperandNode(node.right, visitor);
+        visitOperandNode(node.right);
       }
-      return;
-    case "ExistsExpression":
+    },
+    visitExistsExpression: (node) => {
+      visitor.visitExpression?.(node);
       visitSelectQuery(node.subquery, visitor);
-      return;
-    case "BetweenExpression":
-      visitOperandNode(node.left, visitor);
-      visitOperandNode(node.lower, visitor);
-      visitOperandNode(node.upper, visitor);
-      return;
-    case "ArithmeticExpression":
-      visitOperandNode(node.left, visitor);
-      visitOperandNode(node.right, visitor);
-      return;
-    case "BitwiseExpression":
-      visitOperandNode(node.left, visitor);
-      visitOperandNode(node.right, visitor);
-      return;
-    default: {
-      return;
+    },
+    visitBetweenExpression: (node) => {
+      visitor.visitExpression?.(node);
+      visitOperandNode(node.left);
+      visitOperandNode(node.lower);
+      visitOperandNode(node.upper);
+    },
+    visitArithmeticExpression: (node) => {
+      visitor.visitExpression?.(node);
+      visitOperandNode(node.left);
+      visitOperandNode(node.right);
+    },
+    visitBitwiseExpression: (node) => {
+      visitor.visitExpression?.(node);
+      visitOperandNode(node.left);
+      visitOperandNode(node.right);
+    },
+    visitOperand: (node) => {
+      visitOperandNode(node);
+    },
+    visitSelectQuery: (node) => {
+      visitSelectQuery(node, visitor);
+    },
+    otherwise: (node) => {
+      visitor.visitExpression?.(node);
     }
-  }
-};
-var visitOperandNode = (node, visitor) => {
-  visitor.visitOperand?.(node);
-  const type = getNodeType3(node);
-  if (type === "Param") {
-    visitor.visitParam?.(node);
-  }
-  if (!type) return;
-  switch (type) {
-    case "Column":
-    case "Literal":
-    case "Param":
-    case "AliasRef":
-      return;
-    case "Function":
-      node.args?.forEach((arg) => visitOperandNode(arg, visitor));
-      node.orderBy?.forEach((order) => visitOrderByNode(order, visitor));
+  };
+  const operandVisitor = {
+    visitColumn: (node) => {
+      visitor.visitOperand?.(node);
+    },
+    visitLiteral: (node) => {
+      visitor.visitOperand?.(node);
+    },
+    visitParam: (node) => {
+      visitor.visitOperand?.(node);
+      visitor.visitParam?.(node);
+    },
+    visitFunction: (node) => {
+      visitor.visitOperand?.(node);
+      node.args?.forEach((arg) => visitOperandNode(arg));
+      node.orderBy?.forEach((order) => visitOrderByNode(order));
       if (node.separator) {
-        visitOperandNode(node.separator, visitor);
+        visitOperandNode(node.separator);
       }
-      return;
-    case "JsonPath":
-      visitOperandNode(node.column, visitor);
-      return;
-    case "ScalarSubquery":
+    },
+    visitJsonPath: (node) => {
+      visitor.visitOperand?.(node);
+      visitOperandNode(node.column);
+    },
+    visitScalarSubquery: (node) => {
+      visitor.visitOperand?.(node);
       visitSelectQuery(node.query, visitor);
-      return;
-    case "CaseExpression":
+    },
+    visitCaseExpression: (node) => {
+      visitor.visitOperand?.(node);
       node.conditions.forEach((cond) => {
-        visitExpressionNode(cond.when, visitor);
-        visitOperandNode(cond.then, visitor);
+        visitExpressionNode(cond.when);
+        visitOperandNode(cond.then);
       });
       if (node.else) {
-        visitOperandNode(node.else, visitor);
+        visitOperandNode(node.else);
       }
-      return;
-    case "Cast":
-      visitOperandNode(node.expression, visitor);
-      return;
-    case "WindowFunction":
-      node.args?.forEach((arg) => visitOperandNode(arg, visitor));
-      node.partitionBy?.forEach((term) => visitOperandNode(term, visitor));
-      node.orderBy?.forEach((order) => visitOrderByNode(order, visitor));
-      return;
-    case "ArithmeticExpression":
-      visitOperandNode(node.left, visitor);
-      visitOperandNode(node.right, visitor);
-      return;
-    case "BitwiseExpression":
-      visitOperandNode(node.left, visitor);
-      visitOperandNode(node.right, visitor);
-      return;
-    case "Collate":
-      visitOperandNode(node.expression, visitor);
-      return;
-    default: {
-      const _exhaustive = node;
-      return _exhaustive;
+    },
+    visitCast: (node) => {
+      visitor.visitOperand?.(node);
+      visitOperandNode(node.expression);
+    },
+    visitWindowFunction: (node) => {
+      visitor.visitOperand?.(node);
+      node.args?.forEach((arg) => visitOperandNode(arg));
+      node.partitionBy?.forEach((term) => visitOperandNode(term));
+      node.orderBy?.forEach((order) => visitOrderByNode(order));
+    },
+    visitArithmeticExpression: (node) => {
+      visitor.visitOperand?.(node);
+      visitOperandNode(node.left);
+      visitOperandNode(node.right);
+    },
+    visitBitwiseExpression: (node) => {
+      visitor.visitOperand?.(node);
+      visitOperandNode(node.left);
+      visitOperandNode(node.right);
+    },
+    visitExpression: (node) => {
+      visitExpressionNode(node);
+    },
+    visitSelectQuery: (node) => {
+      visitSelectQuery(node, visitor);
+    },
+    visitCollate: (node) => {
+      visitor.visitOperand?.(node);
+      visitOperandNode(node.expression);
+    },
+    visitAliasRef: (node) => {
+      visitor.visitOperand?.(node);
+    },
+    otherwise: (node) => {
+      visitor.visitOperand?.(node);
     }
-  }
-};
-var visitSelectQuery = (ast, visitor) => {
+  };
   visitor.visitSelectQuery?.(ast);
   if (ast.ctes) {
     for (const cte of ast.ctes) {
@@ -7669,29 +7714,29 @@ var visitSelectQuery = (ast, visitor) => {
       visitSelectQuery(cte.query, visitor);
     }
   }
-  visitTableSource(ast.from, visitor);
+  visitTableSource(ast.from);
   ast.columns?.forEach((col2) => {
-    visitOperandNode(col2, visitor);
+    visitOperandNode(col2);
   });
   ast.joins?.forEach((join) => {
     visitor.visitJoin?.(join);
-    visitTableSource(join.table, visitor);
-    visitExpressionNode(join.condition, visitor);
+    visitTableSource(join.table);
+    visitExpressionNode(join.condition);
   });
   if (ast.where) {
-    visitExpressionNode(ast.where, visitor);
+    visitExpressionNode(ast.where);
   }
   ast.groupBy?.forEach((term) => {
-    visitOrderingTerm(term, visitor);
+    visitOrderingTerm(term);
   });
   if (ast.having) {
-    visitExpressionNode(ast.having, visitor);
+    visitExpressionNode(ast.having);
   }
   ast.orderBy?.forEach((order) => {
-    visitOrderByNode(order, visitor);
+    visitOrderByNode(order);
   });
   ast.distinct?.forEach((col2) => {
-    visitOperandNode(col2, visitor);
+    visitOperandNode(col2);
   });
   ast.setOps?.forEach((op) => {
     visitor.visitSetOperation?.(op);
@@ -7700,14 +7745,16 @@ var visitSelectQuery = (ast, visitor) => {
 };
 // src/core/ast/ast-validation.ts
-var hasParamOperandsInQuery = (ast) => {
-  let hasParams = false;
+var findFirstParamOperandName = (ast) => {
+  let name;
   visitSelectQuery(ast, {
-    visitParam: () => {
-      hasParams = true;
+    visitParam: (node) => {
+      if (!name) {
+        name = node.name;
+      }
     }
   });
-  return hasParams;
+  return name;
 };
 // src/query-builder/select.ts
@@ -8189,9 +8236,9 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    */
   validateNoParamOperands() {
     const ast = this.context.hydration.applyToAst(this.context.state.ast);
-    const hasParams = hasParamOperandsInQuery(ast);
-    if (hasParams) {
-      throw new Error("Cannot execute query containing Param operands. Param proxies are only for schema generation (getSchema()). If you need real parameters, use literal values.");
+    const paramName = findFirstParamOperandName(ast);
+    if (paramName) {
+      throw new Error(`Cannot execute query containing Param operand "${paramName}". Param proxies are only for schema generation (getSchema()). If you need real parameters, use literal values.`);
     }
   }
   /**
@@ -8518,9 +8565,17 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    *   .compile('postgres');
    * console.log(compiled.sql); // SELECT "id", "name" FROM "users" WHERE "active" = true
    */
-  compile(dialect) {
+  compile(dialect, options) {
     const resolved = resolveDialectInput(dialect);
-    return resolved.compileSelect(this.getAST());
+    const ast = this.getAST();
+    if (!options?.allowParamOperands) {
+      const paramName = findFirstParamOperandName(ast);
+      if (paramName) {
+        throw new Error(`Cannot compile query containing Param operand "${paramName}". Param proxies are only for schema generation (getSchema()). If you need real parameters, use literal values.`);
+      }
+      return resolved.compileSelect(ast);
+    }
+    return resolved.compileSelectWithOptions(ast, { allowParams: true });
   }
   /**
    * Converts the query to SQL string for a specific dialect
@@ -8532,8 +8587,8 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    *   .toSql('postgres');
    * console.log(sql); // SELECT "id", "name" FROM "users" WHERE "active" = true
    */
-  toSql(dialect) {
-    return this.compile(dialect).sql;
+  toSql(dialect, options) {
+    return this.compile(dialect, options).sql;
   }
   /**
    * Gets hydration plan for query
@@ -14221,8 +14276,10 @@ export {
   groupConcat,
   gt,
   gte,
+  hasExpressionDispatcher,
   hasMany,
   hasOne,
+  hasOperandDispatcher,
   hour,
   hydrateRows,
   ifNull,