@simplysm/orm-node 13.0.69 → 13.0.71

package/dist/pooled-db-conn.d.ts

@@ -3,10 +3,10 @@ import type { Pool } from "generic-pool";
 import type { ColumnMeta, IsolationLevel } from "@simplysm/orm-common";
 import { type DbConn, type DbConnConfig } from "./types/db-conn";
 /**
- * 커넥션 풀에서 관리되는 DB 연결 래퍼
+ * DB connection wrapper managed by connection pool
  *
- * generic-pool 라이브러리를 사용하여 커넥션 풀링을 지원한다.
- * 실제 물리 연결은 풀에서 획득하고 반환한다.
+ * Supports connection pooling using the generic-pool library.
+ * Acquires and returns actual physical connections from/to the pool.
  */
 export declare class PooledDbConn extends EventEmitter<{
     close: void;
@@ -20,59 +20,59 @@ export declare class PooledDbConn extends EventEmitter<{
     get isConnected(): boolean;
     get isInTransaction(): boolean;
     /**
-     * 풀에서 DB 연결을 획득한다.
+     * Acquire DB connection from pool
      *
-     * @throws {SdError} 이미 연결된 상태일 때
+     * @throws {SdError} When already connected
      */
     connect(): Promise<void>;
     /**
-     * 풀에 DB 연결을 반환한다. (실제 연결을 종료하지 않음)
+     * Return DB connection to pool (does not terminate actual connection)
      */
     close(): Promise<void>;
     private readonly _onRawConnClose;
     /**
-     * 트랜잭션 시작
+     * Begin transaction
      *
-     * @param isolationLevel - 트랜잭션 격리 수준
-     * @throws {SdError} 연결이 획득되지 않은 상태일 때
+     * @param isolationLevel - Transaction isolation level
+     * @throws {SdError} When connection is not acquired
      */
     beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;
     /**
-     * 트랜잭션 커밋
+     * Commit transaction
      *
-     * @throws {SdError} 연결이 획득되지 않은 상태일 때
+     * @throws {SdError} When connection is not acquired
      */
     commitTransaction(): Promise<void>;
     /**
-     * 트랜잭션 롤백
+     * Rollback transaction
      *
-     * @throws {SdError} 연결이 획득되지 않은 상태일 때
+     * @throws {SdError} When connection is not acquired
      */
     rollbackTransaction(): Promise<void>;
     /**
-     * SQL 쿼리 실행
+     * Execute SQL query
      *
-     * @param queries - 실행할 SQL 쿼리 배열
-     * @returns 각 쿼리의 결과 배열
-     * @throws {SdError} 연결이 획득되지 않은 상태일 때
+     * @param queries - SQL query array to execute
+     * @returns Result array for each query
+     * @throws {SdError} When connection is not acquired
      */
     execute(queries: string[]): Promise<Record<string, unknown>[][]>;
     /**
-     * 파라미터화된 SQL 쿼리 실행
+     * Execute parameterized SQL query
      *
-     * @param query - SQL 쿼리 문자열
-     * @param params - 쿼리 파라미터 배열
-     * @returns 쿼리 결과 배열
-     * @throws {SdError} 연결이 획득되지 않은 상태일 때
+     * @param query - SQL query string
+     * @param params - Query parameter array
+     * @returns Query result array
+     * @throws {SdError} When connection is not acquired
      */
     executeParametrized(query: string, params?: unknown[]): Promise<Record<string, unknown>[][]>;
     /**
-     * 대량 데이터 삽입 (네이티브 벌크 API 사용)
+     * Bulk insert data (using native bulk API)
      *
-     * @param tableName - 대상 테이블명
-     * @param columnMetas - 컬럼 메타데이터
-     * @param records - 삽입할 레코드 배열
-     * @throws {SdError} 연결이 획득되지 않은 상태일 때
+     * @param tableName - Target table name
+     * @param columnMetas - Column metadata
+     * @param records - Record array to insert
+     * @throws {SdError} When connection is not acquired
      */
     bulkInsert(tableName: string, columnMetas: Record<string, ColumnMeta>, records: Record<string, unknown>[]): Promise<void>;
     private _requireRawConn;

package/dist/pooled-db-conn.js

@@ -9,7 +9,7 @@ class PooledDbConn extends EventEmitter {
     this._initialConfig = _initialConfig;
     this._getLastCreateError = _getLastCreateError;
   }
-  // 풀에서 빌려온 실제 물리 커넥션
+  // Actual physical connection borrowed from pool
   _rawConn;
   // [Property] config
   get config() {
@@ -24,9 +24,9 @@ class PooledDbConn extends EventEmitter {
     return this._rawConn?.isInTransaction ?? false;
   }
   /**
-   * 풀에서 DB 연결을 획득한다.
+   * Acquire DB connection from pool
    *
-   * @throws {SdError} 이미 연결된 상태일 때
+   * @throws {SdError} When already connected
    */
   async connect() {
     if (this._rawConn != null) {
@@ -39,13 +39,13 @@ class PooledDbConn extends EventEmitter {
       const cause = this._getLastCreateError?.() ?? (err instanceof Error ? err : void 0);
       throw new SdError(
         ...cause != null ? [cause] : [],
-        `DB \uC5F0\uACB0 \uC2E4\uD328 [${dialect}://${host}:${port ?? ""}/${database ?? ""}]`
+        `DB connection failed [${dialect}://${host}:${port ?? ""}/${database ?? ""}]`
       );
     }
     this._rawConn.on("close", this._onRawConnClose);
   }
   /**
-   * 풀에 DB 연결을 반환한다. (실제 연결을 종료하지 않음)
+   * Return DB connection to pool (does not terminate actual connection)
    */
   async close() {
     if (this._rawConn != null) {
@@ -53,7 +53,7 @@ class PooledDbConn extends EventEmitter {
         try {
           await this._rawConn.rollbackTransaction();
         } catch (err) {
-          logger.warn("\uD480 \uBC18\uD658 \uC2DC \uB864\uBC31 \uC2E4\uD328", err instanceof Error ? err.message : String(err));
+          logger.warn("Rollback failed when returning to pool", err instanceof Error ? err.message : String(err));
         }
       }
       this._rawConn.off("close", this._onRawConnClose);
@@ -62,70 +62,70 @@ class PooledDbConn extends EventEmitter {
       this.emit("close");
     }
   }
-  // 물리 연결이 끊겼을 때 처리 핸들러
+  // Handler for physical connection loss
   _onRawConnClose = () => {
     this._rawConn = void 0;
     this.emit("close");
   };
-  // --- 아래는 위임(Delegation) 메소드 ---
+  // --- Below are delegation methods ---
   /**
-   * 트랜잭션 시작
+   * Begin transaction
    *
-   * @param isolationLevel - 트랜잭션 격리 수준
-   * @throws {SdError} 연결이 획득되지 않은 상태일 때
+   * @param isolationLevel - Transaction isolation level
+   * @throws {SdError} When connection is not acquired
    */
   async beginTransaction(isolationLevel) {
     const conn = this._requireRawConn();
     await conn.beginTransaction(isolationLevel);
   }
   /**
-   * 트랜잭션 커밋
+   * Commit transaction
    *
-   * @throws {SdError} 연결이 획득되지 않은 상태일 때
+   * @throws {SdError} When connection is not acquired
    */
   async commitTransaction() {
     const conn = this._requireRawConn();
     await conn.commitTransaction();
   }
   /**
-   * 트랜잭션 롤백
+   * Rollback transaction
    *
-   * @throws {SdError} 연결이 획득되지 않은 상태일 때
+   * @throws {SdError} When connection is not acquired
    */
   async rollbackTransaction() {
     const conn = this._requireRawConn();
     await conn.rollbackTransaction();
   }
   /**
-   * SQL 쿼리 실행
+   * Execute SQL query
    *
-   * @param queries - 실행할 SQL 쿼리 배열
-   * @returns 각 쿼리의 결과 배열
-   * @throws {SdError} 연결이 획득되지 않은 상태일 때
+   * @param queries - SQL query array to execute
+   * @returns Result array for each query
+   * @throws {SdError} When connection is not acquired
    */
   async execute(queries) {
     const conn = this._requireRawConn();
     return conn.execute(queries);
   }
   /**
-   * 파라미터화된 SQL 쿼리 실행
+   * Execute parameterized SQL query
    *
-   * @param query - SQL 쿼리 문자열
-   * @param params - 쿼리 파라미터 배열
-   * @returns 쿼리 결과 배열
-   * @throws {SdError} 연결이 획득되지 않은 상태일 때
+   * @param query - SQL query string
+   * @param params - Query parameter array
+   * @returns Query result array
+   * @throws {SdError} When connection is not acquired
    */
   async executeParametrized(query, params) {
     const conn = this._requireRawConn();
     return conn.executeParametrized(query, params);
   }
   /**
-   * 대량 데이터 삽입 (네이티브 벌크 API 사용)
+   * Bulk insert data (using native bulk API)
    *
-   * @param tableName - 대상 테이블명
-   * @param columnMetas - 컬럼 메타데이터
-   * @param records - 삽입할 레코드 배열
-   * @throws {SdError} 연결이 획득되지 않은 상태일 때
+   * @param tableName - Target table name
+   * @param columnMetas - Column metadata
+   * @param records - Record array to insert
+   * @throws {SdError} When connection is not acquired
    */
   async bulkInsert(tableName, columnMetas, records) {
     const conn = this._requireRawConn();

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/pooled-db-conn.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/types/db-conn.d.ts

@@ -1,122 +1,122 @@
 import type { EventEmitter } from "@simplysm/core-common";
 import type { ColumnMeta, Dialect, IsolationLevel } from "@simplysm/orm-common";
 /**
- * DB 연결 수립 타임아웃 (10초)
+ * DB connection establishment timeout (10 seconds)
  */
 export declare const DB_CONN_CONNECT_TIMEOUT: number;
 /**
- * DB 쿼리 기본 타임아웃 (10분)
+ * DB query default timeout (10 minutes)
  */
 export declare const DB_CONN_DEFAULT_TIMEOUT: number;
 /**
- * DB 연결 에러 메시지
+ * DB connection error messages
  */
 export declare const DB_CONN_ERRORS: {
-    readonly NOT_CONNECTED: "'Connection'이 연결되어있지 않습니다.";
-    readonly ALREADY_CONNECTED: "이미 'Connection'이 연결되어있습니다.";
+    readonly NOT_CONNECTED: "'Connection' is not connected.";
+    readonly ALREADY_CONNECTED: "'Connection' is already connected.";
 };
 /**
- * 저수준 DB 연결 인터페이스
+ * Low-level DB connection interface
  *
- * 각 DBMS별 구현체가 이 인터페이스를 구현합니다.
- * - {@link MysqlDbConn} - MySQL 연결
- * - {@link MssqlDbConn} - MSSQL 연결
- * - {@link PostgresqlDbConn} - PostgreSQL 연결
+ * Implementations for each DBMS implement this interface.
+ * - {@link MysqlDbConn} - MySQL connection
+ * - {@link MssqlDbConn} - MSSQL connection
+ * - {@link PostgresqlDbConn} - PostgreSQL connection
  *
  * @remarks
- * SdEventEmitter를 상속하여 'close' 이벤트를 발생시킵니다.
+ * Inherits from EventEmitter and emits 'close' events.
  */
 export interface DbConn extends EventEmitter<{
     close: void;
 }> {
     /**
-     * 연결 설정
+     * Connection configuration
      */
     config: DbConnConfig;
     /**
-     * 연결 여부
+     * Whether connected
      */
     isConnected: boolean;
     /**
-     * 트랜잭션 진행 여부
+     * Whether transaction is in progress
      */
     isInTransaction: boolean;
     /**
-     * DB 연결 수립
+     * Establish DB connection
      */
     connect(): Promise<void>;
     /**
-     * DB 연결 종료
+     * Close DB connection
      */
     close(): Promise<void>;
     /**
-     * 트랜잭션 시작
+     * Begin transaction
      *
-     * @param isolationLevel - 격리 수준 (선택)
+     * @param isolationLevel - Isolation level (optional)
      */
     beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;
     /**
-     * 트랜잭션 커밋
+     * Commit transaction
      */
     commitTransaction(): Promise<void>;
     /**
-     * 트랜잭션 롤백
+     * Rollback transaction
      */
     rollbackTransaction(): Promise<void>;
     /**
-     * SQL 쿼리 배열 실행
+     * Execute SQL query array
      *
-     * @param queries - 실행할 SQL 문자열 배열
-     * @returns 각 쿼리별 결과 배열의 배열
+     * @param queries - SQL string array to execute
+     * @returns Array of result arrays for each query
      */
     execute(queries: string[]): Promise<Record<string, unknown>[][]>;
     /**
-     * 파라미터화된 쿼리 실행
+     * Execute parameterized query
      *
-     * @param query - SQL 쿼리 문자열
-     * @param params - 바인딩 파라미터 (선택)
-     * @returns 결과 배열의 배열
+     * @param query - SQL query string
+     * @param params - Binding parameters (optional)
+     * @returns Array of result arrays
      */
     executeParametrized(query: string, params?: unknown[]): Promise<Record<string, unknown>[][]>;
     /**
-     * 대량 INSERT (네이티브 벌크 API 사용)
+     * Bulk INSERT (using native bulk API)
      *
      * - MSSQL: tedious BulkLoad
-     * - MySQL: LOAD DATA LOCAL INFILE (임시 파일)
+     * - MySQL: LOAD DATA LOCAL INFILE (temporary file)
      * - PostgreSQL: COPY FROM STDIN
      *
-     * @param tableName - 테이블명 (database.table 또는 database.schema.table)
-     * @param columnMetas - 컬럼명 → ColumnMeta 매핑
-     * @param records - 삽입할 레코드 배열
+     * @param tableName - Table name (database.table or database.schema.table)
+     * @param columnMetas - Column name → ColumnMeta mapping
+     * @param records - Record array to insert
      */
     bulkInsert(tableName: string, columnMetas: Record<string, ColumnMeta>, records: Record<string, unknown>[]): Promise<void>;
 }
 /**
- * 커넥션 풀 설정
+ * Connection pool configuration
  *
  * @remarks
- * 각 값의 기본값:
- * - min: 1 (최소 연결 수)
- * - max: 10 (최대 연결 수)
- * - acquireTimeoutMillis: 30000 (연결 획득 타임아웃)
- * - idleTimeoutMillis: 30000 (유휴 연결 타임아웃)
+ * Default values for each setting:
+ * - min: 1 (minimum connection count)
+ * - max: 10 (maximum connection count)
+ * - acquireTimeoutMillis: 30000 (connection acquisition timeout)
+ * - idleTimeoutMillis: 30000 (idle connection timeout)
  */
 export interface DbPoolConfig {
-    /** 최소 연결 수 (기본: 1) */
+    /** Minimum connection count (default: 1) */
     min?: number;
-    /** 최대 연결 수 (기본: 10) */
+    /** Maximum connection count (default: 10) */
     max?: number;
-    /** 연결 획득 타임아웃 (밀리초, 기본: 30000) */
+    /** Connection acquisition timeout (milliseconds, default: 30000) */
     acquireTimeoutMillis?: number;
-    /** 유휴 연결 타임아웃 (밀리초, 기본: 30000) */
+    /** Idle connection timeout (milliseconds, default: 30000) */
     idleTimeoutMillis?: number;
 }
 /**
- * DB 연결 설정 타입 (dialect별 분기)
+ * DB connection configuration type (branching by dialect)
  */
 export type DbConnConfig = MysqlDbConnConfig | MssqlDbConnConfig | PostgresqlDbConnConfig;
 /**
- * MySQL 연결 설정
+ * MySQL connection configuration
  */
 export interface MysqlDbConnConfig {
     dialect: "mysql";
@@ -129,7 +129,7 @@ export interface MysqlDbConnConfig {
     pool?: DbPoolConfig;
 }
 /**
- * MSSQL 연결 설정
+ * MSSQL connection configuration
  */
 export interface MssqlDbConnConfig {
     dialect: "mssql" | "mssql-azure";
@@ -143,7 +143,7 @@ export interface MssqlDbConnConfig {
     pool?: DbPoolConfig;
 }
 /**
- * PostgreSQL 연결 설정
+ * PostgreSQL connection configuration
  */
 export interface PostgresqlDbConnConfig {
     dialect: "postgresql";
@@ -157,7 +157,7 @@ export interface PostgresqlDbConnConfig {
     pool?: DbPoolConfig;
 }
 /**
- * DbConnConfig에서 Dialect 추출
+ * Extract Dialect from DbConnConfig
  */
 export declare function getDialectFromConfig(config: DbConnConfig): Dialect;
 //# sourceMappingURL=db-conn.d.ts.map

package/dist/types/db-conn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-conn.d.ts","sourceRoot":"","sources":["..\\..\\src\\types\\db-conn.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"db-conn.d.ts","sourceRoot":"","sources":["..\\..\\src\\types\\db-conn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMhF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAY,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAMX;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAO,SAAQ,YAAY,CAAC;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC;IAC3D;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE;;;;;;OAMG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAE7F;;;;;;;;;;OAUG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,cAAc,CAAC;IACvC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,cAAc,CAAC;IACvC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,cAAc,CAAC;IACvC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKlE"}

package/dist/types/db-conn.js

@@ -1,8 +1,8 @@
 const DB_CONN_CONNECT_TIMEOUT = 10 * 1e3;
 const DB_CONN_DEFAULT_TIMEOUT = 10 * 60 * 1e3;
 const DB_CONN_ERRORS = {
-  NOT_CONNECTED: "'Connection'\uC774 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
-  ALREADY_CONNECTED: "\uC774\uBBF8 'Connection'\uC774 \uC5F0\uACB0\uB418\uC5B4\uC788\uC2B5\uB2C8\uB2E4."
+  NOT_CONNECTED: "'Connection' is not connected.",
+  ALREADY_CONNECTED: "'Connection' is already connected."
 };
 function getDialectFromConfig(config) {
   if (config.dialect === "mssql-azure") {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@simplysm/orm-node",
-  "version": "13.0.69",
-  "description": "심플리즘 패키지 - ORM 모듈 (node)",
-  "author": "김석래",
+  "version": "13.0.71",
+  "description": "Simplysm package - ORM module (node)",
+  "author": "simplysm",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -20,8 +20,8 @@
   "dependencies": {
     "consola": "^3.4.2",
     "generic-pool": "^3.9.0",
-    "@simplysm/core-common": "13.0.69",
-    "@simplysm/orm-common": "13.0.69"
+    "@simplysm/core-common": "13.0.71",
+    "@simplysm/orm-common": "13.0.71"
   },
   "devDependencies": {
     "@types/pg": "^8.16.0",

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 데이터베이스 연결 클래스
+ * MSSQL database connection class
  *
- * tedious 라이브러리를 사용하여 MSSQL/Azure SQL 연결을 관리합니다.
+ * Manages MSSQL/Azure SQL connections using the tedious library.
  */
 export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn {
   private readonly _timeout = DB_CONN_DEFAULT_TIMEOUT;
@@ -114,11 +114,11 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
 
     const conn = this._conn;
 
-    // 진행 중인 요청 취소
+    // Cancel in-progress requests
     conn.cancel();
     await waitUntil(() => this._requests.length < 1, 30000, 100);
 
-    // 연결 종료 대기
+    // Wait for connection termination
     await new Promise<void>((resolve) => {
       conn.on("end", () => {
         waitUntil(() => 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("쿼리 실행", { queryLength: query.length, params });
+    logger.debug("Query execution", { 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 errRec = err as unknown as Record<string, unknown>;
           if (errRec["code"] === "ECANCEL") {
-            reject(new SdError(err, "쿼리가 취소되었습니다."));
+            reject(new SdError(err, "Query was cancelled."));
           } else {
             const lineNumber = errRec["lineNumber"] as number | undefined;
             if (lineNumber != null && lineNumber > 0) {
               const splitQuery = query.split("\n");
               splitQuery[lineNumber - 1] = "==> " + splitQuery[lineNumber - 1];
               reject(
-                new SdError(err, `쿼리 수행중 오류발생\n-- query\n${splitQuery.join("\n")}\n--`),
+                new SdError(err, `Error executing query\n-- query\n${splitQuery.join("\n")}\n--`),
               );
             } else {
-              reject(new SdError(err, `쿼리 수행중 오류발생\n-- query\n${query}\n--`));
+              reject(new SdError(err, `Error executing query\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, `쿼리 수행중 오류발생\n-- query\n${query}\n--`));
+          reject(new SdError(err, `Error executing query\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 오류발생\n${jsonStringify(tediousColumnDefs)}\n-- data\n${jsonStringify(records).substring(0, 10000)}...\n--`,
+              `Bulk Insert error\n${jsonStringify(tediousColumnDefs)}\n-- data\n${jsonStringify(records).substring(0, 10000)}...\n--`,
             ),
           );
           return;
@@ -334,12 +334,12 @@ export class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn
         bulkLoad.addColumn(tediousColumnDef.name, tediousColumnDef.type, tediousColumnDef.options);
       }
 
-      // 레코드를 row 배열로 변환 (컬럼 순서 유지, 값 변환 포함)
+      // Convert records to row arrays (maintain column order, include value conversion)
       const rows = records.map((record) =>
         colNames.map((colName) => {
           const val = record[colName];
           if (val instanceof Uuid) return val.toString();
-          // eslint-disable-next-line no-restricted-globals -- tedious 라이브러리가 Buffer를 요구함
+          // eslint-disable-next-line no-restricted-globals -- tedious library requires Buffer
           if (val instanceof Uint8Array) return Buffer.from(val);
           if (val instanceof DateTime) return val.date;
           if (val instanceof DateOnly) return val.date;
@@ -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(`지원하지 않는 DataType: ${JSON.stringify(dataType)}`);
+        throw new SdError(`Unsupported DataType: ${JSON.stringify(dataType)}`);
     }
   }
 
   /**
-   * 값의 타입을 추론하여 Tedious 데이터 타입 반환
+   * Infer the type of a value and return Tedious data type
    *
-   * @param value - 타입을 추론할 값 (null/undefined 전달 시 오류 발생)
-   * @throws null/undefined가 전달되면 오류 발생
+   * @param value - Value whose type is to be inferred (error if null/undefined is passed)
+   * @throws Error if null/undefined is passed
    */
   private _guessTediousType(value: unknown): TediousDataType {
     if (value == null) {
-      throw new SdError("_guessTediousType: null/undefined 값은 지원하지 않습니다.");
+      throw new SdError("_guessTediousType: null/undefined values are not supported.");
     }
     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(`알 수 없는 값 타입: ${typeof value}`);
+    throw new SdError(`Unknown value type: ${typeof value}`);
   }
 }