@simplysm/orm-common 13.0.28 → 13.0.30

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

@@ -465,7 +465,9 @@ export class PostgresqlExprRenderer extends ExprRendererBase {
   }
 
   protected switch(expr: ExprSwitch): string {
-    const cases = expr.cases.map((c) => `WHEN ${this.render(c.when)} THEN ${this.render(c.then)}`).join(" ");
+    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`;
   }
 
@@ -589,7 +591,9 @@ export class PostgresqlExprRenderer extends ExprRendererBase {
       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}` : ""}`);
+      const orderParts = spec.orderBy.map(
+        ([expr, dir]) => `${this.render(expr)}${dir != null ? ` ${dir}` : ""}`,
+      );
       parts.push(`ORDER BY ${orderParts.join(", ")}`);
     }
     return parts.join(" ");

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

@@ -71,7 +71,10 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   protected renderJoin(join: SelectQueryDefJoin): string {
     const from = this.renderFrom(join.from);
     const alias = this.expr.wrap(join.as);
-    const where = join.where != null && join.where.length > 0 ? ` ON ${this.expr.renderWhere(join.where)}` : " ON TRUE";
+    const where =
+      join.where != null && join.where.length > 0
+        ? ` ON ${this.expr.renderWhere(join.where)}`
+        : " ON TRUE";
 
     // LATERAL JOIN 필요 여부 감지
     if (this.needsLateral(join)) {
@@ -236,7 +239,9 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
     const alias = this.expr.wrap(def.as);
 
     // SET
-    const setParts = Object.entries(def.record).map(([col, e]) => `${this.expr.wrap(col)} = ${this.expr.render(e)}`);
+    const setParts = Object.entries(def.record).map(
+      ([col, e]) => `${this.expr.wrap(col)} = ${this.expr.render(e)}`,
+    );
 
     let sql = `UPDATE ${table} AS ${alias} SET ${setParts.join(", ")}`;
 
@@ -253,8 +258,10 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
         .filter((j) => j.where != null && j.where.length > 0)
         .map((j) => this.expr.renderWhere(j.where!));
       if (joinConditions.length > 0) {
-        const whereCondition = def.where != null && def.where.length > 0 ? this.expr.renderWhere(def.where) : null;
-        const allConditions = whereCondition != null ? [whereCondition, ...joinConditions] : joinConditions;
+        const whereCondition =
+          def.where != null && def.where.length > 0 ? this.expr.renderWhere(def.where) : null;
+        const allConditions =
+          whereCondition != null ? [whereCondition, ...joinConditions] : joinConditions;
         sql += ` WHERE ${allConditions.join(" AND ")}`;
       } else {
         sql += this.renderWhere(def.where);
@@ -295,8 +302,10 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
         .filter((j) => j.where != null && j.where.length > 0)
         .map((j) => this.expr.renderWhere(j.where!));
       if (joinConditions.length > 0) {
-        const whereCondition = def.where != null && def.where.length > 0 ? this.expr.renderWhere(def.where) : null;
-        const allConditions = whereCondition != null ? [whereCondition, ...joinConditions] : joinConditions;
+        const whereCondition =
+          def.where != null && def.where.length > 0 ? this.expr.renderWhere(def.where) : null;
+        const allConditions =
+          whereCondition != null ? [whereCondition, ...joinConditions] : joinConditions;
         sql += ` WHERE ${allConditions.join(" AND ")}`;
       } else {
         sql += this.renderWhere(def.where);
@@ -340,7 +349,8 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
         : "TRUE";
 
     // OUTPUT 컬럼
-    const outputCols = def.output != null ? def.output.columns.map((c) => this.expr.wrap(c)).join(", ") : "*";
+    const outputCols =
+      def.output != null ? def.output.columns.map((c) => this.expr.wrap(c)).join(", ") : "*";
 
     // CTE 방식 UPSERT
     let sql = `WITH matched AS (\n`;
@@ -405,7 +415,9 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   }
 
   protected renameTable(def: RenameTableQueryDef): QueryBuildResult {
-    return { sql: `ALTER TABLE ${this.tableName(def.table)} RENAME TO ${this.expr.wrap(def.newName)}` };
+    return {
+      sql: `ALTER TABLE ${this.tableName(def.table)} RENAME TO ${this.expr.wrap(def.newName)}`,
+    };
   }
 
   protected truncate(def: TruncateQueryDef): QueryBuildResult {
@@ -442,7 +454,9 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   }
 
   protected dropColumn(def: DropColumnQueryDef): QueryBuildResult {
-    return { sql: `ALTER TABLE ${this.tableName(def.table)} DROP COLUMN ${this.expr.wrap(def.column)}` };
+    return {
+      sql: `ALTER TABLE ${this.tableName(def.table)} DROP COLUMN ${this.expr.wrap(def.column)}`,
+    };
   }
 
   protected modifyColumn(def: ModifyColumnQueryDef): QueryBuildResult {
@@ -453,7 +467,9 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
     const parts: string[] = [];
 
     // TYPE 변경
-    parts.push(`ALTER COLUMN ${this.expr.wrap(col.name)} TYPE ${this.expr.renderDataType(col.dataType)}`);
+    parts.push(
+      `ALTER COLUMN ${this.expr.wrap(col.name)} TYPE ${this.expr.renderDataType(col.dataType)}`,
+    );
 
     // NULL 변경
     if (col.nullable === false) {
@@ -464,7 +480,9 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
 
     // DEFAULT 변경
     if (col.default !== undefined) {
-      parts.push(`ALTER COLUMN ${this.expr.wrap(col.name)} SET DEFAULT ${this.expr.escapeValue(col.default)}`);
+      parts.push(
+        `ALTER COLUMN ${this.expr.wrap(col.name)} SET DEFAULT ${this.expr.escapeValue(col.default)}`,
+      );
     }
 
     return { sql: `ALTER TABLE ${table} ${parts.join(", ")}` };
@@ -485,7 +503,9 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
     const table = this.tableName(def.table);
     const cols = def.columns.map((c) => this.expr.wrap(c)).join(", ");
     const pkName = `PK_${def.table.name}`;
-    return { sql: `ALTER TABLE ${table} ADD CONSTRAINT ${this.expr.wrap(pkName)} PRIMARY KEY (${cols})` };
+    return {
+      sql: `ALTER TABLE ${table} ADD CONSTRAINT ${this.expr.wrap(pkName)} PRIMARY KEY (${cols})`,
+    };
   }
 
   protected dropPk(def: DropPkQueryDef): QueryBuildResult {
@@ -511,7 +531,9 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   }
 
   protected dropFk(def: DropFkQueryDef): QueryBuildResult {
-    return { sql: `ALTER TABLE ${this.tableName(def.table)} DROP CONSTRAINT ${this.expr.wrap(def.foreignKey)}` };
+    return {
+      sql: `ALTER TABLE ${this.tableName(def.table)} DROP CONSTRAINT ${this.expr.wrap(def.foreignKey)}`,
+    };
   }
 
   protected addIdx(def: AddIdxQueryDef): QueryBuildResult {

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

@@ -83,7 +83,9 @@ export class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends ColumnM
    * createdAt: c.datetime().default("CURRENT_TIMESTAMP")
    * ```
    */
-  default(value: TValue): ColumnBuilder<TValue, Omit<TMeta, "default"> & { default: typeof value }> {
+  default(
+    value: TValue,
+  ): ColumnBuilder<TValue, Omit<TMeta, "default"> & { default: typeof value }> {
     return new ColumnBuilder({ ...this.meta, default: value });
   }
 
@@ -196,7 +198,10 @@ export function createColumnFactory() {
     decimal(
       precision: number,
       scale?: number,
-    ): ColumnBuilder<number, { type: "number"; dataType: { type: "decimal"; precision: number; scale?: number } }> {
+    ): ColumnBuilder<
+      number,
+      { type: "number"; dataType: { type: "decimal"; precision: number; scale?: number } }
+    > {
       return new ColumnBuilder({ type: "number", dataType: { type: "decimal", precision, scale } });
     },
 
@@ -211,7 +216,9 @@ export function createColumnFactory() {
      * name: c.varchar(100)  // VARCHAR(100)
      * ```
      */
-    varchar(length: number): ColumnBuilder<string, { type: "string"; dataType: { type: "varchar"; length: number } }> {
+    varchar(
+      length: number,
+    ): ColumnBuilder<string, { type: "string"; dataType: { type: "varchar"; length: number } }> {
       return new ColumnBuilder({ type: "string", dataType: { type: "varchar", length } });
     },
 
@@ -226,7 +233,9 @@ export function createColumnFactory() {
      * countryCode: c.char(2)  // CHAR(2)
      * ```
      */
-    char(length: number): ColumnBuilder<string, { type: "string"; dataType: { type: "char"; length: number } }> {
+    char(
+      length: number,
+    ): ColumnBuilder<string, { type: "string"; dataType: { type: "char"; length: number } }> {
       return new ColumnBuilder({ type: "string", dataType: { type: "char" as const, length } });
     },
 
@@ -397,7 +406,9 @@ export type InferInsertColumns<TBuilders extends ColumnBuilderRecord> = Pick<
  *
  * @template T - 컬럼 빌더 레코드 타입
  */
-export type InferUpdateColumns<TBuilders extends ColumnBuilderRecord> = Partial<InferColumns<TBuilders>>;
+export type InferUpdateColumns<TBuilders extends ColumnBuilderRecord> = Partial<
+  InferColumns<TBuilders>
+>;
 
 /**
  * 데이터 레코드에서 컬럼 빌더 레코드로 변환

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

@@ -32,7 +32,10 @@ import type { ViewBuilder } from "../view-builder";
  * @see {@link ForeignKeyTargetBuilder} 역참조 빌더
  * @see {@link RelationKeyBuilder} DB FK 없는 관계
  */
-export class ForeignKeyBuilder<TOwner extends TableBuilder<any, any>, TTargetFn extends () => TableBuilder<any, any>> {
+export class ForeignKeyBuilder<
+  TOwner extends TableBuilder<any, any>,
+  TTargetFn extends () => TableBuilder<any, any>,
+> {
   /**
    * @param meta - FK 메타데이터
    * @param meta.ownerFn - 소유 테이블 팩토리
@@ -88,7 +91,10 @@ export class ForeignKeyBuilder<TOwner extends TableBuilder<any, any>, TTargetFn
  *
  * @see {@link ForeignKeyBuilder} FK 빌더
  */
-export class ForeignKeyTargetBuilder<TTargetTableFn extends () => TableBuilder<any, any>, TIsSingle extends boolean> {
+export class ForeignKeyTargetBuilder<
+  TTargetTableFn extends () => TableBuilder<any, any>,
+  TIsSingle extends boolean,
+> {
   /**
    * @param meta - FK 역참조 메타데이터
    * @param meta.targetTableFn - 참조하는 테이블 팩토리
@@ -294,7 +300,9 @@ type RelationRkFactory<
     targetFn: TTargetFn,
   ): RelationKeyBuilder<TOwner, TTargetFn>;
   /** 1:N 논리적 역참조 정의 */
-  relationKeyTarget<TTargetTableFn extends () => TableBuilder<any, any> | ViewBuilder<any, any, any>>(
+  relationKeyTarget<
+    TTargetTableFn extends () => TableBuilder<any, any> | ViewBuilder<any, any, any>,
+  >(
     targetTableFn: TTargetTableFn,
     relationName: string,
   ): RelationKeyTargetBuilder<TTargetTableFn, false>;
@@ -439,5 +447,7 @@ export type ExtractRelationTargetResult<TRelation> = TRelation extends
  * ```
  */
 export type InferDeepRelations<TRelations extends RelationBuilderRecord> = {
-  [K in keyof TRelations]?: ExtractRelationTarget<TRelations[K]> | ExtractRelationTargetResult<TRelations[K]>;
+  [K in keyof TRelations]?:
+    | ExtractRelationTarget<TRelations[K]>
+    | ExtractRelationTargetResult<TRelations[K]>;
 };

package/src/schema/procedure-builder.ts

@@ -40,7 +40,10 @@ import { type ColumnBuilderRecord, createColumnFactory } from "./factory/column-
  * @see {@link Procedure} 팩토리 함수
  * @see {@link executable} Executable 생성
  */
-export class ProcedureBuilder<TParams extends ColumnBuilderRecord, TReturns extends ColumnBuilderRecord> {
+export class ProcedureBuilder<
+  TParams extends ColumnBuilderRecord,
+  TReturns extends ColumnBuilderRecord,
+> {
   /** 파라미터 정의 (타입 추론용) */
   readonly $params!: TParams;
   /** 반환 타입 정의 (타입 추론용) */

package/src/schema/table-builder.ts

@@ -6,7 +6,11 @@ import {
   type InferUpdateColumns,
 } from "./factory/column-builder";
 import { createIndexFactory, type IndexBuilder } from "./factory/index-builder";
-import { createRelationFactory, type InferDeepRelations, type RelationBuilderRecord } from "./factory/relation-builder";
+import {
+  createRelationFactory,
+  type InferDeepRelations,
+  type RelationBuilderRecord,
+} from "./factory/relation-builder";
 
 // ============================================
 // TableBuilder
@@ -44,7 +48,10 @@ import { createRelationFactory, type InferDeepRelations, type RelationBuilderRec
  * @see {@link Table} 팩토리 함수
  * @see {@link queryable} Queryable 생성
  */
-export class TableBuilder<TColumns extends ColumnBuilderRecord, TRelations extends RelationBuilderRecord> {
+export class TableBuilder<
+  TColumns extends ColumnBuilderRecord,
+  TRelations extends RelationBuilderRecord,
+> {
   /** 컬럼 정의 (타입 추론용) */
   readonly $columns!: TColumns;
   /** 관계 정의 (타입 추론용) */
@@ -206,7 +213,11 @@ export class TableBuilder<TColumns extends ColumnBuilderRecord, TRelations exten
    *   ]);
    * ```
    */
-  indexes(fn: (i: ReturnType<typeof createIndexFactory<keyof TColumns & string>>) => IndexBuilder<string[]>[]) {
+  indexes(
+    fn: (
+      i: ReturnType<typeof createIndexFactory<keyof TColumns & string>>,
+    ) => IndexBuilder<string[]>[],
+  ) {
     return new TableBuilder({
       ...this.meta,
       indexes: fn(createIndexFactory<keyof TColumns & string>()),

package/src/schema/view-builder.ts

@@ -1,7 +1,11 @@
 import type { DbContextBase } from "../types/db-context-def";
 import type { Queryable } from "../exec/queryable";
 import type { DataRecord } from "../types/db";
-import { createRelationFactory, type InferDeepRelations, type RelationBuilderRecord } from "./factory/relation-builder";
+import {
+  createRelationFactory,
+  type InferDeepRelations,
+  type RelationBuilderRecord,
+} from "./factory/relation-builder";
 
 // ============================================
 // ViewBuilder

package/src/types/db-context-def.ts

@@ -20,8 +20,13 @@ export interface DbContextBase {
   readonly schema: string | undefined;
   getNextAlias(): string;
   resetAliasCounter(): void;
-  executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]>;
-  getQueryDefObjectName(tableOrView: TableBuilder<any, any> | ViewBuilder<any, any, any>): QueryDefObjectName;
+  executeDefs<T = DataRecord>(
+    defs: QueryDef[],
+    resultMetas?: (ResultMeta | undefined)[],
+  ): Promise<T[][]>;
+  getQueryDefObjectName(
+    tableOrView: TableBuilder<any, any> | ViewBuilder<any, any, any>,
+  ): QueryDefObjectName;
   switchFk(table: QueryDefObjectName, switch_: "on" | "off"): Promise<void>;
 }
 
@@ -92,13 +97,25 @@ export interface DbContextDdlMethods {
   dropView(view: QueryDefObjectName): Promise<void>;
   createProc(procedure: ProcedureBuilder<any, any>): Promise<void>;
   dropProc(procedure: QueryDefObjectName): Promise<void>;
-  addColumn(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): Promise<void>;
+  addColumn(
+    table: QueryDefObjectName,
+    columnName: string,
+    column: ColumnBuilder<any, any>,
+  ): Promise<void>;
   dropColumn(table: QueryDefObjectName, column: string): Promise<void>;
-  modifyColumn(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): Promise<void>;
+  modifyColumn(
+    table: QueryDefObjectName,
+    columnName: string,
+    column: ColumnBuilder<any, any>,
+  ): Promise<void>;
   renameColumn(table: QueryDefObjectName, column: string, newName: string): Promise<void>;
   addPk(table: QueryDefObjectName, columns: string[]): Promise<void>;
   dropPk(table: QueryDefObjectName): Promise<void>;
-  addFk(table: QueryDefObjectName, relationName: string, relationDef: ForeignKeyBuilder<any, any>): Promise<void>;
+  addFk(
+    table: QueryDefObjectName,
+    relationName: string,
+    relationDef: ForeignKeyBuilder<any, any>,
+  ): Promise<void>;
   addIdx(table: QueryDefObjectName, indexBuilder: IndexBuilder<string[]>): Promise<void>;
   dropFk(table: QueryDefObjectName, relationName: string): Promise<void>;
   dropIdx(table: QueryDefObjectName, columns: string[]): Promise<void>;
@@ -117,13 +134,25 @@ export interface DbContextDdlMethods {
   getRenameTableQueryDef(table: QueryDefObjectName, newName: string): QueryDef;
   getDropViewQueryDef(view: QueryDefObjectName): QueryDef;
   getDropProcQueryDef(procedure: QueryDefObjectName): QueryDef;
-  getAddColumnQueryDef(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): QueryDef;
+  getAddColumnQueryDef(
+    table: QueryDefObjectName,
+    columnName: string,
+    column: ColumnBuilder<any, any>,
+  ): QueryDef;
   getDropColumnQueryDef(table: QueryDefObjectName, column: string): QueryDef;
-  getModifyColumnQueryDef(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): QueryDef;
+  getModifyColumnQueryDef(
+    table: QueryDefObjectName,
+    columnName: string,
+    column: ColumnBuilder<any, any>,
+  ): QueryDef;
   getRenameColumnQueryDef(table: QueryDefObjectName, column: string, newName: string): QueryDef;
   getAddPkQueryDef(table: QueryDefObjectName, columns: string[]): QueryDef;
   getDropPkQueryDef(table: QueryDefObjectName): QueryDef;
-  getAddFkQueryDef(table: QueryDefObjectName, relationName: string, relationDef: ForeignKeyBuilder<any, any>): QueryDef;
+  getAddFkQueryDef(
+    table: QueryDefObjectName,
+    relationName: string,
+    relationDef: ForeignKeyBuilder<any, any>,
+  ): QueryDef;
   getAddIdxQueryDef(table: QueryDefObjectName, indexBuilder: IndexBuilder<string[]>): QueryDef;
   getDropFkQueryDef(table: QueryDefObjectName, relationName: string): QueryDef;
   getDropIdxQueryDef(table: QueryDefObjectName, columns: string[]): QueryDef;

package/src/types/db.ts

@@ -56,7 +56,11 @@ export interface QueryBuildResult {
  * - `REPEATABLE_READ`: 트랜잭션 내 동일 쿼리 동일 결과 보장
  * - `SERIALIZABLE`: 완전 직렬화 (가장 엄격)
  */
-export type IsolationLevel = "READ_UNCOMMITTED" | "READ_COMMITTED" | "REPEATABLE_READ" | "SERIALIZABLE";
+export type IsolationLevel =
+  | "READ_UNCOMMITTED"
+  | "READ_COMMITTED"
+  | "REPEATABLE_READ"
+  | "SERIALIZABLE";
 
 // ============================================
 // DataRecord - 결과 데이터 타입 (재귀적, 중첩 허용)
@@ -144,7 +148,10 @@ export interface DbContextExecutor {
    * @param resultMetas - 결과 변환을 위한 메타데이터 (선택)
    * @returns 각 QueryDef별 결과 배열의 배열
    */
-  executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]>;
+  executeDefs<T = DataRecord>(
+    defs: QueryDef[],
+    resultMetas?: (ResultMeta | undefined)[],
+  ): Promise<T[][]>;
 }
 
 /**

package/src/utils/result-parser.ts

@@ -273,7 +273,9 @@ function groupRecordsRecursively(
       return !key.includes(".");
     } else {
       // 하위 레벨: 현재 경로 + "." + 키
-      return key.startsWith(currentPath + ".") && key.slice(currentPath.length + 1).indexOf(".") === -1;
+      return (
+        key.startsWith(currentPath + ".") && key.slice(currentPath.length + 1).indexOf(".") === -1
+      );
     }
   });
 
@@ -375,7 +377,10 @@ function groupRecordsRecursively(
 /**
  * 레코드에서 JOIN 키를 제외한 그룹 키 추출
  */
-function extractGroupKey(record: Record<string, unknown>, joinKeys: string[]): Record<string, unknown> {
+function extractGroupKey(
+  record: Record<string, unknown>,
+  joinKeys: string[],
+): Record<string, unknown> {
   const result: Record<string, unknown> = {};
   for (const [key, value] of Object.entries(record)) {
     // JOIN 키가 아닌 것만 포함
@@ -433,7 +438,9 @@ function mergeJoinData(
         }
       } else {
         // hashSet이 없으면 폴백 (기존 방식)
-        const isDuplicate = existingJoinData.some((item) => objEqual(item as Record<string, unknown>, newJoinData));
+        const isDuplicate = existingJoinData.some((item) =>
+          objEqual(item as Record<string, unknown>, newJoinData),
+        );
         if (!isDuplicate) {
           existingJoinData.push(newJoinData);
         }