@simplysm/orm-node 13.0.0-beta.11

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

@@ -0,0 +1,386 @@
+import { createConsola } from "consola";
+import {
+  DateOnly,
+  DateTime,
+  jsonStringify,
+  SdError,
+  EventEmitter,
+  strIsNullOrEmpty,
+  Time,
+  Uuid,
+  waitUntil
+} from "@simplysm/core-common";
+import { DB_CONN_DEFAULT_TIMEOUT, DB_CONN_ERRORS } from "../types/db-conn";
+const logger = createConsola().withTag("mssql-db-conn");
+class MssqlDbConn extends EventEmitter {
+  constructor(_tedious, config) {
+    super();
+    this._tedious = _tedious;
+    this.config = config;
+  }
+  _timeout = DB_CONN_DEFAULT_TIMEOUT;
+  _conn;
+  _connTimeout;
+  _requests = [];
+  isConnected = false;
+  isOnTransaction = false;
+  async connect() {
+    if (this.isConnected) {
+      throw new SdError(DB_CONN_ERRORS.ALREADY_CONNECTED);
+    }
+    const conn = new this._tedious.Connection({
+      server: this.config.host,
+      authentication: {
+        type: "default",
+        options: {
+          userName: this.config.username,
+          password: this.config.password
+        }
+      },
+      options: {
+        database: this.config.database,
+        port: this.config.port,
+        rowCollectionOnDone: true,
+        useUTC: false,
+        encrypt: this.config.dialect === "mssql-azure",
+        requestTimeout: this._timeout,
+        trustServerCertificate: true,
+        connectTimeout: this._timeout * 5
+      }
+    });
+    conn.on("infoMessage", (info) => {
+      logger.debug("info", info.message);
+    });
+    conn.on("errorMessage", (error) => {
+      logger.error("errorMessage", error.message);
+    });
+    conn.on("error", (error) => {
+      logger.error("error", error.message);
+    });
+    conn.on("end", () => {
+      this.emit("close");
+      this._resetState();
+    });
+    await new Promise((resolve, reject) => {
+      conn.connect((err) => {
+        if (err != null) {
+          reject(new SdError(err));
+          return;
+        }
+        this._startTimeout();
+        this.isConnected = true;
+        this.isOnTransaction = false;
+        resolve();
+      });
+    });
+    this._conn = conn;
+  }
+  async close() {
+    this._stopTimeout();
+    if (this._conn == null || !this.isConnected) {
+      return;
+    }
+    const conn = this._conn;
+    conn.cancel();
+    await waitUntil(() => this._requests.length < 1, 3e4, 100);
+    await new Promise((resolve) => {
+      conn.on("end", () => {
+        waitUntil(() => this._conn == null, 3e4, 100).then(() => resolve()).catch(() => resolve());
+      });
+      conn.close();
+    });
+  }
+  async beginTransaction(isolationLevel) {
+    this._assertConnected();
+    this._startTimeout();
+    const conn = this._conn;
+    await new Promise((resolve, reject) => {
+      conn.beginTransaction(
+        (err) => {
+          if (err != null) {
+            reject(new SdError(err));
+            return;
+          }
+          this.isOnTransaction = true;
+          resolve();
+        },
+        "",
+        this._tedious.ISOLATION_LEVEL[isolationLevel ?? this.config.defaultIsolationLevel ?? "READ_UNCOMMITTED"]
+      );
+    });
+  }
+  async commitTransaction() {
+    this._assertConnected();
+    this._startTimeout();
+    const conn = this._conn;
+    await new Promise((resolve, reject) => {
+      conn.commitTransaction((err) => {
+        if (err != null) {
+          reject(new SdError(err));
+          return;
+        }
+        this.isOnTransaction = false;
+        resolve();
+      });
+    });
+  }
+  async rollbackTransaction() {
+    this._assertConnected();
+    this._startTimeout();
+    const conn = this._conn;
+    await new Promise((resolve, reject) => {
+      conn.rollbackTransaction((err) => {
+        if (err != null) {
+          reject(new SdError(err));
+          return;
+        }
+        this.isOnTransaction = false;
+        resolve();
+      });
+    });
+  }
+  async execute(queries) {
+    const results = [];
+    for (const query of queries.filter((item) => !strIsNullOrEmpty(item))) {
+      const resultItems = await this.executeParametrized(query);
+      results.push(...resultItems);
+    }
+    return results;
+  }
+  async executeParametrized(query, params) {
+    this._assertConnected();
+    this._startTimeout();
+    const conn = this._conn;
+    const results = [];
+    logger.debug("\uCFFC\uB9AC \uC2E4\uD589", { queryLength: query.length, params });
+    await new Promise((resolve, reject) => {
+      let rejected = false;
+      const queryRequest = new this._tedious.Request(query, (err) => {
+        if (err != null) {
+          rejected = true;
+          this._requests = this._requests.filter((r) => r !== queryRequest);
+          const errRec = err;
+          if (errRec["code"] === "ECANCEL") {
+            reject(new SdError(err, "\uCFFC\uB9AC\uAC00 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+          } else {
+            const lineNumber = errRec["lineNumber"];
+            if (lineNumber != null && lineNumber > 0) {
+              const splitQuery = query.split("\n");
+              splitQuery[lineNumber - 1] = "==> " + splitQuery[lineNumber - 1];
+              reject(new SdError(err, `\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD
+-- query
+${splitQuery.join("\n")}
+--`));
+            } else {
+              reject(new SdError(err, `\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD
+-- query
+${query}
+--`));
+            }
+          }
+        }
+      });
+      queryRequest.on("done", (_rowCount, _more, rst) => {
+        this._startTimeout();
+        if (rejected) {
+          return;
+        }
+        results.push(this._parseRowsToRecords(rst));
+      }).on("doneInProc", (_rowCount, _more, rst) => {
+        this._startTimeout();
+        if (rejected) {
+          return;
+        }
+        results.push(this._parseRowsToRecords(rst));
+      }).on("error", (err) => {
+        this._startTimeout();
+        if (rejected) {
+          return;
+        }
+        rejected = true;
+        this._requests = this._requests.filter((r) => r !== queryRequest);
+        reject(new SdError(err, `\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD
+-- query
+${query}
+--`));
+      }).on("requestCompleted", () => {
+        this._startTimeout();
+        if (rejected) {
+          return;
+        }
+        this._requests = this._requests.filter((r) => r !== queryRequest);
+        resolve();
+      });
+      this._requests.push(queryRequest);
+      if (params != null) {
+        for (let i = 0; i < params.length; i++) {
+          const paramValue = params[i];
+          const paramName = `p${i}`;
+          const type = this._guessTediousType(paramValue);
+          queryRequest.addParameter(paramName, type, paramValue);
+        }
+        conn.execSql(queryRequest);
+      } else {
+        conn.execSqlBatch(queryRequest);
+      }
+    });
+    return results;
+  }
+  async bulkInsert(tableName, columnMetas, records) {
+    if (records.length === 0) return;
+    this._assertConnected();
+    this._startTimeout();
+    const tediousColumnDefs = Object.entries(columnMetas).map(
+      ([name, meta]) => this._convertColumnMetaToTediousBulkColumnDef(name, meta)
+    );
+    await new Promise((resolve, reject) => {
+      const bulkLoad = this._conn.newBulkLoad(tableName, (err) => {
+        if (err != null) {
+          reject(
+            new SdError(
+              err,
+              `Bulk Insert \uC624\uB958\uBC1C\uC0DD
+${jsonStringify(tediousColumnDefs)}
+-- data
+${jsonStringify(records).substring(0, 1e4)}...
+--`
+            )
+          );
+          return;
+        }
+        resolve();
+      });
+      const colNames = Object.keys(columnMetas);
+      for (const tediousColumnDef of tediousColumnDefs) {
+        bulkLoad.addColumn(tediousColumnDef.name, tediousColumnDef.type, tediousColumnDef.options);
+      }
+      const rows = records.map(
+        (record) => colNames.map((colName) => {
+          const val = record[colName];
+          if (val instanceof Uuid) return val.toString();
+          if (val instanceof Uint8Array) return Buffer.from(val);
+          if (val instanceof DateTime) return val.date;
+          if (val instanceof DateOnly) return val.date;
+          if (val instanceof Time) return val.toFormatString("HH:mm:ss");
+          return val;
+        })
+      );
+      this._conn.execBulkLoad(bulkLoad, rows);
+    });
+  }
+  // ─────────────────────────────────────────────
+  // Private helpers
+  // ─────────────────────────────────────────────
+  _assertConnected() {
+    if (this._conn == null || !this.isConnected) {
+      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);
+    }
+  }
+  _parseRowsToRecords(rows) {
+    return (rows ?? []).map((item) => {
+      const resultItem = {};
+      for (const col of item) {
+        resultItem[col.metadata.colName] = col.value;
+      }
+      return resultItem;
+    });
+  }
+  _resetState() {
+    this.isConnected = false;
+    this.isOnTransaction = false;
+    this._conn = void 0;
+    this._requests = [];
+  }
+  _stopTimeout() {
+    if (this._connTimeout != null) {
+      clearTimeout(this._connTimeout);
+    }
+  }
+  _startTimeout() {
+    this._stopTimeout();
+    this._connTimeout = setTimeout(() => {
+      this.close().catch((err) => {
+        logger.error("close error", err instanceof Error ? err.message : String(err));
+      });
+    }, this._timeout * 2);
+  }
+  _convertColumnMetaToTediousBulkColumnDef(name, meta) {
+    const tediousDataType = this._convertDataTypeToTediousBulkColumnType(meta.dataType);
+    return {
+      name,
+      type: tediousDataType.type,
+      options: {
+        length: tediousDataType.length,
+        nullable: meta.nullable ?? false,
+        precision: tediousDataType.precision,
+        scale: tediousDataType.scale
+      }
+    };
+  }
+  _convertDataTypeToTediousBulkColumnType(dataType) {
+    switch (dataType.type) {
+      case "int":
+        return { type: this._tedious.TYPES.Int };
+      case "bigint":
+        return { type: this._tedious.TYPES.BigInt };
+      case "float":
+        return { type: this._tedious.TYPES.Real };
+      case "double":
+        return { type: this._tedious.TYPES.Float };
+      case "decimal":
+        return {
+          type: this._tedious.TYPES.Decimal,
+          precision: dataType.precision,
+          scale: dataType.scale
+        };
+      case "varchar":
+        return { type: this._tedious.TYPES.NVarChar, length: dataType.length };
+      case "char":
+        return { type: this._tedious.TYPES.NChar, length: dataType.length };
+      case "text":
+        return { type: this._tedious.TYPES.NText };
+      case "binary":
+        return { type: this._tedious.TYPES.VarBinary, length: Infinity };
+      case "boolean":
+        return { type: this._tedious.TYPES.Bit };
+      case "datetime":
+        return { type: this._tedious.TYPES.DateTime2 };
+      case "date":
+        return { type: this._tedious.TYPES.Date };
+      case "time":
+        return { type: this._tedious.TYPES.Time };
+      case "uuid":
+        return { type: this._tedious.TYPES.UniqueIdentifier };
+      default:
+        throw new SdError(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 DataType: ${JSON.stringify(dataType)}`);
+    }
+  }
+  /**
+   * 값의 타입을 추론하여 Tedious 데이터 타입 반환
+   *
+   * @param value - 타입을 추론할 값 (null/undefined 전달 시 오류 발생)
+   * @throws null/undefined가 전달되면 오류 발생
+   */
+  _guessTediousType(value) {
+    if (value == null) {
+      throw new SdError("_guessTediousType: null/undefined \uAC12\uC740 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+    }
+    if (typeof value === "string") {
+      return this._tedious.TYPES.NVarChar;
+    }
+    if (typeof value === "number") {
+      return Number.isInteger(value) ? this._tedious.TYPES.BigInt : this._tedious.TYPES.Decimal;
+    }
+    if (typeof value === "boolean") return this._tedious.TYPES.Bit;
+    if (value instanceof DateTime) return this._tedious.TYPES.DateTime2;
+    if (value instanceof DateOnly) return this._tedious.TYPES.Date;
+    if (value instanceof Time) return this._tedious.TYPES.Time;
+    if (value instanceof Uuid) return this._tedious.TYPES.UniqueIdentifier;
+    if (value instanceof Uint8Array) return this._tedious.TYPES.VarBinary;
+    throw new SdError(`\uC54C \uC218 \uC5C6\uB294 \uAC12 \uD0C0\uC785: ${typeof value}`);
+  }
+}
+export {
+  MssqlDbConn
+};
+//# sourceMappingURL=mssql-db-conn.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/connections/mssql-db-conn.ts"],
+  "sourcesContent": ["import { createConsola } from \"consola\";\nimport {\n  DateOnly,\n  DateTime,\n  jsonStringify,\n  SdError,\n  EventEmitter,\n  strIsNullOrEmpty,\n  Time,\n  Uuid,\n  waitUntil,\n} from \"@simplysm/core-common\";\nimport type { ColumnMeta, DataType, IsolationLevel } from \"@simplysm/orm-common\";\nimport { DB_CONN_DEFAULT_TIMEOUT, DB_CONN_ERRORS, type DbConn, type MssqlDbConnConfig } from \"../types/db-conn\";\nimport type tediousType from \"tedious\";\nimport type { DataType as TediousDataType } from \"tedious/lib/data-type\";\n\nconst logger = createConsola().withTag(\"mssql-db-conn\");\n\n/**\n * MSSQL \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC5F0\uACB0 \uD074\uB798\uC2A4\n *\n * tedious \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB97C \uC0AC\uC6A9\uD558\uC5EC MSSQL/Azure SQL \uC5F0\uACB0\uC744 \uAD00\uB9AC\uD569\uB2C8\uB2E4.\n */\nexport class MssqlDbConn extends EventEmitter<{ close: void }> implements DbConn {\n  private readonly _timeout = DB_CONN_DEFAULT_TIMEOUT;\n\n  private _conn?: tediousType.Connection;\n  private _connTimeout?: ReturnType<typeof setTimeout>;\n  private _requests: tediousType.Request[] = [];\n\n  isConnected = false;\n  isOnTransaction = false;\n\n  constructor(\n    private readonly _tedious: typeof import(\"tedious\"),\n    readonly config: MssqlDbConnConfig,\n  ) {\n    super();\n  }\n\n  async connect(): Promise<void> {\n    if (this.isConnected) {\n      throw new SdError(DB_CONN_ERRORS.ALREADY_CONNECTED);\n    }\n\n    const conn = new this._tedious.Connection({\n      server: this.config.host,\n      authentication: {\n        type: \"default\",\n        options: {\n          userName: this.config.username,\n          password: this.config.password,\n        },\n      },\n      options: {\n        database: this.config.database,\n        port: this.config.port,\n        rowCollectionOnDone: true,\n        useUTC: false,\n        encrypt: this.config.dialect === \"mssql-azure\",\n        requestTimeout: this._timeout,\n        trustServerCertificate: true,\n        connectTimeout: this._timeout * 5,\n      } as tediousType.ConnectionOptions,\n    });\n\n    conn.on(\"infoMessage\", (info) => {\n      logger.debug(\"info\", info.message);\n    });\n\n    conn.on(\"errorMessage\", (error) => {\n      logger.error(\"errorMessage\", error.message);\n    });\n\n    conn.on(\"error\", (error) => {\n      logger.error(\"error\", error.message);\n    });\n\n    conn.on(\"end\", () => {\n      this.emit(\"close\");\n      this._resetState();\n    });\n\n    await new Promise<void>((resolve, reject) => {\n      conn.connect((err: Error | undefined) => {\n        if (err != null) {\n          reject(new SdError(err));\n          return;\n        }\n\n        this._startTimeout();\n        this.isConnected = true;\n        this.isOnTransaction = false;\n        resolve();\n      });\n    });\n\n    this._conn = conn;\n  }\n\n  async close(): Promise<void> {\n    this._stopTimeout();\n\n    if (this._conn == null || !this.isConnected) {\n      return;\n    }\n\n    const conn = this._conn;\n\n    // \uC9C4\uD589 \uC911\uC778 \uC694\uCCAD \uCDE8\uC18C\n    conn.cancel();\n    await waitUntil(() => this._requests.length < 1, 30000, 100);\n\n    // \uC5F0\uACB0 \uC885\uB8CC \uB300\uAE30\n    await new Promise<void>((resolve) => {\n      conn.on(\"end\", () => {\n        waitUntil(() => this._conn == null, 30000, 100)\n          .then(() => resolve())\n          .catch(() => resolve());\n      });\n      conn.close();\n    });\n  }\n\n  async beginTransaction(isolationLevel?: IsolationLevel): Promise<void> {\n    this._assertConnected();\n    this._startTimeout();\n\n    const conn = this._conn!;\n\n    await new Promise<void>((resolve, reject) => {\n      conn.beginTransaction(\n        (err) => {\n          if (err != null) {\n            reject(new SdError(err));\n            return;\n          }\n\n          this.isOnTransaction = true;\n          resolve();\n        },\n        \"\",\n        this._tedious.ISOLATION_LEVEL[isolationLevel ?? this.config.defaultIsolationLevel ?? \"READ_UNCOMMITTED\"],\n      );\n    });\n  }\n\n  async commitTransaction(): Promise<void> {\n    this._assertConnected();\n    this._startTimeout();\n\n    const conn = this._conn!;\n\n    await new Promise<void>((resolve, reject) => {\n      conn.commitTransaction((err) => {\n        if (err != null) {\n          reject(new SdError(err));\n          return;\n        }\n\n        this.isOnTransaction = false;\n        resolve();\n      });\n    });\n  }\n\n  async rollbackTransaction(): Promise<void> {\n    this._assertConnected();\n    this._startTimeout();\n\n    const conn = this._conn!;\n\n    await new Promise<void>((resolve, reject) => {\n      conn.rollbackTransaction((err) => {\n        if (err != null) {\n          reject(new SdError(err));\n          return;\n        }\n\n        this.isOnTransaction = false;\n        resolve();\n      });\n    });\n  }\n\n  async execute(queries: string[]): Promise<unknown[][]> {\n    const results: unknown[][] = [];\n    for (const query of queries.filter((item) => !strIsNullOrEmpty(item))) {\n      const resultItems = await this.executeParametrized(query);\n      results.push(...resultItems);\n    }\n\n    return results;\n  }\n\n  async executeParametrized(query: string, params?: unknown[]): Promise<unknown[][]> {\n    this._assertConnected();\n    this._startTimeout();\n\n    const conn = this._conn!;\n\n    const results: unknown[][] = [];\n\n    logger.debug(\"\uCFFC\uB9AC \uC2E4\uD589\", { queryLength: query.length, params });\n    await new Promise<void>((resolve, reject) => {\n      let rejected = false;\n      const queryRequest = new this._tedious.Request(query, (err) => {\n        if (err != null) {\n          rejected = true;\n          this._requests = this._requests.filter((r) => r !== queryRequest);\n\n          const errRec = err as unknown as Record<string, unknown>;\n          if (errRec[\"code\"] === \"ECANCEL\") {\n            reject(new SdError(err, \"\uCFFC\uB9AC\uAC00 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.\"));\n          } else {\n            const lineNumber = errRec[\"lineNumber\"] as number | undefined;\n            if (lineNumber != null && lineNumber > 0) {\n              const splitQuery = query.split(\"\\n\");\n              splitQuery[lineNumber - 1] = \"==> \" + splitQuery[lineNumber - 1];\n              reject(new SdError(err, `\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD\\n-- query\\n${splitQuery.join(\"\\n\")}\\n--`));\n            } else {\n              reject(new SdError(err, `\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD\\n-- query\\n${query}\\n--`));\n            }\n          }\n        }\n      });\n\n      queryRequest\n        .on(\"done\", (_rowCount, _more, rst) => {\n          this._startTimeout();\n\n          if (rejected) {\n            return;\n          }\n\n          results.push(this._parseRowsToRecords(rst));\n        })\n        .on(\"doneInProc\", (_rowCount, _more, rst) => {\n          this._startTimeout();\n\n          if (rejected) {\n            return;\n          }\n\n          results.push(this._parseRowsToRecords(rst));\n        })\n        .on(\"error\", (err) => {\n          this._startTimeout();\n\n          if (rejected) {\n            return;\n          }\n\n          rejected = true;\n          this._requests = this._requests.filter((r) => r !== queryRequest);\n          reject(new SdError(err, `\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD\\n-- query\\n${query}\\n--`));\n        })\n        .on(\"requestCompleted\", () => {\n          this._startTimeout();\n\n          if (rejected) {\n            return;\n          }\n\n          this._requests = this._requests.filter((r) => r !== queryRequest);\n          resolve();\n        });\n\n      this._requests.push(queryRequest);\n\n      if (params != null) {\n        for (let i = 0; i < params.length; i++) {\n          const paramValue = params[i];\n          const paramName = `p${i}`;\n          const type = this._guessTediousType(paramValue);\n\n          queryRequest.addParameter(paramName, type, paramValue);\n        }\n\n        conn.execSql(queryRequest);\n      } else {\n        conn.execSqlBatch(queryRequest);\n      }\n    });\n\n    return results;\n  }\n\n  async bulkInsert(\n    tableName: string,\n    columnMetas: Record<string, ColumnMeta>,\n    records: Record<string, unknown>[],\n  ): Promise<void> {\n    if (records.length === 0) return;\n\n    this._assertConnected();\n    this._startTimeout();\n\n    const tediousColumnDefs = Object.entries(columnMetas).map(([name, meta]) =>\n      this._convertColumnMetaToTediousBulkColumnDef(name, meta),\n    );\n\n    await new Promise<void>((resolve, reject) => {\n      const bulkLoad = this._conn!.newBulkLoad(tableName, (err) => {\n        if (err != null) {\n          reject(\n            new SdError(\n              err,\n              `Bulk Insert \uC624\uB958\uBC1C\uC0DD\\n${jsonStringify(tediousColumnDefs)}\\n-- data\\n${jsonStringify(records).substring(0, 10000)}...\\n--`,\n            ),\n          );\n          return;\n        }\n        resolve();\n      });\n\n      const colNames = Object.keys(columnMetas);\n\n      for (const tediousColumnDef of tediousColumnDefs) {\n        bulkLoad.addColumn(tediousColumnDef.name, tediousColumnDef.type, tediousColumnDef.options);\n      }\n\n      // \uB808\uCF54\uB4DC\uB97C row \uBC30\uC5F4\uB85C \uBCC0\uD658 (\uCEEC\uB7FC \uC21C\uC11C \uC720\uC9C0, \uAC12 \uBCC0\uD658 \uD3EC\uD568)\n      const rows = records.map((record) =>\n        colNames.map((colName) => {\n          const val = record[colName];\n          if (val instanceof Uuid) return val.toString();\n          // eslint-disable-next-line no-restricted-globals -- tedious \uB77C\uC774\uBE0C\uB7EC\uB9AC\uAC00 Buffer\uB97C \uC694\uAD6C\uD568\n          if (val instanceof Uint8Array) return Buffer.from(val);\n          if (val instanceof DateTime) return val.date;\n          if (val instanceof DateOnly) return val.date;\n          if (val instanceof Time) return val.toFormatString(\"HH:mm:ss\");\n          return val;\n        }),\n      );\n\n      this._conn!.execBulkLoad(bulkLoad, rows);\n    });\n  }\n\n  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // Private helpers\n  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private _assertConnected(): void {\n    if (this._conn == null || !this.isConnected) {\n      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);\n    }\n  }\n\n  private _parseRowsToRecords(\n    rows: Array<Array<{ metadata: { colName: string }; value: unknown }>> | undefined,\n  ): Record<string, unknown>[] {\n    return (rows ?? []).map((item) => {\n      const resultItem: Record<string, unknown> = {};\n      for (const col of item) {\n        resultItem[col.metadata.colName] = col.value;\n      }\n      return resultItem;\n    });\n  }\n\n  private _resetState(): void {\n    this.isConnected = false;\n    this.isOnTransaction = false;\n    this._conn = undefined;\n    this._requests = [];\n  }\n\n  private _stopTimeout(): void {\n    if (this._connTimeout != null) {\n      clearTimeout(this._connTimeout);\n    }\n  }\n\n  private _startTimeout(): void {\n    this._stopTimeout();\n    this._connTimeout = setTimeout(() => {\n      this.close().catch((err) => {\n        logger.error(\"close error\", err instanceof Error ? err.message : String(err));\n      });\n    }, this._timeout * 2);\n  }\n\n  private _convertColumnMetaToTediousBulkColumnDef(\n    name: string,\n    meta: ColumnMeta,\n  ): {\n    name: string;\n    type: TediousDataType;\n    options: TediousColumnOptions;\n  } {\n    const tediousDataType = this._convertDataTypeToTediousBulkColumnType(meta.dataType);\n    return {\n      name,\n      type: tediousDataType.type,\n      options: {\n        length: tediousDataType.length,\n        nullable: meta.nullable ?? false,\n        precision: tediousDataType.precision,\n        scale: tediousDataType.scale,\n      },\n    };\n  }\n\n  private _convertDataTypeToTediousBulkColumnType(dataType: DataType): {\n    type: TediousDataType;\n    length?: number;\n    precision?: number;\n    scale?: number;\n  } {\n    switch (dataType.type) {\n      case \"int\":\n        return { type: this._tedious.TYPES.Int };\n      case \"bigint\":\n        return { type: this._tedious.TYPES.BigInt };\n      case \"float\":\n        return { type: this._tedious.TYPES.Real };\n      case \"double\":\n        return { type: this._tedious.TYPES.Float };\n      case \"decimal\":\n        return {\n          type: this._tedious.TYPES.Decimal,\n          precision: dataType.precision,\n          scale: dataType.scale,\n        };\n      case \"varchar\":\n        return { type: this._tedious.TYPES.NVarChar, length: dataType.length };\n      case \"char\":\n        return { type: this._tedious.TYPES.NChar, length: dataType.length };\n      case \"text\":\n        return { type: this._tedious.TYPES.NText };\n      case \"binary\":\n        return { type: this._tedious.TYPES.VarBinary, length: Infinity };\n      case \"boolean\":\n        return { type: this._tedious.TYPES.Bit };\n      case \"datetime\":\n        return { type: this._tedious.TYPES.DateTime2 };\n      case \"date\":\n        return { type: this._tedious.TYPES.Date };\n      case \"time\":\n        return { type: this._tedious.TYPES.Time };\n      case \"uuid\":\n        return { type: this._tedious.TYPES.UniqueIdentifier };\n      default:\n        throw new SdError(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 DataType: ${JSON.stringify(dataType)}`);\n    }\n  }\n\n  /**\n   * \uAC12\uC758 \uD0C0\uC785\uC744 \uCD94\uB860\uD558\uC5EC Tedious \uB370\uC774\uD130 \uD0C0\uC785 \uBC18\uD658\n   *\n   * @param value - \uD0C0\uC785\uC744 \uCD94\uB860\uD560 \uAC12 (null/undefined \uC804\uB2EC \uC2DC \uC624\uB958 \uBC1C\uC0DD)\n   * @throws null/undefined\uAC00 \uC804\uB2EC\uB418\uBA74 \uC624\uB958 \uBC1C\uC0DD\n   */\n  private _guessTediousType(value: unknown): TediousDataType {\n    if (value == null) {\n      throw new SdError(\"_guessTediousType: null/undefined \uAC12\uC740 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.\");\n    }\n    if (typeof value === \"string\") {\n      return this._tedious.TYPES.NVarChar;\n    }\n    if (typeof value === \"number\") {\n      return Number.isInteger(value) ? this._tedious.TYPES.BigInt : this._tedious.TYPES.Decimal;\n    }\n    if (typeof value === \"boolean\") return this._tedious.TYPES.Bit;\n    if (value instanceof DateTime) return this._tedious.TYPES.DateTime2;\n    if (value instanceof DateOnly) return this._tedious.TYPES.Date;\n    if (value instanceof Time) return this._tedious.TYPES.Time;\n    if (value instanceof Uuid) return this._tedious.TYPES.UniqueIdentifier;\n    if (value instanceof Uint8Array) return this._tedious.TYPES.VarBinary;\n\n    throw new SdError(`\uC54C \uC218 \uC5C6\uB294 \uAC12 \uD0C0\uC785: ${typeof value}`);\n  }\n}\n\ninterface TediousColumnOptions {\n  length?: number;\n  precision?: number;\n  scale?: number;\n  nullable?: boolean;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,227 @@
+import { randomUUID } from "crypto";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { createConsola } from "consola";
+import {
+  bytesToHex,
+  DateOnly,
+  DateTime,
+  SdError,
+  EventEmitter,
+  strIsNullOrEmpty,
+  Time,
+  Uuid
+} from "@simplysm/core-common";
+import { DB_CONN_DEFAULT_TIMEOUT, DB_CONN_ERRORS } from "../types/db-conn";
+const logger = createConsola().withTag("mysql-db-conn");
+class MysqlDbConn extends EventEmitter {
+  constructor(_mysql2, config) {
+    super();
+    this._mysql2 = _mysql2;
+    this.config = config;
+  }
+  static _ROOT_USER = "root";
+  _timeout = DB_CONN_DEFAULT_TIMEOUT;
+  _conn;
+  _connTimeout;
+  isConnected = false;
+  isOnTransaction = false;
+  async connect() {
+    if (this.isConnected) {
+      throw new SdError(DB_CONN_ERRORS.ALREADY_CONNECTED);
+    }
+    const conn = await this._mysql2.createConnection({
+      host: this.config.host,
+      port: this.config.port,
+      user: this.config.username,
+      password: this.config.password,
+      // root 사용자는 특정 database에 바인딩되지 않고 연결하여
+      // 모든 데이터베이스에 접근할 수 있도록 함 (관리 작업용)
+      database: this.config.username === MysqlDbConn._ROOT_USER ? void 0 : this.config.database,
+      multipleStatements: true,
+      charset: "utf8mb4",
+      infileStreamFactory: (filePath) => fs.createReadStream(filePath)
+      // LOAD DATA LOCAL INFILE 지원
+    });
+    conn.on("end", () => {
+      this.emit("close");
+      this._resetState();
+    });
+    conn.on("error", (error) => {
+      logger.error("DB \uC5F0\uACB0 \uC624\uB958", error.message);
+    });
+    this._conn = conn;
+    this._startTimeout();
+    this.isConnected = true;
+  }
+  async close() {
+    this._stopTimeout();
+    if (this._conn == null || !this.isConnected) {
+      return;
+    }
+    await this._conn.end();
+    this.emit("close");
+    this._resetState();
+  }
+  async beginTransaction(isolationLevel) {
+    const conn = this._assertConnected();
+    const level = (isolationLevel ?? this.config.defaultIsolationLevel ?? "READ_UNCOMMITTED").replace(/_/g, " ");
+    await conn.query({
+      sql: `SET SESSION TRANSACTION ISOLATION LEVEL ${level}`,
+      timeout: this._timeout
+    });
+    await conn.beginTransaction();
+    this.isOnTransaction = true;
+  }
+  async commitTransaction() {
+    const conn = this._assertConnected();
+    await conn.commit();
+    this.isOnTransaction = false;
+  }
+  async rollbackTransaction() {
+    const conn = this._assertConnected();
+    await conn.rollback();
+    this.isOnTransaction = false;
+  }
+  async execute(queries) {
+    const results = [];
+    for (const query of queries.filter((item) => !strIsNullOrEmpty(item))) {
+      const resultItems = await this.executeParametrized(query);
+      results.push(...resultItems);
+    }
+    return results;
+  }
+  async executeParametrized(query, params) {
+    const conn = this._assertConnected();
+    logger.debug("\uCFFC\uB9AC \uC2E4\uD589", { queryLength: query.length, params });
+    try {
+      const [queryResults] = await conn.query({
+        sql: query,
+        timeout: this._timeout,
+        values: params
+      });
+      this._startTimeout();
+      const result = [];
+      if (queryResults instanceof Array) {
+        for (const queryResult of queryResults.filter(
+          (item) => !(typeof item === "object" && item !== null && "affectedRows" in item && "fieldCount" in item)
+        )) {
+          result.push(queryResult);
+        }
+      }
+      return [result];
+    } catch (err) {
+      this._startTimeout();
+      const error = err;
+      throw new SdError(
+        error,
+        "\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD" + (error.sql != null ? "\n-- query\n" + error.sql.trim() + "\n--" : "")
+      );
+    }
+  }
+  async bulkInsert(tableName, columnMetas, records) {
+    const conn = this._assertConnected();
+    if (records.length === 0) return;
+    const colNames = Object.keys(columnMetas);
+    const tmpDir = os.tmpdir();
+    const tmpFile = path.join(tmpDir, `mysql_bulk_${randomUUID()}.csv`);
+    try {
+      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");
+      await fs.promises.writeFile(tmpFile, csvContent, "utf8");
+      const binaryColNames = colNames.filter((c) => {
+        const dt = columnMetas[c].dataType.type;
+        return dt === "uuid" || dt === "binary";
+      });
+      const normalCols = colNames.map((c) => {
+        if (binaryColNames.includes(c)) return `@_${c}`;
+        return `\`${c}\``;
+      });
+      const setClauses = binaryColNames.map((c) => `\`${c}\` = UNHEX(@_${c})`);
+      let query = `LOAD DATA LOCAL INFILE ? INTO TABLE ${tableName} FIELDS TERMINATED BY '\\t' LINES TERMINATED BY '\\n' (${normalCols.join(", ")})`;
+      if (setClauses.length > 0) {
+        query += ` SET ${setClauses.join(", ")}`;
+      }
+      await conn.query({ sql: query, timeout: this._timeout, values: [tmpFile] });
+    } finally {
+      try {
+        await fs.promises.unlink(tmpFile);
+      } catch {
+      }
+    }
+  }
+  // ─────────────────────────────────────────────
+  // Private helpers
+  // ─────────────────────────────────────────────
+  /**
+   * MySQL LOAD DATA INFILE용 값 이스케이프
+   */
+  _escapeForCsv(value, dataType) {
+    if (value == null) {
+      return "\\N";
+    }
+    switch (dataType.type) {
+      case "int":
+      case "bigint":
+      case "float":
+      case "double":
+      case "decimal":
+        return String(value);
+      case "boolean":
+        return value ? "1" : "0";
+      case "varchar":
+      case "char":
+      case "text": {
+        const str = value;
+        return str.replace(/\\/g, "\\\\").replace(/\t/g, "\\t").replace(/\n/g, "\\n").replace(/\r/g, "\\r");
+      }
+      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().replace(/-/g, "");
+      // BINARY(16) 저장용 hex
+      case "binary":
+        return bytesToHex(value);
+      default:
+        throw new SdError(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 DataType: ${JSON.stringify(dataType)}`);
+    }
+  }
+  _assertConnected() {
+    if (this._conn == null || !this.isConnected) {
+      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);
+    }
+    this._startTimeout();
+    return this._conn;
+  }
+  _resetState() {
+    this.isConnected = false;
+    this.isOnTransaction = false;
+    this._conn = void 0;
+  }
+  _stopTimeout() {
+    if (this._connTimeout != null) {
+      clearTimeout(this._connTimeout);
+    }
+  }
+  _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 {
+  MysqlDbConn
+};
+//# sourceMappingURL=mysql-db-conn.js.map