@simplysm/orm-node 13.0.100 → 14.0.1

package/dist/types/db-conn.js

@@ -1,19 +1,28 @@
-const DB_CONN_CONNECT_TIMEOUT = 10 * 1e3;
-const DB_CONN_DEFAULT_TIMEOUT = 10 * 60 * 1e3;
-const DB_CONN_ERRORS = {
-  NOT_CONNECTED: "'Connection' is not connected.",
-  ALREADY_CONNECTED: "'Connection' is already connected."
+// ============================================
+// 공통 상수
+// ============================================
+/**
+ * DB 연결 수립 타임아웃 (10초)
+ */
+export const DB_CONN_CONNECT_TIMEOUT = 10 * 1000;
+/**
+ * DB 쿼리 기본 타임아웃 (10분)
+ */
+export const DB_CONN_DEFAULT_TIMEOUT = 10 * 60 * 1000;
+/**
+ * DB 연결 오류 메시지
+ */
+export const DB_CONN_ERRORS = {
+    NOT_CONNECTED: "'Connection'이 연결되어 있지 않습니다.",
+    ALREADY_CONNECTED: "'Connection'이 이미 연결되어 있습니다.",
 };
-function getDialectFromConfig(config) {
-  if (config.dialect === "mssql-azure") {
-    return "mssql";
-  }
-  return config.dialect;
+/**
+ * DbConnConfig에서 Dialect를 추출한다
+ */
+export function getDialectFromConfig(config) {
+    if (config.dialect === "mssql-azure") {
+        return "mssql";
+    }
+    return config.dialect;
 }
-export {
-  DB_CONN_CONNECT_TIMEOUT,
-  DB_CONN_DEFAULT_TIMEOUT,
-  DB_CONN_ERRORS,
-  getDialectFromConfig
-};
-//# sourceMappingURL=db-conn.js.map
+//# sourceMappingURL=db-conn.js.map

package/dist/types/db-conn.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/types/db-conn.ts"],
-  "mappings": "AAUO,MAAM,0BAA0B,KAAK;AAKrC,MAAM,0BAA0B,KAAK,KAAK;AAK1C,MAAM,iBAAiB;AAAA,EAC5B,eAAe;AAAA,EACf,mBAAmB;AACrB;AAoJO,SAAS,qBAAqB,QAA+B;AAClE,MAAI,OAAO,YAAY,eAAe;AACpC,WAAO;AAAA,EACT;AACA,SAAO,OAAO;AAChB;",
-  "names": []
-}
+{"version":3,"file":"db-conn.js","sourceRoot":"","sources":["..\\..\\src\\types\\db-conn.ts"],"names":[],"mappings":"AAGA,+CAA+C;AAC/C,QAAQ;AACR,+CAA+C;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,aAAa,EAAE,6BAA6B;IAC5C,iBAAiB,EAAE,6BAA6B;CACxC,CAAC;AAiJX;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,IAAI,MAAM,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@simplysm/orm-node",
-  "version": "13.0.100",
-  "description": "Simplysm package - ORM module (node)",
-  "author": "simplysm",
+  "version": "14.0.1",
+  "description": "심플리즘 패키지 - ORM (node)",
+  "author": "심플리즘",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -19,8 +19,8 @@
   "sideEffects": false,
   "dependencies": {
     "consola": "^3.4.2",
-    "@simplysm/core-common": "13.0.100",
-    "@simplysm/orm-common": "13.0.100"
+    "@simplysm/core-common": "14.0.1",
+    "@simplysm/orm-common": "14.0.1"
   },
   "devDependencies": {
     "@types/pg": "^8.20.0",
@@ -31,10 +31,10 @@
     "tedious": "^19.2.1"
   },
   "peerDependencies": {
-    "mysql2": "^3.16.0",
-    "pg": "^8.16.3",
-    "pg-copy-streams": "^7.0.0",
-    "tedious": "^19.2.0"
+    "mysql2": "^3",
+    "pg": "^8",
+    "pg-copy-streams": "^7",
+    "tedious": "^19"
   },
   "peerDependenciesMeta": {
     "mysql2": {

package/src/connections/mssql-db-conn.ts

@@ -24,9 +24,9 @@ import type { DataType as TediousDataType } from "tedious/lib/data-type";
 const logger = consola.withTag("mssql-db-conn");
 
 /**
- * MSSQL database connection class
+ * MSSQL 데이터베이스 연결 클래스
  *
- * Manages MSSQL/Azure SQL connections using the tedious library.
+ * tedious 라이브러리를 사용하여 MSSQL/Azure SQL 연결을 관리한다.
  */
 export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn {
   private readonly _timeout = DB_CONN_DEFAULT_TIMEOUT;
@@ -72,15 +72,15 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
     });
 
     conn.on("infoMessage", (info) => {
-      logger.debug("info", info.message);
+      logger.debug("정보", info.message);
     });
 
     conn.on("errorMessage", (error) => {
-      logger.error("errorMessage", error.message);
+      logger.error("오류 메시지", error.message);
     });
 
     conn.on("error", (error) => {
-      logger.error("error", error.message);
+      logger.error("오류", error.message);
     });
 
     conn.on("end", () => {
@@ -114,11 +114,11 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
 
     const conn = this._conn;
 
-    // Cancel in-progress requests
+    // 진행 중인 요청 취소
     conn.cancel();
     await wait.until(() => this._requests.length < 1, 30000, 100);
 
-    // Wait for connection termination
+    // 연결 종료 대기
     await new Promise<void>((resolve) => {
       conn.on("end", () => {
         wait.until(() => this._conn == null, 30000, 100)
@@ -213,7 +213,7 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
 
     const results: Record<string, unknown>[][] = [];
 
-    logger.debug("Query execution", { queryLength: query.length, params });
+    logger.debug("쿼리 실행", { queryLength: query.length, params });
     await new Promise<void>((resolve, reject) => {
       let rejected = false;
       const queryRequest = new this._tedious.Request(query, (err) => {
@@ -223,17 +223,17 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
 
           const errCode = "code" in err ? err.code : undefined;
           if (errCode === "ECANCEL") {
-            reject(new SdError(err, "Query was cancelled."));
+            reject(new SdError(err, "쿼리가 취소되었습니다."));
           } else {
             const lineNumber = "lineNumber" in err && typeof err.lineNumber === "number" ? err.lineNumber : undefined;
             if (lineNumber != null && lineNumber > 0) {
               const splitQuery = query.split("\n");
               splitQuery[lineNumber - 1] = "==> " + splitQuery[lineNumber - 1];
               reject(
-                new SdError(err, `Error executing query\n-- query\n${splitQuery.join("\n")}\n--`),
+                new SdError(err, `쿼리 실행 오류\n-- query\n${splitQuery.join("\n")}\n--`),
               );
             } else {
-              reject(new SdError(err, `Error executing query\n-- query\n${query}\n--`));
+              reject(new SdError(err, `쿼리 실행 오류\n-- query\n${query}\n--`));
             }
           }
         }
@@ -267,7 +267,7 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
 
           rejected = true;
           this._requests = this._requests.filter((r) => r !== queryRequest);
-          reject(new SdError(err, `Error executing query\n-- query\n${query}\n--`));
+          reject(new SdError(err, `쿼리 실행 오류\n-- query\n${query}\n--`));
         })
         .on("requestCompleted", () => {
           this._startTimeout();
@@ -320,7 +320,7 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
           reject(
             new SdError(
               err,
-              `Bulk Insert error\n${json.stringify(tediousColumnDefs)}\n-- data\n${json.stringify(records).substring(0, 10000)}...\n--`,
+              `Bulk Insert 오류\n${json.stringify(tediousColumnDefs)}\n-- data\n${json.stringify(records).substring(0, 10000)}...\n--`,
             ),
           );
           return;
@@ -334,7 +334,7 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
         bulkLoad.addColumn(tediousColumnDef.name, tediousColumnDef.type, tediousColumnDef.options);
       }
 
-      // Convert records to row arrays (maintain column order, include value conversion)
+      // 레코드를 행 배열로 변환 (컬럼 순서 유지, 값 변환 포함)
       const rows = records.map((record) =>
         colNames.map((colName) => {
           const val = record[colName];
@@ -353,7 +353,7 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
   }
 
   // ─────────────────────────────────────────────
-  // Private helpers
+  // 내부 헬퍼
   // ─────────────────────────────────────────────
 
   private _assertConnected(): void {
@@ -391,7 +391,7 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
     this._stopTimeout();
     this._connTimeout = setTimeout(() => {
       this.close().catch((err) => {
-        logger.error("close error", err instanceof Error ? err.message : String(err));
+        logger.error("연결 종료 오류", err instanceof Error ? err.message : String(err));
       });
     }, this._timeout * 2);
   }
@@ -457,19 +457,19 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
       case "uuid":
         return { type: this._tedious.TYPES.UniqueIdentifier };
       default:
-        throw new SdError(`Unsupported DataType: ${JSON.stringify(dataType)}`);
+        throw new SdError(`지원하지 않는 DataType: ${JSON.stringify(dataType)}`);
     }
   }
 
   /**
-   * Infer the type of a value and return Tedious data type
+   * 값의 타입을 추론하여 Tedious 데이터 타입을 반환한다
    *
-   * @param value - Value whose type is to be inferred (error if null/undefined is passed)
-   * @throws Error if null/undefined is passed
+   * @param value - 타입을 추론할 값 (null/undefined 전달 시 오류 발생)
+   * @throws null/undefined 전달 시 오류
    */
   private _guessTediousType(value: unknown): TediousDataType {
     if (value == null) {
-      throw new SdError("_guessTediousType: null/undefined values are not supported.");
+      throw new SdError("_guessTediousType: null/undefined 값은 지원하지 않습니다.");
     }
     if (typeof value === "string") {
       return this._tedious.TYPES.NVarChar;
@@ -484,7 +484,7 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
     if (value instanceof Uuid) return this._tedious.TYPES.UniqueIdentifier;
     if (value instanceof Uint8Array) return this._tedious.TYPES.VarBinary;
 
-    throw new SdError(`Unknown value type: ${typeof value}`);
+    throw new SdError(`알 수 없는 값 타입: ${typeof value}`);
   }
 }
 

package/src/connections/mysql-db-conn.ts

@@ -25,9 +25,9 @@ import {
 const logger = consola.withTag("mysql-db-conn");
 
 /**
- * MySQL database connection class
+ * MySQL 데이터베이스 연결 클래스
  *
- * Manages MySQL connections using the mysql2/promise library.
+ * mysql2/promise 라이브러리를 사용하여 MySQL 연결을 관리한다.
  */
 export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn {
   private static readonly _ROOT_USER = "root";
@@ -56,12 +56,12 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
       port: this.config.port,
       user: this.config.username,
       password: this.config.password,
-      // Root user connects without binding to specific database
-      // to allow access to all databases (for admin operations)
+      // root 사용자는 특정 데이터베이스에 바인딩하지 않고 연결
+      // 모든 데이터베이스에 접근할 수 있도록 (관리 작업용)
       database: this.config.username === MysqlDbConn._ROOT_USER ? undefined : this.config.database,
       multipleStatements: true,
       charset: "utf8mb4",
-      infileStreamFactory: (filePath: string) => fs.createReadStream(filePath), // Support for LOAD DATA LOCAL INFILE
+      infileStreamFactory: (filePath: string) => fs.createReadStream(filePath), // LOAD DATA LOCAL INFILE 지원
     } as Parameters<typeof this._mysql2.createConnection>[0]);
 
     conn.on("end", () => {
@@ -70,7 +70,7 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
     });
 
     conn.on("error", (error) => {
-      logger.error("DB connection error", error.message);
+      logger.error("DB 연결 오류", error.message);
     });
 
     this._conn = conn;
@@ -100,13 +100,13 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
       "READ_UNCOMMITTED"
     ).replace(/_/g, " ");
 
-    // Set isolation level first (applies to next transaction)
+    // 격리 수준을 먼저 설정 (다음 트랜잭션에 적용)
     await conn.query({
       sql: `SET SESSION TRANSACTION ISOLATION LEVEL ${level}`,
       timeout: this._timeout,
     });
 
-    // Then start transaction
+    // 그 후 트랜잭션 시작
     await conn.beginTransaction();
 
     this.isInTransaction = true;
@@ -139,7 +139,7 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
   ): Promise<Record<string, unknown>[][]> {
     const conn = this._assertConnected();
 
-    logger.debug("Query execution", { queryLength: query.length, params });
+    logger.debug("쿼리 실행", { queryLength: query.length, params });
 
     try {
       const [queryResults] = await conn.query({
@@ -150,9 +150,9 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
 
       this._startTimeout();
 
-      // MySQL returns ResultSetHeader for INSERT/UPDATE/DELETE statements
-      // Filter ResultSetHeader objects to extract only SELECT results
-      // ResultSetHeader has fields like affectedRows, fieldCount, etc.
+      // MySQL은 INSERT/UPDATE/DELETE 문에 대해 ResultSetHeader를 반환한다
+      // ResultSetHeader 객체를 필터링하여 SELECT 결과만 추출
+      // ResultSetHeader에는 affectedRows, fieldCount 등의 필드가 있다
       const result: Record<string, unknown>[] = [];
       if (queryResults instanceof Array) {
         for (const queryResult of queryResults.filter(
@@ -174,7 +174,7 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
       const error = err as Error & { sql?: string };
       throw new SdError(
         error,
-        "Error executing query" +
+        "쿼리 실행 오류" +
           (error.sql != null ? "\n-- query\n" + error.sql.trim() + "\n--" : ""),
       );
     }
@@ -191,12 +191,12 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
 
     const colNames = Object.keys(columnMetas);
 
-    // Create temporary CSV file
+    // 임시 CSV 파일 생성
     const tmpDir = os.tmpdir();
     const tmpFile = path.join(tmpDir, `mysql_bulk_${randomUUID()}.csv`);
 
     try {
-      // Generate CSV data
+      // CSV 데이터 생성
       const csvLines: string[] = [];
       for (const record of records) {
         const row = colNames.map((colName) =>
@@ -206,10 +206,10 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
       }
       const csvContent = csvLines.join("\n");
 
-      // Write file
+      // 파일 쓰기
       await fs.promises.writeFile(tmpFile, csvContent, "utf8");
 
-      // UUID/binary columns are read as temporary variables and converted with UNHEX() in SET clause
+      // UUID/binary 컬럼은 임시 변수로 읽어들인 후 SET 절에서 UNHEX()로 변환
       const binaryColNames = colNames.filter((c) => {
         const dt = columnMetas[c].dataType.type;
         return dt === "uuid" || dt === "binary";
@@ -220,7 +220,7 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
       });
       const setClauses = binaryColNames.map((c) => `\`${c}\` = UNHEX(@_${c})`);
 
-      // Execute LOAD DATA LOCAL INFILE
+      // LOAD DATA LOCAL INFILE 실행
       let query = `LOAD DATA LOCAL INFILE ? INTO TABLE ${tableName} FIELDS TERMINATED BY '\\t' LINES TERMINATED BY '\\n' (${normalCols.join(", ")})`;
       if (setClauses.length > 0) {
         query += ` SET ${setClauses.join(", ")}`;
@@ -228,25 +228,25 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
 
       await conn.query({ sql: query, timeout: this._timeout, values: [tmpFile] });
     } finally {
-      // Delete temporary file
+      // 임시 파일 삭제
       try {
         await fs.promises.unlink(tmpFile);
       } catch {
-        // Ignore deletion failure
+        // 삭제 실패 무시
       }
     }
   }
 
   // ─────────────────────────────────────────────
-  // Private helpers
+  // 내부 헬퍼
   // ─────────────────────────────────────────────
 
   /**
-   * Escape value for MySQL LOAD DATA INFILE
+   * MySQL LOAD DATA INFILE용 값 이스케이프
    */
   private _escapeForCsv(value: unknown, dataType: DataType): string {
     if (value == null) {
-      return "\\N"; // MySQL NULL representation
+      return "\\N"; // MySQL NULL 표현
     }
 
     switch (dataType.type) {
@@ -264,7 +264,7 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
       case "char":
       case "text": {
         const strVal = value as string;
-        // Escape tab, newline, backslash
+        // 탭, 줄바꿈, 백슬래시 이스케이프
         return strVal
           .replace(/\\/g, "\\\\")
           .replace(/\0/g, "\\0")
@@ -283,13 +283,13 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
         return (value as Time).toFormatString("HH:mm:ss");
 
       case "uuid":
-        return (value as Uuid).toString().replace(/-/g, ""); // Hex for BINARY(16) storage
+        return (value as Uuid).toString().replace(/-/g, ""); // BINARY(16) 저장용 Hex
 
       case "binary":
         return bytes.toHex(value as Uint8Array);
 
       default:
-        throw new SdError(`Unsupported DataType: ${JSON.stringify(dataType)}`);
+        throw new SdError(`지원하지 않는 DataType: ${JSON.stringify(dataType)}`);
     }
   }
 
@@ -317,7 +317,7 @@ export class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn
     this._stopTimeout();
     this._connTimeout = setTimeout(() => {
       this.close().catch((err) => {
-        logger.error("close error", err instanceof Error ? err.message : String(err));
+        logger.error("연결 종료 오류", err instanceof Error ? err.message : String(err));
       });
     }, this._timeout * 2);
   }

package/src/connections/postgresql-db-conn.ts

@@ -23,9 +23,9 @@ import type { Client } from "pg";
 const logger = consola.withTag("postgresql-db-conn");
 
 /**
- * PostgreSQL database connection class
+ * PostgreSQL 데이터베이스 연결 클래스
  *
- * Manages PostgreSQL connections using the pg library.
+ * pg 라이브러리를 사용하여 PostgreSQL 연결을 관리한다.
  */
 export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements DbConn {
   private readonly _timeout = DB_CONN_DEFAULT_TIMEOUT;
@@ -65,7 +65,7 @@ export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements D
     });
 
     client.on("error", (error) => {
-      logger.error("DB connection error", error.message);
+      logger.error("DB 연결 오류", error.message);
     });
 
     await client.connect();
@@ -130,19 +130,19 @@ export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements D
   ): Promise<Record<string, unknown>[][]> {
     this._assertConnected();
 
-    logger.debug("Query execution", { queryLength: query.length, params });
+    logger.debug("쿼리 실행", { queryLength: query.length, params });
 
     try {
       const result = await this._client!.query(query, params);
 
       this._startTimeout();
 
-      // PostgreSQL returns a single result set
+      // PostgreSQL은 단일 결과 집합을 반환한다
       return [result.rows];
     } catch (err) {
       this._startTimeout();
       const error = err instanceof Error ? err : new Error(String(err));
-      throw new SdError(error, "Error executing query\n-- query\n" + query.trim() + "\n--");
+      throw new SdError(error, "쿼리 실행 오류\n-- query\n" + query.trim() + "\n--");
     }
   }
 
@@ -158,11 +158,11 @@ export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements D
     const colNames = Object.keys(columnMetas);
     const wrappedCols = colNames.map((c) => `"${c}"`).join(", ");
 
-    // Create COPY FROM STDIN stream
+    // COPY FROM STDIN 스트림 생성
     const copyQuery = `COPY ${tableName} (${wrappedCols}) FROM STDIN WITH (FORMAT csv, NULL '\\N')`;
     const stream = this._client!.query(this._pgCopyStreams.from(copyQuery));
 
-    // Generate CSV data
+    // CSV 데이터 생성
     const csvLines: string[] = [];
     for (const record of records) {
       const row = colNames.map((colName) =>
@@ -172,7 +172,7 @@ export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements D
     }
     const csvContent = csvLines.join("\n") + "\n";
 
-    // Send data via stream
+    // 스트림을 통해 데이터 전송
     await new Promise<void>((resolve, reject) => {
       const readable = Readable.from([csvContent]);
 
@@ -185,15 +185,15 @@ export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements D
   }
 
   // ─────────────────────────────────────────────
-  // Private helpers
+  // 내부 헬퍼
   // ─────────────────────────────────────────────
 
   /**
-   * Escape value for PostgreSQL COPY CSV
+   * PostgreSQL COPY CSV용 값 이스케이프
    */
   private _escapeForCsv(value: unknown, dataType: DataType): string {
     if (value == null) {
-      return "\\N"; // NULL representation
+      return "\\N"; // NULL 표현
     }
 
     switch (dataType.type) {
@@ -211,7 +211,7 @@ export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements D
       case "char":
       case "text": {
         const strVal = value as string;
-        // CSV format: wrap with double quotes, escape internal double quotes with double quotes
+        // CSV 형식: 큰따옴표로 감싸고, 내부 큰따옴표는 이중 큰따옴표로 이스케이프
         if (
           strVal.includes('"') ||
           strVal.includes(",") ||
@@ -237,10 +237,10 @@ export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements D
         return (value as Uuid).toString();
 
       case "binary":
-        return '"\\x' + bytes.toHex(value as Uint8Array) + '"'; // PostgreSQL bytea hex format (wrapped in CSV double quotes)
+        return '"\\x' + bytes.toHex(value as Uint8Array) + '"'; // PostgreSQL bytea hex 형식 (CSV 큰따옴표로 감쌈)
 
       default:
-        throw new SdError(`Unsupported DataType: ${JSON.stringify(dataType)}`);
+        throw new SdError(`지원하지 않는 DataType: ${JSON.stringify(dataType)}`);
     }
   }
 
@@ -267,7 +267,7 @@ export class PostgresqlDbConn extends EventEmitter<{ close: void }> implements D
     this._stopTimeout();
     this._connTimeout = setTimeout(() => {
       this.close().catch((err) => {
-        logger.error("close error", err instanceof Error ? err.message : String(err));
+        logger.error("연결 종료 오류", err instanceof Error ? err.message : String(err));
       });
     }, this._timeout * 2);
   }

package/src/create-db-conn.ts

@@ -4,13 +4,13 @@ import { MssqlDbConn } from "./connections/mssql-db-conn";
 import { PostgresqlDbConn } from "./connections/postgresql-db-conn";
 
 /**
- * DB connection factory
+ * DB 연결 팩토리
  *
- * Creates database connection instances.
- * Supports MSSQL, MySQL, and PostgreSQL.
+ * 데이터베이스 연결 인스턴스를 생성한다.
+ * MSSQL, MySQL, PostgreSQL을 지원한다.
  */
 
-// Lazy-loaded module cache
+// 지연 로딩 모듈 캐시
 const modules: {
   tedious?: typeof import("tedious");
   mysql?: typeof import("mysql2/promise");
@@ -19,10 +19,10 @@ const modules: {
 } = {};
 
 /**
- * Create DB connection
+ * DB 연결 생성
  *
- * @param config - Database connection configuration
- * @returns DB connection object (not yet connected — call connect() separately)
+ * @param config - 데이터베이스 연결 설정
+ * @returns DB 연결 객체 (아직 연결되지 않음 - connect()를 별도로 호출해야 함)
  */
 export async function createDbConn(config: DbConnConfig): Promise<DbConn> {
   if (config.dialect === "mysql") {