@simplysm/orm-node 13.0.99 → 14.0.1

package/dist/connections/postgresql-db-conn.js

@@ -1,197 +1,199 @@
 import { Readable } from "stream";
 import consola from "consola";
-import {
-  bytes,
-  str,
-  DateOnly,
-  DateTime,
-  SdError,
-  EventEmitter,
-  Time,
-  Uuid
-} from "@simplysm/core-common";
-import {
-  DB_CONN_CONNECT_TIMEOUT,
-  DB_CONN_DEFAULT_TIMEOUT,
-  DB_CONN_ERRORS
-} from "../types/db-conn.js";
+import { bytes, str, DateOnly, DateTime, SdError, EventEmitter, Time, Uuid, } from "@simplysm/core-common";
+import { DB_CONN_CONNECT_TIMEOUT, DB_CONN_DEFAULT_TIMEOUT, DB_CONN_ERRORS, } from "../types/db-conn.js";
 const logger = consola.withTag("postgresql-db-conn");
-class PostgresqlDbConn extends EventEmitter {
-  constructor(_pg, _pgCopyStreams, config) {
-    super();
-    this._pg = _pg;
-    this._pgCopyStreams = _pgCopyStreams;
-    this.config = config;
-  }
-  _timeout = DB_CONN_DEFAULT_TIMEOUT;
-  _client;
-  _connTimeout;
-  isConnected = false;
-  isInTransaction = false;
-  async connect() {
-    if (this.isConnected) {
-      throw new SdError(DB_CONN_ERRORS.ALREADY_CONNECTED);
+/**
+ * PostgreSQL 데이터베이스 연결 클래스
+ *
+ * pg 라이브러리를 사용하여 PostgreSQL 연결을 관리한다.
+ */
+export class PostgresqlDbConn extends EventEmitter {
+    _pg;
+    _pgCopyStreams;
+    config;
+    _timeout = DB_CONN_DEFAULT_TIMEOUT;
+    _client;
+    _connTimeout;
+    isConnected = false;
+    isInTransaction = false;
+    constructor(_pg, _pgCopyStreams, config) {
+        super();
+        this._pg = _pg;
+        this._pgCopyStreams = _pgCopyStreams;
+        this.config = config;
     }
-    const client = new this._pg.Client({
-      host: this.config.host,
-      port: this.config.port ?? 5432,
-      user: this.config.username,
-      password: this.config.password,
-      database: this.config.database,
-      connectionTimeoutMillis: DB_CONN_CONNECT_TIMEOUT,
-      query_timeout: this._timeout
-    });
-    client.on("end", () => {
-      this.emit("close");
-      this._resetState();
-    });
-    client.on("error", (error) => {
-      logger.error("DB connection error", error.message);
-    });
-    await client.connect();
-    this._client = client;
-    this._startTimeout();
-    this.isConnected = true;
-  }
-  async close() {
-    this._stopTimeout();
-    if (this._client == null || !this.isConnected) {
-      return;
+    async connect() {
+        if (this.isConnected) {
+            throw new SdError(DB_CONN_ERRORS.ALREADY_CONNECTED);
+        }
+        const client = new this._pg.Client({
+            host: this.config.host,
+            port: this.config.port ?? 5432,
+            user: this.config.username,
+            password: this.config.password,
+            database: this.config.database,
+            connectionTimeoutMillis: DB_CONN_CONNECT_TIMEOUT,
+            query_timeout: this._timeout,
+        });
+        client.on("end", () => {
+            this.emit("close");
+            this._resetState();
+        });
+        client.on("error", (error) => {
+            logger.error("DB 연결 오류", error.message);
+        });
+        await client.connect();
+        this._client = client;
+        this._startTimeout();
+        this.isConnected = true;
+    }
+    async close() {
+        this._stopTimeout();
+        if (this._client == null || !this.isConnected) {
+            return;
+        }
+        await this._client.end();
+        this.emit("close");
+        this._resetState();
+    }
+    async beginTransaction(isolationLevel) {
+        this._assertConnected();
+        const level = (isolationLevel ??
+            this.config.defaultIsolationLevel ??
+            "READ_UNCOMMITTED").replace(/_/g, " ");
+        await this._client.query("BEGIN");
+        await this._client.query(`SET TRANSACTION ISOLATION LEVEL ${level}`);
+        this.isInTransaction = true;
     }
-    await this._client.end();
-    this.emit("close");
-    this._resetState();
-  }
-  async beginTransaction(isolationLevel) {
-    this._assertConnected();
-    const level = (isolationLevel ?? this.config.defaultIsolationLevel ?? "READ_UNCOMMITTED").replace(/_/g, " ");
-    await this._client.query("BEGIN");
-    await this._client.query(`SET TRANSACTION ISOLATION LEVEL ${level}`);
-    this.isInTransaction = true;
-  }
-  async commitTransaction() {
-    this._assertConnected();
-    await this._client.query("COMMIT");
-    this.isInTransaction = false;
-  }
-  async rollbackTransaction() {
-    this._assertConnected();
-    await this._client.query("ROLLBACK");
-    this.isInTransaction = false;
-  }
-  async execute(queries) {
-    const results = [];
-    for (const query of queries.filter((item) => !str.isNullOrEmpty(item))) {
-      const resultItems = await this.executeParametrized(query);
-      results.push(...resultItems);
+    async commitTransaction() {
+        this._assertConnected();
+        await this._client.query("COMMIT");
+        this.isInTransaction = false;
+    }
+    async rollbackTransaction() {
+        this._assertConnected();
+        await this._client.query("ROLLBACK");
+        this.isInTransaction = false;
+    }
+    async execute(queries) {
+        const results = [];
+        for (const query of queries.filter((item) => !str.isNullOrEmpty(item))) {
+            const resultItems = await this.executeParametrized(query);
+            results.push(...resultItems);
+        }
+        return results;
     }
-    return results;
-  }
-  async executeParametrized(query, params) {
-    this._assertConnected();
-    logger.debug("Query execution", { queryLength: query.length, params });
-    try {
-      const result = await this._client.query(query, params);
-      this._startTimeout();
-      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--");
+    async executeParametrized(query, params) {
+        this._assertConnected();
+        logger.debug("쿼리 실행", { queryLength: query.length, params });
+        try {
+            const result = await this._client.query(query, params);
+            this._startTimeout();
+            // PostgreSQL은 단일 결과 집합을 반환한다
+            return [result.rows];
+        }
+        catch (err) {
+            this._startTimeout();
+            const error = err instanceof Error ? err : new Error(String(err));
+            throw new SdError(error, "쿼리 실행 오류\n-- query\n" + query.trim() + "\n--");
+        }
     }
-  }
-  async bulkInsert(tableName, columnMetas, records) {
-    this._assertConnected();
-    if (records.length === 0) return;
-    const colNames = Object.keys(columnMetas);
-    const wrappedCols = colNames.map((c) => `"${c}"`).join(", ");
-    const copyQuery = `COPY ${tableName} (${wrappedCols}) FROM STDIN WITH (FORMAT csv, NULL '\\N')`;
-    const stream = this._client.query(this._pgCopyStreams.from(copyQuery));
-    const csvLines = [];
-    for (const record of records) {
-      const row = colNames.map(
-        (colName) => this._escapeForCsv(record[colName], columnMetas[colName].dataType)
-      );
-      csvLines.push(row.join(","));
+    async bulkInsert(tableName, columnMetas, records) {
+        this._assertConnected();
+        if (records.length === 0)
+            return;
+        const colNames = Object.keys(columnMetas);
+        const wrappedCols = colNames.map((c) => `"${c}"`).join(", ");
+        // COPY FROM STDIN 스트림 생성
+        const copyQuery = `COPY ${tableName} (${wrappedCols}) FROM STDIN WITH (FORMAT csv, NULL '\\N')`;
+        const stream = this._client.query(this._pgCopyStreams.from(copyQuery));
+        // CSV 데이터 생성
+        const csvLines = [];
+        for (const record of records) {
+            const row = colNames.map((colName) => this._escapeForCsv(record[colName], columnMetas[colName].dataType));
+            csvLines.push(row.join(","));
+        }
+        const csvContent = csvLines.join("\n") + "\n";
+        // 스트림을 통해 데이터 전송
+        await new Promise((resolve, reject) => {
+            const readable = Readable.from([csvContent]);
+            readable.on("error", reject);
+            stream.on("error", reject);
+            stream.on("finish", resolve);
+            readable.pipe(stream);
+        });
     }
-    const csvContent = csvLines.join("\n") + "\n";
-    await new Promise((resolve, reject) => {
-      const readable = Readable.from([csvContent]);
-      readable.on("error", reject);
-      stream.on("error", reject);
-      stream.on("finish", resolve);
-      readable.pipe(stream);
-    });
-  }
-  // ─────────────────────────────────────────────
-  // Private helpers
-  // ─────────────────────────────────────────────
-  /**
-   * Escape value for PostgreSQL COPY CSV
-   */
-  _escapeForCsv(value, dataType) {
-    if (value == null) {
-      return "\\N";
+    // ─────────────────────────────────────────────
+    // 내부 헬퍼
+    // ─────────────────────────────────────────────
+    /**
+     * PostgreSQL COPY CSV용 값 이스케이프
+     */
+    _escapeForCsv(value, dataType) {
+        if (value == null) {
+            return "\\N"; // NULL 표현
+        }
+        switch (dataType.type) {
+            case "int":
+            case "bigint":
+            case "float":
+            case "double":
+            case "decimal":
+                return String(value);
+            case "boolean":
+                return value ? "true" : "false";
+            case "varchar":
+            case "char":
+            case "text": {
+                const strVal = value;
+                // CSV 형식: 큰따옴표로 감싸고, 내부 큰따옴표는 이중 큰따옴표로 이스케이프
+                if (strVal.includes('"') ||
+                    strVal.includes(",") ||
+                    strVal.includes("\n") ||
+                    strVal.includes("\r") ||
+                    strVal.includes("\\")) {
+                    return '"' + strVal.replace(/"/g, '""') + '"';
+                }
+                return strVal;
+            }
+            case "datetime":
+                return value.toFormatString("yyyy-MM-dd HH:mm:ss.fff");
+            case "date":
+                return value.toFormatString("yyyy-MM-dd");
+            case "time":
+                return value.toFormatString("HH:mm:ss");
+            case "uuid":
+                return value.toString();
+            case "binary":
+                return '"\\x' + bytes.toHex(value) + '"'; // PostgreSQL bytea hex 형식 (CSV 큰따옴표로 감쌈)
+            default:
+                throw new SdError(`지원하지 않는 DataType: ${JSON.stringify(dataType)}`);
+        }
     }
-    switch (dataType.type) {
-      case "int":
-      case "bigint":
-      case "float":
-      case "double":
-      case "decimal":
-        return String(value);
-      case "boolean":
-        return value ? "true" : "false";
-      case "varchar":
-      case "char":
-      case "text": {
-        const strVal = value;
-        if (strVal.includes('"') || strVal.includes(",") || strVal.includes("\n") || strVal.includes("\r") || strVal.includes("\\")) {
-          return '"' + strVal.replace(/"/g, '""') + '"';
+    _assertConnected() {
+        if (this._client == null || !this.isConnected) {
+            throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);
         }
-        return strVal;
-      }
-      case "datetime":
-        return value.toFormatString("yyyy-MM-dd HH:mm:ss.fff");
-      case "date":
-        return value.toFormatString("yyyy-MM-dd");
-      case "time":
-        return value.toFormatString("HH:mm:ss");
-      case "uuid":
-        return value.toString();
-      case "binary":
-        return '"\\x' + bytes.toHex(value) + '"';
-      // PostgreSQL bytea hex format (wrapped in CSV double quotes)
-      default:
-        throw new SdError(`Unsupported DataType: ${JSON.stringify(dataType)}`);
+        this._startTimeout();
+    }
+    _resetState() {
+        this.isConnected = false;
+        this.isInTransaction = false;
+        this._client = undefined;
     }
-  }
-  _assertConnected() {
-    if (this._client == null || !this.isConnected) {
-      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);
+    _stopTimeout() {
+        if (this._connTimeout != null) {
+            clearTimeout(this._connTimeout);
+        }
     }
-    this._startTimeout();
-  }
-  _resetState() {
-    this.isConnected = false;
-    this.isInTransaction = false;
-    this._client = void 0;
-  }
-  _stopTimeout() {
-    if (this._connTimeout != null) {
-      clearTimeout(this._connTimeout);
+    _startTimeout() {
+        this._stopTimeout();
+        this._connTimeout = setTimeout(() => {
+            this.close().catch((err) => {
+                logger.error("연결 종료 오류", err instanceof Error ? err.message : String(err));
+            });
+        }, this._timeout * 2);
     }
-  }
-  _startTimeout() {
-    this._stopTimeout();
-    this._connTimeout = setTimeout(() => {
-      this.close().catch((err) => {
-        logger.error("close error", err instanceof Error ? err.message : String(err));
-      });
-    }, this._timeout * 2);
-  }
 }
-export {
-  PostgresqlDbConn
-};
-//# sourceMappingURL=postgresql-db-conn.js.map
+//# sourceMappingURL=postgresql-db-conn.js.map

package/dist/connections/postgresql-db-conn.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/connections/postgresql-db-conn.ts"],
-  "mappings": "AAAA,SAAS,gBAAgB;AACzB,OAAO,aAAa;AACpB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAGP,MAAM,SAAS,QAAQ,QAAQ,oBAAoB;AAO5C,MAAM,yBAAyB,aAAgD;AAAA,EASpF,YACmB,KACA,gBACR,QACT;AACA,UAAM;AAJW;AACA;AACR;AAAA,EAGX;AAAA,EAdiB,WAAW;AAAA,EAEpB;AAAA,EACA;AAAA,EAER,cAAc;AAAA,EACd,kBAAkB;AAAA,EAUlB,MAAM,UAAyB;AAC7B,QAAI,KAAK,aAAa;AACpB,YAAM,IAAI,QAAQ,eAAe,iBAAiB;AAAA,IACpD;AAEA,UAAM,SAAS,IAAI,KAAK,IAAI,OAAO;AAAA,MACjC,MAAM,KAAK,OAAO;AAAA,MAClB,MAAM,KAAK,OAAO,QAAQ;AAAA,MAC1B,MAAM,KAAK,OAAO;AAAA,MAClB,UAAU,KAAK,OAAO;AAAA,MACtB,UAAU,KAAK,OAAO;AAAA,MACtB,yBAAyB;AAAA,MACzB,eAAe,KAAK;AAAA,IACtB,CAAC;AAED,WAAO,GAAG,OAAO,MAAM;AACrB,WAAK,KAAK,OAAO;AACjB,WAAK,YAAY;AAAA,IACnB,CAAC;AAED,WAAO,GAAG,SAAS,CAAC,UAAU;AAC5B,aAAO,MAAM,uBAAuB,MAAM,OAAO;AAAA,IACnD,CAAC;AAED,UAAM,OAAO,QAAQ;AAErB,SAAK,UAAU;AACf,SAAK,cAAc;AACnB,SAAK,cAAc;AAAA,EACrB;AAAA,EAEA,MAAM,QAAuB;AAC3B,SAAK,aAAa;AAElB,QAAI,KAAK,WAAW,QAAQ,CAAC,KAAK,aAAa;AAC7C;AAAA,IACF;AAEA,UAAM,KAAK,QAAQ,IAAI;AAEvB,SAAK,KAAK,OAAO;AACjB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,MAAM,iBAAiB,gBAAgD;AACrE,SAAK,iBAAiB;AAEtB,UAAM,SACJ,kBACA,KAAK,OAAO,yBACZ,oBACA,QAAQ,MAAM,GAAG;AAEnB,UAAM,KAAK,QAAS,MAAM,OAAO;AACjC,UAAM,KAAK,QAAS,MAAM,mCAAmC,KAAK,EAAE;AAEpE,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEA,MAAM,oBAAmC;AACvC,SAAK,iBAAiB;AACtB,UAAM,KAAK,QAAS,MAAM,QAAQ;AAClC,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEA,MAAM,sBAAqC;AACzC,SAAK,iBAAiB;AACtB,UAAM,KAAK,QAAS,MAAM,UAAU;AACpC,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEA,MAAM,QAAQ,SAAyD;AACrE,UAAM,UAAuC,CAAC;AAC9C,eAAW,SAAS,QAAQ,OAAO,CAAC,SAAS,CAAC,IAAI,cAAc,IAAI,CAAC,GAAG;AACtE,YAAM,cAAc,MAAM,KAAK,oBAAoB,KAAK;AACxD,cAAQ,KAAK,GAAG,WAAW;AAAA,IAC7B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,oBACJ,OACA,QACsC;AACtC,SAAK,iBAAiB;AAEtB,WAAO,MAAM,mBAAmB,EAAE,aAAa,MAAM,QAAQ,OAAO,CAAC;AAErE,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,QAAS,MAAM,OAAO,MAAM;AAEtD,WAAK,cAAc;AAGnB,aAAO,CAAC,OAAO,IAAI;AAAA,IACrB,SAAS,KAAK;AACZ,WAAK,cAAc;AACnB,YAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,YAAM,IAAI,QAAQ,OAAO,sCAAsC,MAAM,KAAK,IAAI,MAAM;AAAA,IACtF;AAAA,EACF;AAAA,EAEA,MAAM,WACJ,WACA,aACA,SACe;AACf,SAAK,iBAAiB;AAEtB,QAAI,QAAQ,WAAW,EAAG;AAE1B,UAAM,WAAW,OAAO,KAAK,WAAW;AACxC,UAAM,cAAc,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAG3D,UAAM,YAAY,QAAQ,SAAS,KAAK,WAAW;AACnD,UAAM,SAAS,KAAK,QAAS,MAAM,KAAK,eAAe,KAAK,SAAS,CAAC;AAGtE,UAAM,WAAqB,CAAC;AAC5B,eAAW,UAAU,SAAS;AAC5B,YAAM,MAAM,SAAS;AAAA,QAAI,CAAC,YACxB,KAAK,cAAc,OAAO,OAAO,GAAG,YAAY,OAAO,EAAE,QAAQ;AAAA,MACnE;AACA,eAAS,KAAK,IAAI,KAAK,GAAG,CAAC;AAAA,IAC7B;AACA,UAAM,aAAa,SAAS,KAAK,IAAI,IAAI;AAGzC,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,YAAM,WAAW,SAAS,KAAK,CAAC,UAAU,CAAC;AAE3C,eAAS,GAAG,SAAS,MAAM;AAC3B,aAAO,GAAG,SAAS,MAAM;AACzB,aAAO,GAAG,UAAU,OAAO;AAE3B,eAAS,KAAK,MAAM;AAAA,IACtB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,cAAc,OAAgB,UAA4B;AAChE,QAAI,SAAS,MAAM;AACjB,aAAO;AAAA,IACT;AAEA,YAAQ,SAAS,MAAM;AAAA,MACrB,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACH,eAAO,OAAO,KAAK;AAAA,MAErB,KAAK;AACH,eAAQ,QAAoB,SAAS;AAAA,MAEvC,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK,QAAQ;AACX,cAAM,SAAS;AAEf,YACE,OAAO,SAAS,GAAG,KACnB,OAAO,SAAS,GAAG,KACnB,OAAO,SAAS,IAAI,KACpB,OAAO,SAAS,IAAI,KACpB,OAAO,SAAS,IAAI,GACpB;AACA,iBAAO,MAAM,OAAO,QAAQ,MAAM,IAAI,IAAI;AAAA,QAC5C;AACA,eAAO;AAAA,MACT;AAAA,MAEA,KAAK;AACH,eAAQ,MAAmB,eAAe,yBAAyB;AAAA,MAErE,KAAK;AACH,eAAQ,MAAmB,eAAe,YAAY;AAAA,MAExD,KAAK;AACH,eAAQ,MAAe,eAAe,UAAU;AAAA,MAElD,KAAK;AACH,eAAQ,MAAe,SAAS;AAAA,MAElC,KAAK;AACH,eAAO,SAAS,MAAM,MAAM,KAAmB,IAAI;AAAA;AAAA,MAErD;AACE,cAAM,IAAI,QAAQ,yBAAyB,KAAK,UAAU,QAAQ,CAAC,EAAE;AAAA,IACzE;AAAA,EACF;AAAA,EAEQ,mBAAyB;AAC/B,QAAI,KAAK,WAAW,QAAQ,CAAC,KAAK,aAAa;AAC7C,YAAM,IAAI,QAAQ,eAAe,aAAa;AAAA,IAChD;AACA,SAAK,cAAc;AAAA,EACrB;AAAA,EAEQ,cAAoB;AAC1B,SAAK,cAAc;AACnB,SAAK,kBAAkB;AACvB,SAAK,UAAU;AAAA,EACjB;AAAA,EAEQ,eAAqB;AAC3B,QAAI,KAAK,gBAAgB,MAAM;AAC7B,mBAAa,KAAK,YAAY;AAAA,IAChC;AAAA,EACF;AAAA,EAEQ,gBAAsB;AAC5B,SAAK,aAAa;AAClB,SAAK,eAAe,WAAW,MAAM;AACnC,WAAK,MAAM,EAAE,MAAM,CAAC,QAAQ;AAC1B,eAAO,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,MAC9E,CAAC;AAAA,IACH,GAAG,KAAK,WAAW,CAAC;AAAA,EACtB;AACF;",
-  "names": []
-}
+{"version":3,"file":"postgresql-db-conn.js","sourceRoot":"","sources":["..\\..\\src\\connections\\postgresql-db-conn.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,9 @@
 import type { DbConn, DbConnConfig } from "./types/db-conn";
 /**
- * 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 declare function createDbConn(config: DbConnConfig): Promise<DbConn>;
 //# sourceMappingURL=create-db-conn.d.ts.map

package/dist/create-db-conn.js

@@ -1,35 +1,51 @@
 import { MysqlDbConn } from "./connections/mysql-db-conn.js";
 import { MssqlDbConn } from "./connections/mssql-db-conn.js";
 import { PostgresqlDbConn } from "./connections/postgresql-db-conn.js";
+/**
+ * DB 연결 팩토리
+ *
+ * 데이터베이스 연결 인스턴스를 생성한다.
+ * MSSQL, MySQL, PostgreSQL을 지원한다.
+ */
+// 지연 로딩 모듈 캐시
 const modules = {};
-async function createDbConn(config) {
-  if (config.dialect === "mysql") {
-    const mysql = await ensureModule("mysql");
-    return new MysqlDbConn(mysql, config);
-  } else if (config.dialect === "postgresql") {
-    const pg = await ensureModule("pg");
-    const pgCopyStreams = await ensureModule("pgCopyStreams");
-    return new PostgresqlDbConn(pg, pgCopyStreams, config);
-  } else {
-    const tedious = await ensureModule("tedious");
-    return new MssqlDbConn(tedious, config);
-  }
+/**
+ * DB 연결 생성
+ *
+ * @param config - 데이터베이스 연결 설정
+ * @returns DB 연결 객체 (아직 연결되지 않음 - connect()를 별도로 호출해야 함)
+ */
+export async function createDbConn(config) {
+    if (config.dialect === "mysql") {
+        const mysql = await ensureModule("mysql");
+        return new MysqlDbConn(mysql, config);
+    }
+    else if (config.dialect === "postgresql") {
+        const pg = await ensureModule("pg");
+        const pgCopyStreams = await ensureModule("pgCopyStreams");
+        return new PostgresqlDbConn(pg, pgCopyStreams, config);
+    }
+    else {
+        // mssql, mssql-azure
+        const tedious = await ensureModule("tedious");
+        return new MssqlDbConn(tedious, config);
+    }
 }
 async function ensureModule(name) {
-  if (modules[name] == null) {
-    if (name === "mysql") {
-      modules.mysql = await import("mysql2/promise");
-    } else if (name === "pg") {
-      modules.pg = await import("pg");
-    } else if (name === "pgCopyStreams") {
-      modules.pgCopyStreams = await import("pg-copy-streams");
-    } else {
-      modules.tedious = await import("tedious");
+    if (modules[name] == null) {
+        if (name === "mysql") {
+            modules.mysql = await import("mysql2/promise");
+        }
+        else if (name === "pg") {
+            modules.pg = await import("pg");
+        }
+        else if (name === "pgCopyStreams") {
+            modules.pgCopyStreams = await import("pg-copy-streams");
+        }
+        else {
+            modules.tedious = await import("tedious");
+        }
     }
-  }
-  return modules[name];
+    return modules[name];
 }
-export {
-  createDbConn
-};
-//# sourceMappingURL=create-db-conn.js.map
+//# sourceMappingURL=create-db-conn.js.map

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

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/create-db-conn.ts"],
-  "mappings": "AACA,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AAUjC,MAAM,UAKF,CAAC;AAQL,eAAsB,aAAa,QAAuC;AACxE,MAAI,OAAO,YAAY,SAAS;AAC9B,UAAM,QAAQ,MAAM,aAAa,OAAO;AACxC,WAAO,IAAI,YAAY,OAAO,MAAM;AAAA,EACtC,WAAW,OAAO,YAAY,cAAc;AAC1C,UAAM,KAAK,MAAM,aAAa,IAAI;AAClC,UAAM,gBAAgB,MAAM,aAAa,eAAe;AACxD,WAAO,IAAI,iBAAiB,IAAI,eAAe,MAAM;AAAA,EACvD,OAAO;AAEL,UAAM,UAAU,MAAM,aAAa,SAAS;AAC5C,WAAO,IAAI,YAAY,SAAS,MAAM;AAAA,EACxC;AACF;AAEA,eAAe,aACb,MAC2C;AAC3C,MAAI,QAAQ,IAAI,KAAK,MAAM;AACzB,QAAI,SAAS,SAAS;AACpB,cAAQ,QAAQ,MAAM,OAAO,gBAAgB;AAAA,IAC/C,WAAW,SAAS,MAAM;AACxB,cAAQ,KAAK,MAAM,OAAO,IAAI;AAAA,IAChC,WAAW,SAAS,iBAAiB;AACnC,cAAQ,gBAAgB,MAAM,OAAO,iBAAiB;AAAA,IACxD,OAAO;AACL,cAAQ,UAAU,MAAM,OAAO,SAAS;AAAA,IAC1C;AAAA,EACF;AACA,SAAO,QAAQ,IAAI;AACrB;",
-  "names": []
-}
+{"version":3,"file":"create-db-conn.js","sourceRoot":"","sources":["..\\src\\create-db-conn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;;;GAKG;AAEH,cAAc;AACd,MAAM,OAAO,GAKT,EAAE,CAAC;AAEP;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB;IACrD,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,MAAM,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,CAAC;QAC1D,OAAO,IAAI,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,qBAAqB;QACrB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;QAC9C,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,IAAO;IAEP,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,CAAC,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;YACpC,OAAO,CAAC,aAAa,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAE,CAAC;AACxB,CAAC"}

package/dist/create-orm.d.ts

@@ -1,50 +1,50 @@
 import { type DbContextDef, type DbContextInstance, type IsolationLevel } from "@simplysm/orm-common";
 import type { DbConnConfig } from "./types/db-conn";
 /**
- * ORM options
+ * ORM 옵션
  *
- * DbContext options that take precedence over DbConnConfig
+ * DbConnConfig보다 우선하는 DbContext 옵션
  */
 export interface OrmOptions {
     /**
-     * Database name (used instead of DbConnConfig's database)
+     * 데이터베이스 이름 (DbConnConfig의 database 대신 사용)
      */
     database?: string;
     /**
-     * Schema name (MSSQL: dbo, PostgreSQL: public)
+     * 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
      */
     schema?: string;
 }
 /**
- * ORM instance type
+ * ORM 인스턴스 타입
  *
- * Type of the object returned from createOrm
+ * createOrm에서 반환하는 객체의 타입
  */
 export interface Orm<TDef extends DbContextDef<any, any, any>> {
     readonly dbContextDef: TDef;
     readonly config: DbConnConfig;
     readonly options?: OrmOptions;
     /**
-     * Execute callback within a transaction
+     * 트랜잭션 내에서 콜백을 실행한다
      *
-     * @param callback - Callback to execute after DB connection
-     * @param isolationLevel - Transaction isolation level
-     * @returns Callback result
+     * @param callback - DB 연결 후 실행할 콜백
+     * @param isolationLevel - 트랜잭션 격리 수준
+     * @returns 콜백 결과
      */
     connect<R>(callback: (conn: DbContextInstance<TDef>) => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>;
     /**
-     * Execute callback without a transaction
+     * 트랜잭션 없이 콜백을 실행한다
      *
-     * @param callback - Callback to execute after DB connection
-     * @returns Callback result
+     * @param callback - DB 연결 후 실행할 콜백
+     * @returns 콜백 결과
      */
     connectWithoutTransaction<R>(callback: (conn: DbContextInstance<TDef>) => Promise<R>): Promise<R>;
 }
 /**
- * Node.js ORM factory function
+ * Node.js ORM 팩토리 함수
  *
- * Creates an instance that manages DbContext and DB connections.
- * Receives DbContext definition and connection configuration to manage transactions.
+ * DbContext와 DB 연결을 관리하는 인스턴스를 생성한다.
+ * DbContext 정의와 연결 설정을 받아 트랜잭션을 관리한다.
  *
  * @example
  * ```typescript
@@ -61,13 +61,13 @@ export interface Orm<TDef extends DbContextDef<any, any, any>> {
  *   database: "mydb",
  * });
  *
- * // Execute within a transaction
+ * // 트랜잭션 내에서 실행
  * await orm.connect(async (db) => {
  *   const users = await db.user().execute();
  *   return users;
  * });
  *
- * // Execute without a transaction
+ * // 트랜잭션 없이 실행
  * await orm.connectWithoutTransaction(async (db) => {
  *   const users = await db.user().execute();
  *   return users;