@simplysm/orm-node 13.0.0-beta.6 → 13.0.2

package/dist/create-orm.js

@@ -0,0 +1,32 @@
+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");
+    }
+    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));
+    }
+  };
+}
+export {
+  createOrm
+};
+//# sourceMappingURL=create-orm.js.map

package/dist/create-orm.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/create-orm.ts"],
+  "mappings": "AAAA,SAAS,uBAAuF;AAEhG,SAAS,6BAA6B;AAiF/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": []
+}

package/dist/{orm-node/src/index.d.ts → index.d.ts}

@@ -2,8 +2,8 @@ export * from "./types/db-conn";
 export * from "./connections/mssql-db-conn";
 export * from "./connections/mysql-db-conn";
 export * from "./connections/postgresql-db-conn";
-export * from "./db-conn-factory";
+export * from "./create-db-conn";
 export * from "./node-db-context-executor";
 export * from "./pooled-db-conn";
-export * from "./sd-orm";
+export * from "./create-orm";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC;AAGhC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AAGjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -1,9 +1,9 @@
-export * from "./types/db-conn";
-export * from "./connections/mssql-db-conn";
-export * from "./connections/mysql-db-conn";
-export * from "./connections/postgresql-db-conn";
-export * from "./db-conn-factory";
-export * from "./node-db-context-executor";
-export * from "./pooled-db-conn";
-export * from "./sd-orm";
+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 "./pooled-db-conn.js";
+export * from "./create-orm.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["// Types\nexport * from \"./types/db-conn\";\n\n// Connections\nexport * from \"./connections/mssql-db-conn\";\nexport * from \"./connections/mysql-db-conn\";\nexport * from \"./connections/postgresql-db-conn\";\n\n// Core\nexport * from \"./db-conn-factory\";\nexport * from \"./node-db-context-executor\";\nexport * from \"./pooled-db-conn\";\nexport * from \"./sd-orm\";\n"],
   "mappings": "AACA,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-db-context-executor.d.ts","sourceRoot":"","sources":["../src/node-db-context-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,UAAU,EAEV,UAAU,EACV,UAAU,EACX,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI5D;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IAIjD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEN,OAAO,EAAE,YAAY;IAIlD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;OAKG;IACG,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtE;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C;;;;;;;OAOG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IAKlF;;;;;;;OAOG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlH;;;;;;;;;OASG;IACG,WAAW,CAAC,CAAC,GAAG,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC;IAqC7G,OAAO,CAAC,YAAY;CAMrB"}

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

@@ -1,7 +1,7 @@
 import { SdError } from "@simplysm/core-common";
 import { createQueryBuilder, parseQueryResult } from "@simplysm/orm-common";
-import { DB_CONN_ERRORS, getDialectFromConfig } from "./types/db-conn";
-import { DbConnFactory } from "./db-conn-factory";
+import { DB_CONN_ERRORS, getDialectFromConfig } from "./types/db-conn.js";
+import { createDbConn } from "./create-db-conn.js";
 class NodeDbContextExecutor {
   constructor(_config) {
     this._config = _config;
@@ -15,7 +15,7 @@ class NodeDbContextExecutor {
    * 커넥션 풀에서 연결을 획득하고 연결 상태를 활성화한다.
    */
   async connect() {
-    this._conn = await DbConnFactory.create(this._config);
+    this._conn = await createDbConn(this._config);
     await this._conn.connect();
   }
   /**

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

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/node-db-context-executor.ts"],
-  "sourcesContent": ["import { SdError } from \"@simplysm/core-common\";\nimport type {\n  DbContextExecutor,\n  IsolationLevel,\n  QueryDef,\n  ResultMeta,\n  Dialect,\n  ColumnMeta,\n  DataRecord,\n} from \"@simplysm/orm-common\";\nimport { createQueryBuilder, parseQueryResult } from \"@simplysm/orm-common\";\nimport type { DbConn, DbConnConfig } from \"./types/db-conn\";\nimport { DB_CONN_ERRORS, getDialectFromConfig } from \"./types/db-conn\";\nimport { DbConnFactory } from \"./db-conn-factory\";\n\n/**\n * Node.js \uD658\uACBD\uC6A9 DbContextExecutor\n *\n * DbContext\uC5D0\uC11C \uC0AC\uC6A9\uD558\uB294 \uC2E4\uD589\uAE30\uB85C, \uC2E4\uC81C DB \uC5F0\uACB0\uC744 \uB2F4\uB2F9\uD55C\uB2E4.\n */\nexport class NodeDbContextExecutor implements DbContextExecutor {\n  private _conn?: DbConn;\n  private readonly _dialect: Dialect;\n\n  constructor(private readonly _config: DbConnConfig) {\n    this._dialect = getDialectFromConfig(_config);\n  }\n\n  /**\n   * DB \uC5F0\uACB0 \uC218\uB9BD\n   *\n   * \uCEE4\uB125\uC158 \uD480\uC5D0\uC11C \uC5F0\uACB0\uC744 \uD68D\uB4DD\uD558\uACE0 \uC5F0\uACB0 \uC0C1\uD0DC\uB97C \uD65C\uC131\uD654\uD55C\uB2E4.\n   */\n  async connect(): Promise<void> {\n    this._conn = await DbConnFactory.create(this._config);\n    await this._conn.connect();\n  }\n\n  /**\n   * DB \uC5F0\uACB0 \uC885\uB8CC\n   *\n   * \uCEE4\uB125\uC158 \uD480\uC5D0 \uC5F0\uACB0\uC744 \uBC18\uD658\uD55C\uB2E4.\n   *\n   * @throws {Error} \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async close(): Promise<void> {\n    const conn = this._requireConn();\n    await conn.close();\n    this._conn = undefined;\n  }\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uC2DC\uC791\n   *\n   * @param isolationLevel - \uD2B8\uB79C\uC7AD\uC158 \uACA9\uB9AC \uC218\uC900\n   * @throws {Error} \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async beginTransaction(isolationLevel?: IsolationLevel): Promise<void> {\n    const conn = this._requireConn();\n    await conn.beginTransaction(isolationLevel);\n  }\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uCEE4\uBC0B\n   *\n   * @throws {Error} \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async commitTransaction(): Promise<void> {\n    const conn = this._requireConn();\n    await conn.commitTransaction();\n  }\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uB864\uBC31\n   *\n   * @throws {Error} \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async rollbackTransaction(): Promise<void> {\n    const conn = this._requireConn();\n    await conn.rollbackTransaction();\n  }\n\n  /**\n   * \uD30C\uB77C\uBBF8\uD130\uD654\uB41C \uCFFC\uB9AC \uC2E4\uD589\n   *\n   * @param query - SQL \uCFFC\uB9AC \uBB38\uC790\uC5F4\n   * @param params - \uCFFC\uB9AC \uD30C\uB77C\uBBF8\uD130 \uBC30\uC5F4\n   * @returns \uCFFC\uB9AC \uACB0\uACFC \uBC30\uC5F4\n   * @throws {Error} \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async executeParametrized(query: string, params?: unknown[]): Promise<unknown[][]> {\n    const conn = this._requireConn();\n    return conn.executeParametrized(query, params);\n  }\n\n  /**\n   * \uB300\uB7C9 \uB370\uC774\uD130 \uC0BD\uC785 (\uB124\uC774\uD2F0\uBE0C \uBC8C\uD06C API \uC0AC\uC6A9)\n   *\n   * @param tableName - \uB300\uC0C1 \uD14C\uC774\uBE14\uBA85\n   * @param columnMetas - \uCEEC\uB7FC \uBA54\uD0C0\uB370\uC774\uD130\n   * @param records - \uC0BD\uC785\uD560 \uB808\uCF54\uB4DC \uBC30\uC5F4\n   * @throws {Error} \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async bulkInsert(tableName: string, columnMetas: Record<string, ColumnMeta>, records: DataRecord[]): Promise<void> {\n    const conn = this._requireConn();\n    await conn.bulkInsert(tableName, columnMetas, records);\n  }\n\n  /**\n   * QueryDef \uBC30\uC5F4 \uC2E4\uD589\n   *\n   * QueryDef\uB97C SQL\uB85C \uBCC0\uD658\uD558\uC5EC \uC2E4\uD589\uD558\uACE0, ResultMeta\uB97C \uC0AC\uC6A9\uD558\uC5EC \uACB0\uACFC\uB97C \uD30C\uC2F1\uD55C\uB2E4.\n   *\n   * @param defs - \uC2E4\uD589\uD560 QueryDef \uBC30\uC5F4\n   * @param resultMetas - \uACB0\uACFC \uD30C\uC2F1\uC6A9 \uBA54\uD0C0\uB370\uC774\uD130 \uBC30\uC5F4 (\uD0C0\uC785 \uBCC0\uD658\uC5D0 \uC0AC\uC6A9)\n   * @returns \uAC01 QueryDef\uC758 \uC2E4\uD589 \uACB0\uACFC \uBC30\uC5F4\n   * @throws {Error} \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]> {\n    const conn = this._requireConn();\n\n    const builder = createQueryBuilder(this._dialect);\n\n    // \uAC00\uC838\uC62C \uB370\uC774\uD130\uAC00 \uC5C6\uB294 \uAC83\uC73C\uB85C \uC635\uC158 \uC124\uC815\uC744 \uD588\uC744 \uB54C, \uD558\uB098\uC758 \uCFFC\uB9AC\uB85C \uD55C\uBC88\uC758 \uC694\uCCAD \uBCF4\uB0C4\n    // \uACB0\uACFC\uAC00 \uD544\uC694 \uC5C6\uC73C\uBBC0\uB85C defs.length\uAC1C\uC758 \uBE48 \uBC30\uC5F4\uC744 \uBC18\uD658\uD558\uC5EC \uC778\uD130\uD398\uC774\uC2A4 \uACC4\uC57D \uC720\uC9C0\n    if (resultMetas != null && resultMetas.every((item) => item == null)) {\n      const combinedSql = defs.map((def) => builder.build(def).sql).join(\"\\n\");\n      await conn.execute([combinedSql]);\n      return defs.map(() => []) as T[][];\n    }\n\n    // \uAC01 def\uB97C \uAC1C\uBCC4 \uC2E4\uD589\n    const results: T[][] = [];\n    for (let i = 0; i < defs.length; i++) {\n      const def = defs[i];\n      const meta = resultMetas?.[i];\n      const buildResult = builder.build(def);\n\n      const rawResults = await conn.execute([buildResult.sql]);\n\n      // resultSetIndex\uAC00 \uC9C0\uC815\uB41C \uACBD\uC6B0 \uD574\uB2F9 \uC778\uB371\uC2A4\uC758 \uACB0\uACFC\uC14B \uC0AC\uC6A9\n      const targetResultSet =\n        buildResult.resultSetIndex != null ? rawResults[buildResult.resultSetIndex] : rawResults[0];\n\n      if (meta != null) {\n        const parsed = await parseQueryResult<T>(targetResultSet as Record<string, unknown>[], meta);\n        results.push(parsed ?? []);\n      } else {\n        results.push(targetResultSet as T[]);\n      }\n    }\n\n    return results;\n  }\n\n  private _requireConn(): DbConn {\n    if (this._conn == null) {\n      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);\n    }\n    return this._conn;\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,eAAe;AAUxB,SAAS,oBAAoB,wBAAwB;AAErD,SAAS,gBAAgB,4BAA4B;AACrD,SAAS,qBAAqB;AAOvB,MAAM,sBAAmD;AAAA,EAI9D,YAA6B,SAAuB;AAAvB;AAC3B,SAAK,WAAW,qBAAqB,OAAO;AAAA,EAC9C;AAAA,EALQ;AAAA,EACS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWjB,MAAM,UAAyB;AAC7B,SAAK,QAAQ,MAAM,cAAc,OAAO,KAAK,OAAO;AACpD,UAAM,KAAK,MAAM,QAAQ;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,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,oBAAoB,OAAe,QAA0C;AACjF,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,WAAW,WAAmB,aAAyC,SAAsC;AACjH,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,YAA4B,MAAkB,aAA0D;AAC5G,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,iBAA8C,IAAI;AAC3F,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;",
+  "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;AAAA;AAAA,EAWjB,MAAM,UAAyB;AAC7B,SAAK,QAAQ,MAAM,aAAa,KAAK,OAAO;AAC5C,UAAM,KAAK,MAAM,QAAQ;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,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,oBAAoB,OAAe,QAA0C;AACjF,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,WAAW,WAAmB,aAAyC,SAAsC;AACjH,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,YAA4B,MAAkB,aAA0D;AAC5G,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,iBAA8C,IAAI;AAC3F,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": []
 }

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

@@ -0,0 +1 @@
+{"version":3,"file":"pooled-db-conn.d.ts","sourceRoot":"","sources":["../src/pooled-db-conn.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAkB,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIjF;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,YAAY,CAAC;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,CAAE,YAAW,MAAM;IAK7E,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAJjC,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAGP,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EACnB,cAAc,EAAE,YAAY;IAM/C,IAAI,MAAM,IAAI,YAAY,CAEzB;IAGD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAGD,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAIF;;;;;OAKG;IACG,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtE;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IAKtD;;;;;;;OAOG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IAKlF;;;;;;;OAOG;IACG,UAAU,CACd,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;IAKhB,OAAO,CAAC,eAAe;CAMxB"}

package/dist/pooled-db-conn.js

@@ -1,7 +1,7 @@
-import { createConsola } from "consola";
+import consola from "consola";
 import { SdError, EventEmitter } from "@simplysm/core-common";
-import { DB_CONN_ERRORS } from "./types/db-conn";
-const logger = createConsola().withTag("pooled-db-conn");
+import { DB_CONN_ERRORS } from "./types/db-conn.js";
+const logger = consola.withTag("pooled-db-conn");
 class PooledDbConn extends EventEmitter {
   constructor(_pool, _initialConfig) {
     super();

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

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/pooled-db-conn.ts"],
-  "sourcesContent": ["import { createConsola } from \"consola\";\nimport { SdError, EventEmitter } from \"@simplysm/core-common\";\nimport type { Pool } from \"generic-pool\";\nimport type { ColumnMeta, IsolationLevel } from \"@simplysm/orm-common\";\nimport { DB_CONN_ERRORS, type DbConn, type DbConnConfig } from \"./types/db-conn\";\n\nconst logger = createConsola().withTag(\"pooled-db-conn\");\n\n/**\n * \uCEE4\uB125\uC158 \uD480\uC5D0\uC11C \uAD00\uB9AC\uB418\uB294 DB \uC5F0\uACB0 \uB798\uD37C\n *\n * generic-pool \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB97C \uC0AC\uC6A9\uD558\uC5EC \uCEE4\uB125\uC158 \uD480\uB9C1\uC744 \uC9C0\uC6D0\uD55C\uB2E4.\n * \uC2E4\uC81C \uBB3C\uB9AC \uC5F0\uACB0\uC740 \uD480\uC5D0\uC11C \uD68D\uB4DD\uD558\uACE0 \uBC18\uD658\uD55C\uB2E4.\n */\nexport class PooledDbConn extends EventEmitter<{ close: void }> implements DbConn {\n  // \uD480\uC5D0\uC11C \uBE4C\uB824\uC628 \uC2E4\uC81C \uBB3C\uB9AC \uCEE4\uB125\uC158\n  private _rawConn?: DbConn;\n\n  constructor(\n    private readonly _pool: Pool<DbConn>,\n    private readonly _initialConfig: DbConnConfig,\n  ) {\n    super();\n  }\n\n  // [Property] config\n  get config(): DbConnConfig {\n    return this._rawConn?.config ?? this._initialConfig;\n  }\n\n  // [Property] isConnected\n  get isConnected(): boolean {\n    return this._rawConn?.isConnected ?? false;\n  }\n\n  // [Property] isOnTransaction\n  get isOnTransaction(): boolean {\n    return this._rawConn?.isOnTransaction ?? false;\n  }\n\n  /**\n   * \uD480\uC5D0\uC11C DB \uC5F0\uACB0\uC744 \uD68D\uB4DD\uD55C\uB2E4.\n   *\n   * @throws {SdError} \uC774\uBBF8 \uC5F0\uACB0\uB41C \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async connect(): Promise<void> {\n    if (this._rawConn != null) {\n      throw new SdError(DB_CONN_ERRORS.ALREADY_CONNECTED);\n    }\n\n    // 1. \uD480\uC5D0\uC11C \uCEE4\uB125\uC158 \uD68D\uB4DD\n    this._rawConn = await this._pool.acquire();\n\n    // 2. \uBB3C\uB9AC \uC5F0\uACB0\uC774 (\uD0C0\uC784\uC544\uC6C3 \uB4F1\uC73C\uB85C) \uB04A\uC5B4\uC9C8 \uACBD\uC6B0\uB97C \uB300\uBE44\uD574 \uB9AC\uC2A4\uB108 \uB4F1\uB85D\n    //    \uB9CC\uC57D \uC0AC\uC6A9 \uC911\uC5D0 \uB04A\uAE30\uBA74 PooledDbConn\uB3C4 close \uC774\uBCA4\uD2B8\uB97C \uBC1C\uC0DD\uC2DC\uCF1C\uC57C \uD568\n    this._rawConn.on(\"close\", this._onRawConnClose);\n  }\n\n  /**\n   * \uD480\uC5D0 DB \uC5F0\uACB0\uC744 \uBC18\uD658\uD55C\uB2E4. (\uC2E4\uC81C \uC5F0\uACB0\uC744 \uC885\uB8CC\uD558\uC9C0 \uC54A\uC74C)\n   */\n  async close(): Promise<void> {\n    if (this._rawConn != null) {\n      // 1. \uD2B8\uB79C\uC7AD\uC158 \uC9C4\uD589 \uC911\uC774\uBA74 \uB864\uBC31\uD558\uC5EC \uAE68\uB057\uD55C \uC0C1\uD0DC\uB85C \uD480\uC5D0 \uBC18\uD658\n      if (this._rawConn.isOnTransaction) {\n        try {\n          await this._rawConn.rollbackTransaction();\n        } catch (err) {\n          // \uB864\uBC31 \uC2E4\uD328 \uC2DC \uB85C\uADF8\uB9CC \uB0A8\uAE30\uACE0 \uACC4\uC18D \uC9C4\uD589 (\uC5F0\uACB0\uC774 \uC774\uBBF8 \uB04A\uAE34 \uACBD\uC6B0 \uB4F1)\n          logger.warn(\"\uD480 \uBC18\uD658 \uC2DC \uB864\uBC31 \uC2E4\uD328\", err instanceof Error ? err.message : String(err));\n        }\n      }\n\n      // 2. \uB9AC\uC2A4\uB108 \uD574\uC81C (Pool\uC5D0 \uB3CC\uC544\uAC00\uC11C \uB2E4\uB978 \uB798\uD37C\uC5D0 \uC758\uD574 \uC7AC\uC0AC\uC6A9\uB420 \uB54C \uC601\uD5A5 \uC8FC\uC9C0 \uC54A\uB3C4\uB85D)\n      this._rawConn.off(\"close\", this._onRawConnClose);\n\n      // 3. \uD480\uC5D0 \uCEE4\uB125\uC158 \uBC18\uD658 (\uC2E4\uC81C\uB85C \uB04A\uC9C0 \uC54A\uC74C)\n      await this._pool.release(this._rawConn);\n      this._rawConn = undefined;\n\n      // 4. \uC18C\uBE44\uC790\uC5D0\uAC8C \uB17C\uB9AC\uC801\uC73C\uB85C \uC5F0\uACB0\uC774 \uB2EB\uD614\uC74C\uC744 \uC54C\uB9BC\n      this.emit(\"close\");\n    }\n  }\n\n  // \uBB3C\uB9AC \uC5F0\uACB0\uC774 \uB04A\uACBC\uC744 \uB54C \uCC98\uB9AC \uD578\uB4E4\uB7EC\n  private readonly _onRawConnClose = () => {\n    // \uBB3C\uB9AC \uC5F0\uACB0\uC774 \uB04A\uACBC\uC73C\uBBC0\uB85C \uCC38\uC870 \uC81C\uAC70 (Pool\uC5D0\uC11C\uB294 validate \uC2DC\uC810\uC5D0 \uAC78\uB7EC\uB0BC \uAC83\uC784)\n    this._rawConn = undefined;\n    // \uC18C\uBE44\uC790\uC5D0\uAC8C \uC54C\uB9BC\n    this.emit(\"close\");\n  };\n\n  // --- \uC544\uB798\uB294 \uC704\uC784(Delegation) \uBA54\uC18C\uB4DC ---\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uC2DC\uC791\n   *\n   * @param isolationLevel - \uD2B8\uB79C\uC7AD\uC158 \uACA9\uB9AC \uC218\uC900\n   * @throws {SdError} \uC5F0\uACB0\uC774 \uD68D\uB4DD\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async beginTransaction(isolationLevel?: IsolationLevel): Promise<void> {\n    const conn = this._requireRawConn();\n    await conn.beginTransaction(isolationLevel);\n  }\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uCEE4\uBC0B\n   *\n   * @throws {SdError} \uC5F0\uACB0\uC774 \uD68D\uB4DD\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async commitTransaction(): Promise<void> {\n    const conn = this._requireRawConn();\n    await conn.commitTransaction();\n  }\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uB864\uBC31\n   *\n   * @throws {SdError} \uC5F0\uACB0\uC774 \uD68D\uB4DD\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async rollbackTransaction(): Promise<void> {\n    const conn = this._requireRawConn();\n    await conn.rollbackTransaction();\n  }\n\n  /**\n   * SQL \uCFFC\uB9AC \uC2E4\uD589\n   *\n   * @param queries - \uC2E4\uD589\uD560 SQL \uCFFC\uB9AC \uBC30\uC5F4\n   * @returns \uAC01 \uCFFC\uB9AC\uC758 \uACB0\uACFC \uBC30\uC5F4\n   * @throws {SdError} \uC5F0\uACB0\uC774 \uD68D\uB4DD\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async execute(queries: string[]): Promise<unknown[][]> {\n    const conn = this._requireRawConn();\n    return conn.execute(queries);\n  }\n\n  /**\n   * \uD30C\uB77C\uBBF8\uD130\uD654\uB41C SQL \uCFFC\uB9AC \uC2E4\uD589\n   *\n   * @param query - SQL \uCFFC\uB9AC \uBB38\uC790\uC5F4\n   * @param params - \uCFFC\uB9AC \uD30C\uB77C\uBBF8\uD130 \uBC30\uC5F4\n   * @returns \uCFFC\uB9AC \uACB0\uACFC \uBC30\uC5F4\n   * @throws {SdError} \uC5F0\uACB0\uC774 \uD68D\uB4DD\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async executeParametrized(query: string, params?: unknown[]): Promise<unknown[][]> {\n    const conn = this._requireRawConn();\n    return conn.executeParametrized(query, params);\n  }\n\n  /**\n   * \uB300\uB7C9 \uB370\uC774\uD130 \uC0BD\uC785 (\uB124\uC774\uD2F0\uBE0C \uBC8C\uD06C API \uC0AC\uC6A9)\n   *\n   * @param tableName - \uB300\uC0C1 \uD14C\uC774\uBE14\uBA85\n   * @param columnMetas - \uCEEC\uB7FC \uBA54\uD0C0\uB370\uC774\uD130\n   * @param records - \uC0BD\uC785\uD560 \uB808\uCF54\uB4DC \uBC30\uC5F4\n   * @throws {SdError} \uC5F0\uACB0\uC774 \uD68D\uB4DD\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC77C \uB54C\n   */\n  async bulkInsert(\n    tableName: string,\n    columnMetas: Record<string, ColumnMeta>,\n    records: Record<string, unknown>[],\n  ): Promise<void> {\n    const conn = this._requireRawConn();\n    await conn.bulkInsert(tableName, columnMetas, records);\n  }\n\n  private _requireRawConn(): DbConn {\n    if (this._rawConn == null) {\n      throw new SdError(`${DB_CONN_ERRORS.NOT_CONNECTED} (Pool Connection is not acquired)`);\n    }\n    return this._rawConn;\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,qBAAqB;AAC9B,SAAS,SAAS,oBAAoB;AAGtC,SAAS,sBAAsD;AAE/D,MAAM,SAAS,cAAc,EAAE,QAAQ,gBAAgB;AAQhD,MAAM,qBAAqB,aAAgD;AAAA,EAIhF,YACmB,OACA,gBACjB;AACA,UAAM;AAHW;AACA;AAAA,EAGnB;AAAA;AAAA,EAPQ;AAAA;AAAA,EAUR,IAAI,SAAuB;AACzB,WAAO,KAAK,UAAU,UAAU,KAAK;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK,UAAU,eAAe;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,kBAA2B;AAC7B,WAAO,KAAK,UAAU,mBAAmB;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAyB;AAC7B,QAAI,KAAK,YAAY,MAAM;AACzB,YAAM,IAAI,QAAQ,eAAe,iBAAiB;AAAA,IACpD;AAGA,SAAK,WAAW,MAAM,KAAK,MAAM,QAAQ;AAIzC,SAAK,SAAS,GAAG,SAAS,KAAK,eAAe;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAuB;AAC3B,QAAI,KAAK,YAAY,MAAM;AAEzB,UAAI,KAAK,SAAS,iBAAiB;AACjC,YAAI;AACF,gBAAM,KAAK,SAAS,oBAAoB;AAAA,QAC1C,SAAS,KAAK;AAEZ,iBAAO,KAAK,wDAAgB,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,QAC9E;AAAA,MACF;AAGA,WAAK,SAAS,IAAI,SAAS,KAAK,eAAe;AAG/C,YAAM,KAAK,MAAM,QAAQ,KAAK,QAAQ;AACtC,WAAK,WAAW;AAGhB,WAAK,KAAK,OAAO;AAAA,IACnB;AAAA,EACF;AAAA;AAAA,EAGiB,kBAAkB,MAAM;AAEvC,SAAK,WAAW;AAEhB,SAAK,KAAK,OAAO;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,iBAAiB,gBAAgD;AACrE,UAAM,OAAO,KAAK,gBAAgB;AAClC,UAAM,KAAK,iBAAiB,cAAc;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBAAmC;AACvC,UAAM,OAAO,KAAK,gBAAgB;AAClC,UAAM,KAAK,kBAAkB;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,sBAAqC;AACzC,UAAM,OAAO,KAAK,gBAAgB;AAClC,UAAM,KAAK,oBAAoB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAQ,SAAyC;AACrD,UAAM,OAAO,KAAK,gBAAgB;AAClC,WAAO,KAAK,QAAQ,OAAO;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,oBAAoB,OAAe,QAA0C;AACjF,UAAM,OAAO,KAAK,gBAAgB;AAClC,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,gBAAgB;AAClC,UAAM,KAAK,WAAW,WAAW,aAAa,OAAO;AAAA,EACvD;AAAA,EAEQ,kBAA0B;AAChC,QAAI,KAAK,YAAY,MAAM;AACzB,YAAM,IAAI,QAAQ,GAAG,eAAe,aAAa,oCAAoC;AAAA,IACvF;AACA,WAAO,KAAK;AAAA,EACd;AACF;",
+  "mappings": "AAAA,OAAO,aAAa;AACpB,SAAS,SAAS,oBAAoB;AAGtC,SAAS,sBAAsD;AAE/D,MAAM,SAAS,QAAQ,QAAQ,gBAAgB;AAQxC,MAAM,qBAAqB,aAAgD;AAAA,EAIhF,YACmB,OACA,gBACjB;AACA,UAAM;AAHW;AACA;AAAA,EAGnB;AAAA;AAAA,EAPQ;AAAA;AAAA,EAUR,IAAI,SAAuB;AACzB,WAAO,KAAK,UAAU,UAAU,KAAK;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK,UAAU,eAAe;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,kBAA2B;AAC7B,WAAO,KAAK,UAAU,mBAAmB;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAyB;AAC7B,QAAI,KAAK,YAAY,MAAM;AACzB,YAAM,IAAI,QAAQ,eAAe,iBAAiB;AAAA,IACpD;AAGA,SAAK,WAAW,MAAM,KAAK,MAAM,QAAQ;AAIzC,SAAK,SAAS,GAAG,SAAS,KAAK,eAAe;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAuB;AAC3B,QAAI,KAAK,YAAY,MAAM;AAEzB,UAAI,KAAK,SAAS,iBAAiB;AACjC,YAAI;AACF,gBAAM,KAAK,SAAS,oBAAoB;AAAA,QAC1C,SAAS,KAAK;AAEZ,iBAAO,KAAK,wDAAgB,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,QAC9E;AAAA,MACF;AAGA,WAAK,SAAS,IAAI,SAAS,KAAK,eAAe;AAG/C,YAAM,KAAK,MAAM,QAAQ,KAAK,QAAQ;AACtC,WAAK,WAAW;AAGhB,WAAK,KAAK,OAAO;AAAA,IACnB;AAAA,EACF;AAAA;AAAA,EAGiB,kBAAkB,MAAM;AAEvC,SAAK,WAAW;AAEhB,SAAK,KAAK,OAAO;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,iBAAiB,gBAAgD;AACrE,UAAM,OAAO,KAAK,gBAAgB;AAClC,UAAM,KAAK,iBAAiB,cAAc;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBAAmC;AACvC,UAAM,OAAO,KAAK,gBAAgB;AAClC,UAAM,KAAK,kBAAkB;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,sBAAqC;AACzC,UAAM,OAAO,KAAK,gBAAgB;AAClC,UAAM,KAAK,oBAAoB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAQ,SAAyC;AACrD,UAAM,OAAO,KAAK,gBAAgB;AAClC,WAAO,KAAK,QAAQ,OAAO;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,oBAAoB,OAAe,QAA0C;AACjF,UAAM,OAAO,KAAK,gBAAgB;AAClC,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,gBAAgB;AAClC,UAAM,KAAK,WAAW,WAAW,aAAa,OAAO;AAAA,EACvD;AAAA,EAEQ,kBAA0B;AAChC,QAAI,KAAK,YAAY,MAAM;AACzB,YAAM,IAAI,QAAQ,GAAG,eAAe,aAAa,oCAAoC;AAAA,IACvF;AACA,WAAO,KAAK;AAAA,EACd;AACF;",
   "names": []
 }

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

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

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

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/types/db-conn.ts"],
-  "sourcesContent": ["import type { EventEmitter } from \"@simplysm/core-common\";\nimport type { ColumnMeta, Dialect, IsolationLevel } from \"@simplysm/orm-common\";\n\n// ============================================\n// \uACF5\uD1B5 \uC0C1\uC218\n// ============================================\n\n/**\n * DB \uC5F0\uACB0 \uAE30\uBCF8 \uD0C0\uC784\uC544\uC6C3 (10\uBD84)\n */\nexport const DB_CONN_DEFAULT_TIMEOUT = 10 * 60 * 1000;\n\n/**\n * DB \uC5F0\uACB0 \uC5D0\uB7EC \uBA54\uC2DC\uC9C0\n */\nexport const DB_CONN_ERRORS = {\n  NOT_CONNECTED: \"'Connection'\uC774 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.\",\n  ALREADY_CONNECTED: \"\uC774\uBBF8 'Connection'\uC774 \uC5F0\uACB0\uB418\uC5B4\uC788\uC2B5\uB2C8\uB2E4.\",\n} as const;\n\n// ============================================\n// IDbConn Interface\n// ============================================\n\n/**\n * \uC800\uC218\uC900 DB \uC5F0\uACB0 \uC778\uD130\uD398\uC774\uC2A4\n *\n * \uAC01 DBMS\uBCC4 \uAD6C\uD604\uCCB4\uAC00 \uC774 \uC778\uD130\uD398\uC774\uC2A4\uB97C \uAD6C\uD604\uD569\uB2C8\uB2E4.\n * - {@link MysqlDbConn} - MySQL \uC5F0\uACB0\n * - {@link MssqlDbConn} - MSSQL \uC5F0\uACB0\n * - {@link PostgresqlDbConn} - PostgreSQL \uC5F0\uACB0\n *\n * @remarks\n * SdEventEmitter\uB97C \uC0C1\uC18D\uD558\uC5EC 'close' \uC774\uBCA4\uD2B8\uB97C \uBC1C\uC0DD\uC2DC\uD0B5\uB2C8\uB2E4.\n */\nexport interface DbConn extends EventEmitter<{ close: void }> {\n  /**\n   * \uC5F0\uACB0 \uC124\uC815\n   */\n  config: DbConnConfig;\n\n  /**\n   * \uC5F0\uACB0 \uC5EC\uBD80\n   */\n  isConnected: boolean;\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uC9C4\uD589 \uC5EC\uBD80\n   */\n  isOnTransaction: boolean;\n\n  /**\n   * DB \uC5F0\uACB0 \uC218\uB9BD\n   */\n  connect(): Promise<void>;\n\n  /**\n   * DB \uC5F0\uACB0 \uC885\uB8CC\n   */\n  close(): Promise<void>;\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uC2DC\uC791\n   *\n   * @param isolationLevel - \uACA9\uB9AC \uC218\uC900 (\uC120\uD0DD)\n   */\n  beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uCEE4\uBC0B\n   */\n  commitTransaction(): Promise<void>;\n\n  /**\n   * \uD2B8\uB79C\uC7AD\uC158 \uB864\uBC31\n   */\n  rollbackTransaction(): Promise<void>;\n\n  /**\n   * SQL \uCFFC\uB9AC \uBC30\uC5F4 \uC2E4\uD589\n   *\n   * @param queries - \uC2E4\uD589\uD560 SQL \uBB38\uC790\uC5F4 \uBC30\uC5F4\n   * @returns \uAC01 \uCFFC\uB9AC\uBCC4 \uACB0\uACFC \uBC30\uC5F4\uC758 \uBC30\uC5F4\n   */\n  execute(queries: string[]): Promise<unknown[][]>;\n\n  /**\n   * \uD30C\uB77C\uBBF8\uD130\uD654\uB41C \uCFFC\uB9AC \uC2E4\uD589\n   *\n   * @param query - SQL \uCFFC\uB9AC \uBB38\uC790\uC5F4\n   * @param params - \uBC14\uC778\uB529 \uD30C\uB77C\uBBF8\uD130 (\uC120\uD0DD)\n   * @returns \uACB0\uACFC \uBC30\uC5F4\uC758 \uBC30\uC5F4\n   */\n  executeParametrized(query: string, params?: unknown[]): Promise<unknown[][]>;\n\n  /**\n   * \uB300\uB7C9 INSERT (\uB124\uC774\uD2F0\uBE0C \uBC8C\uD06C API \uC0AC\uC6A9)\n   *\n   * - MSSQL: tedious BulkLoad\n   * - MySQL: LOAD DATA LOCAL INFILE (\uC784\uC2DC \uD30C\uC77C)\n   * - PostgreSQL: COPY FROM STDIN\n   *\n   * @param tableName - \uD14C\uC774\uBE14\uBA85 (database.table \uB610\uB294 database.schema.table)\n   * @param columnMetas - \uCEEC\uB7FC\uBA85 \u2192 ColumnMeta \uB9E4\uD551\n   * @param records - \uC0BD\uC785\uD560 \uB808\uCF54\uB4DC \uBC30\uC5F4\n   */\n  bulkInsert(\n    tableName: string,\n    columnMetas: Record<string, ColumnMeta>,\n    records: Record<string, unknown>[],\n  ): Promise<void>;\n}\n\n// ============================================\n// DbConnConfig Types\n// ============================================\n\n/**\n * \uCEE4\uB125\uC158 \uD480 \uC124\uC815\n *\n * @remarks\n * \uAC01 \uAC12\uC758 \uAE30\uBCF8\uAC12:\n * - min: 1 (\uCD5C\uC18C \uC5F0\uACB0 \uC218)\n * - max: 10 (\uCD5C\uB300 \uC5F0\uACB0 \uC218)\n * - acquireTimeoutMillis: 30000 (\uC5F0\uACB0 \uD68D\uB4DD \uD0C0\uC784\uC544\uC6C3)\n * - idleTimeoutMillis: 30000 (\uC720\uD734 \uC5F0\uACB0 \uD0C0\uC784\uC544\uC6C3)\n */\nexport interface DbPoolConfig {\n  /** \uCD5C\uC18C \uC5F0\uACB0 \uC218 (\uAE30\uBCF8: 1) */\n  min?: number;\n  /** \uCD5C\uB300 \uC5F0\uACB0 \uC218 (\uAE30\uBCF8: 10) */\n  max?: number;\n  /** \uC5F0\uACB0 \uD68D\uB4DD \uD0C0\uC784\uC544\uC6C3 (\uBC00\uB9AC\uCD08, \uAE30\uBCF8: 30000) */\n  acquireTimeoutMillis?: number;\n  /** \uC720\uD734 \uC5F0\uACB0 \uD0C0\uC784\uC544\uC6C3 (\uBC00\uB9AC\uCD08, \uAE30\uBCF8: 30000) */\n  idleTimeoutMillis?: number;\n}\n\n/**\n * DB \uC5F0\uACB0 \uC124\uC815 \uD0C0\uC785 (dialect\uBCC4 \uBD84\uAE30)\n */\nexport type DbConnConfig = MysqlDbConnConfig | MssqlDbConnConfig | PostgresqlDbConnConfig;\n\n/**\n * MySQL \uC5F0\uACB0 \uC124\uC815\n */\nexport interface MysqlDbConnConfig {\n  dialect: \"mysql\";\n  host: string;\n  port?: number;\n  username: string;\n  password: string;\n  database?: string;\n  defaultIsolationLevel?: IsolationLevel;\n  pool?: DbPoolConfig;\n}\n\n/**\n * MSSQL \uC5F0\uACB0 \uC124\uC815\n */\nexport interface MssqlDbConnConfig {\n  dialect: \"mssql\" | \"mssql-azure\";\n  host: string;\n  port?: number;\n  username: string;\n  password: string;\n  database?: string;\n  schema?: string;\n  defaultIsolationLevel?: IsolationLevel;\n  pool?: DbPoolConfig;\n}\n\n/**\n * PostgreSQL \uC5F0\uACB0 \uC124\uC815\n */\nexport interface PostgresqlDbConnConfig {\n  dialect: \"postgresql\";\n  host: string;\n  port?: number;\n  username: string;\n  password: string;\n  database?: string;\n  schema?: string;\n  defaultIsolationLevel?: IsolationLevel;\n  pool?: DbPoolConfig;\n}\n\n/**\n * DbConnConfig\uC5D0\uC11C Dialect \uCD94\uCD9C\n */\nexport function getDialectFromConfig(config: DbConnConfig): Dialect {\n  if (config.dialect === \"mssql-azure\") {\n    return \"mssql\";\n  }\n  return config.dialect;\n}\n"],
   "mappings": "AAUO,MAAM,0BAA0B,KAAK,KAAK;AAK1C,MAAM,iBAAiB;AAAA,EAC5B,eAAe;AAAA,EACf,mBAAmB;AACrB;AA4KO,SAAS,qBAAqB,QAA+B;AAClE,MAAI,OAAO,YAAY,eAAe;AACpC,WAAO;AAAA,EACT;AACA,SAAO,OAAO;AAChB;",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysm/orm-node",
   "sideEffects": false,
-  "version": "13.0.0-beta.6",
+  "version": "13.0.2",
   "description": "심플리즘 패키지 - ORM 모듈 (node)",
   "author": "김석래",
   "repository": {
@@ -13,19 +13,23 @@
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
   "dependencies": {
-    "@simplysm/core-common": "workspace:*",
-    "@simplysm/orm-common": "workspace:*",
     "consola": "^3.4.2",
-    "generic-pool": "^3.9.0"
+    "generic-pool": "^3.9.0",
+    "@simplysm/core-common": "13.0.2",
+    "@simplysm/orm-common": "13.0.2"
   },
   "devDependencies": {
     "@types/pg": "^8.16.0",
     "@types/pg-copy-streams": "^1.2.5",
-    "mysql2": "^3.16.1",
-    "pg": "^8.17.2",
+    "mysql2": "^3.17.0",
+    "pg": "^8.18.0",
     "pg-copy-streams": "^7.0.0",
-    "tedious": "^19.2.0"
+    "tedious": "^19.2.1"
   },
   "peerDependencies": {
     "mysql2": "^3.16.0",
@@ -47,4 +51,4 @@
       "optional": true
     }
   }
-}
+}

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

@@ -1,4 +1,4 @@
-import { createConsola } from "consola";
+import consola from "consola";
 import {
   DateOnly,
   DateTime,
@@ -15,7 +15,7 @@ import { DB_CONN_DEFAULT_TIMEOUT, DB_CONN_ERRORS, type DbConn, type MssqlDbConnC
 import type tediousType from "tedious";
 import type { DataType as TediousDataType } from "tedious/lib/data-type";
 
-const logger = createConsola().withTag("mssql-db-conn");
+const logger = consola.withTag("mssql-db-conn");
 
 /**
  * MSSQL 데이터베이스 연결 클래스

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

@@ -3,7 +3,7 @@ import fs from "fs";
 import os from "os";
 import path from "path";
 import type { Connection } from "mysql2/promise";
-import { createConsola } from "consola";
+import consola from "consola";
 import {
   bytesToHex,
   DateOnly,
@@ -17,7 +17,7 @@ import {
 import type { ColumnMeta, DataType, IsolationLevel } from "@simplysm/orm-common";
 import { DB_CONN_DEFAULT_TIMEOUT, DB_CONN_ERRORS, type DbConn, type MysqlDbConnConfig } from "../types/db-conn";
 
-const logger = createConsola().withTag("mysql-db-conn");
+const logger = consola.withTag("mysql-db-conn");
 
 /**
  * MySQL 데이터베이스 연결 클래스

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

@@ -1,5 +1,5 @@
 import { Readable } from "stream";
-import { createConsola } from "consola";
+import consola from "consola";
 import {
   bytesToHex,
   DateOnly,
@@ -15,7 +15,7 @@ import { DB_CONN_DEFAULT_TIMEOUT, DB_CONN_ERRORS, type DbConn, type PostgresqlDb
 import type { Client } from "pg";
 import type { CopyStreamQuery } from "pg-copy-streams";
 
-const logger = createConsola().withTag("postgresql-db-conn");
+const logger = consola.withTag("postgresql-db-conn");
 
 /**
  * PostgreSQL 데이터베이스 연결 클래스

package/src/create-db-conn.ts

@@ -0,0 +1,111 @@
+import type { Pool } from "generic-pool";
+import { createPool } from "generic-pool";
+import type { DbConn, DbConnConfig } from "./types/db-conn";
+import { PooledDbConn } from "./pooled-db-conn";
+import { MysqlDbConn } from "./connections/mysql-db-conn";
+import { MssqlDbConn } from "./connections/mssql-db-conn";
+import { PostgresqlDbConn } from "./connections/postgresql-db-conn";
+
+/**
+ * DB 연결 팩토리
+ *
+ * 데이터베이스 연결 인스턴스를 생성하고 풀링을 관리한다.
+ * MSSQL, MySQL, PostgreSQL을 지원한다.
+ */
+
+// 설정별 커넥션 풀 캐싱
+const poolMap = new Map<string, Pool<DbConn>>();
+
+// 지연 로딩 모듈 캐시
+const modules: {
+  tedious?: typeof import("tedious");
+  mysql?: typeof import("mysql2/promise");
+  pg?: typeof import("pg");
+  pgCopyStreams?: typeof import("pg-copy-streams");
+} = {};
+
+/**
+ * DB 연결 생성
+ *
+ * 커넥션 풀에서 연결을 획득하여 반환한다.
+ * 풀이 없는 경우 새로 생성한다.
+ *
+ * @param config - 데이터베이스 연결 설정
+ * @returns 풀링된 DB 연결 객체
+ */
+export function createDbConn(config: DbConnConfig): Promise<DbConn> {
+  // 1. 풀 가져오기 (없으면 생성)
+  const pool = getOrCreatePool(config);
+
+  // 2. 래퍼 객체 반환
+  return Promise.resolve(new PooledDbConn(pool, config));
+}
+
+function getOrCreatePool(config: DbConnConfig): Pool<DbConn> {
+  // 객체를 키로 쓰기 위해 문자열 변환 (중첩 객체도 정렬하여 동일 설정의 일관된 키 보장)
+  const configKey = JSON.stringify(config, (_, value: unknown) =>
+    value != null && typeof value === "object" && !Array.isArray(value)
+      ? Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)))
+      : value,
+  );
+
+  if (!poolMap.has(configKey)) {
+    const pool = createPool<DbConn>(
+      {
+        create: async () => {
+          const conn = await createRawConnection(config);
+          await conn.connect();
+          return conn;
+        },
+        destroy: async (conn) => {
+          await conn.close(); // 풀에서 제거될 때 실제 연결 종료
+        },
+        validate: (conn) => {
+          // 획득 시 연결 상태 확인 (끊겨있으면 Pool이 폐기하고 새로 만듦)
+          return Promise.resolve(conn.isConnected);
+        },
+      },
+      {
+        min: config.pool?.min ?? 1,
+        max: config.pool?.max ?? 10,
+        acquireTimeoutMillis: config.pool?.acquireTimeoutMillis ?? 30000,
+        idleTimeoutMillis: config.pool?.idleTimeoutMillis ?? 30000,
+        testOnBorrow: true, // [중요] 빌려줄 때 validate 실행 여부
+      },
+    );
+
+    poolMap.set(configKey, pool);
+  }
+
+  return poolMap.get(configKey)!;
+}
+
+async function createRawConnection(config: DbConnConfig): Promise<DbConn> {
+  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.from, config);
+  } else {
+    // mssql, mssql-azure
+    const tedious = await ensureModule("tedious");
+    return new MssqlDbConn(tedious, config);
+  }
+}
+
+async function ensureModule<K extends keyof typeof modules>(name: K): Promise<NonNullable<(typeof modules)[K]>> {
+  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]!;
+}

package/src/create-orm.ts

@@ -0,0 +1,118 @@
+import { createDbContext, type DbContextDef, type DbContextInstance, type IsolationLevel } from "@simplysm/orm-common";
+import type { DbConnConfig } from "./types/db-conn";
+import { NodeDbContextExecutor } from "./node-db-context-executor";
+
+/**
+ * Orm 옵션
+ *
+ * DbConnConfig보다 우선 적용되는 DbContext 옵션
+ */
+export interface OrmOptions {
+  /**
+   * 데이터베이스 이름 (DbConnConfig의 database 대신 사용)
+   */
+  database?: string;
+
+  /**
+   * 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
+   */
+  schema?: string;
+}
+
+/**
+ * Orm 인스턴스 타입
+ *
+ * createOrm에서 반환되는 객체의 타입
+ */
+export interface Orm<TDef extends DbContextDef<any, any, any>> {
+  readonly dbContextDef: TDef;
+  readonly config: DbConnConfig;
+  readonly options?: OrmOptions;
+
+  /**
+   * 트랜잭션 내에서 콜백 실행
+   *
+   * @param callback - DB 연결 후 실행할 콜백
+   * @param isolationLevel - 트랜잭션 격리 수준
+   * @returns 콜백 결과
+   */
+  connect<R>(callback: (conn: DbContextInstance<TDef>) => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>;
+
+  /**
+   * 트랜잭션 없이 콜백 실행
+   *
+   * @param callback - DB 연결 후 실행할 콜백
+   * @returns 콜백 결과
+   */
+  connectWithoutTransaction<R>(callback: (conn: DbContextInstance<TDef>) => Promise<R>): Promise<R>;
+}
+
+/**
+ * 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().result();
+ *   return users;
+ * });
+ *
+ * // 트랜잭션 없이 실행
+ * await orm.connectWithoutTransaction(async (db) => {
+ *   const users = await db.user().result();
+ *   return users;
+ * });
+ * ```
+ */
+export function createOrm<TDef extends DbContextDef<any, any, any>>(
+  dbContextDef: TDef,
+  config: DbConnConfig,
+  options?: OrmOptions,
+): Orm<TDef> {
+  function _createDbContext(): DbContextInstance<TDef> {
+    // database는 options에서 우선, 없으면 config에서
+    const database = options?.database ?? ("database" in config ? config.database : undefined);
+    if (database == null || database === "") {
+      throw new Error("database is required");
+    }
+
+    // schema는 options에서 우선, 없으면 config에서
+    const schema = options?.schema ?? ("schema" in config ? config.schema : undefined);
+
+    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));
+    },
+  };
+}

package/src/index.ts

@@ -7,7 +7,7 @@ export * from "./connections/mysql-db-conn";
 export * from "./connections/postgresql-db-conn";
 
 // Core
-export * from "./db-conn-factory";
+export * from "./create-db-conn";
 export * from "./node-db-context-executor";
 export * from "./pooled-db-conn";
-export * from "./sd-orm";
+export * from "./create-orm";

package/src/node-db-context-executor.ts

@@ -11,7 +11,7 @@ import type {
 import { createQueryBuilder, parseQueryResult } from "@simplysm/orm-common";
 import type { DbConn, DbConnConfig } from "./types/db-conn";
 import { DB_CONN_ERRORS, getDialectFromConfig } from "./types/db-conn";
-import { DbConnFactory } from "./db-conn-factory";
+import { createDbConn } from "./create-db-conn";
 
 /**
  * Node.js 환경용 DbContextExecutor
@@ -32,7 +32,7 @@ export class NodeDbContextExecutor implements DbContextExecutor {
    * 커넥션 풀에서 연결을 획득하고 연결 상태를 활성화한다.
    */
   async connect(): Promise<void> {
-    this._conn = await DbConnFactory.create(this._config);
+    this._conn = await createDbConn(this._config);
     await this._conn.connect();
   }
 

package/src/pooled-db-conn.ts

@@ -1,10 +1,10 @@
-import { createConsola } from "consola";
+import consola from "consola";
 import { SdError, EventEmitter } from "@simplysm/core-common";
 import type { Pool } from "generic-pool";
 import type { ColumnMeta, IsolationLevel } from "@simplysm/orm-common";
 import { DB_CONN_ERRORS, type DbConn, type DbConnConfig } from "./types/db-conn";
 
-const logger = createConsola().withTag("pooled-db-conn");
+const logger = consola.withTag("pooled-db-conn");
 
 /**
  * 커넥션 풀에서 관리되는 DB 연결 래퍼