@simplysm/orm-common 14.1.2 → 14.1.6

package/src/db-context.ts

@@ -42,7 +42,10 @@ export const SD_BUILDER = Symbol("sdBuilder");
  */
 export abstract class DbContext implements DbContextBase {
   // ── 상태 ──
-  status: DbContextStatus = "ready";
+  private _status: DbContextStatus = "ready";
+  get status(): DbContextStatus {
+    return this._status;
+  }
   private _aliasCounter = 0;
   private _relationsValidated = false;
 
@@ -83,7 +86,7 @@ export abstract class DbContext implements DbContextBase {
   }
 
   getQueryDefObjectName(
-    tableOrView: TableBuilder<any, any, any> | ViewBuilder<any, any, any>,
+    tableOrView: TableBuilder<any, any> | ViewBuilder<any, any, any>,
   ): QueryDefObjectName {
     return getQueryDefObjectNameImpl(this, tableOrView);
   }
@@ -94,9 +97,9 @@ export abstract class DbContext implements DbContextBase {
 
   // ── 등록 메서드 ──
 
-  protected queryable<T extends TableBuilder<any, any, any> | ViewBuilder<any, any, any>>(
+  protected queryable<T extends TableBuilder<any, any> | ViewBuilder<any, any, any>>(
     builder: T,
-  ): () => Queryable<T["$inferSelect"], T extends TableBuilder<any, any, any> ? T : never> {
+  ): () => Queryable<T["$inferSelect"], T extends TableBuilder<any, any> ? T : never> {
     const fn = createQueryable(this, builder);
     Object.defineProperty(fn, SD_BUILDER, { value: builder });
     return fn;
@@ -128,18 +131,18 @@ export abstract class DbContext implements DbContextBase {
     this.resetAliasCounter();
 
     await this._executor.connect();
-    this.status = "connect";
+    this._status = "connect";
 
     try {
       await this._executor.beginTransaction(isolationLevel);
-      this.status = "transact";
+      this._status = "transact";
 
       let result: TResult;
       try {
         result = await fn();
 
         await this._executor.commitTransaction();
-        this.status = "connect";
+        this._status = "connect";
       } catch (err) {
         try {
           await this._executor.rollbackTransaction();
@@ -151,7 +154,7 @@ export abstract class DbContext implements DbContextBase {
             (err as Error).cause = err1;
           }
         }
-        this.status = "connect";
+        this._status = "connect";
         throw err;
       }
 
@@ -160,7 +163,7 @@ export abstract class DbContext implements DbContextBase {
       try {
         await this._executor.close();
       } finally {
-        this.status = "ready";
+        this._status = "ready";
       }
     }
   }
@@ -178,7 +181,7 @@ export abstract class DbContext implements DbContextBase {
     this.resetAliasCounter();
 
     await this._executor.connect();
-    this.status = "connect";
+    this._status = "connect";
 
     try {
       return await callback();
@@ -186,7 +189,7 @@ export abstract class DbContext implements DbContextBase {
       try {
         await this._executor.close();
       } finally {
-        this.status = "ready";
+        this._status = "ready";
       }
     }
   }
@@ -200,14 +203,14 @@ export abstract class DbContext implements DbContextBase {
     }
 
     await this._executor.beginTransaction(isolationLevel);
-    this.status = "transact";
+    this._status = "transact";
 
     let result: TResult;
     try {
       result = await fn();
 
       await this._executor.commitTransaction();
-      this.status = "connect";
+      this._status = "connect";
     } catch (err) {
       try {
         await this._executor.rollbackTransaction();
@@ -219,7 +222,7 @@ export abstract class DbContext implements DbContextBase {
           (err as Error).cause = err1;
         }
       }
-      this.status = "connect";
+      this._status = "connect";
       throw err;
     }
 
@@ -228,7 +231,7 @@ export abstract class DbContext implements DbContextBase {
 
   // ── DDL 실행 메서드 ──
 
-  async createTable(table: TableBuilder<any, any, any>): Promise<void> {
+  async createTable(table: TableBuilder<any, any>): Promise<void> {
     await this.executeDefs([tableDdl.getCreateTableQueryDef(this, table)]);
   }
 
@@ -241,7 +244,7 @@ export abstract class DbContext implements DbContextBase {
   }
 
   async createView(view: ViewBuilder<any, any, any>): Promise<void> {
-    await this.executeDefs([tableDdl.getCreateViewQueryDef(this as any, view)]);
+    await this.executeDefs([tableDdl.getCreateViewQueryDef(this, view)]);
   }
 
   async dropView(view: QueryDefObjectName): Promise<void> {
@@ -291,7 +294,7 @@ export abstract class DbContext implements DbContextBase {
   async addForeignKey(
     table: QueryDefObjectName,
     relationName: string,
-    relationDef: ForeignKeyBuilder<any, any>,
+    relationDef: ForeignKeyBuilder<any>,
   ): Promise<void> {
     await this.executeDefs([
       relationDdl.getAddForeignKeyQueryDef(this, table, relationName, relationDef),
@@ -325,7 +328,7 @@ export abstract class DbContext implements DbContextBase {
 
   // ── DDL QueryDef 생성기 ──
 
-  getCreateTableQueryDef(table: TableBuilder<any, any, any>): QueryDef {
+  getCreateTableQueryDef(table: TableBuilder<any, any>): QueryDef {
     return tableDdl.getCreateTableQueryDef(this, table);
   }
 
@@ -338,7 +341,7 @@ export abstract class DbContext implements DbContextBase {
   }
 
   getCreateObjectQueryDef(
-    builder: TableBuilder<any, any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>,
+    builder: TableBuilder<any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>,
   ): QueryDef {
     return tableDdl.getCreateObjectQueryDef(this, builder);
   }
@@ -394,7 +397,7 @@ export abstract class DbContext implements DbContextBase {
   getAddForeignKeyQueryDef(
     table: QueryDefObjectName,
     relationName: string,
-    relationDef: ForeignKeyBuilder<any, any>,
+    relationDef: ForeignKeyBuilder<any>,
   ): QueryDef {
     return relationDdl.getAddForeignKeyQueryDef(this, table, relationName, relationDef);
   }

package/src/ddl/initialize.ts

@@ -131,7 +131,7 @@ export async function initialize(
  */
 async function createAllObjects(
   db: DbContextBase,
-  builders: (TableBuilder<any, any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>)[],
+  builders: (TableBuilder<any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>)[],
   targetDatabase: string,
 ): Promise<void> {
   // targetDatabase에 해당하는 builder만 필터링
@@ -188,16 +188,16 @@ async function createAllObjects(
  */
 function collectBuilders(
   dbContext: object,
-): (TableBuilder<any, any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>)[] {
+): (TableBuilder<any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>)[] {
   const builders: (
-    | TableBuilder<any, any, any>
+    | TableBuilder<any, any>
     | ViewBuilder<any, any, any>
     | ProcedureBuilder<any, any>
   )[] = [];
 
   for (const value of Object.values(dbContext)) {
     if (typeof value === "function" && SD_BUILDER in value) {
-      builders.push(value[SD_BUILDER as keyof typeof value] as TableBuilder<any, any, any>);
+      builders.push(value[SD_BUILDER as keyof typeof value] as TableBuilder<any, any>);
     }
   }
 

package/src/ddl/relation-ddl.ts

@@ -33,7 +33,7 @@ export function getAddForeignKeyQueryDef(
   db: DbContextBase,
   table: QueryDefObjectName,
   relationName: string,
-  relationDef: ForeignKeyBuilder<any, any>,
+  relationDef: ForeignKeyBuilder<any>,
 ): QueryDef {
   const targetTable = relationDef.meta.targetFn();
   const fkColumns = relationDef.meta.columns;

package/src/ddl/table-ddl.ts

@@ -23,7 +23,7 @@ import { obj } from "@simplysm/core-common";
  */
 export function getCreateObjectQueryDef(
   db: DbContextBase,
-  builder: TableBuilder<any, any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>,
+  builder: TableBuilder<any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>,
 ): QueryDef {
   if (builder instanceof TableBuilder) {
     return getCreateTableQueryDef(db, builder);
@@ -44,7 +44,7 @@ export function getCreateObjectQueryDef(
  * @returns CREATE TABLE QueryDef
  * @throws {Error} 테이블에 column이 없을 때
  */
-export function getCreateTableQueryDef(db: DbContextBase, table: TableBuilder<any, any, any>): QueryDef {
+export function getCreateTableQueryDef(db: DbContextBase, table: TableBuilder<any, any>): QueryDef {
   const columns = table.meta.columns as ColumnBuilderRecord | undefined;
   if (columns == null) {
     throw new Error(`테이블 '${table.meta.name}'에 column이 없습니다.`);
@@ -179,7 +179,7 @@ export function getDropProcQueryDef(procedure: QueryDefObjectName): DropProcQuer
  */
 export function getQueryDefObjectName(
   db: DbContextBase,
-  tableOrView: TableBuilder<any, any, any> | ViewBuilder<any, any, any>,
+  tableOrView: TableBuilder<any, any> | ViewBuilder<any, any, any>,
 ): QueryDefObjectName {
   return obj.clearUndefined({
     database: tableOrView.meta.database ?? db.database,

package/src/errors/db-transaction-error.ts

@@ -1,3 +1,5 @@
+import { SdError } from "@simplysm/core-common";
+
 /**
  * 트랜잭션 관련 에러 코드
  *
@@ -23,7 +25,7 @@ export enum DbErrorCode {
  * DBMS별 네이티브 에러를 표준화된 에러 코드로 래핑하여
  * DBMS 독립적인 에러 처리를 지원한다
  */
-export class DbTransactionError extends Error {
+export class DbTransactionError extends SdError {
   override readonly name = "DbTransactionError";
 
   constructor(
@@ -31,9 +33,9 @@ export class DbTransactionError extends Error {
     public readonly code: DbErrorCode,
     /** 에러 메시지 */
     message: string,
-    /** 원본 DBMS 에러 (디버깅용) */
-    public readonly originalError?: unknown,
+    /** 원본 DBMS 에러 (cause 체인으로 보존) */
+    cause?: Error,
   ) {
-    super(message);
+    super(cause as Error, message);
   }
 }

package/src/exec/executable.ts

@@ -1,6 +1,7 @@
-import type { ColumnBuilderRecord, InferColumnExprs } from "../schema/factory/column-builder";
+import type { ColumnBuilderRecord, InferColumnExprs, InferColumns } from "../schema/factory/column-builder";
 import type { ProcedureBuilder } from "../schema/procedure-builder";
 import type { DbContextBase } from "../types/db-context-def";
+import type { ExecProcQueryDef } from "../types/query-def";
 import { ExprUnit } from "../expr/expr-unit";
 import { expr } from "../expr/expr";
 
@@ -25,7 +26,7 @@ export class Executable<TParams extends ColumnBuilderRecord, TReturns extends Co
   /**
    * 프로시저 실행 QueryDef 생성
    */
-  getExecProcQueryDef(params?: InferColumnExprs<TParams>) {
+  getExecProcQueryDef(params?: InferColumnExprs<TParams>): ExecProcQueryDef {
     const meta = this._builder.meta;
     if (params && !meta.params) {
       throw new Error(`Procedure '${meta.name}'에 파라미터가 없습니다.`);
@@ -55,8 +56,8 @@ export class Executable<TParams extends ColumnBuilderRecord, TReturns extends Co
   /**
    * 프로시저 실행
    */
-  async execute(params: InferColumnExprs<TParams>): Promise<InferColumnExprs<TReturns>[][]> {
-    return this._db.executeDefs<InferColumnExprs<TReturns>>([this.getExecProcQueryDef(params)]);
+  async execute(params: InferColumnExprs<TParams>): Promise<InferColumns<TReturns>[][]> {
+    return this._db.executeDefs<InferColumns<TReturns>>([this.getExecProcQueryDef(params)]);
   }
 }
 

package/src/exec/queryable.ts

@@ -49,7 +49,7 @@ class JoinQueryable {
    * @param table - 조인할 table
    * @returns 조인된 Queryable
    */
-  from<T extends TableBuilder<any, any, any>>(table: T): Queryable<T["$inferSelect"], T> {
+  from<T extends TableBuilder<any, any>>(table: T): Queryable<T["$inferSelect"], T> {
     return queryable(this._db, table, this._joinAlias)();
   }
 
@@ -113,7 +113,7 @@ class RecursiveQueryable<TBaseData extends DataRecord> {
    * @param table - 재귀할 대상 table
    * @returns self 속성이 추가된 Queryable (자기 참조용)
    */
-  from<T extends TableBuilder<any, any, any>>(
+  from<T extends TableBuilder<any, any>>(
     table: T,
   ): Queryable<T["$inferSelect"] & { self?: TBaseData[] }, T> {
     const selfAlias = `${this._cteName}.self`;
@@ -210,7 +210,7 @@ class RecursiveQueryable<TBaseData extends DataRecord> {
  */
 export class Queryable<
   TData extends DataRecord,
-  TFrom extends TableBuilder<any, any, any> | never, // CUD 연산은 TableBuilder만 지원
+  TFrom extends TableBuilder<any, any> | never, // CUD 연산은 TableBuilder만 지원
 > {
   constructor(readonly meta: QueryableMeta<TData>) {}
 
@@ -1060,15 +1060,15 @@ export class Queryable<
    * @param outputColumns - Column name array to receive (optional)
    * @returns When outputColumns specified, returns array of inserted records
    */
-  async insertInto<TTable extends TableBuilder<any, DataToColumnBuilderRecord<TData>, any>>(
+  async insertInto<TTable extends TableBuilder<any, DataToColumnBuilderRecord<TData>>>(
     targetTable: TTable,
   ): Promise<void>;
   async insertInto<
-    TTable extends TableBuilder<any, DataToColumnBuilderRecord<TData>, any>,
+    TTable extends TableBuilder<any, DataToColumnBuilderRecord<TData>>,
     TOut extends keyof TTable["$inferColumns"] & string,
   >(targetTable: TTable, outputColumns: TOut[]): Promise<Pick<TData, TOut>[]>;
   async insertInto<
-    TTable extends TableBuilder<any, DataToColumnBuilderRecord<TData>, any>,
+    TTable extends TableBuilder<any, DataToColumnBuilderRecord<TData>>,
     TOut extends keyof TTable["$inferColumns"] & string,
   >(targetTable: TTable, outputColumns?: TOut[]): Promise<Pick<TData, TOut>[] | void> {
     const results = await this.meta.db.executeDefs<Pick<TData, TOut>>(
@@ -1085,7 +1085,7 @@ export class Queryable<
     records: TFrom["$inferInsert"][],
     outputColumns?: (keyof TFrom["$inferColumns"] & string)[],
   ): InsertQueryDef {
-    const from = this.meta.from as TableBuilder<any, any, any> | ViewBuilder<any, any, any>;
+    const from = this._getCudFrom();
     const outputDef = this._getCudOutputDef();
 
     // AI column에 명시적 값이 있으면 overrideIdentity 설정
@@ -1113,7 +1113,7 @@ export class Queryable<
     record: TFrom["$inferInsert"],
     outputColumns?: (keyof TFrom["$inferColumns"] & string)[],
   ): InsertIfNotExistsQueryDef {
-    const from = this.meta.from as TableBuilder<any, any, any> | ViewBuilder<any, any, any>;
+    const from = this._getCudFrom();
     const outputDef = this._getCudOutputDef();
 
     const { select: _, ...existsSelectQuery } = this.getSelectQueryDef();
@@ -1133,7 +1133,7 @@ export class Queryable<
     });
   }
 
-  getInsertIntoQueryDef<TTable extends TableBuilder<any, DataToColumnBuilderRecord<TData>, any>>(
+  getInsertIntoQueryDef<TTable extends TableBuilder<any, DataToColumnBuilderRecord<TData>>>(
     targetTable: TTable,
     outputColumns?: (keyof TTable["$inferColumns"] & string)[],
   ): InsertIntoQueryDef {
@@ -1212,7 +1212,7 @@ export class Queryable<
     recordFwd: (cols: QueryableRecord<TData>) => QueryableWriteRecord<TFrom["$inferUpdate"]>,
     outputColumns?: (keyof TFrom["$inferColumns"] & string)[],
   ): UpdateQueryDef {
-    const from = this.meta.from as TableBuilder<any, any, any> | ViewBuilder<any, any, any>;
+    const from = this._getCudFrom();
     const outputDef = this._getCudOutputDef();
 
     return obj.clearUndefined({
@@ -1235,7 +1235,7 @@ export class Queryable<
   }
 
   getDeleteQueryDef(outputColumns?: (keyof TFrom["$inferColumns"] & string)[]): DeleteQueryDef {
-    const from = this.meta.from as TableBuilder<any, any, any> | ViewBuilder<any, any, any>;
+    const from = this._getCudFrom();
     const outputDef = this._getCudOutputDef();
 
     return obj.clearUndefined({
@@ -1325,7 +1325,7 @@ export class Queryable<
     insertRecordFn: (updateRecord: U) => QueryableWriteRecord<TFrom["$inferInsert"]>,
     outputColumns?: (keyof TFrom["$inferColumns"] & string)[],
   ): UpsertQueryDef {
-    const from = this.meta.from as TableBuilder<any, any, any> | ViewBuilder<any, any, any>;
+    const from = this._getCudFrom();
     const outputDef = this._getCudOutputDef();
 
     const { select: _sel, ...existsSelectQuery } = this.getSelectQueryDef();
@@ -1380,6 +1380,11 @@ export class Queryable<
 
   //#region ========== CUD Common ==========
 
+  /** CUD QueryDef 생성용 from(Table/View) 캐스팅 통일 */
+  private _getCudFrom(): TableBuilder<any, any> | ViewBuilder<any, any, any> {
+    return this.meta.from as TableBuilder<any, any> | ViewBuilder<any, any, any>;
+  }
+
   private _getCudOutputDef(): {
     pkColNames: string[];
     aiColName?: string;
@@ -1422,7 +1427,7 @@ export class Queryable<
  */
 export function getMatchedPrimaryKeys(
   fkCols: string[],
-  targetTable: TableBuilder<any, any, any>,
+  targetTable: TableBuilder<any, any>,
 ): string[] {
   const pk = targetTable.meta.primaryKey;
   if (pk == null || fkCols.length !== pk.length) {
@@ -1470,7 +1475,7 @@ function transformColumnsAlias<TRecord extends DataRecord>(
     } else if (value == null) {
       result[key] = value;
     } else {
-      result[key] = new ExprUnit(inferColumnPrimitiveStr(value as ColumnPrimitive), {
+      result[key] = new ExprUnit(inferColumnPrimitiveStr(value as Exclude<ColumnPrimitive, undefined>), {
         type: "value",
         value: value as ColumnPrimitive,
       });
@@ -1500,7 +1505,7 @@ function wrapColumnsPrimitives<T>(columns: T): T {
     } else if (value == null) {
       result[key] = value;
     } else {
-      result[key] = new ExprUnit(inferColumnPrimitiveStr(value as ColumnPrimitive), {
+      result[key] = new ExprUnit(inferColumnPrimitiveStr(value as Exclude<ColumnPrimitive, undefined>), {
         type: "value",
         value: value as ColumnPrimitive,
       });
@@ -1572,13 +1577,15 @@ export type QueryableWriteRecord<TData> = {
 export type UnwrapQueryableRecord<R> = {
   [K in keyof R as K extends symbol ? never : K]: NonNullable<R[K]> extends ExprUnit<infer T>
     ? T | Extract<R[K], undefined>
-    : NonNullable<R[K]> extends (infer U)[]
-      ? U extends Record<string, any>
-        ? UnwrapQueryableRecord<U>[] | Extract<R[K], undefined>
-        : never
-      : NonNullable<R[K]> extends Record<string, any>
-        ? UnwrapQueryableRecord<NonNullable<R[K]>> | Extract<R[K], undefined>
-        : never;
+    : NonNullable<R[K]> extends ColumnPrimitive
+      ? R[K]
+      : NonNullable<R[K]> extends (infer U)[]
+        ? U extends Record<string, any>
+          ? UnwrapQueryableRecord<U>[] | Extract<R[K], undefined>
+          : never
+        : NonNullable<R[K]> extends Record<string, any>
+          ? UnwrapQueryableRecord<NonNullable<R[K]>> | Extract<R[K], undefined>
+          : never;
 };
 
 //#region ========== PathProxy - Type-safe path builder for include ==========
@@ -1646,11 +1653,11 @@ function createPathProxy<TObject>(path: string[] = []): PathProxy<TObject> {
  * @param as - Alias 지정 (선택, 미지정 시 자동 생성)
  * @returns Queryable을 반환하는 factory 함수
  */
-export function queryable<TBuilder extends TableBuilder<any, any, any> | ViewBuilder<any, any, any>>(
+export function queryable<TBuilder extends TableBuilder<any, any> | ViewBuilder<any, any, any>>(
   db: DbContextBase,
   tableOrView: TBuilder,
   as?: string,
-): () => Queryable<TBuilder["$inferSelect"], TBuilder extends TableBuilder<any, any, any> ? TBuilder : never> {
+): () => Queryable<TBuilder["$inferSelect"], TBuilder extends TableBuilder<any, any> ? TBuilder : never> {
   return () => {
     // as가 미지정이면 db.getNextAlias() 사용 (카운터 증가)
     // as가 지정되면 그대로 사용 (카운터 증가 없음)

package/src/expr/expr.ts

@@ -68,7 +68,7 @@ export const expr = {
    * @returns Column 참조 ExprUnit 인스턴스
    */
   col<TStr extends ColumnPrimitiveStr>(
-    dataType: ColumnPrimitiveStr,
+    dataType: TStr,
     ...path: string[]
   ): ExprUnit<ColumnPrimitiveMap[TStr] | undefined> {
     return new ExprUnit(dataType, { type: "column", path });
@@ -566,13 +566,16 @@ export const expr = {
   /**
    * 문자열 내 위치 찾기 (LOCATE/CHARINDEX)
    *
-   * 1부터 시작하는 인덱스 반환, 찾지 못하면 0 반환
+   * 0부터 시작하는 인덱스 반환, 찾지 못하면 -1 반환. source가 NULL이면 undefined.
    *
    * @param source - String to search in
    * @param search - String to find
-   * @returns Position (starting from 1, 0 if not found)
+   * @returns Position (0-based, -1 if not found; undefined if source is NULL)
    */
-  indexOf(source: ExprUnit<string | undefined>, search: ExprInput<string>): ExprUnit<number> {
+  indexOf<T extends string | undefined>(
+    source: ExprUnit<T>,
+    search: ExprInput<string>,
+  ): ExprUnit<T extends undefined ? number | undefined : number> {
     return new ExprUnit("number", {
       type: "indexOf",
       source: toExpr(source),
@@ -897,6 +900,9 @@ export const expr = {
    *
    * 메서드 체이닝으로 조건 분기 구성
    *
+   * 타입 인자 생략 시 case/default 값 타입이 강제되지 않음.
+   * 분기 값 타입의 동질성을 컴파일 시점에 강제하려면 `expr.switch<T>()` 로 T 를 명시.
+   *
    * @returns SwitchExprBuilder instance
    */
   switch<T extends ColumnPrimitive>(): SwitchExprBuilder<T> {

package/src/query-builder/base/expr-renderer-base.ts

@@ -1,3 +1,4 @@
+import type { ColumnPrimitive } from "../../types/column";
 import type {
   Expr,
   WhereExpr,
@@ -96,7 +97,7 @@ export abstract class ExprRendererBase {
   /**
    * 값 이스케이프 (타입에 맞는 SQL 리터럴로 변환)
    */
-  abstract escapeValue(value: unknown): string;
+  abstract escapeValue(value: ColumnPrimitive): string;
 
   //#endregion
 

package/src/query-builder/mssql/mssql-expr-renderer.ts

@@ -65,7 +65,7 @@ import type {
   ExprSubquery,
   DateUnit,
 } from "../../types/expr";
-import type { DataType } from "../../types/column";
+import type { ColumnPrimitive, DataType } from "../../types/column";
 import { ExprRendererBase } from "../base/expr-renderer-base";
 
 /**
@@ -85,7 +85,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   }
 
   /** 값 이스케이프 */
-  escapeValue(value: unknown): string {
+  escapeValue(value: ColumnPrimitive): string {
     if (value == null) {
       return "NULL";
     }
@@ -325,9 +325,9 @@ export class MssqlExprRenderer extends ExprRendererBase {
     return `SUBSTRING(${this.render(expr.source)}, ${this.render(expr.start)}, LEN(${this.render(expr.source)}))`;
   }
 
-  protected indexOf(expr: ExprIndexOf): string {
-    return `(CHARINDEX(${this.render(expr.search)}, ${this.render(expr.source)}) - 1)`;
-  }
+  protected indexOf(expr: ExprIndexOf): string {
+    return `(CHARINDEX(${this.render(expr.search)}, ${this.render(expr.source)}) - 1)`;
+  }
 
   //#endregion
 

package/src/query-builder/mysql/mysql-expr-renderer.ts

@@ -65,7 +65,7 @@ import type {
   ExprSubquery,
   DateUnit,
 } from "../../types/expr";
-import type { DataType } from "../../types/column";
+import type { ColumnPrimitive, DataType } from "../../types/column";
 import { ExprRendererBase } from "../base/expr-renderer-base";
 
 /**
@@ -91,7 +91,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   /** 값 이스케이프 */
-  escapeValue(value: unknown): string {
+  escapeValue(value: ColumnPrimitive): string {
     if (value == null) {
       return "NULL";
     }

package/src/query-builder/postgresql/postgresql-expr-renderer.ts

@@ -65,7 +65,7 @@ import type {
   ExprSubquery,
   DateUnit,
 } from "../../types/expr";
-import type { DataType } from "../../types/column";
+import type { ColumnPrimitive, DataType } from "../../types/column";
 import { ExprRendererBase } from "../base/expr-renderer-base";
 
 /**
@@ -85,7 +85,7 @@ export class PostgresqlExprRenderer extends ExprRendererBase {
   }
 
   /** 값 이스케이프 */
-  escapeValue(value: unknown): string {
+  escapeValue(value: ColumnPrimitive): string {
     if (value == null) {
       return "NULL";
     }
@@ -320,9 +320,9 @@ export class PostgresqlExprRenderer extends ExprRendererBase {
     return `SUBSTRING(${this.render(expr.source)} FROM ${this.render(expr.start)})`;
   }
 
-  protected indexOf(expr: ExprIndexOf): string {
-    return `(POSITION(${this.render(expr.search)} IN ${this.render(expr.source)}) - 1)`;
-  }
+  protected indexOf(expr: ExprIndexOf): string {
+    return `(POSITION(${this.render(expr.search)} IN ${this.render(expr.source)}) - 1)`;
+  }
 
   //#endregion
 

package/src/query-builder/postgresql/postgresql-query-builder.ts

@@ -31,6 +31,7 @@ import type {
   UpdateQueryDef,
   UpsertQueryDef,
 } from "../../types/query-def";
+import type { WhereExpr } from "../../types/expr";
 import type { QueryBuildResult } from "../../types/db";
 import { QueryBuilderBase } from "../base/query-builder-base";
 import { PostgresqlExprRenderer } from "./postgresql-expr-renderer";
@@ -685,7 +686,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
    * ctid 기반 CTE로 변환한다.
    */
   private _buildLimitCte(
-    def: { table: QueryDefObjectName; as: string; top?: number; limit?: [number, number]; where?: unknown[]; joins?: SelectQueryDefJoin[] },
+    def: { table: QueryDefObjectName; as: string; top?: number; limit?: [number, number]; where?: WhereExpr[]; joins?: SelectQueryDefJoin[] },
     table: string,
     alias: string,
   ): string {
@@ -703,7 +704,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
         .map((j) => this.expr.renderWhere(j.where!));
       const whereCondition =
         def.where != null && def.where.length > 0
-          ? this.expr.renderWhere(def.where as any)
+          ? this.expr.renderWhere(def.where)
           : null;
       const allConditions = [
         ...(whereCondition != null ? [whereCondition] : []),
@@ -713,7 +714,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
         sql += ` WHERE ${allConditions.join(" AND ")}`;
       }
     } else if (def.where != null && def.where.length > 0) {
-      sql += ` WHERE ${this.expr.renderWhere(def.where as any)}`;
+      sql += ` WHERE ${this.expr.renderWhere(def.where)}`;
     }
 
     if (def.limit != null) {

package/src/schema/factory/column-builder.ts

@@ -282,9 +282,9 @@ export type RequiredInsertKeys<TBuilders extends ColumnBuilderRecord> = {
       ? never
       : M["nullable"] extends true
         ? never
-        : M["default"] extends undefined
-          ? K
-          : never
+        : "default" extends keyof M
+          ? never
+          : K
     : never;
 }[keyof TBuilders];