@simplysm/orm-node 13.0.0-beta.6

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/connections/mysql-db-conn.ts"],
+  "sourcesContent": ["import { randomUUID } from \"crypto\";\nimport fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport type { Connection } from \"mysql2/promise\";\nimport { createConsola } from \"consola\";\nimport {\n  bytesToHex,\n  DateOnly,\n  DateTime,\n  SdError,\n  EventEmitter,\n  strIsNullOrEmpty,\n  Time,\n  Uuid,\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 MysqlDbConnConfig } from \"../types/db-conn\";\n\nconst logger = createConsola().withTag(\"mysql-db-conn\");\n\n/**\n * MySQL \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC5F0\uACB0 \uD074\uB798\uC2A4\n *\n * mysql2/promise \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB97C \uC0AC\uC6A9\uD558\uC5EC MySQL \uC5F0\uACB0\uC744 \uAD00\uB9AC\uD569\uB2C8\uB2E4.\n */\nexport class MysqlDbConn extends EventEmitter<{ close: void }> implements DbConn {\n  private static readonly _ROOT_USER = \"root\";\n  private readonly _timeout = DB_CONN_DEFAULT_TIMEOUT;\n\n  private _conn?: Connection;\n  private _connTimeout?: ReturnType<typeof setTimeout>;\n\n  isConnected = false;\n  isOnTransaction = false;\n\n  constructor(\n    private readonly _mysql2: typeof import(\"mysql2/promise\"),\n    readonly config: MysqlDbConnConfig,\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 = await this._mysql2.createConnection({\n      host: this.config.host,\n      port: this.config.port,\n      user: this.config.username,\n      password: this.config.password,\n      // root \uC0AC\uC6A9\uC790\uB294 \uD2B9\uC815 database\uC5D0 \uBC14\uC778\uB529\uB418\uC9C0 \uC54A\uACE0 \uC5F0\uACB0\uD558\uC5EC\n      // \uBAA8\uB4E0 \uB370\uC774\uD130\uBCA0\uC774\uC2A4\uC5D0 \uC811\uADFC\uD560 \uC218 \uC788\uB3C4\uB85D \uD568 (\uAD00\uB9AC \uC791\uC5C5\uC6A9)\n      database: this.config.username === MysqlDbConn._ROOT_USER ? undefined : this.config.database,\n      multipleStatements: true,\n      charset: \"utf8mb4\",\n      infileStreamFactory: (filePath: string) => fs.createReadStream(filePath), // LOAD DATA LOCAL INFILE \uC9C0\uC6D0\n    } as Parameters<typeof this._mysql2.createConnection>[0]);\n\n    conn.on(\"end\", () => {\n      this.emit(\"close\");\n      this._resetState();\n    });\n\n    conn.on(\"error\", (error) => {\n      logger.error(\"DB \uC5F0\uACB0 \uC624\uB958\", error.message);\n    });\n\n    this._conn = conn;\n    this._startTimeout();\n    this.isConnected = true;\n  }\n\n  async close(): Promise<void> {\n    this._stopTimeout();\n\n    if (this._conn == null || !this.isConnected) {\n      return;\n    }\n\n    await this._conn.end();\n\n    this.emit(\"close\");\n    this._resetState();\n  }\n\n  async beginTransaction(isolationLevel?: IsolationLevel): Promise<void> {\n    const conn = this._assertConnected();\n\n    const level = (isolationLevel ?? this.config.defaultIsolationLevel ?? \"READ_UNCOMMITTED\").replace(/_/g, \" \");\n\n    // \uACA9\uB9AC \uC218\uC900\uC744 \uBA3C\uC800 \uC124\uC815 (\uB2E4\uC74C \uD2B8\uB79C\uC7AD\uC158\uC5D0 \uC801\uC6A9\uB428)\n    await conn.query({\n      sql: `SET SESSION TRANSACTION ISOLATION LEVEL ${level}`,\n      timeout: this._timeout,\n    });\n\n    // \uADF8 \uB2E4\uC74C \uD2B8\uB79C\uC7AD\uC158 \uC2DC\uC791\n    await conn.beginTransaction();\n\n    this.isOnTransaction = true;\n  }\n\n  async commitTransaction(): Promise<void> {\n    const conn = this._assertConnected();\n    await conn.commit();\n    this.isOnTransaction = false;\n  }\n\n  async rollbackTransaction(): Promise<void> {\n    const conn = this._assertConnected();\n    await conn.rollback();\n    this.isOnTransaction = false;\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    return results;\n  }\n\n  async executeParametrized(query: string, params?: unknown[]): Promise<unknown[][]> {\n    const conn = this._assertConnected();\n\n    logger.debug(\"\uCFFC\uB9AC \uC2E4\uD589\", { queryLength: query.length, params });\n\n    try {\n      const [queryResults] = await conn.query({\n        sql: query,\n        timeout: this._timeout,\n        values: params,\n      });\n\n      this._startTimeout();\n\n      // MySQL\uC740 INSERT/UPDATE/DELETE \uBB38\uC5D0 \uB300\uD574 ResultSetHeader\uB97C \uBC18\uD658\uD568\n      // SELECT \uACB0\uACFC\uB9CC \uCD94\uCD9C\uD558\uAE30 \uC704\uD574 ResultSetHeader \uAC1D\uCCB4\uB97C \uD544\uD130\uB9C1\uD568\n      // ResultSetHeader\uB294 affectedRows, fieldCount \uB4F1\uC758 \uD544\uB4DC\uB97C \uAC00\uC9C0\uACE0 \uC788\uC74C\n      const result: unknown[] = [];\n      if (queryResults instanceof Array) {\n        for (const queryResult of queryResults.filter(\n          (item: unknown) =>\n            !(typeof item === \"object\" && item !== null && \"affectedRows\" in item && \"fieldCount\" in item),\n        )) {\n          result.push(queryResult);\n        }\n      }\n\n      return [result];\n    } catch (err) {\n      this._startTimeout();\n      const error = err as Error & { sql?: string };\n      throw new SdError(\n        error,\n        \"\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD\" + (error.sql != null ? \"\\n-- query\\n\" + error.sql.trim() + \"\\n--\" : \"\"),\n      );\n    }\n  }\n\n  async bulkInsert(\n    tableName: string,\n    columnMetas: Record<string, ColumnMeta>,\n    records: Record<string, unknown>[],\n  ): Promise<void> {\n    const conn = this._assertConnected();\n\n    if (records.length === 0) return;\n\n    const colNames = Object.keys(columnMetas);\n\n    // \uC784\uC2DC CSV \uD30C\uC77C \uC0DD\uC131\n    const tmpDir = os.tmpdir();\n    const tmpFile = path.join(tmpDir, `mysql_bulk_${randomUUID()}.csv`);\n\n    try {\n      // CSV \uB370\uC774\uD130 \uC0DD\uC131\n      const csvLines: string[] = [];\n      for (const record of records) {\n        const row = colNames.map((colName) => this._escapeForCsv(record[colName], columnMetas[colName].dataType));\n        csvLines.push(row.join(\"\\t\"));\n      }\n      const csvContent = csvLines.join(\"\\n\");\n\n      // \uD30C\uC77C \uC4F0\uAE30\n      await fs.promises.writeFile(tmpFile, csvContent, \"utf8\");\n\n      // UUID/binary \uCEEC\uB7FC\uC740 \uC784\uC2DC \uBCC0\uC218\uB85C \uC77D\uACE0 SET \uC808\uC5D0\uC11C UNHEX() \uBCC0\uD658\n      const binaryColNames = colNames.filter((c) => {\n        const dt = columnMetas[c].dataType.type;\n        return dt === \"uuid\" || dt === \"binary\";\n      });\n      const normalCols = colNames.map((c) => {\n        if (binaryColNames.includes(c)) return `@_${c}`;\n        return `\\`${c}\\``;\n      });\n      const setClauses = binaryColNames.map((c) => `\\`${c}\\` = UNHEX(@_${c})`);\n\n      // LOAD DATA LOCAL INFILE \uC2E4\uD589\n      let query = `LOAD DATA LOCAL INFILE ? INTO TABLE ${tableName} FIELDS TERMINATED BY '\\\\t' LINES TERMINATED BY '\\\\n' (${normalCols.join(\", \")})`;\n      if (setClauses.length > 0) {\n        query += ` SET ${setClauses.join(\", \")}`;\n      }\n\n      await conn.query({ sql: query, timeout: this._timeout, values: [tmpFile] });\n    } finally {\n      // \uC784\uC2DC \uD30C\uC77C \uC0AD\uC81C\n      try {\n        await fs.promises.unlink(tmpFile);\n      } catch {\n        // \uC0AD\uC81C \uC2E4\uD328 \uBB34\uC2DC\n      }\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  /**\n   * MySQL LOAD DATA INFILE\uC6A9 \uAC12 \uC774\uC2A4\uCF00\uC774\uD504\n   */\n  private _escapeForCsv(value: unknown, dataType: DataType): string {\n    if (value == null) {\n      return \"\\\\N\"; // MySQL NULL \uD45C\uD604\n    }\n\n    switch (dataType.type) {\n      case \"int\":\n      case \"bigint\":\n      case \"float\":\n      case \"double\":\n      case \"decimal\":\n        return String(value);\n\n      case \"boolean\":\n        return (value as boolean) ? \"1\" : \"0\";\n\n      case \"varchar\":\n      case \"char\":\n      case \"text\": {\n        const str = value as string;\n        // \uD0ED, \uC904\uBC14\uAFC8, \uBC31\uC2AC\uB798\uC2DC \uC774\uC2A4\uCF00\uC774\uD504\n        return str.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\t/g, \"\\\\t\").replace(/\\n/g, \"\\\\n\").replace(/\\r/g, \"\\\\r\");\n      }\n\n      case \"datetime\":\n        return (value as DateTime).toFormatString(\"yyyy-MM-dd HH:mm:ss.fff\");\n\n      case \"date\":\n        return (value as DateOnly).toFormatString(\"yyyy-MM-dd\");\n\n      case \"time\":\n        return (value as Time).toFormatString(\"HH:mm:ss\");\n\n      case \"uuid\":\n        return (value as Uuid).toString().replace(/-/g, \"\"); // BINARY(16) \uC800\uC7A5\uC6A9 hex\n\n      case \"binary\":\n        return bytesToHex(value as Uint8Array);\n\n      default:\n        throw new SdError(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 DataType: ${JSON.stringify(dataType)}`);\n    }\n  }\n\n  private _assertConnected(): Connection {\n    if (this._conn == null || !this.isConnected) {\n      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);\n    }\n    this._startTimeout();\n    return this._conn;\n  }\n\n  private _resetState(): void {\n    this.isConnected = false;\n    this.isOnTransaction = false;\n    this._conn = undefined;\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"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,191 @@
+import { Readable } from "stream";
+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("postgresql-db-conn");
+class PostgresqlDbConn extends EventEmitter {
+  constructor(_pg, _pgCopyFrom, config) {
+    super();
+    this._pg = _pg;
+    this._pgCopyFrom = _pgCopyFrom;
+    this.config = config;
+  }
+  _timeout = DB_CONN_DEFAULT_TIMEOUT;
+  _client;
+  _connTimeout;
+  isConnected = false;
+  isOnTransaction = false;
+  async connect() {
+    if (this.isConnected) {
+      throw new SdError(DB_CONN_ERRORS.ALREADY_CONNECTED);
+    }
+    const client = new this._pg.Client({
+      host: this.config.host,
+      port: this.config.port ?? 5432,
+      user: this.config.username,
+      password: this.config.password,
+      database: this.config.database,
+      connectionTimeoutMillis: this._timeout,
+      query_timeout: this._timeout
+    });
+    client.on("end", () => {
+      this.emit("close");
+      this._resetState();
+    });
+    client.on("error", (error) => {
+      logger.error("DB \uC5F0\uACB0 \uC624\uB958", error.message);
+    });
+    await client.connect();
+    this._client = client;
+    this._startTimeout();
+    this.isConnected = true;
+  }
+  async close() {
+    this._stopTimeout();
+    if (this._client == null || !this.isConnected) {
+      return;
+    }
+    await this._client.end();
+    this.emit("close");
+    this._resetState();
+  }
+  async beginTransaction(isolationLevel) {
+    this._assertConnected();
+    const level = (isolationLevel ?? this.config.defaultIsolationLevel ?? "READ_UNCOMMITTED").replace(/_/g, " ");
+    await this._client.query("BEGIN");
+    await this._client.query(`SET TRANSACTION ISOLATION LEVEL ${level}`);
+    this.isOnTransaction = true;
+  }
+  async commitTransaction() {
+    this._assertConnected();
+    await this._client.query("COMMIT");
+    this.isOnTransaction = false;
+  }
+  async rollbackTransaction() {
+    this._assertConnected();
+    await this._client.query("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) {
+    this._assertConnected();
+    logger.debug("\uCFFC\uB9AC \uC2E4\uD589", { queryLength: query.length, params });
+    try {
+      const result = await this._client.query(query, params);
+      this._startTimeout();
+      return [result.rows];
+    } catch (err) {
+      this._startTimeout();
+      const error = err instanceof Error ? err : new Error(String(err));
+      throw new SdError(error, "\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD\n-- query\n" + query.trim() + "\n--");
+    }
+  }
+  async bulkInsert(tableName, columnMetas, records) {
+    this._assertConnected();
+    if (records.length === 0) return;
+    const colNames = Object.keys(columnMetas);
+    const wrappedCols = colNames.map((c) => `"${c}"`).join(", ");
+    const copyQuery = `COPY ${tableName} (${wrappedCols}) FROM STDIN WITH (FORMAT csv, NULL '\\N')`;
+    const stream = this._client.query(this._pgCopyFrom(copyQuery));
+    const csvLines = [];
+    for (const record of records) {
+      const row = colNames.map((colName) => this._escapeForCsv(record[colName], columnMetas[colName].dataType));
+      csvLines.push(row.join(","));
+    }
+    const csvContent = csvLines.join("\n") + "\n";
+    await new Promise((resolve, reject) => {
+      const readable = Readable.from([csvContent]);
+      readable.on("error", reject);
+      stream.on("error", reject);
+      stream.on("finish", resolve);
+      readable.pipe(stream);
+    });
+  }
+  // ─────────────────────────────────────────────
+  // Private helpers
+  // ─────────────────────────────────────────────
+  /**
+   * PostgreSQL COPY CSV용 값 이스케이프
+   */
+  _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 ? "true" : "false";
+      case "varchar":
+      case "char":
+      case "text": {
+        const str = value;
+        if (str.includes('"') || str.includes(",") || str.includes("\n") || str.includes("\r")) {
+          return '"' + str.replace(/"/g, '""') + '"';
+        }
+        return str;
+      }
+      case "datetime":
+        return value.toFormatString("yyyy-MM-dd HH:mm:ss.fff");
+      case "date":
+        return value.toFormatString("yyyy-MM-dd");
+      case "time":
+        return value.toFormatString("HH:mm:ss");
+      case "uuid":
+        return value.toString();
+      case "binary":
+        return '"\\x' + bytesToHex(value) + '"';
+      // PostgreSQL bytea hex 형식 (CSV 쌍따옴표로 감쌈)
+      default:
+        throw new SdError(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 DataType: ${JSON.stringify(dataType)}`);
+    }
+  }
+  _assertConnected() {
+    if (this._client == null || !this.isConnected) {
+      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);
+    }
+    this._startTimeout();
+  }
+  _resetState() {
+    this.isConnected = false;
+    this.isOnTransaction = false;
+    this._client = void 0;
+  }
+  _stopTimeout() {
+    if (this._connTimeout != null) {
+      clearTimeout(this._connTimeout);
+    }
+  }
+  _startTimeout() {
+    this._stopTimeout();
+    this._connTimeout = setTimeout(() => {
+      this.close().catch((err) => {
+        logger.error("close error", err instanceof Error ? err.message : String(err));
+      });
+    }, this._timeout * 2);
+  }
+}
+export {
+  PostgresqlDbConn
+};
+//# sourceMappingURL=postgresql-db-conn.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/connections/postgresql-db-conn.ts"],
+  "sourcesContent": ["import { Readable } from \"stream\";\nimport { createConsola } from \"consola\";\nimport {\n  bytesToHex,\n  DateOnly,\n  DateTime,\n  SdError,\n  EventEmitter,\n  strIsNullOrEmpty,\n  Time,\n  Uuid,\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 PostgresqlDbConnConfig } from \"../types/db-conn\";\nimport type { Client } from \"pg\";\nimport type { CopyStreamQuery } from \"pg-copy-streams\";\n\nconst logger = createConsola().withTag(\"postgresql-db-conn\");\n\n/**\n * PostgreSQL \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC5F0\uACB0 \uD074\uB798\uC2A4\n *\n * pg \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB97C \uC0AC\uC6A9\uD558\uC5EC PostgreSQL \uC5F0\uACB0\uC744 \uAD00\uB9AC\uD569\uB2C8\uB2E4.\n */\nexport class PostgresqlDbConn extends EventEmitter<{ close: void }> implements DbConn {\n  private readonly _timeout = DB_CONN_DEFAULT_TIMEOUT;\n\n  private _client?: Client;\n  private _connTimeout?: ReturnType<typeof setTimeout>;\n\n  isConnected = false;\n  isOnTransaction = false;\n\n  constructor(\n    private readonly _pg: typeof import(\"pg\"),\n    private readonly _pgCopyFrom: (queryText: string) => CopyStreamQuery,\n    readonly config: PostgresqlDbConnConfig,\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 client = new this._pg.Client({\n      host: this.config.host,\n      port: this.config.port ?? 5432,\n      user: this.config.username,\n      password: this.config.password,\n      database: this.config.database,\n      connectionTimeoutMillis: this._timeout,\n      query_timeout: this._timeout,\n    });\n\n    client.on(\"end\", () => {\n      this.emit(\"close\");\n      this._resetState();\n    });\n\n    client.on(\"error\", (error) => {\n      logger.error(\"DB \uC5F0\uACB0 \uC624\uB958\", error.message);\n    });\n\n    await client.connect();\n\n    this._client = client;\n    this._startTimeout();\n    this.isConnected = true;\n  }\n\n  async close(): Promise<void> {\n    this._stopTimeout();\n\n    if (this._client == null || !this.isConnected) {\n      return;\n    }\n\n    await this._client.end();\n\n    this.emit(\"close\");\n    this._resetState();\n  }\n\n  async beginTransaction(isolationLevel?: IsolationLevel): Promise<void> {\n    this._assertConnected();\n\n    const level = (isolationLevel ?? this.config.defaultIsolationLevel ?? \"READ_UNCOMMITTED\").replace(/_/g, \" \");\n\n    await this._client!.query(\"BEGIN\");\n    await this._client!.query(`SET TRANSACTION ISOLATION LEVEL ${level}`);\n\n    this.isOnTransaction = true;\n  }\n\n  async commitTransaction(): Promise<void> {\n    this._assertConnected();\n    await this._client!.query(\"COMMIT\");\n    this.isOnTransaction = false;\n  }\n\n  async rollbackTransaction(): Promise<void> {\n    this._assertConnected();\n    await this._client!.query(\"ROLLBACK\");\n    this.isOnTransaction = false;\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    return results;\n  }\n\n  async executeParametrized(query: string, params?: unknown[]): Promise<unknown[][]> {\n    this._assertConnected();\n\n    logger.debug(\"\uCFFC\uB9AC \uC2E4\uD589\", { queryLength: query.length, params });\n\n    try {\n      const result = await this._client!.query(query, params);\n\n      this._startTimeout();\n\n      // PostgreSQL\uC740 \uB2E8\uC77C \uACB0\uACFC\uC14B \uBC18\uD658\n      return [result.rows];\n    } catch (err) {\n      this._startTimeout();\n      const error = err instanceof Error ? err : new Error(String(err));\n      throw new SdError(error, \"\uCFFC\uB9AC \uC218\uD589\uC911 \uC624\uB958\uBC1C\uC0DD\\n-- query\\n\" + query.trim() + \"\\n--\");\n    }\n  }\n\n  async bulkInsert(\n    tableName: string,\n    columnMetas: Record<string, ColumnMeta>,\n    records: Record<string, unknown>[],\n  ): Promise<void> {\n    this._assertConnected();\n\n    if (records.length === 0) return;\n\n    const colNames = Object.keys(columnMetas);\n    const wrappedCols = colNames.map((c) => `\"${c}\"`).join(\", \");\n\n    // COPY FROM STDIN \uC2A4\uD2B8\uB9BC \uC0DD\uC131\n    const copyQuery = `COPY ${tableName} (${wrappedCols}) FROM STDIN WITH (FORMAT csv, NULL '\\\\N')`;\n    const stream = this._client!.query(this._pgCopyFrom(copyQuery));\n\n    // CSV \uB370\uC774\uD130 \uC0DD\uC131\n    const csvLines: string[] = [];\n    for (const record of records) {\n      const row = colNames.map((colName) => this._escapeForCsv(record[colName], columnMetas[colName].dataType));\n      csvLines.push(row.join(\",\"));\n    }\n    const csvContent = csvLines.join(\"\\n\") + \"\\n\";\n\n    // \uC2A4\uD2B8\uB9BC\uC73C\uB85C \uB370\uC774\uD130 \uC804\uC1A1\n    await new Promise<void>((resolve, reject) => {\n      const readable = Readable.from([csvContent]);\n\n      readable.on(\"error\", reject);\n      stream.on(\"error\", reject);\n      stream.on(\"finish\", resolve);\n\n      readable.pipe(stream);\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  /**\n   * PostgreSQL COPY CSV\uC6A9 \uAC12 \uC774\uC2A4\uCF00\uC774\uD504\n   */\n  private _escapeForCsv(value: unknown, dataType: DataType): string {\n    if (value == null) {\n      return \"\\\\N\"; // NULL \uD45C\uD604\n    }\n\n    switch (dataType.type) {\n      case \"int\":\n      case \"bigint\":\n      case \"float\":\n      case \"double\":\n      case \"decimal\":\n        return String(value);\n\n      case \"boolean\":\n        return (value as boolean) ? \"true\" : \"false\";\n\n      case \"varchar\":\n      case \"char\":\n      case \"text\": {\n        const str = value as string;\n        // CSV \uD615\uC2DD: \uC30D\uB530\uC634\uD45C\uB85C \uAC10\uC2F8\uACE0, \uB0B4\uBD80 \uC30D\uB530\uC634\uD45C\uB294 \uB450 \uBC88\n        if (str.includes('\"') || str.includes(\",\") || str.includes(\"\\n\") || str.includes(\"\\r\")) {\n          return '\"' + str.replace(/\"/g, '\"\"') + '\"';\n        }\n        return str;\n      }\n\n      case \"datetime\":\n        return (value as DateTime).toFormatString(\"yyyy-MM-dd HH:mm:ss.fff\");\n\n      case \"date\":\n        return (value as DateOnly).toFormatString(\"yyyy-MM-dd\");\n\n      case \"time\":\n        return (value as Time).toFormatString(\"HH:mm:ss\");\n\n      case \"uuid\":\n        return (value as Uuid).toString();\n\n      case \"binary\":\n        return '\"\\\\x' + bytesToHex(value as Uint8Array) + '\"'; // PostgreSQL bytea hex \uD615\uC2DD (CSV \uC30D\uB530\uC634\uD45C\uB85C \uAC10\uC308)\n\n      default:\n        throw new SdError(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 DataType: ${JSON.stringify(dataType)}`);\n    }\n  }\n\n  private _assertConnected(): void {\n    if (this._client == null || !this.isConnected) {\n      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);\n    }\n    this._startTimeout();\n  }\n\n  private _resetState(): void {\n    this.isConnected = false;\n    this.isOnTransaction = false;\n    this._client = undefined;\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"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core-common/src/common.types.d.ts

@@ -0,0 +1,74 @@
+import { DateTime } from "./types/date-time";
+import { DateOnly } from "./types/date-only";
+import { Time } from "./types/time";
+import { Uuid } from "./types/uuid";
+/**
+ * Buffer 대신 사용하는 바이너리 타입
+ */
+export type Bytes = Uint8Array;
+/**
+ * Primitive 타입 매핑
+ * orm-common과 공유
+ */
+export type PrimitiveTypeMap = {
+    string: string;
+    number: number;
+    boolean: boolean;
+    DateTime: DateTime;
+    DateOnly: DateOnly;
+    Time: Time;
+    Uuid: Uuid;
+    Bytes: Bytes;
+};
+/**
+ * Primitive 타입 문자열 키
+ */
+export type PrimitiveTypeStr = keyof PrimitiveTypeMap;
+/**
+ * Primitive 타입 유니온
+ */
+export type PrimitiveType = PrimitiveTypeMap[PrimitiveTypeStr] | undefined;
+/**
+ * 깊은 Partial 타입
+ *
+ * 객체의 모든 속성을 재귀적으로 선택적(optional)으로 만듭니다.
+ * Primitive 타입(string, number, boolean 등)은 그대로 유지하고,
+ * 객체/배열 타입만 재귀적으로 Partial을 적용합니다.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   name: string;
+ *   profile: {
+ *     age: number;
+ *     address: { city: string };
+ *   };
+ * }
+ *
+ * // 모든 깊이의 속성이 선택적이 됨
+ * const partial: DeepPartial<User> = {
+ *   profile: { address: {} }
+ * };
+ * ```
+ */
+export type DeepPartial<T> = Partial<{
+    [K in keyof T]: T[K] extends PrimitiveType ? T[K] : DeepPartial<T[K]>;
+}>;
+/**
+ * 생성자 타입
+ *
+ * 클래스 생성자를 타입으로 표현할 때 사용합니다.
+ * 주로 의존성 주입, 팩토리 패턴, instanceof 체크 등에서 활용됩니다.
+ *
+ * @example
+ * function create<T>(ctor: Type<T>): T {
+ *   return new ctor();
+ * }
+ *
+ * class MyClass { name = "test"; }
+ * const instance = create(MyClass); // MyClass 인스턴스
+ */
+export interface Type<T> extends Function {
+    new (...args: unknown[]): T;
+}
+//# sourceMappingURL=common.types.d.ts.map

package/dist/core-common/src/common.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../../../core-common/src/common.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAIpC;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC;AAM/B;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;AAM3E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC;KAClC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,CAAE,SAAQ,QAAQ;IACvC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;CAC7B"}

package/dist/core-common/src/env.d.ts

@@ -0,0 +1,6 @@
+export declare const env: {
+    DEV: boolean;
+    VER?: string;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/core-common/src/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../core-common/src/env.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,EAAE;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAKxB,CAAC"}

package/dist/core-common/src/errors/argument-error.d.ts

@@ -0,0 +1,25 @@
+import { SdError } from "./sd-error";
+/**
+ * 인수 오류
+ *
+ * 잘못된 인수를 받았을 때 발생시키는 에러이다.
+ * 인수 객체를 YAML 형식으로 메시지에 포함하여 디버깅을 용이하게 한다.
+ *
+ * @example
+ * // 인수 객체만 전달
+ * throw new ArgumentError({ userId: 123, name: null });
+ * // 결과 메시지: "인수가 잘못되었습니다.\n\nuserId: 123\nname: null"
+ *
+ * @example
+ * // 커스텀 메시지와 인수 객체 전달
+ * throw new ArgumentError("유효하지 않은 사용자", { userId: 123 });
+ * // 결과 메시지: "유효하지 않은 사용자\n\nuserId: 123"
+ */
+export declare class ArgumentError extends SdError {
+    /** 기본 메시지("인수가 잘못되었습니다.")와 함께 인수 객체를 YAML 형식으로 출력 */
+    constructor(argObj: Record<string, unknown>);
+    /** 커스텀 메시지와 함께 인수 객체를 YAML 형식으로 출력 */
+    constructor(message: string, argObj: Record<string, unknown>);
+    constructor(arg1: Record<string, unknown> | string, arg2?: Record<string, unknown>);
+}
+//# sourceMappingURL=argument-error.d.ts.map

package/dist/core-common/src/errors/argument-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,qDAAqD;gBACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,sCAAsC;gBAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYnF"}

package/dist/core-common/src/errors/not-implemented-error.d.ts

@@ -0,0 +1,29 @@
+import { SdError } from "./sd-error";
+/**
+ * 미구현 오류
+ *
+ * 아직 구현되지 않은 기능을 호출했을 때 발생시키는 에러이다.
+ * 추상 메서드 스텁, 향후 구현 예정인 분기 등에 사용한다.
+ *
+ * @example
+ * // 추상 메서드 구현 전
+ * class BaseService {
+ *   process(): void {
+ *     throw new NotImplementedError("서브클래스에서 구현 필요");
+ *   }
+ * }
+ *
+ * @example
+ * // 향후 구현 예정 분기
+ * switch (type) {
+ *   case "A": return handleA();
+ *   case "B": throw new NotImplementedError(`타입 ${type} 처리`);
+ * }
+ */
+export declare class NotImplementedError extends SdError {
+    /**
+     * @param message 추가 설명 메시지
+     */
+    constructor(message?: string);
+}
+//# sourceMappingURL=not-implemented-error.d.ts.map

package/dist/core-common/src/errors/not-implemented-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-implemented-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/not-implemented-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAoB,SAAQ,OAAO;IAC9C;;OAEG;gBACS,OAAO,CAAC,EAAE,MAAM;CAI7B"}

package/dist/core-common/src/errors/sd-error.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 오류의 Tree 구조 구성이 가능한 오류 클래스
+ * ES2024 cause 속성 활용
+ *
+ * @example
+ * // 원인 에러를 감싸서 생성
+ * try {
+ *   await fetch(url);
+ * } catch (err) {
+ *   throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
+ * }
+ * // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
+ *
+ * @example
+ * // 메시지만으로 생성
+ * throw new SdError("잘못된 상태", "처리 불가");
+ * // 결과 메시지: "처리 불가 => 잘못된 상태"
+ */
+export declare class SdError extends Error {
+    cause?: Error;
+    /** 원인 에러를 감싸서 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지 => 원인 메시지) */
+    constructor(cause: Error, ...messages: string[]);
+    /** 메시지만으로 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지) */
+    constructor(...messages: string[]);
+    constructor(arg1?: unknown, ...messages: string[]);
+}
+//# sourceMappingURL=sd-error.d.ts.map

package/dist/core-common/src/errors/sd-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/sd-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,gEAAgE;gBACpD,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;IAC/C,kDAAkD;gBACtC,GAAG,QAAQ,EAAE,MAAM,EAAE;gBACrB,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;CA2BlD"}

package/dist/core-common/src/errors/timeout-error.d.ts

@@ -0,0 +1,31 @@
+import { SdError } from "./sd-error";
+/**
+ * 타임아웃 오류
+ *
+ * 대기 시간이 초과되었을 때 발생하는 에러이다.
+ * Wait.until() 등의 비동기 대기 함수에서 최대 시도 횟수를 초과하면 자동으로 발생한다.
+ *
+ * @example
+ * // Wait.until에서 자동 발생
+ * try {
+ *   await Wait.until(() => isReady, 100, 50); // 100ms 간격, 최대 50회
+ * } catch (err) {
+ *   if (err instanceof TimeoutError) {
+ *     console.log("시간 초과");
+ *   }
+ * }
+ *
+ * @example
+ * // 직접 발생
+ * if (elapsed > maxTime) {
+ *   throw new TimeoutError(undefined, "API 응답 대기 초과");
+ * }
+ */
+export declare class TimeoutError extends SdError {
+    /**
+     * @param count 시도 횟수
+     * @param message 추가 메시지
+     */
+    constructor(count?: number, message?: string);
+}
+//# sourceMappingURL=timeout-error.d.ts.map

package/dist/core-common/src/errors/timeout-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/timeout-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAa,SAAQ,OAAO;IACvC;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAM7C"}

package/dist/core-common/src/extensions/arr-ext.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Array 확장 메서드
+ *
+ * @remarks 각 메서드의 TSDoc은 타입 정의 파일(arr-ext.types.ts) 참조
+ */
+import "./map-ext";
+import type { ReadonlyArrayExt, MutableArrayExt } from "./arr-ext.types";
+declare global {
+    interface ReadonlyArray<T> extends ReadonlyArrayExt<T> {
+    }
+    interface Array<T> extends ReadonlyArrayExt<T>, MutableArrayExt<T> {
+    }
+}
+export type { ArrayDiffsResult, ArrayDiffs2Result, TreeArray, ComparableType } from "./arr-ext.types";
+//# sourceMappingURL=arr-ext.d.ts.map

package/dist/core-common/src/extensions/arr-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arr-ext.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,WAAW,CAAC;AAUnB,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AA2uBzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,aAAa,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;KAAG;IACzD,UAAU,KAAK,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;KAAG;CACtE;AAID,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core-common/src/extensions/arr-ext.helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Array 확장 헬퍼 함수
+ */
+import type { ComparableType } from "./arr-ext.types";
+/**
+ * DateTime, DateOnly, Time을 비교 가능한 primitive 값으로 변환
+ */
+export declare function toComparable(value: ComparableType): string | number | boolean | undefined;
+/**
+ * 정렬을 위한 비교 함수
+ *
+ * @param pp 비교 대상 1
+ * @param pn 비교 대상 2
+ * @param desc true: 내림차순, false: 오름차순
+ * @returns 음수: pp가 앞, 0: 같음, 양수: pn이 앞
+ * @note null/undefined 값은 오름차순 시 앞으로, 내림차순 시 뒤로 정렬됨
+ */
+export declare function compareForOrder(pp: ComparableType, pn: ComparableType, desc: boolean): number;
+//# sourceMappingURL=arr-ext.helpers.d.ts.map

package/dist/core-common/src/extensions/arr-ext.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arr-ext.helpers.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAKzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAuB7F"}