@simplysm/orm-common 13.0.28 → 13.0.29

package/src/create-db-context.ts

@@ -1,4 +1,9 @@
-import type { DbContextDef, DbContextBase, DbContextStatus, DbContextInstance } from "./types/db-context-def";
+import type {
+  DbContextDef,
+  DbContextBase,
+  DbContextStatus,
+  DbContextInstance,
+} from "./types/db-context-def";
 import type { DataRecord, DbContextExecutor, IsolationLevel, ResultMeta } from "./types/db";
 import type { QueryDef, QueryDefObjectName } from "./types/query-def";
 import { DDL_TYPES } from "./types/query-def";
@@ -15,7 +20,10 @@ import * as tableDdl from "./ddl/table-ddl";
 import * as columnDdl from "./ddl/column-ddl";
 import * as relationDdl from "./ddl/relation-ddl";
 import * as schemaDdl from "./ddl/schema-ddl";
-import { initialize as initializeImpl, validateRelations as validateRelationsImpl } from "./ddl/initialize";
+import {
+  initialize as initializeImpl,
+  validateRelations as validateRelationsImpl,
+} from "./ddl/initialize";
 
 import type { ColumnBuilder } from "./schema/factory/column-builder";
 import type { ForeignKeyBuilder } from "./schema/factory/relation-builder";
@@ -77,13 +85,21 @@ export function createDbContext<TDef extends DbContextDef<any, any, any>>(
     resetAliasCounter() {
       aliasCounter = 0;
     },
-    executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]> {
-      if (status === "transact" && defs.some((d) => (DDL_TYPES as readonly string[]).includes(d.type))) {
+    executeDefs<T = DataRecord>(
+      defs: QueryDef[],
+      resultMetas?: (ResultMeta | undefined)[],
+    ): Promise<T[][]> {
+      if (
+        status === "transact" &&
+        defs.some((d) => (DDL_TYPES as readonly string[]).includes(d.type))
+      ) {
         throw new Error("TRANSACTION 상태에서는 DDL을 실행할 수 없습니다.");
       }
       return executor.executeDefs(defs, resultMetas);
     },
-    getQueryDefObjectName(tableOrView: TableBuilder<any, any> | ViewBuilder<any, any, any>): QueryDefObjectName {
+    getQueryDefObjectName(
+      tableOrView: TableBuilder<any, any> | ViewBuilder<any, any, any>,
+    ): QueryDefObjectName {
       return objClearUndefined({
         database: tableOrView.meta.database ?? opt.database,
         schema: tableOrView.meta.schema ?? opt.schema,
@@ -123,7 +139,10 @@ export function createDbContext<TDef extends DbContextDef<any, any, any>>(
      * 연결 -> 트랜잭션 시작 -> 콜백 실행 -> 커밋 -> 연결 종료
      * 에러 발생 시 자동 롤백 후 연결 종료
      */
-    async connect<TResult>(fn: () => Promise<TResult>, isolationLevel?: IsolationLevel): Promise<TResult> {
+    async connect<TResult>(
+      fn: () => Promise<TResult>,
+      isolationLevel?: IsolationLevel,
+    ): Promise<TResult> {
       validateRelationsImpl(def);
       base.resetAliasCounter();
 
@@ -198,7 +217,10 @@ export function createDbContext<TDef extends DbContextDef<any, any, any>>(
      *
      * connectWithoutTransaction 내에서 부분적으로 트랜잭션이 필요할 때 사용
      */
-    async trans<TResult>(fn: () => Promise<TResult>, isolationLevel?: IsolationLevel): Promise<TResult> {
+    async trans<TResult>(
+      fn: () => Promise<TResult>,
+      isolationLevel?: IsolationLevel,
+    ): Promise<TResult> {
       if (status === "transact") {
         throw new Error("이미 TRANSACTION 상태입니다.");
       }
@@ -258,13 +280,21 @@ export function createDbContext<TDef extends DbContextDef<any, any, any>>(
     async dropProc(procedure: QueryDefObjectName): Promise<void> {
       await base.executeDefs([tableDdl.getDropProcQueryDef(procedure)]);
     },
-    async addColumn(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): Promise<void> {
+    async addColumn(
+      table: QueryDefObjectName,
+      columnName: string,
+      column: ColumnBuilder<any, any>,
+    ): Promise<void> {
       await base.executeDefs([columnDdl.getAddColumnQueryDef(table, columnName, column)]);
     },
     async dropColumn(table: QueryDefObjectName, column: string): Promise<void> {
       await base.executeDefs([columnDdl.getDropColumnQueryDef(table, column)]);
     },
-    async modifyColumn(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): Promise<void> {
+    async modifyColumn(
+      table: QueryDefObjectName,
+      columnName: string,
+      column: ColumnBuilder<any, any>,
+    ): Promise<void> {
       await base.executeDefs([columnDdl.getModifyColumnQueryDef(table, columnName, column)]);
     },
     async renameColumn(table: QueryDefObjectName, column: string, newName: string): Promise<void> {
@@ -281,7 +311,9 @@ export function createDbContext<TDef extends DbContextDef<any, any, any>>(
       relationName: string,
       relationDef: ForeignKeyBuilder<any, any>,
     ): Promise<void> {
-      await base.executeDefs([relationDdl.getAddFkQueryDef(base, table, relationName, relationDef)]);
+      await base.executeDefs([
+        relationDdl.getAddFkQueryDef(base, table, relationName, relationDef),
+      ]);
     },
     async addIdx(table: QueryDefObjectName, indexBuilder: IndexBuilder<string[]>): Promise<void> {
       await base.executeDefs([relationDdl.getAddIdxQueryDef(table, indexBuilder)]);
@@ -310,9 +342,12 @@ export function createDbContext<TDef extends DbContextDef<any, any, any>>(
 
     //#region ========== DDL QueryDef generators ==========
 
-    getCreateTableQueryDef: (table: TableBuilder<any, any>) => tableDdl.getCreateTableQueryDef(base, table),
-    getCreateViewQueryDef: (view: ViewBuilder<any, any, any>) => tableDdl.getCreateViewQueryDef(db as any, view),
-    getCreateProcQueryDef: (procedure: ProcedureBuilder<any, any>) => tableDdl.getCreateProcQueryDef(base, procedure),
+    getCreateTableQueryDef: (table: TableBuilder<any, any>) =>
+      tableDdl.getCreateTableQueryDef(base, table),
+    getCreateViewQueryDef: (view: ViewBuilder<any, any, any>) =>
+      tableDdl.getCreateViewQueryDef(db as any, view),
+    getCreateProcQueryDef: (procedure: ProcedureBuilder<any, any>) =>
+      tableDdl.getCreateProcQueryDef(base, procedure),
     getCreateObjectQueryDef: (
       builder: TableBuilder<any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>,
     ) => tableDdl.getCreateObjectQueryDef(db as any, builder),
@@ -326,8 +361,11 @@ export function createDbContext<TDef extends DbContextDef<any, any, any>>(
     getRenameColumnQueryDef: columnDdl.getRenameColumnQueryDef,
     getAddPkQueryDef: relationDdl.getAddPkQueryDef,
     getDropPkQueryDef: relationDdl.getDropPkQueryDef,
-    getAddFkQueryDef: (table: QueryDefObjectName, relationName: string, relationDef: ForeignKeyBuilder<any, any>) =>
-      relationDdl.getAddFkQueryDef(base, table, relationName, relationDef),
+    getAddFkQueryDef: (
+      table: QueryDefObjectName,
+      relationName: string,
+      relationDef: ForeignKeyBuilder<any, any>,
+    ) => relationDdl.getAddFkQueryDef(base, table, relationName, relationDef),
     getAddIdxQueryDef: relationDdl.getAddIdxQueryDef,
     getDropFkQueryDef: relationDdl.getDropFkQueryDef,
     getDropIdxQueryDef: relationDdl.getDropIdxQueryDef,

package/src/ddl/column-ddl.ts

@@ -31,7 +31,10 @@ export function getAddColumnQueryDef(
 /**
  * DROP COLUMN QueryDef 생성
  */
-export function getDropColumnQueryDef(table: QueryDefObjectName, column: string): DropColumnQueryDef {
+export function getDropColumnQueryDef(
+  table: QueryDefObjectName,
+  column: string,
+): DropColumnQueryDef {
   return { type: "dropColumn", table, column };
 }
 

package/src/ddl/initialize.ts

@@ -104,7 +104,10 @@ export async function initialize(
 /**
  * 전체 객체 생성 (테이블/뷰/프로시저/FK/Index)
  */
-async function createAllObjects(db: DbContextBase, def: DbContextDef<any, any, any>): Promise<void> {
+async function createAllObjects(
+  db: DbContextBase,
+  def: DbContextDef<any, any, any>,
+): Promise<void> {
   // 1. 테이블/뷰/프로시저 생성
   const builders = getBuilders(def);
   const createDefs: QueryDef[] = [];
@@ -155,7 +158,11 @@ async function createAllObjects(db: DbContextBase, def: DbContextDef<any, any, a
 function getBuilders(
   def: DbContextDef<any, any, any>,
 ): (TableBuilder<any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>)[] {
-  const builders: (TableBuilder<any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>)[] = [];
+  const builders: (
+    | TableBuilder<any, any>
+    | ViewBuilder<any, any, any>
+    | ProcedureBuilder<any, any>
+  )[] = [];
 
   // Tables
   const tables: TableBuilder<any, any>[] = Object.values(def.meta.tables);
@@ -191,7 +198,10 @@ export function validateRelations(def: DbContextDef<any, any, any>): void {
     if (relations == null) continue;
 
     for (const [relName, relDef] of Object.entries(relations)) {
-      if (!(relDef instanceof ForeignKeyTargetBuilder) && !(relDef instanceof RelationKeyTargetBuilder)) {
+      if (
+        !(relDef instanceof ForeignKeyTargetBuilder) &&
+        !(relDef instanceof RelationKeyTargetBuilder)
+      ) {
         continue;
       }
 

package/src/ddl/relation-ddl.ts

@@ -54,7 +54,10 @@ export function getAddFkQueryDef(
 /**
  * ADD INDEX QueryDef 생성
  */
-export function getAddIdxQueryDef(table: QueryDefObjectName, indexBuilder: IndexBuilder<string[]>): QueryDef {
+export function getAddIdxQueryDef(
+  table: QueryDefObjectName,
+  indexBuilder: IndexBuilder<string[]>,
+): QueryDef {
   const indexMeta = indexBuilder.meta;
 
   return {

package/src/ddl/schema-ddl.ts

@@ -9,7 +9,10 @@ import type {
 /**
  * CLEAR SCHEMA QueryDef 생성
  */
-export function getClearSchemaQueryDef(params: { database: string; schema?: string }): ClearSchemaQueryDef {
+export function getClearSchemaQueryDef(params: {
+  database: string;
+  schema?: string;
+}): ClearSchemaQueryDef {
   return { type: "clearSchema", database: params.database, schema: params.schema };
 }
 
@@ -30,6 +33,9 @@ export function getTruncateQueryDef(table: QueryDefObjectName): TruncateQueryDef
 /**
  * SWITCH FK QueryDef 생성
  */
-export function getSwitchFkQueryDef(table: QueryDefObjectName, switch_: "on" | "off"): SwitchFkQueryDef {
+export function getSwitchFkQueryDef(
+  table: QueryDefObjectName,
+  switch_: "on" | "off",
+): SwitchFkQueryDef {
   return { type: "switchFk", table, switch: switch_ };
 }

package/src/ddl/table-ddl.ts

@@ -72,7 +72,10 @@ export function getCreateTableQueryDef(db: DbContextBase, table: TableBuilder<an
  * @returns CREATE VIEW QueryDef
  * @throws {Error} 뷰에 viewFn이 없을 때
  */
-export function getCreateViewQueryDef(db: DbContextBase, view: ViewBuilder<any, any, any>): QueryDef {
+export function getCreateViewQueryDef(
+  db: DbContextBase,
+  view: ViewBuilder<any, any, any>,
+): QueryDef {
   if (view.meta.viewFn == null) {
     throw new Error(`뷰 '${view.meta.name}'에 viewFn이 없습니다.`);
   }
@@ -99,7 +102,10 @@ export function getCreateViewQueryDef(db: DbContextBase, view: ViewBuilder<any,
  * @returns CREATE PROCEDURE QueryDef
  * @throws {Error} 프로시저에 본문이 없을 때
  */
-export function getCreateProcQueryDef(db: DbContextBase, procedure: ProcedureBuilder<any, any>): QueryDef {
+export function getCreateProcQueryDef(
+  db: DbContextBase,
+  procedure: ProcedureBuilder<any, any>,
+): QueryDef {
   if (procedure.meta.query == null) {
     throw new Error(`프로시저 '${procedure.meta.name}'에 본문이 없습니다.`);
   }
@@ -143,7 +149,10 @@ export function getDropTableQueryDef(table: QueryDefObjectName): DropTableQueryD
 /**
  * RENAME TABLE QueryDef 생성
  */
-export function getRenameTableQueryDef(table: QueryDefObjectName, newName: string): RenameTableQueryDef {
+export function getRenameTableQueryDef(
+  table: QueryDefObjectName,
+  newName: string,
+): RenameTableQueryDef {
   return { type: "renameTable", table, newName };
 }
 

package/src/define-db-context.ts

@@ -17,7 +17,9 @@ export function defineDbContext<
 }): DbContextDef<TTables & { _migration: typeof _Migration }, TViews, TProcedures> {
   return {
     meta: {
-      tables: { ...(config.tables ?? {}), _migration: _Migration } as TTables & { _migration: typeof _Migration },
+      tables: { ...(config.tables ?? {}), _migration: _Migration } as TTables & {
+        _migration: typeof _Migration;
+      },
       views: (config.views ?? {}) as TViews,
       procedures: (config.procedures ?? {}) as TProcedures,
       migrations: config.migrations ?? [],

package/src/exec/executable.ts

@@ -103,7 +103,10 @@ export class Executable<TParams extends ColumnBuilderRecord, TReturns extends Co
  * @see {@link Executable} 실행 클래스
  * @see {@link ProcedureBuilder} 프로시저 정의
  */
-export function executable<TParams extends ColumnBuilderRecord, TReturns extends ColumnBuilderRecord>(
+export function executable<
+  TParams extends ColumnBuilderRecord,
+  TReturns extends ColumnBuilderRecord,
+>(
   db: DbContextBase,
   builder: ProcedureBuilder<TParams, TReturns>,
 ): () => Executable<TParams, TReturns> {

package/src/exec/queryable.ts

@@ -14,7 +14,10 @@ import type {
   UpsertQueryDef,
 } from "../types/query-def";
 import type { DbContextBase } from "../types/db-context-def";
-import { type ColumnBuilderRecord, type DataToColumnBuilderRecord } from "../schema/factory/column-builder";
+import {
+  type ColumnBuilderRecord,
+  type DataToColumnBuilderRecord,
+} from "../schema/factory/column-builder";
 import type { ColumnPrimitive, ColumnPrimitiveStr } from "../types/column";
 import type { WhereExprUnit } from "../expr/expr-unit";
 import { ExprUnit } from "../expr/expr-unit";
@@ -110,7 +113,9 @@ class RecursiveQueryable<TBaseData extends DataRecord> {
    * @param table - 재귀할 대상 테이블
    * @returns self 속성이 추가된 Queryable (자기 참조용)
    */
-  from<T extends TableBuilder<any, any>>(table: T): Queryable<T["$infer"] & { self?: TBaseData[] }, T> {
+  from<T extends TableBuilder<any, any>>(
+    table: T,
+  ): Queryable<T["$infer"] & { self?: TBaseData[] }, T> {
     const selfAlias = `${this._cteName}.self`;
 
     return queryable(this._baseQr.meta.db, table, this._cteName)().join(
@@ -132,7 +137,9 @@ class RecursiveQueryable<TBaseData extends DataRecord> {
    * @param columns - 커스텀 컬럼 정의
    * @returns self 속성이 추가된 Queryable
    */
-  select<R extends DataRecord>(columns: QueryableRecord<R>): Queryable<R & { self?: TBaseData[] }, never> {
+  select<R extends DataRecord>(
+    columns: QueryableRecord<R>,
+  ): Queryable<R & { self?: TBaseData[] }, never> {
     const selfAlias = `${this._cteName}.self`;
 
     return new Queryable<R, never>({
@@ -240,7 +247,9 @@ export class Queryable<
    * }))
    * ```
    */
-  select<R extends DataRecord>(fn: (columns: QueryableRecord<TData>) => QueryableRecord<R>): Queryable<R, never> {
+  select<R extends DataRecord>(
+    fn: (columns: QueryableRecord<TData>) => QueryableRecord<R>,
+  ): Queryable<R, never> {
     if (Array.isArray(this.meta.from)) {
       const newFroms = this.meta.from.map((from) => from.select(fn));
       return new Queryable({
@@ -507,7 +516,9 @@ export class Queryable<
       conditions.push(expr.or(columnMatches));
     } else if (parsed.or.length > 1) {
       const orConditions = parsed.or.map((pattern) => {
-        const columnMatches = columns.map((col) => expr.like(expr.lower(col), pattern.toLowerCase()));
+        const columnMatches = columns.map((col) =>
+          expr.like(expr.lower(col), pattern.toLowerCase()),
+        );
         return expr.or(columnMatches);
       });
       conditions.push(expr.or(orConditions));
@@ -552,7 +563,9 @@ export class Queryable<
    *   .groupBy((o) => [o.userId])
    * ```
    */
-  groupBy(fn: (columns: QueryableRecord<TData>) => ExprUnit<ColumnPrimitive>[]): Queryable<TData, never> {
+  groupBy(
+    fn: (columns: QueryableRecord<TData>) => ExprUnit<ColumnPrimitive>[],
+  ): Queryable<TData, never> {
     if (Array.isArray(this.meta.from)) {
       const newFroms = this.meta.from.map((from) => from.groupBy(fn));
       return new Queryable({
@@ -677,7 +690,10 @@ export class Queryable<
   joinSingle<A extends string, R extends DataRecord>(
     as: A,
     fwd: (qr: JoinQueryable, cols: QueryableRecord<TData>) => Queryable<R, any>,
-  ): Queryable<{ [K in keyof TData as K extends A ? never : K]: TData[K] } & { [K in A]?: R }, TFrom> {
+  ): Queryable<
+    { [K in keyof TData as K extends A ? never : K]: TData[K] } & { [K in A]?: R },
+    TFrom
+  > {
     if (Array.isArray(this.meta.from)) {
       const newFroms = this.meta.from.map((from) => from.joinSingle(as, fwd));
       return new Queryable({
@@ -797,7 +813,9 @@ export class Queryable<
 
           // FKT join은 배열로 저장되므로 배열인 경우 첫 번째 요소 사용
           const srcColsRaw = parentChain ? parentCols[parentChain] : parentCols;
-          const srcCols = (Array.isArray(srcColsRaw) ? srcColsRaw[0] : srcColsRaw) as QueryableRecord<any>;
+          const srcCols = (
+            Array.isArray(srcColsRaw) ? srcColsRaw[0] : srcColsRaw
+          ) as QueryableRecord<any>;
           const conditions: WhereExprUnit[] = [];
 
           for (let i = 0; i < fkColKeys.length; i++) {
@@ -811,7 +829,10 @@ export class Queryable<
         });
 
         currentTable = targetTable;
-      } else if (relationDef instanceof ForeignKeyTargetBuilder || relationDef instanceof RelationKeyTargetBuilder) {
+      } else if (
+        relationDef instanceof ForeignKeyTargetBuilder ||
+        relationDef instanceof RelationKeyTargetBuilder
+      ) {
         // FKT/RelationKeyTarget (1:N 또는 1:1): User.posts → Post[]
         // 조건: Post.userId = User.id
         const targetTable = relationDef.meta.targetTableFn();
@@ -834,7 +855,9 @@ export class Queryable<
 
           // FKT join은 배열로 저장되므로 배열인 경우 첫 번째 요소 사용
           const srcColsRaw = parentChain ? parentCols[parentChain] : parentCols;
-          const srcCols = (Array.isArray(srcColsRaw) ? srcColsRaw[0] : srcColsRaw) as QueryableRecord<any>;
+          const srcCols = (
+            Array.isArray(srcColsRaw) ? srcColsRaw[0] : srcColsRaw
+          ) as QueryableRecord<any>;
           const conditions: WhereExprUnit[] = [];
 
           for (let i = 0; i < fkColKeys.length; i++) {
@@ -905,7 +928,9 @@ export class Queryable<
    * );
    * ```
    */
-  static union<TData extends DataRecord>(...queries: Queryable<TData, any>[]): Queryable<TData, never> {
+  static union<TData extends DataRecord>(
+    ...queries: Queryable<TData, any>[]
+  ): Queryable<TData, never> {
     if (queries.length < 2) {
       throw new ArgumentError("union은 최소 2개의 queryable이 필요합니다.", {
         provided: queries.length,
@@ -946,7 +971,9 @@ export class Queryable<
    *   )
    * ```
    */
-  recursive(fwd: (qr: RecursiveQueryable<TData>) => Queryable<TData, any>): Queryable<TData, never> {
+  recursive(
+    fwd: (qr: RecursiveQueryable<TData>) => Queryable<TData, any>,
+  ): Queryable<TData, never> {
     if (Array.isArray(this.meta.from)) {
       const newFroms = this.meta.from.map((from) => from.recursive(fwd));
       return new Queryable({
@@ -994,7 +1021,10 @@ export class Queryable<
    * ```
    */
   async result(): Promise<TData[]> {
-    const results = await this.meta.db.executeDefs<TData>([this.getSelectQueryDef()], [this.getResultMeta()]);
+    const results = await this.meta.db.executeDefs<TData>(
+      [this.getSelectQueryDef()],
+      [this.getResultMeta()],
+    );
     return results[0];
   }
 
@@ -1126,7 +1156,12 @@ export class Queryable<
     });
   }
 
-  private _buildFromDef(): QueryDefObjectName | SelectQueryDef | SelectQueryDef[] | string | undefined {
+  private _buildFromDef():
+    | QueryDefObjectName
+    | SelectQueryDef
+    | SelectQueryDef[]
+    | string
+    | undefined {
     const from = this.meta.from;
 
     if (from instanceof TableBuilder || from instanceof ViewBuilder) {
@@ -1440,7 +1475,9 @@ export class Queryable<
    *   }));
    * ```
    */
-  async update(recordFwd: (cols: QueryableRecord<TData>) => QueryableRecord<TFrom["$inferUpdate"]>): Promise<void>;
+  async update(
+    recordFwd: (cols: QueryableRecord<TData>) => QueryableRecord<TFrom["$inferUpdate"]>,
+  ): Promise<void>;
   async update<K extends keyof TFrom["$columns"] & string>(
     recordFwd: (cols: QueryableRecord<TData>) => QueryableRecord<TFrom["$inferUpdate"]>,
     outputColumns: K[],
@@ -1479,7 +1516,9 @@ export class Queryable<
    * ```
    */
   async delete(): Promise<void>;
-  async delete<K extends keyof TFrom["$columns"] & string>(outputColumns: K[]): Promise<Pick<TFrom["$columns"], K>[]>;
+  async delete<K extends keyof TFrom["$columns"] & string>(
+    outputColumns: K[],
+  ): Promise<Pick<TFrom["$columns"], K>[]>;
   async delete<K extends keyof TFrom["$columns"] & string>(
     outputColumns?: K[],
   ): Promise<Pick<TFrom["$columns"], K>[] | void> {
@@ -1574,7 +1613,9 @@ export class Queryable<
    *   );
    * ```
    */
-  async upsert(updateFwd: (cols: QueryableRecord<TData>) => QueryableRecord<TFrom["$inferUpdate"]>): Promise<void>;
+  async upsert(
+    updateFwd: (cols: QueryableRecord<TData>) => QueryableRecord<TFrom["$inferUpdate"]>,
+  ): Promise<void>;
   async upsert<K extends keyof TFrom["$inferColumns"] & string>(
     insertFwd: (cols: QueryableRecord<TData>) => QueryableRecord<TFrom["$inferInsert"]>,
     outputColumns?: K[],
@@ -1583,12 +1624,18 @@ export class Queryable<
     updateFwd: (cols: QueryableRecord<TData>) => U,
     insertFwd: (updateRecord: U) => QueryableRecord<TFrom["$inferInsert"]>,
   ): Promise<void>;
-  async upsert<U extends QueryableRecord<TFrom["$inferUpdate"]>, K extends keyof TFrom["$inferColumns"] & string>(
+  async upsert<
+    U extends QueryableRecord<TFrom["$inferUpdate"]>,
+    K extends keyof TFrom["$inferColumns"] & string,
+  >(
     updateFwd: (cols: QueryableRecord<TData>) => U,
     insertFwd: (updateRecord: U) => QueryableRecord<TFrom["$inferInsert"]>,
     outputColumns?: K[],
   ): Promise<Pick<TFrom["$inferColumns"], K>[]>;
-  async upsert<U extends QueryableRecord<TFrom["$inferUpdate"]>, K extends keyof TFrom["$inferColumns"] & string>(
+  async upsert<
+    U extends QueryableRecord<TFrom["$inferUpdate"]>,
+    K extends keyof TFrom["$inferColumns"] & string,
+  >(
     updateFwdOrInsertFwd:
       | ((cols: QueryableRecord<TData>) => U)
       | ((cols: QueryableRecord<TData>) => QueryableRecord<TFrom["$inferInsert"]>),
@@ -1601,7 +1648,8 @@ export class Queryable<
       insertFwdOrOutputColumns instanceof Function ? insertFwdOrOutputColumns : updateFwdOrInsertFwd
     ) as (updateRecord: U) => QueryableRecord<TFrom["$inferInsert"]>;
 
-    const realOutputColumns = insertFwdOrOutputColumns instanceof Function ? outputColumns : insertFwdOrOutputColumns;
+    const realOutputColumns =
+      insertFwdOrOutputColumns instanceof Function ? outputColumns : insertFwdOrOutputColumns;
 
     const results = await this.meta.db.executeDefs<Pick<TFrom["$inferColumns"], K>>(
       [this.getUpsertQueryDef(updateRecordFwd, insertRecordFwd, realOutputColumns)],
@@ -1662,7 +1710,9 @@ export class Queryable<
   async switchFk(switch_: "on" | "off"): Promise<void> {
     const from = this.meta.from;
     if (!(from instanceof TableBuilder) && !(from instanceof ViewBuilder)) {
-      throw new Error("switchFk는 TableBuilder 또는 ViewBuilder 기반 queryable에서만 사용할 수 있습니다.");
+      throw new Error(
+        "switchFk는 TableBuilder 또는 ViewBuilder 기반 queryable에서만 사용할 수 있습니다.",
+      );
     }
     await this.meta.db.switchFk(this.meta.db.getQueryDefObjectName(from), switch_);
   }
@@ -1711,7 +1761,10 @@ export class Queryable<
  * @returns 매칭된 PK 컬럼명 배열
  * @throws FK/PK 컬럼 수 불일치 시
  */
-export function getMatchedPrimaryKeys(fkCols: string[], targetTable: TableBuilder<any, any>): string[] {
+export function getMatchedPrimaryKeys(
+  fkCols: string[],
+  targetTable: TableBuilder<any, any>,
+): string[] {
   const pk = targetTable.meta.primaryKey;
   if (pk == null || fkCols.length !== pk.length) {
     throw new Error(
@@ -1749,7 +1802,9 @@ function transformColumnsAlias<TRecord extends DataRecord>(
       result[key] = expr.col(value.dataType, alias, fullKey);
     } else if (Array.isArray(value)) {
       if (value.length > 0) {
-        result[key] = [transformColumnsAlias(value[0] as QueryableRecord<DataRecord>, alias, fullKey)];
+        result[key] = [
+          transformColumnsAlias(value[0] as QueryableRecord<DataRecord>, alias, fullKey),
+        ];
       }
     } else if (typeof value === "object" && value != null) {
       result[key] = transformColumnsAlias(value as QueryableRecord<DataRecord>, alias, fullKey);
@@ -1767,7 +1822,12 @@ function transformColumnsAlias<TRecord extends DataRecord>(
 
 interface QueryableMeta<TData extends DataRecord> {
   db: DbContextBase;
-  from?: TableBuilder<any, any> | ViewBuilder<any, any, any> | Queryable<any, any> | Queryable<TData, any>[] | string;
+  from?:
+    | TableBuilder<any, any>
+    | ViewBuilder<any, any, any>
+    | Queryable<any, any>
+    | Queryable<TData, any>[]
+    | string;
   as: string;
   columns: QueryableRecord<TData>;
   isCustomColumns?: boolean;
@@ -1835,7 +1895,9 @@ const PATH_SYMBOL = Symbol("path");
  * include()용 타입 안전 경로 프록시
  */
 export type PathProxy<TObject> = {
-  [K in keyof TObject as TObject[K] extends ColumnPrimitive ? never : K]-?: PathProxy<UnwrapArray<TObject[K]>>;
+  [K in keyof TObject as TObject[K] extends ColumnPrimitive ? never : K]-?: PathProxy<
+    UnwrapArray<TObject[K]>
+  >;
 } & { readonly [PATH_SYMBOL]: string[] };
 
 /**
@@ -1898,7 +1960,10 @@ export function queryable<TBuilder extends TableBuilder<any, any> | ViewBuilder<
         from: tableOrView,
         as: finalAs,
         columns: Object.fromEntries(
-          Object.entries(columnDefs).map(([key, colDef]) => [key, expr.col(colDef.meta.type, finalAs, key)]),
+          Object.entries(columnDefs).map(([key, colDef]) => [
+            key,
+            expr.col(colDef.meta.type, finalAs, key),
+          ]),
         ),
       }) as any;
     }

package/src/exec/search-parser.ts

@@ -164,7 +164,11 @@ function termToLikePattern(term: string): string {
   let pattern = term.replace(/\*/g, WILDCARD);
 
   // SQL LIKE 특수문자 이스케이프 (\ → \\, % → \%, _ → \_, [ → \[)
-  pattern = pattern.replace(/\\/g, "\\\\").replace(/%/g, "\\%").replace(/_/g, "\\_").replace(/\[/g, "\\[");
+  pattern = pattern
+    .replace(/\\/g, "\\\\")
+    .replace(/%/g, "\\%")
+    .replace(/_/g, "\\_")
+    .replace(/\[/g, "\\[");
 
   // 와일드카드 마커 → % (SQL 와일드카드)
   pattern = pattern.replaceAll(WILDCARD, "%");