@simplysm/orm-node 13.0.0-beta.6

package/dist/core-common/src/utils/xml.d.ts

@@ -0,0 +1,36 @@
+/**
+ * XML 변환 유틸리티
+ */
+import type { XmlBuilderOptions } from "fast-xml-parser";
+/**
+ * XML 문자열을 객체로 파싱
+ * @param str XML 문자열
+ * @param options 옵션
+ * @param options.stripTagPrefix 태그 prefix 제거 여부 (namespace)
+ * @returns 파싱된 객체. 구조:
+ *   - 속성: `$` 객체에 그룹화
+ *   - 텍스트 노드: `_` 키에 저장
+ *   - 자식 요소: 배열로 변환 (루트 요소 제외)
+ * @example
+ * xmlParse('<root id="1"><item>hello</item></root>');
+ * // { root: { $: { id: "1" }, item: [{ _: "hello" }] } }
+ */
+export declare function xmlParse(str: string, options?: {
+    stripTagPrefix?: boolean;
+}): unknown;
+/**
+ * 객체를 XML 문자열로 직렬화
+ * @param obj 직렬화할 객체
+ * @param options fast-xml-parser XmlBuilderOptions (선택)
+ * @returns XML 문자열
+ * @example
+ * xmlStringify({
+ *   root: {
+ *     $: { id: "1" },
+ *     item: [{ _: "hello" }, { _: "world" }],
+ *   },
+ * });
+ * // '<root id="1"><item>hello</item><item>world</item></root>'
+ */
+export declare function xmlStringify(obj: unknown, options?: XmlBuilderOptions): string;
+//# sourceMappingURL=xml.d.ts.map

package/dist/core-common/src/utils/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/xml.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAarF;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAS9E"}

package/dist/core-common/src/zip/sd-zip.d.ts

@@ -0,0 +1,80 @@
+import type { Bytes } from "../common.types";
+export interface ZipArchiveProgress {
+    fileName: string;
+    totalSize: number;
+    extractedSize: number;
+}
+/**
+ * ZIP 아카이브 처리 클래스
+ *
+ * ZIP 파일의 읽기, 쓰기, 압축/해제를 처리합니다.
+ * 내부 캐시를 사용하여 동일 파일의 중복 압축 해제를 방지합니다.
+ *
+ * @example
+ * // ZIP 파일 읽기
+ * await using archive = new ZipArchive(zipBytes);
+ * const content = await archive.get("file.txt");
+ *
+ * @example
+ * // ZIP 파일 생성
+ * await using archive = new ZipArchive();
+ * archive.write("file.txt", textBytes);
+ * archive.write("data.json", jsonBytes);
+ * const zipBytes = await archive.compress();
+ *
+ * @example
+ * // 전체 압축 해제 (진행률 표시)
+ * await using archive = new ZipArchive(zipBytes);
+ * const files = await archive.extractAll((progress) => {
+ *   console.log(`${progress.fileName}: ${progress.extractedSize}/${progress.totalSize}`);
+ * });
+ */
+export declare class ZipArchive {
+    private readonly _reader?;
+    private readonly _cache;
+    private _entries?;
+    /**
+     * ZipArchive 생성
+     * @param data ZIP 데이터 (생략 시 새 아카이브 생성)
+     */
+    constructor(data?: Blob | Bytes);
+    private _getEntries;
+    /**
+     * 모든 파일을 압축 해제
+     * @param progressCallback 진행률 콜백
+     */
+    extractAll(progressCallback?: (progress: ZipArchiveProgress) => void): Promise<Map<string, Bytes | undefined>>;
+    /**
+     * 특정 파일 압축 해제
+     * @param fileName 파일 이름
+     */
+    get(fileName: string): Promise<Bytes | undefined>;
+    /**
+     * 파일 존재 여부 확인
+     * @param fileName 파일 이름
+     */
+    exists(fileName: string): Promise<boolean>;
+    /**
+     * 파일 쓰기 (캐시에 저장)
+     * @param fileName 파일 이름
+     * @param bytes 파일 내용
+     */
+    write(fileName: string, bytes: Bytes): void;
+    /**
+     * 캐시된 파일들을 ZIP으로 압축
+     *
+     * @remarks
+     * 내부적으로 `extractAll()`을 호출하여 모든 파일을 메모리에 로드한 후 압축합니다.
+     * 대용량 ZIP 파일의 경우 메모리 사용량에 주의가 필요합니다.
+     */
+    compress(): Promise<Bytes>;
+    /**
+     * 리더 닫기 및 캐시 정리
+     */
+    close(): Promise<void>;
+    /**
+     * await using 지원
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=sd-zip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sd-zip.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/zip/sd-zip.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,CAA6D;IAE9E;;;OAGG;gBACS,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK;YAUjB,WAAW;IAQzB;;;OAGG;IACG,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;IAkDpH;;;OAGG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAwBvD;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAM3C;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;IAiBhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7C"}

package/dist/db-conn-factory.js

@@ -0,0 +1,88 @@
+import { createPool } from "generic-pool";
+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";
+class DbConnFactory {
+  // 설정별 커넥션 풀 캐싱
+  static _poolMap = /* @__PURE__ */ new Map();
+  /**
+   * DB 연결 생성
+   *
+   * 커넥션 풀에서 연결을 획득하여 반환한다.
+   * 풀이 없는 경우 새로 생성한다.
+   *
+   * @param config - 데이터베이스 연결 설정
+   * @returns 풀링된 DB 연결 객체
+   */
+  static create(config) {
+    const pool = this._getOrCreatePool(config);
+    return Promise.resolve(new PooledDbConn(pool, config));
+  }
+  static _getOrCreatePool(config) {
+    const configKey = JSON.stringify(
+      config,
+      (_, value) => value != null && typeof value === "object" && !Array.isArray(value) ? Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b))) : value
+    );
+    if (!this._poolMap.has(configKey)) {
+      const pool = createPool(
+        {
+          create: async () => {
+            const conn = await this._createRawConnection(config);
+            await conn.connect();
+            return conn;
+          },
+          destroy: async (conn) => {
+            await conn.close();
+          },
+          validate: (conn) => {
+            return Promise.resolve(conn.isConnected);
+          }
+        },
+        {
+          min: config.pool?.min ?? 1,
+          max: config.pool?.max ?? 10,
+          acquireTimeoutMillis: config.pool?.acquireTimeoutMillis ?? 3e4,
+          idleTimeoutMillis: config.pool?.idleTimeoutMillis ?? 3e4,
+          testOnBorrow: true
+          // [중요] 빌려줄 때 validate 실행 여부
+        }
+      );
+      this._poolMap.set(configKey, pool);
+    }
+    return this._poolMap.get(configKey);
+  }
+  static async _createRawConnection(config) {
+    if (config.dialect === "mysql") {
+      const mysql = await this._ensureModule("mysql");
+      return new MysqlDbConn(mysql, config);
+    } else if (config.dialect === "postgresql") {
+      const pg = await this._ensureModule("pg");
+      const pgCopyStreams = await this._ensureModule("pgCopyStreams");
+      return new PostgresqlDbConn(pg, pgCopyStreams.from, config);
+    } else {
+      const tedious = await this._ensureModule("tedious");
+      return new MssqlDbConn(tedious, config);
+    }
+  }
+  // 지연 로딩 모듈 캐시
+  static _modules = {};
+  static async _ensureModule(name) {
+    if (this._modules[name] == null) {
+      if (name === "mysql") {
+        this._modules.mysql = await import("mysql2/promise");
+      } else if (name === "pg") {
+        this._modules.pg = await import("pg");
+      } else if (name === "pgCopyStreams") {
+        this._modules.pgCopyStreams = await import("pg-copy-streams");
+      } else {
+        this._modules.tedious = await import("tedious");
+      }
+    }
+    return this._modules[name];
+  }
+}
+export {
+  DbConnFactory
+};
+//# sourceMappingURL=db-conn-factory.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/db-conn-factory.ts"],
+  "sourcesContent": ["import type { Pool } from \"generic-pool\";\nimport { createPool } from \"generic-pool\";\nimport type { DbConn, DbConnConfig } from \"./types/db-conn\";\nimport { PooledDbConn } from \"./pooled-db-conn\";\nimport { MysqlDbConn } from \"./connections/mysql-db-conn\";\nimport { MssqlDbConn } from \"./connections/mssql-db-conn\";\nimport { PostgresqlDbConn } from \"./connections/postgresql-db-conn\";\n\n/**\n * DB \uC5F0\uACB0 \uD329\uD1A0\uB9AC\n *\n * \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC5F0\uACB0 \uC778\uC2A4\uD134\uC2A4\uB97C \uC0DD\uC131\uD558\uACE0 \uD480\uB9C1\uC744 \uAD00\uB9AC\uD55C\uB2E4.\n * MSSQL, MySQL, PostgreSQL\uC744 \uC9C0\uC6D0\uD55C\uB2E4.\n */\nexport class DbConnFactory {\n  // \uC124\uC815\uBCC4 \uCEE4\uB125\uC158 \uD480 \uCE90\uC2F1\n  private static readonly _poolMap = new Map<string, Pool<DbConn>>();\n\n  /**\n   * DB \uC5F0\uACB0 \uC0DD\uC131\n   *\n   * \uCEE4\uB125\uC158 \uD480\uC5D0\uC11C \uC5F0\uACB0\uC744 \uD68D\uB4DD\uD558\uC5EC \uBC18\uD658\uD55C\uB2E4.\n   * \uD480\uC774 \uC5C6\uB294 \uACBD\uC6B0 \uC0C8\uB85C \uC0DD\uC131\uD55C\uB2E4.\n   *\n   * @param config - \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC5F0\uACB0 \uC124\uC815\n   * @returns \uD480\uB9C1\uB41C DB \uC5F0\uACB0 \uAC1D\uCCB4\n   */\n  static create(config: DbConnConfig): Promise<DbConn> {\n    // 1. \uD480 \uAC00\uC838\uC624\uAE30 (\uC5C6\uC73C\uBA74 \uC0DD\uC131)\n    const pool = this._getOrCreatePool(config);\n\n    // 2. \uB798\uD37C \uAC1D\uCCB4 \uBC18\uD658\n    return Promise.resolve(new PooledDbConn(pool, config));\n  }\n\n  private static _getOrCreatePool(config: DbConnConfig): Pool<DbConn> {\n    // \uAC1D\uCCB4\uB97C \uD0A4\uB85C \uC4F0\uAE30 \uC704\uD574 \uBB38\uC790\uC5F4 \uBCC0\uD658 (\uC911\uCCA9 \uAC1D\uCCB4\uB3C4 \uC815\uB82C\uD558\uC5EC \uB3D9\uC77C \uC124\uC815\uC758 \uC77C\uAD00\uB41C \uD0A4 \uBCF4\uC7A5)\n    const configKey = JSON.stringify(config, (_, value: unknown) =>\n      value != null && typeof value === \"object\" && !Array.isArray(value)\n        ? Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)))\n        : value,\n    );\n\n    if (!this._poolMap.has(configKey)) {\n      const pool = createPool<DbConn>(\n        {\n          create: async () => {\n            const conn = await this._createRawConnection(config);\n            await conn.connect();\n            return conn;\n          },\n          destroy: async (conn) => {\n            await conn.close(); // \uD480\uC5D0\uC11C \uC81C\uAC70\uB420 \uB54C \uC2E4\uC81C \uC5F0\uACB0 \uC885\uB8CC\n          },\n          validate: (conn) => {\n            // \uD68D\uB4DD \uC2DC \uC5F0\uACB0 \uC0C1\uD0DC \uD655\uC778 (\uB04A\uACA8\uC788\uC73C\uBA74 Pool\uC774 \uD3D0\uAE30\uD558\uACE0 \uC0C8\uB85C \uB9CC\uB4E6)\n            return Promise.resolve(conn.isConnected);\n          },\n        },\n        {\n          min: config.pool?.min ?? 1,\n          max: config.pool?.max ?? 10,\n          acquireTimeoutMillis: config.pool?.acquireTimeoutMillis ?? 30000,\n          idleTimeoutMillis: config.pool?.idleTimeoutMillis ?? 30000,\n          testOnBorrow: true, // [\uC911\uC694] \uBE4C\uB824\uC904 \uB54C validate \uC2E4\uD589 \uC5EC\uBD80\n        },\n      );\n\n      this._poolMap.set(configKey, pool);\n    }\n\n    return this._poolMap.get(configKey)!;\n  }\n\n  private static async _createRawConnection(config: DbConnConfig): Promise<DbConn> {\n    if (config.dialect === \"mysql\") {\n      const mysql = await this._ensureModule(\"mysql\");\n      return new MysqlDbConn(mysql, config);\n    } else if (config.dialect === \"postgresql\") {\n      const pg = await this._ensureModule(\"pg\");\n      const pgCopyStreams = await this._ensureModule(\"pgCopyStreams\");\n      return new PostgresqlDbConn(pg, pgCopyStreams.from, config);\n    } else {\n      // mssql, mssql-azure\n      const tedious = await this._ensureModule(\"tedious\");\n      return new MssqlDbConn(tedious, config);\n    }\n  }\n\n  // \uC9C0\uC5F0 \uB85C\uB529 \uBAA8\uB4C8 \uCE90\uC2DC\n  private static readonly _modules: {\n    tedious?: typeof import(\"tedious\");\n    mysql?: typeof import(\"mysql2/promise\");\n    pg?: typeof import(\"pg\");\n    pgCopyStreams?: typeof import(\"pg-copy-streams\");\n  } = {};\n\n  private static async _ensureModule<K extends keyof typeof this._modules>(\n    name: K,\n  ): Promise<NonNullable<(typeof this._modules)[K]>> {\n    if (this._modules[name] == null) {\n      if (name === \"mysql\") {\n        this._modules.mysql = await import(\"mysql2/promise\");\n      } else if (name === \"pg\") {\n        this._modules.pg = await import(\"pg\");\n      } else if (name === \"pgCopyStreams\") {\n        this._modules.pgCopyStreams = await import(\"pg-copy-streams\");\n      } else {\n        this._modules.tedious = await import(\"tedious\");\n      }\n    }\n    return this._modules[name]!;\n  }\n}\n"],
+  "mappings": "AACA,SAAS,kBAAkB;AAE3B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AAQ1B,MAAM,cAAc;AAAA;AAAA,EAEzB,OAAwB,WAAW,oBAAI,IAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWjE,OAAO,OAAO,QAAuC;AAEnD,UAAM,OAAO,KAAK,iBAAiB,MAAM;AAGzC,WAAO,QAAQ,QAAQ,IAAI,aAAa,MAAM,MAAM,CAAC;AAAA,EACvD;AAAA,EAEA,OAAe,iBAAiB,QAAoC;AAElE,UAAM,YAAY,KAAK;AAAA,MAAU;AAAA,MAAQ,CAAC,GAAG,UAC3C,SAAS,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAC9D,OAAO,YAAY,OAAO,QAAQ,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,IAC/E;AAAA,IACN;AAEA,QAAI,CAAC,KAAK,SAAS,IAAI,SAAS,GAAG;AACjC,YAAM,OAAO;AAAA,QACX;AAAA,UACE,QAAQ,YAAY;AAClB,kBAAM,OAAO,MAAM,KAAK,qBAAqB,MAAM;AACnD,kBAAM,KAAK,QAAQ;AACnB,mBAAO;AAAA,UACT;AAAA,UACA,SAAS,OAAO,SAAS;AACvB,kBAAM,KAAK,MAAM;AAAA,UACnB;AAAA,UACA,UAAU,CAAC,SAAS;AAElB,mBAAO,QAAQ,QAAQ,KAAK,WAAW;AAAA,UACzC;AAAA,QACF;AAAA,QACA;AAAA,UACE,KAAK,OAAO,MAAM,OAAO;AAAA,UACzB,KAAK,OAAO,MAAM,OAAO;AAAA,UACzB,sBAAsB,OAAO,MAAM,wBAAwB;AAAA,UAC3D,mBAAmB,OAAO,MAAM,qBAAqB;AAAA,UACrD,cAAc;AAAA;AAAA,QAChB;AAAA,MACF;AAEA,WAAK,SAAS,IAAI,WAAW,IAAI;AAAA,IACnC;AAEA,WAAO,KAAK,SAAS,IAAI,SAAS;AAAA,EACpC;AAAA,EAEA,aAAqB,qBAAqB,QAAuC;AAC/E,QAAI,OAAO,YAAY,SAAS;AAC9B,YAAM,QAAQ,MAAM,KAAK,cAAc,OAAO;AAC9C,aAAO,IAAI,YAAY,OAAO,MAAM;AAAA,IACtC,WAAW,OAAO,YAAY,cAAc;AAC1C,YAAM,KAAK,MAAM,KAAK,cAAc,IAAI;AACxC,YAAM,gBAAgB,MAAM,KAAK,cAAc,eAAe;AAC9D,aAAO,IAAI,iBAAiB,IAAI,cAAc,MAAM,MAAM;AAAA,IAC5D,OAAO;AAEL,YAAM,UAAU,MAAM,KAAK,cAAc,SAAS;AAClD,aAAO,IAAI,YAAY,SAAS,MAAM;AAAA,IACxC;AAAA,EACF;AAAA;AAAA,EAGA,OAAwB,WAKpB,CAAC;AAAA,EAEL,aAAqB,cACnB,MACiD;AACjD,QAAI,KAAK,SAAS,IAAI,KAAK,MAAM;AAC/B,UAAI,SAAS,SAAS;AACpB,aAAK,SAAS,QAAQ,MAAM,OAAO,gBAAgB;AAAA,MACrD,WAAW,SAAS,MAAM;AACxB,aAAK,SAAS,KAAK,MAAM,OAAO,IAAI;AAAA,MACtC,WAAW,SAAS,iBAAiB;AACnC,aAAK,SAAS,gBAAgB,MAAM,OAAO,iBAAiB;AAAA,MAC9D,OAAO;AACL,aAAK,SAAS,UAAU,MAAM,OAAO,SAAS;AAAA,MAChD;AAAA,IACF;AACA,WAAO,KAAK,SAAS,IAAI;AAAA,EAC3B;AACF;",
+  "names": []
+}

package/dist/index.js

@@ -0,0 +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";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "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.js

@@ -0,0 +1,129 @@
+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";
+class NodeDbContextExecutor {
+  constructor(_config) {
+    this._config = _config;
+    this._dialect = getDialectFromConfig(_config);
+  }
+  _conn;
+  _dialect;
+  /**
+   * DB 연결 수립
+   *
+   * 커넥션 풀에서 연결을 획득하고 연결 상태를 활성화한다.
+   */
+  async connect() {
+    this._conn = await DbConnFactory.create(this._config);
+    await this._conn.connect();
+  }
+  /**
+   * DB 연결 종료
+   *
+   * 커넥션 풀에 연결을 반환한다.
+   *
+   * @throws {Error} 연결되지 않은 상태일 때
+   */
+  async close() {
+    const conn = this._requireConn();
+    await conn.close();
+    this._conn = void 0;
+  }
+  /**
+   * 트랜잭션 시작
+   *
+   * @param isolationLevel - 트랜잭션 격리 수준
+   * @throws {Error} 연결되지 않은 상태일 때
+   */
+  async beginTransaction(isolationLevel) {
+    const conn = this._requireConn();
+    await conn.beginTransaction(isolationLevel);
+  }
+  /**
+   * 트랜잭션 커밋
+   *
+   * @throws {Error} 연결되지 않은 상태일 때
+   */
+  async commitTransaction() {
+    const conn = this._requireConn();
+    await conn.commitTransaction();
+  }
+  /**
+   * 트랜잭션 롤백
+   *
+   * @throws {Error} 연결되지 않은 상태일 때
+   */
+  async rollbackTransaction() {
+    const conn = this._requireConn();
+    await conn.rollbackTransaction();
+  }
+  /**
+   * 파라미터화된 쿼리 실행
+   *
+   * @param query - SQL 쿼리 문자열
+   * @param params - 쿼리 파라미터 배열
+   * @returns 쿼리 결과 배열
+   * @throws {Error} 연결되지 않은 상태일 때
+   */
+  async executeParametrized(query, params) {
+    const conn = this._requireConn();
+    return conn.executeParametrized(query, params);
+  }
+  /**
+   * 대량 데이터 삽입 (네이티브 벌크 API 사용)
+   *
+   * @param tableName - 대상 테이블명
+   * @param columnMetas - 컬럼 메타데이터
+   * @param records - 삽입할 레코드 배열
+   * @throws {Error} 연결되지 않은 상태일 때
+   */
+  async bulkInsert(tableName, columnMetas, records) {
+    const conn = this._requireConn();
+    await conn.bulkInsert(tableName, columnMetas, records);
+  }
+  /**
+   * QueryDef 배열 실행
+   *
+   * QueryDef를 SQL로 변환하여 실행하고, ResultMeta를 사용하여 결과를 파싱한다.
+   *
+   * @param defs - 실행할 QueryDef 배열
+   * @param resultMetas - 결과 파싱용 메타데이터 배열 (타입 변환에 사용)
+   * @returns 각 QueryDef의 실행 결과 배열
+   * @throws {Error} 연결되지 않은 상태일 때
+   */
+  async executeDefs(defs, resultMetas) {
+    const conn = this._requireConn();
+    const builder = createQueryBuilder(this._dialect);
+    if (resultMetas != null && resultMetas.every((item) => item == null)) {
+      const combinedSql = defs.map((def) => builder.build(def).sql).join("\n");
+      await conn.execute([combinedSql]);
+      return defs.map(() => []);
+    }
+    const results = [];
+    for (let i = 0; i < defs.length; i++) {
+      const def = defs[i];
+      const meta = resultMetas?.[i];
+      const buildResult = builder.build(def);
+      const rawResults = await conn.execute([buildResult.sql]);
+      const targetResultSet = buildResult.resultSetIndex != null ? rawResults[buildResult.resultSetIndex] : rawResults[0];
+      if (meta != null) {
+        const parsed = await parseQueryResult(targetResultSet, meta);
+        results.push(parsed ?? []);
+      } else {
+        results.push(targetResultSet);
+      }
+    }
+    return results;
+  }
+  _requireConn() {
+    if (this._conn == null) {
+      throw new SdError(DB_CONN_ERRORS.NOT_CONNECTED);
+    }
+    return this._conn;
+  }
+}
+export {
+  NodeDbContextExecutor
+};
+//# sourceMappingURL=node-db-context-executor.js.map

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

@@ -0,0 +1,7 @@
+{
+  "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;",
+  "names": []
+}