@simplysm/orm-node 13.0.100 → 14.0.4

package/dist/create-orm.js

@@ -1,34 +1,65 @@
-import {
-  createDbContext
-} from "@simplysm/orm-common";
+import { createDbContext, } from "@simplysm/orm-common";
 import { NodeDbContextExecutor } from "./node-db-context-executor.js";
-function createOrm(dbContextDef, config, options) {
-  function _createDbContext() {
-    const database = options?.database ?? ("database" in config ? config.database : void 0);
-    if (database == null || database === "") {
-      throw new Error("database is required");
+/**
+ * Node.js ORM 팩토리 함수
+ *
+ * DbContext와 DB 연결을 관리하는 인스턴스를 생성한다.
+ * DbContext 정의와 연결 설정을 받아 트랜잭션을 관리한다.
+ *
+ * @example
+ * ```typescript
+ * const MyDb = defineDbContext({
+ *   user: (db) => queryable(db, User),
+ * });
+ *
+ * const orm = createOrm(MyDb, {
+ *   dialect: "mysql",
+ *   host: "localhost",
+ *   port: 3306,
+ *   username: "root",
+ *   password: "password",
+ *   database: "mydb",
+ * });
+ *
+ * // 트랜잭션 내에서 실행
+ * await orm.connect(async (db) => {
+ *   const users = await db.user().execute();
+ *   return users;
+ * });
+ *
+ * // 트랜잭션 없이 실행
+ * await orm.connectWithoutTransaction(async (db) => {
+ *   const users = await db.user().execute();
+ *   return users;
+ * });
+ * ```
+ */
+export function createOrm(dbContextDef, config, options) {
+    function _createDbContext() {
+        // options의 database를 우선 사용, 없으면 config에서
+        const database = options?.database ?? ("database" in config ? config.database : undefined);
+        if (database == null || database === "") {
+            throw new Error("database는 필수입니다");
+        }
+        // options의 schema를 우선 사용, 없으면 config에서
+        const schema = options?.schema ?? ("schema" in config ? config.schema : undefined);
+        return createDbContext(dbContextDef, new NodeDbContextExecutor(config), {
+            database,
+            schema,
+        });
     }
-    const schema = options?.schema ?? ("schema" in config ? config.schema : void 0);
-    return createDbContext(dbContextDef, new NodeDbContextExecutor(config), {
-      database,
-      schema
-    });
-  }
-  return {
-    dbContextDef,
-    config,
-    options,
-    async connect(callback, isolationLevel) {
-      const db = _createDbContext();
-      return db.connect(async () => callback(db), isolationLevel);
-    },
-    async connectWithoutTransaction(callback) {
-      const db = _createDbContext();
-      return db.connectWithoutTransaction(async () => callback(db));
-    }
-  };
+    return {
+        dbContextDef,
+        config,
+        options,
+        async connect(callback, isolationLevel) {
+            const db = _createDbContext();
+            return db.connect(async () => callback(db), isolationLevel);
+        },
+        async connectWithoutTransaction(callback) {
+            const db = _createDbContext();
+            return db.connectWithoutTransaction(async () => callback(db));
+        },
+    };
 }
-export {
-  createOrm
-};
-//# sourceMappingURL=create-orm.js.map
+//# sourceMappingURL=create-orm.js.map

package/dist/create-orm.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/create-orm.ts"],
-  "mappings": "AAAA;AAAA,EACE;AAAA,OAIK;AAEP,SAAS,6BAA6B;AAoF/B,SAAS,UACd,cACA,QACA,SACW;AACX,WAAS,mBAA4C;AAEnD,UAAM,WAAW,SAAS,aAAa,cAAc,SAAS,OAAO,WAAW;AAChF,QAAI,YAAY,QAAQ,aAAa,IAAI;AACvC,YAAM,IAAI,MAAM,sBAAsB;AAAA,IACxC;AAGA,UAAM,SAAS,SAAS,WAAW,YAAY,SAAS,OAAO,SAAS;AAExE,WAAO,gBAAgB,cAAc,IAAI,sBAAsB,MAAM,GAAG;AAAA,MACtE;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM,QAAQ,UAAU,gBAAiB;AACvC,YAAM,KAAK,iBAAiB;AAC5B,aAAO,GAAG,QAAQ,YAAY,SAAS,EAAE,GAAG,cAAc;AAAA,IAC5D;AAAA,IACA,MAAM,0BAA0B,UAAU;AACxC,YAAM,KAAK,iBAAiB;AAC5B,aAAO,GAAG,0BAA0B,YAAY,SAAS,EAAE,CAAC;AAAA,IAC9D;AAAA,EACF;AACF;",
-  "names": []
-}
+{"version":3,"file":"create-orm.js","sourceRoot":"","sources":["..\\src\\create-orm.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAIhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAkDnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,SAAS,CACvB,YAAkB,EAClB,MAAoB,EACpB,OAAoB;IAEpB,SAAS,gBAAgB;QACvB,yCAAyC;QACzC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3F,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QAED,uCAAuC;QACvC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAEnF,OAAO,eAAe,CAAC,YAAY,EAAE,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE;YACtE,QAAQ;YACR,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,YAAY;QACZ,MAAM;QACN,OAAO;QACP,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAe;YACrC,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,CAAC,yBAAyB,CAAC,QAAQ;YACtC,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC,yBAAyB,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -1,8 +1,11 @@
+// 타입
 export * from "./types/db-conn.js";
+// 연결
 export * from "./connections/mssql-db-conn.js";
 export * from "./connections/mysql-db-conn.js";
 export * from "./connections/postgresql-db-conn.js";
+// 코어
 export * from "./create-db-conn.js";
 export * from "./node-db-context-executor.js";
 export * from "./create-orm.js";
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "mappings": "AACA,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;",
-  "names": []
-}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAAA,KAAK;AACL,cAAc,iBAAiB,CAAC;AAEhC,KAAK;AACL,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AAEjD,KAAK;AACL,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC"}

package/dist/node-db-context-executor.d.ts

@@ -1,9 +1,9 @@
 import type { DbContextExecutor, IsolationLevel, QueryDef, ResultMeta, ColumnMeta, DataRecord } from "@simplysm/orm-common";
 import type { DbConnConfig } from "./types/db-conn";
 /**
- * DbContextExecutor for Node.js environment
+ * Node.js 환경용 DbContextExecutor
  *
- * Executor used by DbContext that handles actual DB connections.
+ * DbContext에서 사용하는 실제 DB 연결을 처리하는 실행자.
  */
 export declare class NodeDbContextExecutor implements DbContextExecutor {
     private readonly _config;
@@ -11,61 +11,61 @@ export declare class NodeDbContextExecutor implements DbContextExecutor {
     private readonly _dialect;
     constructor(_config: DbConnConfig);
     /**
-     * Establish DB connection
+     * DB 연결을 수립한다
      */
     connect(): Promise<void>;
     /**
-     * Close DB connection
+     * DB 연결을 종료한다
      *
-     * @throws {Error} When not connected
+     * @throws {Error} 연결되지 않은 경우
      */
     close(): Promise<void>;
     /**
-     * Begin transaction
+     * 트랜잭션을 시작한다
      *
-     * @param isolationLevel - Transaction isolation level
-     * @throws {Error} When not connected
+     * @param isolationLevel - 트랜잭션 격리 수준
+     * @throws {Error} 연결되지 않은 경우
      */
     beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;
     /**
-     * Commit transaction
+     * 트랜잭션을 커밋한다
      *
-     * @throws {Error} When not connected
+     * @throws {Error} 연결되지 않은 경우
      */
     commitTransaction(): Promise<void>;
     /**
-     * Rollback transaction
+     * 트랜잭션을 롤백한다
      *
-     * @throws {Error} When not connected
+     * @throws {Error} 연결되지 않은 경우
      */
     rollbackTransaction(): Promise<void>;
     /**
-     * Execute parameterized query
+     * 파라미터화된 쿼리를 실행한다
      *
-     * @param query - SQL query string
-     * @param params - Query parameter array
-     * @returns Query result array
-     * @throws {Error} When not connected
+     * @param query - SQL 쿼리 문자열
+     * @param params - 쿼리 파라미터 배열
+     * @returns 쿼리 결과 배열
+     * @throws {Error} 연결되지 않은 경우
      */
     executeParametrized(query: string, params?: unknown[]): Promise<Record<string, unknown>[][]>;
     /**
-     * Bulk insert data (using native bulk API)
+     * 대량 데이터 삽입 (네이티브 bulk API 사용)
      *
-     * @param tableName - Target table name
-     * @param columnMetas - Column metadata
-     * @param records - Record array to insert
-     * @throws {Error} When not connected
+     * @param tableName - 대상 테이블 이름
+     * @param columnMetas - 컬럼 메타데이터
+     * @param records - 삽입할 레코드 배열
+     * @throws {Error} 연결되지 않은 경우
      */
     bulkInsert(tableName: string, columnMetas: Record<string, ColumnMeta>, records: DataRecord[]): Promise<void>;
     /**
-     * Execute QueryDef array
+     * QueryDef 배열을 실행한다
      *
-     * Converts QueryDef to SQL and executes, parses results using ResultMeta.
+     * QueryDef를 SQL로 변환하여 실행하고, ResultMeta를 사용하여 결과를 파싱한다.
      *
-     * @param defs - QueryDef array to execute
-     * @param resultMetas - Result parsing metadata array (used for type conversion)
-     * @returns Array of execution results for each QueryDef
-     * @throws {Error} When not connected
+     * @param defs - 실행할 QueryDef 배열
+     * @param resultMetas - 결과 파싱 메타데이터 배열 (타입 변환에 사용)
+     * @returns 각 QueryDef의 실행 결과 배열
+     * @throws {Error} 연결되지 않은 경우
      */
     executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]>;
     private _requireConn;

package/dist/node-db-context-executor.js

@@ -2,124 +2,132 @@ import { SdError } from "@simplysm/core-common";
 import { createQueryBuilder, parseQueryResult } from "@simplysm/orm-common";
 import { DB_CONN_ERRORS, getDialectFromConfig } from "./types/db-conn.js";
 import { createDbConn } from "./create-db-conn.js";
-class NodeDbContextExecutor {
-  constructor(_config) {
-    this._config = _config;
-    this._dialect = getDialectFromConfig(_config);
-  }
-  _conn;
-  _dialect;
-  /**
-   * Establish DB connection
-   */
-  async connect() {
-    this._conn = await createDbConn(this._config);
-    await this._conn.connect();
-  }
-  /**
-   * Close DB connection
-   *
-   * @throws {Error} When not connected
-   */
-  async close() {
-    const conn = this._requireConn();
-    await conn.close();
-    this._conn = void 0;
-  }
-  /**
-   * Begin transaction
-   *
-   * @param isolationLevel - Transaction isolation level
-   * @throws {Error} When not connected
-   */
-  async beginTransaction(isolationLevel) {
-    const conn = this._requireConn();
-    await conn.beginTransaction(isolationLevel);
-  }
-  /**
-   * Commit transaction
-   *
-   * @throws {Error} When not connected
-   */
-  async commitTransaction() {
-    const conn = this._requireConn();
-    await conn.commitTransaction();
-  }
-  /**
-   * Rollback transaction
-   *
-   * @throws {Error} When not connected
-   */
-  async rollbackTransaction() {
-    const conn = this._requireConn();
-    await conn.rollbackTransaction();
-  }
-  /**
-   * Execute parameterized query
-   *
-   * @param query - SQL query string
-   * @param params - Query parameter array
-   * @returns Query result array
-   * @throws {Error} When not connected
-   */
-  async executeParametrized(query, params) {
-    const conn = this._requireConn();
-    return conn.executeParametrized(query, params);
-  }
-  /**
-   * Bulk insert data (using native bulk API)
-   *
-   * @param tableName - Target table name
-   * @param columnMetas - Column metadata
-   * @param records - Record array to insert
-   * @throws {Error} When not connected
-   */
-  async bulkInsert(tableName, columnMetas, records) {
-    const conn = this._requireConn();
-    await conn.bulkInsert(tableName, columnMetas, records);
-  }
-  /**
-   * Execute QueryDef array
-   *
-   * Converts QueryDef to SQL and executes, parses results using ResultMeta.
-   *
-   * @param defs - QueryDef array to execute
-   * @param resultMetas - Result parsing metadata array (used for type conversion)
-   * @returns Array of execution results for each QueryDef
-   * @throws {Error} When not connected
-   */
-  async executeDefs(defs, resultMetas) {
-    const conn = this._requireConn();
-    const builder = createQueryBuilder(this._dialect);
-    if (resultMetas != null && resultMetas.every((item) => item == null)) {
-      const combinedSql = defs.map((def) => builder.build(def).sql).join("\n");
-      await conn.execute([combinedSql]);
-      return defs.map(() => []);
+/**
+ * Node.js 환경용 DbContextExecutor
+ *
+ * DbContext에서 사용하는 실제 DB 연결을 처리하는 실행자.
+ */
+export class NodeDbContextExecutor {
+    _config;
+    _conn;
+    _dialect;
+    constructor(_config) {
+        this._config = _config;
+        this._dialect = getDialectFromConfig(_config);
     }
-    const results = [];
-    for (let i = 0; i < defs.length; i++) {
-      const def = defs[i];
-      const meta = resultMetas?.[i];
-      const buildResult = builder.build(def);
-      const rawResults = await conn.execute([buildResult.sql]);
-      const targetResultSet = buildResult.resultSetIndex != null ? rawResults[buildResult.resultSetIndex] : rawResults[0];
-      if (meta != null) {
-        const parsed = await parseQueryResult(targetResultSet, meta);
-        results.push(parsed ?? []);
-      } else {
-        results.push(targetResultSet);
-      }
+    /**
+     * DB 연결을 수립한다
+     */
+    async connect() {
+        this._conn = await createDbConn(this._config);
+        await this._conn.connect();
     }
-    return results;
-  }
-  _requireConn() {
-    if (this._conn == null) {
-      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);
+    /**
+     * DB 연결을 종료한다
+     *
+     * @throws {Error} 연결되지 않은 경우
+     */
+    async close() {
+        const conn = this._requireConn();
+        await conn.close();
+        this._conn = undefined;
+    }
+    /**
+     * 트랜잭션을 시작한다
+     *
+     * @param isolationLevel - 트랜잭션 격리 수준
+     * @throws {Error} 연결되지 않은 경우
+     */
+    async beginTransaction(isolationLevel) {
+        const conn = this._requireConn();
+        await conn.beginTransaction(isolationLevel);
+    }
+    /**
+     * 트랜잭션을 커밋한다
+     *
+     * @throws {Error} 연결되지 않은 경우
+     */
+    async commitTransaction() {
+        const conn = this._requireConn();
+        await conn.commitTransaction();
+    }
+    /**
+     * 트랜잭션을 롤백한다
+     *
+     * @throws {Error} 연결되지 않은 경우
+     */
+    async rollbackTransaction() {
+        const conn = this._requireConn();
+        await conn.rollbackTransaction();
+    }
+    /**
+     * 파라미터화된 쿼리를 실행한다
+     *
+     * @param query - SQL 쿼리 문자열
+     * @param params - 쿼리 파라미터 배열
+     * @returns 쿼리 결과 배열
+     * @throws {Error} 연결되지 않은 경우
+     */
+    async executeParametrized(query, params) {
+        const conn = this._requireConn();
+        return conn.executeParametrized(query, params);
+    }
+    /**
+     * 대량 데이터 삽입 (네이티브 bulk API 사용)
+     *
+     * @param tableName - 대상 테이블 이름
+     * @param columnMetas - 컬럼 메타데이터
+     * @param records - 삽입할 레코드 배열
+     * @throws {Error} 연결되지 않은 경우
+     */
+    async bulkInsert(tableName, columnMetas, records) {
+        const conn = this._requireConn();
+        await conn.bulkInsert(tableName, columnMetas, records);
+    }
+    /**
+     * QueryDef 배열을 실행한다
+     *
+     * QueryDef를 SQL로 변환하여 실행하고, ResultMeta를 사용하여 결과를 파싱한다.
+     *
+     * @param defs - 실행할 QueryDef 배열
+     * @param resultMetas - 결과 파싱 메타데이터 배열 (타입 변환에 사용)
+     * @returns 각 QueryDef의 실행 결과 배열
+     * @throws {Error} 연결되지 않은 경우
+     */
+    async executeDefs(defs, resultMetas) {
+        const conn = this._requireConn();
+        const builder = createQueryBuilder(this._dialect);
+        // 데이터를 가져올 필요가 없도록 설정된 경우, 단일 쿼리로 한 번의 요청을 보낸다
+        // 결과가 필요 없으므로 인터페이스 계약을 유지하기 위해 defs.length에 맞는 빈 배열을 반환
+        if (resultMetas != null && resultMetas.every((item) => item == null)) {
+            const combinedSql = defs.map((def) => builder.build(def).sql).join("\n");
+            await conn.execute([combinedSql]);
+            return defs.map(() => []);
+        }
+        // 각 def를 개별적으로 실행
+        const results = [];
+        for (let i = 0; i < defs.length; i++) {
+            const def = defs[i];
+            const meta = resultMetas?.[i];
+            const buildResult = builder.build(def);
+            const rawResults = await conn.execute([buildResult.sql]);
+            // resultSetIndex가 지정된 경우 해당 인덱스의 결과 집합을 사용
+            const targetResultSet = buildResult.resultSetIndex != null ? rawResults[buildResult.resultSetIndex] : rawResults[0];
+            if (meta != null) {
+                const parsed = await parseQueryResult(targetResultSet, meta);
+                results.push(parsed ?? []);
+            }
+            else {
+                results.push(targetResultSet);
+            }
+        }
+        return results;
+    }
+    _requireConn() {
+        if (this._conn == null) {
+            throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);
+        }
+        return this._conn;
     }
-    return this._conn;
-  }
 }
-export {
-  NodeDbContextExecutor
-};
-//# sourceMappingURL=node-db-context-executor.js.map
+//# sourceMappingURL=node-db-context-executor.js.map

package/dist/node-db-context-executor.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/node-db-context-executor.ts"],
-  "mappings": "AAAA,SAAS,eAAe;AAUxB,SAAS,oBAAoB,wBAAwB;AAErD,SAAS,gBAAgB,4BAA4B;AACrD,SAAS,oBAAoB;AAOtB,MAAM,sBAAmD;AAAA,EAI9D,YAA6B,SAAuB;AAAvB;AAC3B,SAAK,WAAW,qBAAqB,OAAO;AAAA,EAC9C;AAAA,EALQ;AAAA,EACS;AAAA;AAAA;AAAA;AAAA,EASjB,MAAM,UAAyB;AAC7B,SAAK,QAAQ,MAAM,aAAa,KAAK,OAAO;AAC5C,UAAM,KAAK,MAAM,QAAQ;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAuB;AAC3B,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,MAAM;AACjB,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,iBAAiB,gBAAgD;AACrE,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,iBAAiB,cAAc;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBAAmC;AACvC,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,kBAAkB;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,sBAAqC;AACzC,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,oBAAoB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,oBACJ,OACA,QACsC;AACtC,UAAM,OAAO,KAAK,aAAa;AAC/B,WAAO,KAAK,oBAAoB,OAAO,MAAM;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,WACJ,WACA,aACA,SACe;AACf,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,WAAW,WAAW,aAAa,OAAO;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,YACJ,MACA,aACgB;AAChB,UAAM,OAAO,KAAK,aAAa;AAE/B,UAAM,UAAU,mBAAmB,KAAK,QAAQ;AAIhD,QAAI,eAAe,QAAQ,YAAY,MAAM,CAAC,SAAS,QAAQ,IAAI,GAAG;AACpE,YAAM,cAAc,KAAK,IAAI,CAAC,QAAQ,QAAQ,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,IAAI;AACvE,YAAM,KAAK,QAAQ,CAAC,WAAW,CAAC;AAChC,aAAO,KAAK,IAAI,MAAM,CAAC,CAAC;AAAA,IAC1B;AAGA,UAAM,UAAiB,CAAC;AACxB,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,YAAM,MAAM,KAAK,CAAC;AAClB,YAAM,OAAO,cAAc,CAAC;AAC5B,YAAM,cAAc,QAAQ,MAAM,GAAG;AAErC,YAAM,aAAa,MAAM,KAAK,QAAQ,CAAC,YAAY,GAAG,CAAC;AAGvD,YAAM,kBACJ,YAAY,kBAAkB,OAAO,WAAW,YAAY,cAAc,IAAI,WAAW,CAAC;AAE5F,UAAI,QAAQ,MAAM;AAChB,cAAM,SAAS,MAAM,iBAAoB,iBAAiB,IAAI;AAC9D,gBAAQ,KAAK,UAAU,CAAC,CAAC;AAAA,MAC3B,OAAO;AACL,gBAAQ,KAAK,eAAsB;AAAA,MACrC;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,eAAuB;AAC7B,QAAI,KAAK,SAAS,MAAM;AACtB,YAAM,IAAI,QAAQ,eAAe,aAAa;AAAA,IAChD;AACA,WAAO,KAAK;AAAA,EACd;AACF;",
-  "names": []
-}
+{"version":3,"file":"node-db-context-executor.js","sourceRoot":"","sources":["..\\src\\node-db-context-executor.ts"],"names":[],"mappings":"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"}

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

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