metal-orm 1.0.82 → 1.0.85

package/dist/index.cjs

@@ -655,16 +655,27 @@ var operandTypes = /* @__PURE__ */ new Set([
   "BitwiseExpression",
   "Collate"
 ]);
-var hasTypeProperty = (value) => typeof value === "object" && value !== null && "type" in value;
+var getNodeType = (value) => {
+  if (typeof value !== "object" || value === null) return void 0;
+  const descriptor = Object.getOwnPropertyDescriptor(value, "type");
+  if (descriptor && typeof descriptor.value === "string") {
+    return descriptor.value;
+  }
+  if ("type" in value) {
+    const type = value.type;
+    return typeof type === "string" ? type : void 0;
+  }
+  return void 0;
+};
 var isOperandNode = (node) => {
-  if (!hasTypeProperty(node)) return false;
-  return operandTypes.has(node.type);
-};
-var isFunctionNode = (node) => isOperandNode(node) && node.type === "Function";
-var isCaseExpressionNode = (node) => isOperandNode(node) && node.type === "CaseExpression";
-var isCastExpressionNode = (node) => isOperandNode(node) && node.type === "Cast";
-var isCollateExpressionNode = (node) => isOperandNode(node) && node.type === "Collate";
-var isWindowFunctionNode = (node) => isOperandNode(node) && node.type === "WindowFunction";
+  const type = getNodeType(node);
+  return type !== void 0 && operandTypes.has(type);
+};
+var isFunctionNode = (node) => isOperandNode(node) && getNodeType(node) === "Function";
+var isCaseExpressionNode = (node) => isOperandNode(node) && getNodeType(node) === "CaseExpression";
+var isCastExpressionNode = (node) => isOperandNode(node) && getNodeType(node) === "Cast";
+var isCollateExpressionNode = (node) => isOperandNode(node) && getNodeType(node) === "Collate";
+var isWindowFunctionNode = (node) => isOperandNode(node) && getNodeType(node) === "WindowFunction";
 var isExpressionSelectionNode = (node) => isFunctionNode(node) || isCaseExpressionNode(node) || isCastExpressionNode(node) || isWindowFunctionNode(node);
 
 // src/core/ast/expression-builders.ts
@@ -673,6 +684,14 @@ var toLiteralNode = (value) => ({
   type: "Literal",
   value: value instanceof Date ? value.toISOString() : value
 });
+var toParamNode = (value) => {
+  if (typeof value !== "object" || value === null) return void 0;
+  const type = Object.getOwnPropertyDescriptor(value, "type")?.value;
+  if (type !== "Param") return void 0;
+  const name = Object.getOwnPropertyDescriptor(value, "name")?.value;
+  if (typeof name !== "string") return void 0;
+  return { type: "Param", name };
+};
 var columnRefToNode = (col2) => {
   if (!col2.table) {
     throw new Error(
@@ -682,6 +701,10 @@ var columnRefToNode = (col2) => {
   return { type: "Column", table: col2.table, name: col2.name };
 };
 var toOperandNode = (value) => {
+  const paramNode = toParamNode(value);
+  if (paramNode) {
+    return paramNode;
+  }
   if (isOperandNode(value)) {
     return value;
   }
@@ -691,6 +714,10 @@ var toOperandNode = (value) => {
   return columnRefToNode(value);
 };
 var valueToOperand = (value) => {
+  const paramNode = toParamNode(value);
+  if (paramNode) {
+    return paramNode;
+  }
   if (isOperandNode(value)) {
     return value;
   }
@@ -1033,17 +1060,26 @@ var clearExpressionDispatchers = () => {
 var clearOperandDispatchers = () => {
   operandRegistry = operandRegistry.clear();
 };
-var getNodeType = (node) => typeof node === "object" && node !== null && typeof node.type === "string" ? node.type : void 0;
+var getNodeType2 = (node) => {
+  if (typeof node !== "object" || node === null) return void 0;
+  const descriptor = Object.getOwnPropertyDescriptor(node, "type");
+  if (descriptor && typeof descriptor.value === "string") {
+    return descriptor.value;
+  }
+  const type = node.type;
+  return typeof type === "string" ? type : void 0;
+};
 var unsupportedExpression = (node) => {
-  throw new Error(`Unsupported expression type "${getNodeType(node) ?? "unknown"}"`);
+  throw new Error(`Unsupported expression type "${getNodeType2(node) ?? "unknown"}"`);
 };
 var unsupportedOperand = (node) => {
-  throw new Error(`Unsupported operand type "${getNodeType(node) ?? "unknown"}"`);
+  throw new Error(`Unsupported operand type "${getNodeType2(node) ?? "unknown"}"`);
 };
 var visitExpression = (node, visitor) => {
-  const dynamic = expressionRegistry.get(node.type);
+  const type = getNodeType2(node);
+  const dynamic = type ? expressionRegistry.get(type) : void 0;
   if (dynamic) return dynamic(node, visitor);
-  switch (node.type) {
+  switch (type) {
     case "BinaryExpression":
       if (visitor.visitBinaryExpression) return visitor.visitBinaryExpression(node);
       break;
@@ -1075,9 +1111,10 @@ var visitExpression = (node, visitor) => {
   return unsupportedExpression(node);
 };
 var visitOperand = (node, visitor) => {
-  const dynamic = operandRegistry.get(node.type);
+  const type = getNodeType2(node);
+  const dynamic = type ? operandRegistry.get(type) : void 0;
   if (dynamic) return dynamic(node, visitor);
-  switch (node.type) {
+  switch (type) {
     case "Column":
       if (visitor.visitColumn) return visitor.visitColumn(node);
       break;
@@ -1132,7 +1169,7 @@ var buildParamProxy = (name) => {
         const nextName2 = name ? `${name}.${trimmed}` : trimmed;
         return buildParamProxy(nextName2);
       }
-      if (prop in t) {
+      if (prop in t && name === "") {
         return t[prop];
       }
       const nextName = name ? `${name}.${prop}` : prop;
@@ -1151,9 +1188,6 @@ var createParamProxy = () => {
       if (typeof prop === "string" && prop.startsWith("$")) {
         return buildParamProxy(prop.slice(1));
       }
-      if (prop in t) {
-        return t[prop];
-      }
       return buildParamProxy(String(prop));
     }
   });
@@ -1570,6 +1604,16 @@ var Dialect = class _Dialect {
       params: [...ctx.params]
     };
   }
+  compileSelectWithOptions(ast, options = {}) {
+    const ctx = this.createCompilerContext(options);
+    const normalized = this.normalizeSelectAst(ast);
+    const rawSql = this.compileSelectAst(normalized, ctx).trim();
+    const sql = rawSql.endsWith(";") ? rawSql : `${rawSql};`;
+    return {
+      sql,
+      params: [...ctx.params]
+    };
+  }
   compileInsert(ast) {
     const ctx = this.createCompilerContext();
     const rawSql = this.compileInsertAst(ast, ctx).trim();
@@ -1640,13 +1684,15 @@ var Dialect = class _Dialect {
   }
   /**
    * Creates a new compiler context
+   * @param options - Optional compiler context options
    * @returns Compiler context with parameter management
    */
-  createCompilerContext() {
+  createCompilerContext(options = {}) {
     const params = [];
     let counter = 0;
     return {
       params,
+      allowParams: options.allowParams ?? false,
       addParameter: (value) => {
         counter += 1;
         params.push(value);
@@ -1797,9 +1843,11 @@ var Dialect = class _Dialect {
    * @returns Compiled SQL operand
    */
   compileOperand(node, ctx) {
-    const compiler = this.operandCompilers.get(node.type);
+    const descriptor = Object.getOwnPropertyDescriptor(node, "type");
+    const nodeType = typeof descriptor?.value === "string" ? descriptor.value : typeof node.type === "string" ? node.type : void 0;
+    const compiler = nodeType ? this.operandCompilers.get(nodeType) : void 0;
     if (!compiler) {
-      throw new Error(`Unsupported operand node type "${node.type}" for ${this.constructor.name}`);
+      throw new Error(`Unsupported operand node type "${nodeType ?? "unknown"}" for ${this.constructor.name}`);
     }
     return compiler(node, ctx);
   }
@@ -1868,7 +1916,12 @@ var Dialect = class _Dialect {
   }
   registerDefaultOperandCompilers() {
     this.registerOperandCompiler("Literal", (literal, ctx) => ctx.addParameter(literal.value));
-    this.registerOperandCompiler("Param", (_param, ctx) => ctx.addParameter(null));
+    this.registerOperandCompiler("Param", (_param, ctx) => {
+      if (!ctx.allowParams) {
+        throw new Error("Cannot compile query with Param operands. Param proxies are only for schema generation (getSchema()). If you need real parameters, use literal values.");
+      }
+      return ctx.addParameter(null);
+    });
     this.registerOperandCompiler("AliasRef", (alias, _ctx) => {
       void _ctx;
       return this.quoteIdentifier(alias.name);
@@ -4115,6 +4168,10 @@ var QueryAstService = class {
    * @returns Normalized ordering term
    */
   normalizeOrderingTerm(term) {
+    const paramNode = this.toParamNode(term);
+    if (paramNode) {
+      return paramNode;
+    }
     const from = this.state.ast.from;
     const tableRef2 = from.type === "Table" && from.alias ? { ...this.table, alias: from.alias } : this.table;
     const termType = term.type;
@@ -4132,6 +4189,14 @@ var QueryAstService = class {
     }
     return buildColumnNode(tableRef2, term);
   }
+  toParamNode(value) {
+    if (typeof value !== "object" || value === null) return void 0;
+    const type = Object.getOwnPropertyDescriptor(value, "type")?.value;
+    if (type !== "Param") return void 0;
+    const name = Object.getOwnPropertyDescriptor(value, "name")?.value;
+    if (typeof name !== "string") return void 0;
+    return { type: "Param", name };
+  }
 };
 
 // src/query-builder/relation-projection-helper.ts
@@ -7586,7 +7651,7 @@ var collectFilterColumns = (expr, table, rootTables) => {
       columns.add(node.name);
     }
   };
-  const visitOrderingTerm = (term) => {
+  const visitOrderingTerm2 = (term) => {
     if (!term || typeof term !== "object") return;
     if (isOperandNode(term)) {
       visitOperand2(term);
@@ -7598,7 +7663,7 @@ var collectFilterColumns = (expr, table, rootTables) => {
   };
   const visitOrderBy = (orderBy) => {
     if (!orderBy) return;
-    orderBy.forEach((node) => visitOrderingTerm(node.term));
+    orderBy.forEach((node) => visitOrderingTerm2(node.term));
   };
   const visitOperand2 = (node) => {
     switch (node.type) {
@@ -7737,6 +7802,198 @@ var buildFilterParameters = (table, where, from, options = {}) => {
   }];
 };
 
+// src/core/ast/query-visitor.ts
+var getNodeType3 = (value) => {
+  if (typeof value !== "object" || value === null) return void 0;
+  const descriptor = Object.getOwnPropertyDescriptor(value, "type");
+  if (descriptor && typeof descriptor.value === "string") {
+    return descriptor.value;
+  }
+  if ("type" in value) {
+    const type = value.type;
+    return typeof type === "string" ? type : void 0;
+  }
+  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);
+      }
+      return;
+    case "LogicalExpression":
+      node.operands.forEach((operand) => visitExpressionNode(operand, visitor));
+      return;
+    case "NullExpression":
+      visitOperandNode(node.left, visitor);
+      return;
+    case "InExpression":
+      visitOperandNode(node.left, visitor);
+      if (Array.isArray(node.right)) {
+        node.right.forEach((operand) => visitOperandNode(operand, visitor));
+      } else {
+        visitOperandNode(node.right, visitor);
+      }
+      return;
+    case "ExistsExpression":
+      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;
+    }
+  }
+};
+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));
+      if (node.separator) {
+        visitOperandNode(node.separator, visitor);
+      }
+      return;
+    case "JsonPath":
+      visitOperandNode(node.column, visitor);
+      return;
+    case "ScalarSubquery":
+      visitSelectQuery(node.query, visitor);
+      return;
+    case "CaseExpression":
+      node.conditions.forEach((cond) => {
+        visitExpressionNode(cond.when, visitor);
+        visitOperandNode(cond.then, visitor);
+      });
+      if (node.else) {
+        visitOperandNode(node.else, visitor);
+      }
+      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;
+    }
+  }
+};
+var visitSelectQuery = (ast, visitor) => {
+  visitor.visitSelectQuery?.(ast);
+  if (ast.ctes) {
+    for (const cte of ast.ctes) {
+      visitor.visitCte?.(cte);
+      visitSelectQuery(cte.query, visitor);
+    }
+  }
+  visitTableSource(ast.from, visitor);
+  ast.columns?.forEach((col2) => {
+    visitOperandNode(col2, visitor);
+  });
+  ast.joins?.forEach((join) => {
+    visitor.visitJoin?.(join);
+    visitTableSource(join.table, visitor);
+    visitExpressionNode(join.condition, visitor);
+  });
+  if (ast.where) {
+    visitExpressionNode(ast.where, visitor);
+  }
+  ast.groupBy?.forEach((term) => {
+    visitOrderingTerm(term, visitor);
+  });
+  if (ast.having) {
+    visitExpressionNode(ast.having, visitor);
+  }
+  ast.orderBy?.forEach((order) => {
+    visitOrderByNode(order, visitor);
+  });
+  ast.distinct?.forEach((col2) => {
+    visitOperandNode(col2, visitor);
+  });
+  ast.setOps?.forEach((op) => {
+    visitor.visitSetOperation?.(op);
+    visitSelectQuery(op.query, visitor);
+  });
+};
+
+// src/core/ast/ast-validation.ts
+var hasParamOperandsInQuery = (ast) => {
+  let hasParams = false;
+  visitSelectQuery(ast, {
+    visitParam: () => {
+      hasParams = true;
+    }
+  });
+  return hasParams;
+};
+
 // src/query-builder/select.ts
 var SelectQueryBuilder = class _SelectQueryBuilder {
   env;
@@ -8210,6 +8467,17 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
     }
     return this;
   }
+  /**
+   * Validates that the query does not contain Param operands.
+   * Param proxies are only for schema generation, not execution.
+   */
+  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.");
+    }
+  }
   /**
    * Executes the query and returns hydrated results.
    * If the builder was created with an entity constructor (e.g. via selectFromEntity),
@@ -8223,6 +8491,7 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    * users[0] instanceof User; // true
    */
   async execute(ctx) {
+    this.validateNoParamOperands();
     if (this.entityConstructor) {
       return this.executeAs(this.entityConstructor, ctx);
     }
@@ -8241,6 +8510,7 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    * rows[0] instanceof User; // false
    */
   async executePlain(ctx) {
+    this.validateNoParamOperands();
     const builder = this.ensureDefaultSelection();
     const rows = await executeHydratedPlain(ctx, builder);
     return rows;
@@ -8260,6 +8530,7 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    * users[0].getFullName();   // works!
    */
   async executeAs(entityClass, ctx) {
+    this.validateNoParamOperands();
     const builder = this.ensureDefaultSelection();
     const results = await executeHydrated(ctx, builder);
     return materializeAs(entityClass, results);
@@ -8271,6 +8542,7 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    * const total = await qb.count(session);
    */
   async count(session) {
+    this.validateNoParamOperands();
     return executeCount(this.context, this.env, session);
   }
   /**
@@ -8280,6 +8552,7 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    * const { items, totalItems, page, pageSize } = await qb.executePaged(session, { page: 1, pageSize: 20 });
    */
   async executePaged(session, options) {
+    this.validateNoParamOperands();
     const builder = this.ensureDefaultSelection();
     return executePagedQuery(builder, session, options, (sess) => builder.count(sess));
   }
@@ -8294,6 +8567,7 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
    * const users = await qb.executeWithContexts(execCtx, hydCtx);
    */
   async executeWithContexts(execCtx, hydCtx) {
+    this.validateNoParamOperands();
     const builder = this.ensureDefaultSelection();
     const results = await executeHydratedWithContexts(execCtx, hydCtx, builder);
     if (this.entityConstructor) {