@simplysm/orm-common 13.0.100 → 14.0.4

package/dist/query-builder/mysql/mysql-expr-renderer.js

@@ -1,422 +1,454 @@
 import { bytes, DateOnly, DateTime, Time, Uuid } from "@simplysm/core-common";
 import { ExprRendererBase } from "../base/expr-renderer-base.js";
-class MysqlExprRenderer extends ExprRendererBase {
-  //#region ========== Utilities (public - also used by QueryBuilder) ==========
-  /** Wrap identifier */
-  wrap(name) {
-    return `\`${name.replace(/`/g, "``")}\``;
-  }
-  /** Escape for SQL string literals (returns without quotes) */
-  escapeString(value) {
-    return value.replace(/\\/g, "\\\\").replace(/'/g, "''").replace(/\0/g, "\\0").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
-  }
-  /** value escape */
-  escapeValue(value) {
-    if (value == null) {
-      return "NULL";
-    }
-    if (typeof value === "string") {
-      return `'${this.escapeString(value)}'`;
-    }
-    if (typeof value === "number") {
-      return String(value);
-    }
-    if (typeof value === "boolean") {
-      return value ? "TRUE" : "FALSE";
-    }
-    if (value instanceof DateTime) {
-      return `'${value.toFormatString("yyyy-MM-dd HH:mm:ss")}'`;
-    }
-    if (value instanceof DateOnly) {
-      return `'${value.toFormatString("yyyy-MM-dd")}'`;
-    }
-    if (value instanceof Time) {
-      return `'${value.toFormatString("HH:mm:ss")}'`;
-    }
-    if (value instanceof Uuid) {
-      return `0x${bytes.toHex(value.toBytes())}`;
-    }
-    if (value instanceof Uint8Array) {
-      return `0x${bytes.toHex(value)}`;
-    }
-    throw new Error(`Unknown value type: ${typeof value}`);
-  }
-  /** DataType → SQL type */
-  renderDataType(dataType) {
-    switch (dataType.type) {
-      case "int":
-        return "INT";
-      case "bigint":
-        return "BIGINT";
-      case "float":
-        return "FLOAT";
-      case "double":
-        return "DOUBLE";
-      case "decimal":
-        return dataType.scale != null ? `DECIMAL(${dataType.precision}, ${dataType.scale})` : `DECIMAL(${dataType.precision})`;
-      case "varchar":
-        return `VARCHAR(${dataType.length})`;
-      case "char":
-        return `CHAR(${dataType.length})`;
-      case "text":
-        return "LONGTEXT";
-      case "binary":
-        return "LONGBLOB";
-      case "boolean":
-        return "BOOLEAN";
-      case "datetime":
-        return "DATETIME";
-      case "date":
-        return "DATE";
-      case "time":
-        return "TIME";
-      case "uuid":
-        return "BINARY(16)";
-    }
-  }
-  //#endregion
-  //#region ========== value ==========
-  column(expr) {
-    return expr.path.map((p) => this.wrap(p)).join(".");
-  }
-  value(expr) {
-    return this.escapeValue(expr.value);
-  }
-  raw(expr) {
-    return expr.sql.replace(/\$(\d+)/g, (_, num) => {
-      const idx = parseInt(num) - 1;
-      return idx < expr.params.length ? this.render(expr.params[idx]) : `$${num}`;
-    });
-  }
-  //#endregion
-  //#region ========== comparison (null-safe) ==========
-  eq(expr) {
-    return `${this.render(expr.source)} <=> ${this.render(expr.target)}`;
-  }
-  gt(expr) {
-    return `${this.render(expr.source)} > ${this.render(expr.target)}`;
-  }
-  lt(expr) {
-    return `${this.render(expr.source)} < ${this.render(expr.target)}`;
-  }
-  gte(expr) {
-    return `${this.render(expr.source)} >= ${this.render(expr.target)}`;
-  }
-  lte(expr) {
-    return `${this.render(expr.source)} <= ${this.render(expr.target)}`;
-  }
-  between(expr) {
-    const source = this.render(expr.source);
-    if (expr.from != null && expr.to != null) {
-      return `${source} BETWEEN ${this.render(expr.from)} AND ${this.render(expr.to)}`;
-    }
-    if (expr.from != null) {
-      return `${source} >= ${this.render(expr.from)}`;
-    }
-    if (expr.to != null) {
-      return `${source} <= ${this.render(expr.to)}`;
-    }
-    return "1=1";
-  }
-  null(expr) {
-    return `${this.render(expr.arg)} IS NULL`;
-  }
-  like(expr) {
-    return `${this.render(expr.source)} LIKE ${this.render(expr.pattern)} ESCAPE '\\\\'`;
-  }
-  regexp(expr) {
-    return `${this.render(expr.source)} REGEXP ${this.render(expr.pattern)}`;
-  }
-  in(expr) {
-    if (expr.values.length === 0) {
-      return "1=0";
-    }
-    const values = expr.values.map((v) => this.render(v)).join(", ");
-    return `${this.render(expr.source)} IN (${values})`;
-  }
-  inQuery(expr) {
-    return `${this.render(expr.source)} IN (${this.buildSelect(expr.query)})`;
-  }
-  exists(expr) {
-    const subquery = this.buildSelect({
-      ...expr.query,
-      select: { _: { type: "value", value: 1 } }
-    });
-    return `EXISTS (${subquery})`;
-  }
-  //#endregion
-  //#region ========== logic ==========
-  not(expr) {
-    return `NOT (${this.render(expr.arg)})`;
-  }
-  and(expr) {
-    if (expr.conditions.length === 0) return "1=1";
-    return `(${expr.conditions.map((c) => this.render(c)).join(" AND ")})`;
-  }
-  or(expr) {
-    if (expr.conditions.length === 0) return "1=0";
-    return `(${expr.conditions.map((c) => this.render(c)).join(" OR ")})`;
-  }
-  //#endregion
-  //#region ========== String (null handling) ==========
-  concat(expr) {
-    const args = expr.args.map((a) => `IFNULL(${this.render(a)}, '')`);
-    return `CONCAT(${args.join(", ")})`;
-  }
-  left(expr) {
-    return `LEFT(${this.render(expr.source)}, ${this.render(expr.length)})`;
-  }
-  right(expr) {
-    return `RIGHT(${this.render(expr.source)}, ${this.render(expr.length)})`;
-  }
-  trim(expr) {
-    return `TRIM(${this.render(expr.arg)})`;
-  }
-  padStart(expr) {
-    return `LPAD(${this.render(expr.source)}, ${this.render(expr.length)}, ${this.render(expr.fillString)})`;
-  }
-  replace(expr) {
-    return `REPLACE(${this.render(expr.source)}, ${this.render(expr.from)}, ${this.render(expr.to)})`;
-  }
-  upper(expr) {
-    return `UPPER(${this.render(expr.arg)})`;
-  }
-  lower(expr) {
-    return `LOWER(${this.render(expr.arg)})`;
-  }
-  length(expr) {
-    return `CHAR_LENGTH(IFNULL(${this.render(expr.arg)}, ''))`;
-  }
-  byteLength(expr) {
-    return `LENGTH(IFNULL(${this.render(expr.arg)}, ''))`;
-  }
-  substring(expr) {
-    if (expr.length != null) {
-      return `SUBSTRING(${this.render(expr.source)}, ${this.render(expr.start)}, ${this.render(expr.length)})`;
-    }
-    return `SUBSTRING(${this.render(expr.source)}, ${this.render(expr.start)})`;
-  }
-  indexOf(expr) {
-    return `LOCATE(${this.render(expr.search)}, ${this.render(expr.source)})`;
-  }
-  //#endregion
-  //#region ========== Number ==========
-  abs(expr) {
-    return `ABS(${this.render(expr.arg)})`;
-  }
-  round(expr) {
-    return `ROUND(${this.render(expr.arg)}, ${expr.digits})`;
-  }
-  ceil(expr) {
-    return `CEIL(${this.render(expr.arg)})`;
-  }
-  floor(expr) {
-    return `FLOOR(${this.render(expr.arg)})`;
-  }
-  //#endregion
-  //#region ========== Date ==========
-  year(expr) {
-    return `YEAR(${this.render(expr.arg)})`;
-  }
-  month(expr) {
-    return `MONTH(${this.render(expr.arg)})`;
-  }
-  day(expr) {
-    return `DAY(${this.render(expr.arg)})`;
-  }
-  hour(expr) {
-    return `HOUR(${this.render(expr.arg)})`;
-  }
-  minute(expr) {
-    return `MINUTE(${this.render(expr.arg)})`;
-  }
-  second(expr) {
-    return `SECOND(${this.render(expr.arg)})`;
-  }
-  isoWeek(expr) {
-    return `WEEK(${this.render(expr.arg)}, 1)`;
-  }
-  isoWeekStartDate(expr) {
-    return `DATE_SUB(${this.render(expr.arg)}, INTERVAL (WEEKDAY(${this.render(expr.arg)})) DAY)`;
-  }
-  isoYearMonth(expr) {
-    return `DATE_FORMAT(${this.render(expr.arg)}, '%Y%m')`;
-  }
-  dateDiff(expr) {
-    const from = this.render(expr.from);
-    const to = this.render(expr.to);
-    switch (expr.unit) {
-      case "year":
-        return `TIMESTAMPDIFF(YEAR, ${from}, ${to})`;
-      case "month":
-        return `TIMESTAMPDIFF(MONTH, ${from}, ${to})`;
-      case "day":
-        return `TIMESTAMPDIFF(DAY, ${from}, ${to})`;
-      case "hour":
-        return `TIMESTAMPDIFF(HOUR, ${from}, ${to})`;
-      case "minute":
-        return `TIMESTAMPDIFF(MINUTE, ${from}, ${to})`;
-      case "second":
-        return `TIMESTAMPDIFF(SECOND, ${from}, ${to})`;
-    }
-  }
-  dateAdd(expr) {
-    const source = this.render(expr.source);
-    const value = this.render(expr.value);
-    const unit = this.dateUnitToSql(expr.unit);
-    return `DATE_ADD(${source}, INTERVAL ${value} ${unit})`;
-  }
-  formatDate(expr) {
-    const mysqlFormat = this.convertDateFormat(expr.format);
-    return `DATE_FORMAT(${this.render(expr.source)}, '${mysqlFormat}')`;
-  }
-  dateUnitToSql(unit) {
-    switch (unit) {
-      case "year":
-        return "YEAR";
-      case "month":
-        return "MONTH";
-      case "day":
-        return "DAY";
-      case "hour":
-        return "HOUR";
-      case "minute":
-        return "MINUTE";
-      case "second":
-        return "SECOND";
-    }
-  }
-  convertDateFormat(format) {
-    return format.replace(/yyyy/g, "%Y").replace(/MM/g, "%m").replace(/dd/g, "%d").replace(/HH/g, "%H").replace(/mm/g, "%i").replace(/ss/g, "%s");
-  }
-  //#endregion
-  //#region ========== condition ==========
-  coalesce(expr) {
-    if (expr.args.length === 0) return "NULL";
-    if (expr.args.length === 1) return this.render(expr.args[0]);
-    return `COALESCE(${expr.args.map((a) => this.render(a)).join(", ")})`;
-  }
-  nullIf(expr) {
-    return `NULLIF(${this.render(expr.source)}, ${this.render(expr.value)})`;
-  }
-  is(expr) {
-    return `(${this.render(expr.condition)})`;
-  }
-  switch(expr) {
-    const cases = expr.cases.map((c) => `WHEN ${this.render(c.when)} THEN ${this.render(c.then)}`).join(" ");
-    return `CASE ${cases} ELSE ${this.render(expr.else)} END`;
-  }
-  if(expr) {
-    const elseVal = expr.else != null ? this.render(expr.else) : "NULL";
-    return `IF(${this.render(expr.condition)}, ${this.render(expr.then)}, ${elseVal})`;
-  }
-  //#endregion
-  //#region ========== aggregation ==========
-  count(expr) {
-    if (expr.arg != null) {
-      const distinct = expr.distinct ? "DISTINCT " : "";
-      return `COUNT(${distinct}${this.render(expr.arg)})`;
-    }
-    return "COUNT(*)";
-  }
-  sum(expr) {
-    return `SUM(${this.render(expr.arg)})`;
-  }
-  avg(expr) {
-    return `AVG(${this.render(expr.arg)})`;
-  }
-  max(expr) {
-    return `MAX(${this.render(expr.arg)})`;
-  }
-  min(expr) {
-    return `MIN(${this.render(expr.arg)})`;
-  }
-  //#endregion
-  //#region ========== Other ==========
-  greatest(expr) {
-    if (expr.args.length === 0) throw new Error("greatest requires at least one argument.");
-    return `GREATEST(${expr.args.map((a) => this.render(a)).join(", ")})`;
-  }
-  least(expr) {
-    if (expr.args.length === 0) throw new Error("least requires at least one argument.");
-    return `LEAST(${expr.args.map((a) => this.render(a)).join(", ")})`;
-  }
-  rowNum(_expr) {
-    return "ROW_NUMBER() OVER ()";
-  }
-  random(_expr) {
-    return "RAND()";
-  }
-  cast(expr) {
-    return `CAST(${this.render(expr.source)} AS ${this.renderDataType(expr.targetType)})`;
-  }
-  //#endregion
-  //#region ========== Window ==========
-  window(expr) {
-    const fn = this.renderWindowFn(expr.fn);
-    let over = this.renderWindowSpec(expr.spec);
-    if (expr.fn.type === "lastValue" && over.length > 0) {
-      over += " ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING";
-    }
-    return `${fn} OVER (${over})`;
-  }
-  renderWindowFn(fn) {
-    switch (fn.type) {
-      case "rowNumber":
-        return "ROW_NUMBER()";
-      case "rank":
-        return "RANK()";
-      case "denseRank":
-        return "DENSE_RANK()";
-      case "ntile":
-        return `NTILE(${fn.n})`;
-      case "lag": {
-        const offset = fn.offset ?? 1;
-        const def = fn.default != null ? `, ${this.render(fn.default)}` : "";
-        return `LAG(${this.render(fn.column)}, ${offset}${def})`;
-      }
-      case "lead": {
-        const offset = fn.offset ?? 1;
-        const def = fn.default != null ? `, ${this.render(fn.default)}` : "";
-        return `LEAD(${this.render(fn.column)}, ${offset}${def})`;
-      }
-      case "firstValue":
-        return `FIRST_VALUE(${this.render(fn.column)})`;
-      case "lastValue":
-        return `LAST_VALUE(${this.render(fn.column)})`;
-      case "sum":
-        return `SUM(${this.render(fn.column)})`;
-      case "avg":
-        return `AVG(${this.render(fn.column)})`;
-      case "count":
-        return fn.column != null ? `COUNT(${this.render(fn.column)})` : "COUNT(*)";
-      case "min":
-        return `MIN(${this.render(fn.column)})`;
-      case "max":
-        return `MAX(${this.render(fn.column)})`;
-    }
-  }
-  renderWindowSpec(spec) {
-    const parts = [];
-    if (spec.partitionBy != null && spec.partitionBy.length > 0) {
-      parts.push(`PARTITION BY ${spec.partitionBy.map((p) => this.render(p)).join(", ")}`);
-    }
-    if (spec.orderBy != null && spec.orderBy.length > 0) {
-      const orderParts = spec.orderBy.map(
-        ([expr, dir]) => `${this.render(expr)}${dir != null ? ` ${dir}` : ""}`
-      );
-      parts.push(`ORDER BY ${orderParts.join(", ")}`);
-    }
-    return parts.join(" ");
-  }
-  //#endregion
-  //#region ========== System ==========
-  subquery(expr) {
-    return `(${this.buildSelect(expr.queryDef)})`;
-  }
-  //#endregion
+/**
+ * MySQL 표현식 렌더러
+ */
+export class MysqlExprRenderer extends ExprRendererBase {
+    //#region ========== 유틸리티 (public - QueryBuilder에서도 사용) ==========
+    /** 식별자 감싸기 */
+    wrap(name) {
+        return `\`${name.replace(/`/g, "``")}\``;
+    }
+    /** SQL 문자열 리터럴용 이스케이프 (따옴표 제외) */
+    escapeString(value) {
+        return value
+            .replace(/\\/g, "\\\\") // 백슬래시 (최우선)
+            .replace(/'/g, "''") // 작은따옴표
+            .replace(/\0/g, "\\0") // NULL 바이트
+            .replace(/\n/g, "\\n") // 줄바꿈
+            .replace(/\r/g, "\\r") // 캐리지 리턴
+            .replace(/\t/g, "\\t"); // 탭
+    }
+    /** 값 이스케이프 */
+    escapeValue(value) {
+        if (value == null) {
+            return "NULL";
+        }
+        if (typeof value === "string") {
+            return `'${this.escapeString(value)}'`;
+        }
+        if (typeof value === "number") {
+            return String(value);
+        }
+        if (typeof value === "boolean") {
+            return value ? "TRUE" : "FALSE";
+        }
+        if (value instanceof DateTime) {
+            return `'${value.toFormatString("yyyy-MM-dd HH:mm:ss")}'`;
+        }
+        if (value instanceof DateOnly) {
+            return `'${value.toFormatString("yyyy-MM-dd")}'`;
+        }
+        if (value instanceof Time) {
+            return `'${value.toFormatString("HH:mm:ss")}'`;
+        }
+        if (value instanceof Uuid) {
+            return `0x${bytes.toHex(value.toBytes())}`;
+        }
+        if (value instanceof Uint8Array) {
+            return `0x${bytes.toHex(value)}`;
+        }
+        throw new Error(`알 수 없는 값 타입: ${typeof value}`);
+    }
+    /** DataType → SQL 타입 변환 */
+    renderDataType(dataType) {
+        switch (dataType.type) {
+            case "int":
+                return "INT";
+            case "bigint":
+                return "BIGINT";
+            case "float":
+                return "FLOAT";
+            case "double":
+                return "DOUBLE";
+            case "decimal":
+                return dataType.scale != null
+                    ? `DECIMAL(${dataType.precision}, ${dataType.scale})`
+                    : `DECIMAL(${dataType.precision})`;
+            case "varchar":
+                return `VARCHAR(${dataType.length})`;
+            case "char":
+                return `CHAR(${dataType.length})`;
+            case "text":
+                return "LONGTEXT";
+            case "binary":
+                return "LONGBLOB";
+            case "boolean":
+                return "BOOLEAN";
+            case "datetime":
+                return "DATETIME";
+            case "date":
+                return "DATE";
+            case "time":
+                return "TIME";
+            case "uuid":
+                return "BINARY(16)";
+        }
+    }
+    //#endregion
+    //#region ========== value ==========
+    column(expr) {
+        return expr.path.map((p) => this.wrap(p)).join(".");
+    }
+    value(expr) {
+        return this.escapeValue(expr.value);
+    }
+    raw(expr) {
+        return expr.sql.replace(/\$(\d+)/g, (_, num) => {
+            const idx = parseInt(num) - 1;
+            return idx < expr.params.length ? this.render(expr.params[idx]) : `$${num}`;
+        });
+    }
+    //#endregion
+    //#region ========== comparison (null-safe) ==========
+    eq(expr) {
+        // MySQL: <=> 연산자 (NULL 안전 동등 비교)
+        return `${this.render(expr.source)} <=> ${this.render(expr.target)}`;
+    }
+    gt(expr) {
+        return `${this.render(expr.source)} > ${this.render(expr.target)}`;
+    }
+    lt(expr) {
+        return `${this.render(expr.source)} < ${this.render(expr.target)}`;
+    }
+    gte(expr) {
+        return `${this.render(expr.source)} >= ${this.render(expr.target)}`;
+    }
+    lte(expr) {
+        return `${this.render(expr.source)} <= ${this.render(expr.target)}`;
+    }
+    between(expr) {
+        const source = this.render(expr.source);
+        if (expr.from != null && expr.to != null) {
+            return `${source} BETWEEN ${this.render(expr.from)} AND ${this.render(expr.to)}`;
+        }
+        if (expr.from != null) {
+            return `${source} >= ${this.render(expr.from)}`;
+        }
+        if (expr.to != null) {
+            return `${source} <= ${this.render(expr.to)}`;
+        }
+        return "1=1";
+    }
+    null(expr) {
+        return `${this.render(expr.arg)} IS NULL`;
+    }
+    like(expr) {
+        // 항상 ESCAPE '\' 추가
+        return `${this.render(expr.source)} LIKE ${this.render(expr.pattern)} ESCAPE '\\\\'`;
+    }
+    regexp(expr) {
+        return `${this.render(expr.source)} REGEXP ${this.render(expr.pattern)}`;
+    }
+    in(expr) {
+        if (expr.values.length === 0) {
+            return "1=0"; // 빈 IN은 항상 false
+        }
+        const values = expr.values.map((v) => this.render(v)).join(", ");
+        return `${this.render(expr.source)} IN (${values})`;
+    }
+    inQuery(expr) {
+        return `${this.render(expr.source)} IN (${this.buildSelect(expr.query)})`;
+    }
+    exists(expr) {
+        // SELECT 1로 렌더링
+        const subquery = this.buildSelect({
+            ...expr.query,
+            select: { _: { type: "value", value: 1 } },
+        });
+        return `EXISTS (${subquery})`;
+    }
+    //#endregion
+    //#region ========== logic ==========
+    not(expr) {
+        return `NOT (${this.render(expr.arg)})`;
+    }
+    and(expr) {
+        if (expr.conditions.length === 0)
+            return "1=1";
+        return `(${expr.conditions.map((c) => this.render(c)).join(" AND ")})`;
+    }
+    or(expr) {
+        if (expr.conditions.length === 0)
+            return "1=0";
+        return `(${expr.conditions.map((c) => this.render(c)).join(" OR ")})`;
+    }
+    //#endregion
+    //#region ========== String (null handling) ==========
+    concat(expr) {
+        // null 처리: IFNULL(arg, '')
+        const args = expr.args.map((a) => `IFNULL(${this.render(a)}, '')`);
+        return `CONCAT(${args.join(", ")})`;
+    }
+    left(expr) {
+        return `LEFT(${this.render(expr.source)}, ${this.render(expr.length)})`;
+    }
+    right(expr) {
+        return `RIGHT(${this.render(expr.source)}, ${this.render(expr.length)})`;
+    }
+    trim(expr) {
+        return `TRIM(${this.render(expr.arg)})`;
+    }
+    padStart(expr) {
+        return `LPAD(${this.render(expr.source)}, ${this.render(expr.length)}, ${this.render(expr.fillString)})`;
+    }
+    replace(expr) {
+        return `REPLACE(${this.render(expr.source)}, ${this.render(expr.from)}, ${this.render(expr.to)})`;
+    }
+    upper(expr) {
+        return `UPPER(${this.render(expr.arg)})`;
+    }
+    lower(expr) {
+        return `LOWER(${this.render(expr.arg)})`;
+    }
+    length(expr) {
+        // null 처리: IFNULL(arg, '')
+        return `CHAR_LENGTH(IFNULL(${this.render(expr.arg)}, ''))`;
+    }
+    byteLength(expr) {
+        // null 처리: IFNULL(arg, '')
+        return `LENGTH(IFNULL(${this.render(expr.arg)}, ''))`;
+    }
+    substring(expr) {
+        if (expr.length != null) {
+            return `SUBSTRING(${this.render(expr.source)}, ${this.render(expr.start)}, ${this.render(expr.length)})`;
+        }
+        return `SUBSTRING(${this.render(expr.source)}, ${this.render(expr.start)})`;
+    }
+    indexOf(expr) {
+        return `LOCATE(${this.render(expr.search)}, ${this.render(expr.source)})`;
+    }
+    //#endregion
+    //#region ========== Number ==========
+    abs(expr) {
+        return `ABS(${this.render(expr.arg)})`;
+    }
+    round(expr) {
+        return `ROUND(${this.render(expr.arg)}, ${expr.digits})`;
+    }
+    ceil(expr) {
+        return `CEIL(${this.render(expr.arg)})`;
+    }
+    floor(expr) {
+        return `FLOOR(${this.render(expr.arg)})`;
+    }
+    //#endregion
+    //#region ========== Date ==========
+    year(expr) {
+        return `YEAR(${this.render(expr.arg)})`;
+    }
+    month(expr) {
+        return `MONTH(${this.render(expr.arg)})`;
+    }
+    day(expr) {
+        return `DAY(${this.render(expr.arg)})`;
+    }
+    hour(expr) {
+        return `HOUR(${this.render(expr.arg)})`;
+    }
+    minute(expr) {
+        return `MINUTE(${this.render(expr.arg)})`;
+    }
+    second(expr) {
+        return `SECOND(${this.render(expr.arg)})`;
+    }
+    isoWeek(expr) {
+        return `WEEK(${this.render(expr.arg)}, 1)`;
+    }
+    isoWeekStartDate(expr) {
+        // ISO 주 시작일 (월요일)
+        return `DATE_SUB(${this.render(expr.arg)}, INTERVAL (WEEKDAY(${this.render(expr.arg)})) DAY)`;
+    }
+    isoYearMonth(expr) {
+        return `DATE_FORMAT(${this.render(expr.arg)}, '%Y%m')`;
+    }
+    dateDiff(expr) {
+        const from = this.render(expr.from);
+        const to = this.render(expr.to);
+        switch (expr.unit) {
+            case "year":
+                return `TIMESTAMPDIFF(YEAR, ${from}, ${to})`;
+            case "month":
+                return `TIMESTAMPDIFF(MONTH, ${from}, ${to})`;
+            case "day":
+                return `TIMESTAMPDIFF(DAY, ${from}, ${to})`;
+            case "hour":
+                return `TIMESTAMPDIFF(HOUR, ${from}, ${to})`;
+            case "minute":
+                return `TIMESTAMPDIFF(MINUTE, ${from}, ${to})`;
+            case "second":
+                return `TIMESTAMPDIFF(SECOND, ${from}, ${to})`;
+        }
+    }
+    dateAdd(expr) {
+        const source = this.render(expr.source);
+        const value = this.render(expr.value);
+        const unit = this.dateUnitToSql(expr.unit);
+        return `DATE_ADD(${source}, INTERVAL ${value} ${unit})`;
+    }
+    formatDate(expr) {
+        // JS 포맷 → MySQL 포맷
+        const mysqlFormat = this.convertDateFormat(expr.format);
+        return `DATE_FORMAT(${this.render(expr.source)}, '${mysqlFormat}')`;
+    }
+    dateUnitToSql(unit) {
+        switch (unit) {
+            case "year":
+                return "YEAR";
+            case "month":
+                return "MONTH";
+            case "day":
+                return "DAY";
+            case "hour":
+                return "HOUR";
+            case "minute":
+                return "MINUTE";
+            case "second":
+                return "SECOND";
+        }
+    }
+    convertDateFormat(format) {
+        // 단순 변환 (yyyy-MM-dd HH:mm:ss 포맷)
+        return format
+            .replace(/yyyy/g, "%Y")
+            .replace(/MM/g, "%m")
+            .replace(/dd/g, "%d")
+            .replace(/HH/g, "%H")
+            .replace(/mm/g, "%i")
+            .replace(/ss/g, "%s");
+    }
+    //#endregion
+    //#region ========== condition ==========
+    coalesce(expr) {
+        if (expr.args.length === 0)
+            return "NULL";
+        if (expr.args.length === 1)
+            return this.render(expr.args[0]);
+        // COALESCE로 렌더링 (여러 값 중 첫 번째 non-null 반환)
+        return `COALESCE(${expr.args.map((a) => this.render(a)).join(", ")})`;
+    }
+    nullIf(expr) {
+        return `NULLIF(${this.render(expr.source)}, ${this.render(expr.value)})`;
+    }
+    is(expr) {
+        return `(${this.render(expr.condition)})`;
+    }
+    switch(expr) {
+        const cases = expr.cases
+            .map((c) => `WHEN ${this.render(c.when)} THEN ${this.render(c.then)}`)
+            .join(" ");
+        return `CASE ${cases} ELSE ${this.render(expr.else)} END`;
+    }
+    if(expr) {
+        const elseVal = expr.else != null ? this.render(expr.else) : "NULL";
+        return `IF(${this.render(expr.condition)}, ${this.render(expr.then)}, ${elseVal})`;
+    }
+    //#endregion
+    //#region ========== aggregation ==========
+    count(expr) {
+        if (expr.arg != null) {
+            const distinct = expr.distinct ? "DISTINCT " : "";
+            return `COUNT(${distinct}${this.render(expr.arg)})`;
+        }
+        return "COUNT(*)";
+    }
+    sum(expr) {
+        return `SUM(${this.render(expr.arg)})`;
+    }
+    avg(expr) {
+        return `AVG(${this.render(expr.arg)})`;
+    }
+    max(expr) {
+        return `MAX(${this.render(expr.arg)})`;
+    }
+    min(expr) {
+        return `MIN(${this.render(expr.arg)})`;
+    }
+    //#endregion
+    //#region ========== Other ==========
+    greatest(expr) {
+        if (expr.args.length === 0)
+            throw new Error("greatest에는 최소 1개의 인수가 필요합니다.");
+        return `GREATEST(${expr.args.map((a) => this.render(a)).join(", ")})`;
+    }
+    least(expr) {
+        if (expr.args.length === 0)
+            throw new Error("least에는 최소 1개의 인수가 필요합니다.");
+        return `LEAST(${expr.args.map((a) => this.render(a)).join(", ")})`;
+    }
+    rowNum(_expr) {
+        // MySQL: 변수 또는 ROW_NUMBER() 윈도우 함수 사용
+        // 여기서는 ROW_NUMBER()로 구현 (MySQL 8.0+)
+        return "ROW_NUMBER() OVER ()";
+    }
+    random(_expr) {
+        return "RAND()";
+    }
+    cast(expr) {
+        return `CAST(${this.render(expr.source)} AS ${this.renderDataType(expr.targetType)})`;
+    }
+    //#endregion
+    //#region ========== Window ==========
+    window(expr) {
+        const fn = this.renderWindowFn(expr.fn);
+        let over = this.renderWindowSpec(expr.spec);
+        // LAST_VALUE 기본 프레임은 CURRENT ROW까지만 보므로 전체 프레임을 지정해야 함
+        if (expr.fn.type === "lastValue" && over.length > 0) {
+            over += " ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING";
+        }
+        return `${fn} OVER (${over})`;
+    }
+    renderWindowFn(fn) {
+        switch (fn.type) {
+            case "rowNumber":
+                return "ROW_NUMBER()";
+            case "rank":
+                return "RANK()";
+            case "denseRank":
+                return "DENSE_RANK()";
+            case "ntile":
+                return `NTILE(${fn.n})`;
+            case "lag": {
+                const offset = fn.offset ?? 1;
+                const def = fn.default != null ? `, ${this.render(fn.default)}` : "";
+                return `LAG(${this.render(fn.column)}, ${offset}${def})`;
+            }
+            case "lead": {
+                const offset = fn.offset ?? 1;
+                const def = fn.default != null ? `, ${this.render(fn.default)}` : "";
+                return `LEAD(${this.render(fn.column)}, ${offset}${def})`;
+            }
+            case "firstValue":
+                return `FIRST_VALUE(${this.render(fn.column)})`;
+            case "lastValue":
+                return `LAST_VALUE(${this.render(fn.column)})`;
+            case "sum":
+                return `SUM(${this.render(fn.column)})`;
+            case "avg":
+                return `AVG(${this.render(fn.column)})`;
+            case "count":
+                return fn.column != null ? `COUNT(${this.render(fn.column)})` : "COUNT(*)";
+            case "min":
+                return `MIN(${this.render(fn.column)})`;
+            case "max":
+                return `MAX(${this.render(fn.column)})`;
+        }
+    }
+    renderWindowSpec(spec) {
+        const parts = [];
+        if (spec.partitionBy != null && spec.partitionBy.length > 0) {
+            parts.push(`PARTITION BY ${spec.partitionBy.map((p) => this.render(p)).join(", ")}`);
+        }
+        if (spec.orderBy != null && spec.orderBy.length > 0) {
+            const orderParts = spec.orderBy.map(([expr, dir]) => `${this.render(expr)}${dir != null ? ` ${dir}` : ""}`);
+            parts.push(`ORDER BY ${orderParts.join(", ")}`);
+        }
+        return parts.join(" ");
+    }
+    //#endregion
+    //#region ========== System ==========
+    subquery(expr) {
+        return `(${this.buildSelect(expr.queryDef)})`;
+    }
 }
-export {
-  MysqlExprRenderer
-};
-//# sourceMappingURL=mysql-expr-renderer.js.map
+//# sourceMappingURL=mysql-expr-renderer.js.map