@simplysm/orm-node 13.0.0-beta.51 → 13.0.1

package/README.md

@@ -28,28 +28,33 @@ npm install pg pg-copy-streams
 ## Architecture
 
 ```
-SdOrm (top-level entry point)
+createOrm() (top-level entry point)
   └── NodeDbContextExecutor (executor between DbContext and actual DB)
-        └── DbConnFactory (connection creation and pool management)
+        └── createDbConn() (connection creation and pool management)
               └── PooledDbConn (connection pool wrapper)
                     └── MysqlDbConn / MssqlDbConn / PostgresqlDbConn (DBMS-specific low-level connections)
 ```
 
-- `SdOrm` is the top-level class that takes a `DbContext` type and connection settings to manage transactions.
+- `createOrm()` is the top-level factory function that takes a `DbContext` type and connection settings to manage transactions.
 - `NodeDbContextExecutor` is the executor used by `DbContext`, converting `QueryDef` to SQL and executing it.
-- `DbConnFactory` is a factory that acquires connections from the connection pool.
+- `createDbConn()` is a factory function that acquires connections from the connection pool.
 - `PooledDbConn` is a connection pool wrapper based on `generic-pool`, returning connections to the pool instead of closing them after use.
 - Each DBMS-specific connection class (`MysqlDbConn`, `MssqlDbConn`, `PostgresqlDbConn`) directly uses low-level DB drivers.
 
 ## Core Modules
 
+### Functions
+
+| Function | Description |
+|----------|-------------|
+| `createOrm()` | ORM factory function. Takes `DbContext` type and connection settings to manage transaction-based connections. |
+| `createDbConn()` | Connection factory function. Caches connection pools by configuration and returns `PooledDbConn`. |
+
 ### Classes
 
 | Class | Description |
 |--------|------|
-| `SdOrm` | ORM top-level class. Takes `DbContext` type and connection settings to manage transaction-based connections. |
 | `NodeDbContextExecutor` | `DbContextExecutor` implementation. Converts `QueryDef` to SQL, executes it, and parses results. |
-| `DbConnFactory` | Connection factory. Caches connection pools by configuration and returns `PooledDbConn`. |
 | `PooledDbConn` | Connection pool wrapper. Acquires/returns physical connections from `generic-pool`, implements `DbConn` interface. |
 | `MysqlDbConn` | MySQL connection class. Uses `mysql2/promise` driver. |
 | `MssqlDbConn` | MSSQL/Azure SQL connection class. Uses `tedious` driver. |
@@ -65,7 +70,7 @@ SdOrm (top-level entry point)
 | `MssqlDbConnConfig` | MSSQL connection config. `dialect: "mssql" \| "mssql-azure"`. |
 | `PostgresqlDbConnConfig` | PostgreSQL connection config. `dialect: "postgresql"`. |
 | `DbPoolConfig` | Connection pool config (`min`, `max`, `acquireTimeoutMillis`, `idleTimeoutMillis`). |
-| `SdOrmOptions` | `SdOrm` options. `database`, `schema` settings that override `DbConnConfig`. |
+| `OrmOptions` | `createOrm()` options. `database`, `schema` settings that override `DbConnConfig`. |
 
 ### Constants and Utility Functions
 
@@ -77,12 +82,12 @@ SdOrm (top-level entry point)
 
 ## Usage
 
-### Basic Usage with SdOrm
+### Basic Usage with createOrm
 
-`SdOrm` is the top-level entry point used with `DbContext`. It automatically handles transaction management.
+`createOrm()` is the top-level factory function used with `DbContext`. It automatically handles transaction management.
 
 ```typescript
-import { SdOrm } from "@simplysm/orm-node";
+import { createOrm } from "@simplysm/orm-node";
 import { DbContext, queryable, Table } from "@simplysm/orm-common";
 
 // 1. Define table
@@ -100,8 +105,8 @@ class MyDb extends DbContext {
   readonly user = queryable(this, User);
 }
 
-// 3. Create SdOrm instance
-const orm = new SdOrm(MyDb, {
+// 3. Create ORM instance
+const orm = createOrm(MyDb, {
   dialect: "mysql",
   host: "localhost",
   port: 3306,
@@ -148,12 +153,12 @@ Supported isolation levels (`IsolationLevel`):
 - `"REPEATABLE_READ"`
 - `"SERIALIZABLE"`
 
-### Overriding database/schema via SdOrmOptions
+### Overriding database/schema via OrmOptions
 
-Using `SdOrmOptions`, you can use different values instead of the `database`/`schema` set in `DbConnConfig`.
+Using `OrmOptions`, you can use different values instead of the `database`/`schema` set in `DbConnConfig`.
 
 ```typescript
-const orm = new SdOrm(MyDb, {
+const orm = createOrm(MyDb, {
   dialect: "postgresql",
   host: "localhost",
   port: 5432,
@@ -172,7 +177,7 @@ const orm = new SdOrm(MyDb, {
 Configure connection pool via the `pool` field in `DbConnConfig`. The pool is based on the `generic-pool` library, and pools are automatically cached for identical configurations.
 
 ```typescript
-const orm = new SdOrm(MyDb, {
+const orm = createOrm(MyDb, {
   dialect: "mssql",
   host: "localhost",
   port: 1433,
@@ -188,15 +193,15 @@ const orm = new SdOrm(MyDb, {
 });
 ```
 
-### Low-Level Connection with DbConnFactory
+### Low-Level Connection with createDbConn
 
-You can connect directly to the DB and execute SQL without `SdOrm`/`DbContext`. `DbConnFactory.create()` returns `PooledDbConn` from the connection pool.
+You can connect directly to the DB and execute SQL without `createOrm`/`DbContext`. `createDbConn()` returns `PooledDbConn` from the connection pool.
 
 ```typescript
-import { DbConnFactory } from "@simplysm/orm-node";
+import { createDbConn } from "@simplysm/orm-node";
 
 // Create connection (acquire from pool)
-const conn = await DbConnFactory.create({
+const conn = await createDbConn({
   dialect: "mysql",
   host: "localhost",
   port: 3306,
@@ -233,7 +238,7 @@ try {
 Each connection class supports parameter binding via the `executeParametrized()` method.
 
 ```typescript
-const conn = await DbConnFactory.create({
+const conn = await createDbConn({
   dialect: "postgresql",
   host: "localhost",
   port: 5432,
@@ -266,7 +271,7 @@ Supports bulk data insertion using native bulk APIs for each DBMS.
 ```typescript
 import type { ColumnMeta } from "@simplysm/orm-common";
 
-const conn = await DbConnFactory.create({
+const conn = await createDbConn({
   dialect: "mysql",
   host: "localhost",
   port: 3306,
@@ -398,7 +403,7 @@ The common interface implemented by all DBMS-specific connection classes (`Mysql
 
 ### Driver Lazy Loading
 
-DBMS-specific drivers (`mysql2`, `tedious`, `pg`) are lazy-loaded within `DbConnFactory`. Therefore, import errors won't occur even if unused drivers are not installed.
+DBMS-specific drivers (`mysql2`, `tedious`, `pg`) are lazy-loaded within `createDbConn()`. Therefore, import errors won't occur even if unused drivers are not installed.
 
 ### PooledDbConn close Behavior
 

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

@@ -0,0 +1,12 @@
+import type { DbConn, DbConnConfig } from "./types/db-conn";
+/**
+ * DB 연결 생성
+ *
+ * 커넥션 풀에서 연결을 획득하여 반환한다.
+ * 풀이 없는 경우 새로 생성한다.
+ *
+ * @param config - 데이터베이스 연결 설정
+ * @returns 풀링된 DB 연결 객체
+ */
+export declare function createDbConn(config: DbConnConfig): Promise<DbConn>;
+//# sourceMappingURL=create-db-conn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-db-conn.d.ts","sourceRoot":"","sources":["../src/create-db-conn.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAwB5D;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlE"}

package/dist/create-db-conn.js

@@ -0,0 +1,75 @@
+import { createPool } from "generic-pool";
+import { PooledDbConn } from "./pooled-db-conn.js";
+import { MysqlDbConn } from "./connections/mysql-db-conn.js";
+import { MssqlDbConn } from "./connections/mssql-db-conn.js";
+import { PostgresqlDbConn } from "./connections/postgresql-db-conn.js";
+const poolMap = /* @__PURE__ */ new Map();
+const modules = {};
+function createDbConn(config) {
+  const pool = getOrCreatePool(config);
+  return Promise.resolve(new PooledDbConn(pool, config));
+}
+function 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 (!poolMap.has(configKey)) {
+    const pool = createPool(
+      {
+        create: async () => {
+          const conn = await 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 실행 여부
+      }
+    );
+    poolMap.set(configKey, pool);
+  }
+  return poolMap.get(configKey);
+}
+async function createRawConnection(config) {
+  if (config.dialect === "mysql") {
+    const mysql = await ensureModule("mysql");
+    return new MysqlDbConn(mysql, config);
+  } else if (config.dialect === "postgresql") {
+    const pg = await ensureModule("pg");
+    const pgCopyStreams = await ensureModule("pgCopyStreams");
+    return new PostgresqlDbConn(pg, pgCopyStreams.from, config);
+  } else {
+    const tedious = await ensureModule("tedious");
+    return new MssqlDbConn(tedious, config);
+  }
+}
+async function ensureModule(name) {
+  if (modules[name] == null) {
+    if (name === "mysql") {
+      modules.mysql = await import("mysql2/promise");
+    } else if (name === "pg") {
+      modules.pg = await import("pg");
+    } else if (name === "pgCopyStreams") {
+      modules.pgCopyStreams = await import("pg-copy-streams");
+    } else {
+      modules.tedious = await import("tedious");
+    }
+  }
+  return modules[name];
+}
+export {
+  createDbConn
+};
+//# sourceMappingURL=create-db-conn.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/create-db-conn.ts"],
+  "mappings": "AACA,SAAS,kBAAkB;AAE3B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AAUjC,MAAM,UAAU,oBAAI,IAA0B;AAG9C,MAAM,UAKF,CAAC;AAWE,SAAS,aAAa,QAAuC;AAElE,QAAM,OAAO,gBAAgB,MAAM;AAGnC,SAAO,QAAQ,QAAQ,IAAI,aAAa,MAAM,MAAM,CAAC;AACvD;AAEA,SAAS,gBAAgB,QAAoC;AAE3D,QAAM,YAAY,KAAK;AAAA,IAAU;AAAA,IAAQ,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,EACN;AAEA,MAAI,CAAC,QAAQ,IAAI,SAAS,GAAG;AAC3B,UAAM,OAAO;AAAA,MACX;AAAA,QACE,QAAQ,YAAY;AAClB,gBAAM,OAAO,MAAM,oBAAoB,MAAM;AAC7C,gBAAM,KAAK,QAAQ;AACnB,iBAAO;AAAA,QACT;AAAA,QACA,SAAS,OAAO,SAAS;AACvB,gBAAM,KAAK,MAAM;AAAA,QACnB;AAAA,QACA,UAAU,CAAC,SAAS;AAElB,iBAAO,QAAQ,QAAQ,KAAK,WAAW;AAAA,QACzC;AAAA,MACF;AAAA,MACA;AAAA,QACE,KAAK,OAAO,MAAM,OAAO;AAAA,QACzB,KAAK,OAAO,MAAM,OAAO;AAAA,QACzB,sBAAsB,OAAO,MAAM,wBAAwB;AAAA,QAC3D,mBAAmB,OAAO,MAAM,qBAAqB;AAAA,QACrD,cAAc;AAAA;AAAA,MAChB;AAAA,IACF;AAEA,YAAQ,IAAI,WAAW,IAAI;AAAA,EAC7B;AAEA,SAAO,QAAQ,IAAI,SAAS;AAC9B;AAEA,eAAe,oBAAoB,QAAuC;AACxE,MAAI,OAAO,YAAY,SAAS;AAC9B,UAAM,QAAQ,MAAM,aAAa,OAAO;AACxC,WAAO,IAAI,YAAY,OAAO,MAAM;AAAA,EACtC,WAAW,OAAO,YAAY,cAAc;AAC1C,UAAM,KAAK,MAAM,aAAa,IAAI;AAClC,UAAM,gBAAgB,MAAM,aAAa,eAAe;AACxD,WAAO,IAAI,iBAAiB,IAAI,cAAc,MAAM,MAAM;AAAA,EAC5D,OAAO;AAEL,UAAM,UAAU,MAAM,aAAa,SAAS;AAC5C,WAAO,IAAI,YAAY,SAAS,MAAM;AAAA,EACxC;AACF;AAEA,eAAe,aAA6C,MAAoD;AAC9G,MAAI,QAAQ,IAAI,KAAK,MAAM;AACzB,QAAI,SAAS,SAAS;AACpB,cAAQ,QAAQ,MAAM,OAAO,gBAAgB;AAAA,IAC/C,WAAW,SAAS,MAAM;AACxB,cAAQ,KAAK,MAAM,OAAO,IAAI;AAAA,IAChC,WAAW,SAAS,iBAAiB;AACnC,cAAQ,gBAAgB,MAAM,OAAO,iBAAiB;AAAA,IACxD,OAAO;AACL,cAAQ,UAAU,MAAM,OAAO,SAAS;AAAA,IAC1C;AAAA,EACF;AACA,SAAO,QAAQ,IAAI;AACrB;",
+  "names": []
+}

package/dist/{sd-orm.d.ts → create-orm.d.ts}

@@ -1,12 +1,11 @@
-import type { DbContext, IsolationLevel } from "@simplysm/orm-common";
-import type { Type } from "@simplysm/core-common";
+import { type DbContextDef, type DbContextInstance, type IsolationLevel } from "@simplysm/orm-common";
 import type { DbConnConfig } from "./types/db-conn";
 /**
- * SdOrm 옵션
+ * Orm 옵션
  *
  * DbConnConfig보다 우선 적용되는 DbContext 옵션
  */
-export interface SdOrmOptions {
+export interface OrmOptions {
     /**
      * 데이터베이스 이름 (DbConnConfig의 database 대신 사용)
      */
@@ -17,18 +16,43 @@ export interface SdOrmOptions {
     schema?: string;
 }
 /**
- * Node.js ORM 클래스
+ * Orm 인스턴스 타입
  *
- * DbContext와 DB 연결을 관리하는 최상위 클래스입니다.
- * DbContext 타입과 연결 설정을 받아 트랜잭션을 관리합니다.
+ * createOrm에서 반환되는 객체의 타입
+ */
+export interface Orm<TDef extends DbContextDef<any, any, any>> {
+    readonly dbContextDef: TDef;
+    readonly config: DbConnConfig;
+    readonly options?: OrmOptions;
+    /**
+     * 트랜잭션 내에서 콜백 실행
+     *
+     * @param callback - DB 연결 후 실행할 콜백
+     * @param isolationLevel - 트랜잭션 격리 수준
+     * @returns 콜백 결과
+     */
+    connect<R>(callback: (conn: DbContextInstance<TDef>) => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>;
+    /**
+     * 트랜잭션 없이 콜백 실행
+     *
+     * @param callback - DB 연결 후 실행할 콜백
+     * @returns 콜백 결과
+     */
+    connectWithoutTransaction<R>(callback: (conn: DbContextInstance<TDef>) => Promise<R>): Promise<R>;
+}
+/**
+ * Node.js ORM 팩토리 함수
+ *
+ * DbContext와 DB 연결을 관리하는 인스턴스를 생성합니다.
+ * DbContext 정의와 연결 설정을 받아 트랜잭션을 관리합니다.
  *
  * @example
  * ```typescript
- * class MyDb extends DbContext {
- *   readonly user = queryable(this, User);
- * }
+ * const MyDb = defineDbContext({
+ *   user: (db) => queryable(db, User),
+ * });
  *
- * const orm = new SdOrm(MyDb, {
+ * const orm = createOrm(MyDb, {
  *   dialect: "mysql",
  *   host: "localhost",
  *   port: 3306,
@@ -50,29 +74,5 @@ export interface SdOrmOptions {
  * });
  * ```
  */
-export declare class SdOrm<T extends DbContext> {
-    readonly dbContextType: Type<T>;
-    readonly config: DbConnConfig;
-    readonly options?: SdOrmOptions | undefined;
-    constructor(dbContextType: Type<T>, config: DbConnConfig, options?: SdOrmOptions | undefined);
-    /**
-     * 트랜잭션 내에서 콜백 실행
-     *
-     * @param callback - DB 연결 후 실행할 콜백
-     * @param isolationLevel - 트랜잭션 격리 수준
-     * @returns 콜백 결과
-     */
-    connect<R>(callback: (conn: T) => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>;
-    /**
-     * 트랜잭션 없이 콜백 실행
-     *
-     * @param callback - DB 연결 후 실행할 콜백
-     * @returns 콜백 결과
-     */
-    connectWithoutTransaction<R>(callback: (conn: T) => Promise<R>): Promise<R>;
-    /**
-     * DbContext 인스턴스 생성
-     */
-    private _createDbContext;
-}
-//# sourceMappingURL=sd-orm.d.ts.map
+export declare function createOrm<TDef extends DbContextDef<any, any, any>>(dbContextDef: TDef, config: DbConnConfig, options?: OrmOptions): Orm<TDef>;
+//# sourceMappingURL=create-orm.d.ts.map

package/dist/create-orm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-orm.d.ts","sourceRoot":"","sources":["../src/create-orm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC3D,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEjH;;;;;OAKG;IACH,yBAAyB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACnG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,CAAC,IAAI,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAChE,YAAY,EAAE,IAAI,EAClB,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,GAAG,CAAC,IAAI,CAAC,CA8BX"}

package/dist/create-orm.js

@@ -0,0 +1,32 @@
+import { createDbContext } from "@simplysm/orm-common";
+import { NodeDbContextExecutor } from "./node-db-context-executor.js";
+function createOrm(dbContextDef, config, options) {
+  function _createDbContext() {
+    const database = options?.database ?? ("database" in config ? config.database : void 0);
+    if (database == null || database === "") {
+      throw new Error("database is required");
+    }
+    const schema = options?.schema ?? ("schema" in config ? config.schema : void 0);
+    return createDbContext(dbContextDef, new NodeDbContextExecutor(config), {
+      database,
+      schema
+    });
+  }
+  return {
+    dbContextDef,
+    config,
+    options,
+    async connect(callback, isolationLevel) {
+      const db = _createDbContext();
+      return db.connect(async () => callback(db), isolationLevel);
+    },
+    async connectWithoutTransaction(callback) {
+      const db = _createDbContext();
+      return db.connectWithoutTransaction(async () => callback(db));
+    }
+  };
+}
+export {
+  createOrm
+};
+//# sourceMappingURL=create-orm.js.map

package/dist/create-orm.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/create-orm.ts"],
+  "mappings": "AAAA,SAAS,uBAAuF;AAEhG,SAAS,6BAA6B;AAiF/B,SAAS,UACd,cACA,QACA,SACW;AACX,WAAS,mBAA4C;AAEnD,UAAM,WAAW,SAAS,aAAa,cAAc,SAAS,OAAO,WAAW;AAChF,QAAI,YAAY,QAAQ,aAAa,IAAI;AACvC,YAAM,IAAI,MAAM,sBAAsB;AAAA,IACxC;AAGA,UAAM,SAAS,SAAS,WAAW,YAAY,SAAS,OAAO,SAAS;AAExE,WAAO,gBAAgB,cAAc,IAAI,sBAAsB,MAAM,GAAG;AAAA,MACtE;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM,QAAQ,UAAU,gBAAiB;AACvC,YAAM,KAAK,iBAAiB;AAC5B,aAAO,GAAG,QAAQ,YAAY,SAAS,EAAE,GAAG,cAAc;AAAA,IAC5D;AAAA,IACA,MAAM,0BAA0B,UAAU;AACxC,YAAM,KAAK,iBAAiB;AAC5B,aAAO,GAAG,0BAA0B,YAAY,SAAS,EAAE,CAAC;AAAA,IAC9D;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/node-db-context-executor.ts"],
-  "mappings": "AAAA,SAAS,eAAe;AAUxB,SAAS,oBAAoB,wBAAwB;AAErD,SAAS,gBAAgB,4BAA4B;AACrD,SAAS,qBAAqB;AAOvB,MAAM,sBAAmD;AAAA,EAI9D,YAA6B,SAAuB;AAAvB;AAC3B,SAAK,WAAW,qBAAqB,OAAO;AAAA,EAC9C;AAAA,EALQ;AAAA,EACS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWjB,MAAM,UAAyB;AAC7B,SAAK,QAAQ,MAAM,cAAc,OAAO,KAAK,OAAO;AACpD,UAAM,KAAK,MAAM,QAAQ;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAuB;AAC3B,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,MAAM;AACjB,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,iBAAiB,gBAAgD;AACrE,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,iBAAiB,cAAc;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBAAmC;AACvC,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,kBAAkB;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,sBAAqC;AACzC,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,oBAAoB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,oBAAoB,OAAe,QAA0C;AACjF,UAAM,OAAO,KAAK,aAAa;AAC/B,WAAO,KAAK,oBAAoB,OAAO,MAAM;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,WAAW,WAAmB,aAAyC,SAAsC;AACjH,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,WAAW,WAAW,aAAa,OAAO;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,YAA4B,MAAkB,aAA0D;AAC5G,UAAM,OAAO,KAAK,aAAa;AAE/B,UAAM,UAAU,mBAAmB,KAAK,QAAQ;AAIhD,QAAI,eAAe,QAAQ,YAAY,MAAM,CAAC,SAAS,QAAQ,IAAI,GAAG;AACpE,YAAM,cAAc,KAAK,IAAI,CAAC,QAAQ,QAAQ,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,IAAI;AACvE,YAAM,KAAK,QAAQ,CAAC,WAAW,CAAC;AAChC,aAAO,KAAK,IAAI,MAAM,CAAC,CAAC;AAAA,IAC1B;AAGA,UAAM,UAAiB,CAAC;AACxB,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,YAAM,MAAM,KAAK,CAAC;AAClB,YAAM,OAAO,cAAc,CAAC;AAC5B,YAAM,cAAc,QAAQ,MAAM,GAAG;AAErC,YAAM,aAAa,MAAM,KAAK,QAAQ,CAAC,YAAY,GAAG,CAAC;AAGvD,YAAM,kBACJ,YAAY,kBAAkB,OAAO,WAAW,YAAY,cAAc,IAAI,WAAW,CAAC;AAE5F,UAAI,QAAQ,MAAM;AAChB,cAAM,SAAS,MAAM,iBAAoB,iBAA8C,IAAI;AAC3F,gBAAQ,KAAK,UAAU,CAAC,CAAC;AAAA,MAC3B,OAAO;AACL,gBAAQ,KAAK,eAAsB;AAAA,MACrC;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,eAAuB;AAC7B,QAAI,KAAK,SAAS,MAAM;AACtB,YAAM,IAAI,QAAQ,eAAe,aAAa;AAAA,IAChD;AACA,WAAO,KAAK;AAAA,EACd;AACF;",
+  "mappings": "AAAA,SAAS,eAAe;AAUxB,SAAS,oBAAoB,wBAAwB;AAErD,SAAS,gBAAgB,4BAA4B;AACrD,SAAS,oBAAoB;AAOtB,MAAM,sBAAmD;AAAA,EAI9D,YAA6B,SAAuB;AAAvB;AAC3B,SAAK,WAAW,qBAAqB,OAAO;AAAA,EAC9C;AAAA,EALQ;AAAA,EACS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWjB,MAAM,UAAyB;AAC7B,SAAK,QAAQ,MAAM,aAAa,KAAK,OAAO;AAC5C,UAAM,KAAK,MAAM,QAAQ;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAuB;AAC3B,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,MAAM;AACjB,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,iBAAiB,gBAAgD;AACrE,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,iBAAiB,cAAc;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBAAmC;AACvC,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,kBAAkB;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,sBAAqC;AACzC,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,oBAAoB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,oBAAoB,OAAe,QAA0C;AACjF,UAAM,OAAO,KAAK,aAAa;AAC/B,WAAO,KAAK,oBAAoB,OAAO,MAAM;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,WAAW,WAAmB,aAAyC,SAAsC;AACjH,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,KAAK,WAAW,WAAW,aAAa,OAAO;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,YAA4B,MAAkB,aAA0D;AAC5G,UAAM,OAAO,KAAK,aAAa;AAE/B,UAAM,UAAU,mBAAmB,KAAK,QAAQ;AAIhD,QAAI,eAAe,QAAQ,YAAY,MAAM,CAAC,SAAS,QAAQ,IAAI,GAAG;AACpE,YAAM,cAAc,KAAK,IAAI,CAAC,QAAQ,QAAQ,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,IAAI;AACvE,YAAM,KAAK,QAAQ,CAAC,WAAW,CAAC;AAChC,aAAO,KAAK,IAAI,MAAM,CAAC,CAAC;AAAA,IAC1B;AAGA,UAAM,UAAiB,CAAC;AACxB,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,YAAM,MAAM,KAAK,CAAC;AAClB,YAAM,OAAO,cAAc,CAAC;AAC5B,YAAM,cAAc,QAAQ,MAAM,GAAG;AAErC,YAAM,aAAa,MAAM,KAAK,QAAQ,CAAC,YAAY,GAAG,CAAC;AAGvD,YAAM,kBACJ,YAAY,kBAAkB,OAAO,WAAW,YAAY,cAAc,IAAI,WAAW,CAAC;AAE5F,UAAI,QAAQ,MAAM;AAChB,cAAM,SAAS,MAAM,iBAAoB,iBAA8C,IAAI;AAC3F,gBAAQ,KAAK,UAAU,CAAC,CAAC;AAAA,MAC3B,OAAO;AACL,gBAAQ,KAAK,eAAsB;AAAA,MACrC;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,eAAuB;AAC7B,QAAI,KAAK,SAAS,MAAM;AACtB,YAAM,IAAI,QAAQ,eAAe,aAAa;AAAA,IAChD;AACA,WAAO,KAAK;AAAA,EACd;AACF;",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysm/orm-node",
   "sideEffects": false,
-  "version": "13.0.0-beta.51",
+  "version": "13.0.1",
   "description": "심플리즘 패키지 - ORM 모듈 (node)",
   "author": "김석래",
   "repository": {
@@ -20,8 +20,8 @@
   "dependencies": {
     "consola": "^3.4.2",
     "generic-pool": "^3.9.0",
-    "@simplysm/core-common": "13.0.0-beta.51",
-    "@simplysm/orm-common": "13.0.0-beta.51"
+    "@simplysm/core-common": "13.0.1",
+    "@simplysm/orm-common": "13.0.1"
   },
   "devDependencies": {
     "@types/pg": "^8.16.0",

package/src/create-db-conn.ts

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

package/src/create-orm.ts

@@ -0,0 +1,118 @@
+import { createDbContext, type DbContextDef, type DbContextInstance, type IsolationLevel } from "@simplysm/orm-common";
+import type { DbConnConfig } from "./types/db-conn";
+import { NodeDbContextExecutor } from "./node-db-context-executor";
+
+/**
+ * Orm 옵션
+ *
+ * DbConnConfig보다 우선 적용되는 DbContext 옵션
+ */
+export interface OrmOptions {
+  /**
+   * 데이터베이스 이름 (DbConnConfig의 database 대신 사용)
+   */
+  database?: string;
+
+  /**
+   * 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
+   */
+  schema?: string;
+}
+
+/**
+ * Orm 인스턴스 타입
+ *
+ * createOrm에서 반환되는 객체의 타입
+ */
+export interface Orm<TDef extends DbContextDef<any, any, any>> {
+  readonly dbContextDef: TDef;
+  readonly config: DbConnConfig;
+  readonly options?: OrmOptions;
+
+  /**
+   * 트랜잭션 내에서 콜백 실행
+   *
+   * @param callback - DB 연결 후 실행할 콜백
+   * @param isolationLevel - 트랜잭션 격리 수준
+   * @returns 콜백 결과
+   */
+  connect<R>(callback: (conn: DbContextInstance<TDef>) => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>;
+
+  /**
+   * 트랜잭션 없이 콜백 실행
+   *
+   * @param callback - DB 연결 후 실행할 콜백
+   * @returns 콜백 결과
+   */
+  connectWithoutTransaction<R>(callback: (conn: DbContextInstance<TDef>) => Promise<R>): Promise<R>;
+}
+
+/**
+ * Node.js ORM 팩토리 함수
+ *
+ * DbContext와 DB 연결을 관리하는 인스턴스를 생성합니다.
+ * DbContext 정의와 연결 설정을 받아 트랜잭션을 관리합니다.
+ *
+ * @example
+ * ```typescript
+ * const MyDb = defineDbContext({
+ *   user: (db) => queryable(db, User),
+ * });
+ *
+ * const orm = createOrm(MyDb, {
+ *   dialect: "mysql",
+ *   host: "localhost",
+ *   port: 3306,
+ *   username: "root",
+ *   password: "password",
+ *   database: "mydb",
+ * });
+ *
+ * // 트랜잭션 내에서 실행
+ * await orm.connect(async (db) => {
+ *   const users = await db.user().result();
+ *   return users;
+ * });
+ *
+ * // 트랜잭션 없이 실행
+ * await orm.connectWithoutTransaction(async (db) => {
+ *   const users = await db.user().result();
+ *   return users;
+ * });
+ * ```
+ */
+export function createOrm<TDef extends DbContextDef<any, any, any>>(
+  dbContextDef: TDef,
+  config: DbConnConfig,
+  options?: OrmOptions,
+): Orm<TDef> {
+  function _createDbContext(): DbContextInstance<TDef> {
+    // database는 options에서 우선, 없으면 config에서
+    const database = options?.database ?? ("database" in config ? config.database : undefined);
+    if (database == null || database === "") {
+      throw new Error("database is required");
+    }
+
+    // schema는 options에서 우선, 없으면 config에서
+    const schema = options?.schema ?? ("schema" in config ? config.schema : undefined);
+
+    return createDbContext(dbContextDef, new NodeDbContextExecutor(config), {
+      database,
+      schema,
+    });
+  }
+
+  return {
+    dbContextDef,
+    config,
+    options,
+    async connect(callback, isolationLevel?) {
+      const db = _createDbContext();
+      return db.connect(async () => callback(db), isolationLevel);
+    },
+    async connectWithoutTransaction(callback) {
+      const db = _createDbContext();
+      return db.connectWithoutTransaction(async () => callback(db));
+    },
+  };
+}

package/src/index.ts

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

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

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

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

@@ -1,25 +0,0 @@
-import type { DbConn, DbConnConfig } from "./types/db-conn";
-/**
- * DB 연결 팩토리
- *
- * 데이터베이스 연결 인스턴스를 생성하고 풀링을 관리한다.
- * MSSQL, MySQL, PostgreSQL을 지원한다.
- */
-export declare class DbConnFactory {
-    private static readonly _poolMap;
-    /**
-     * DB 연결 생성
-     *
-     * 커넥션 풀에서 연결을 획득하여 반환한다.
-     * 풀이 없는 경우 새로 생성한다.
-     *
-     * @param config - 데이터베이스 연결 설정
-     * @returns 풀링된 DB 연결 객체
-     */
-    static create(config: DbConnConfig): Promise<DbConn>;
-    private static _getOrCreatePool;
-    private static _createRawConnection;
-    private static readonly _modules;
-    private static _ensureModule;
-}
-//# sourceMappingURL=db-conn-factory.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"db-conn-factory.d.ts","sourceRoot":"","sources":["../src/db-conn-factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAM5D;;;;;GAKG;AACH,qBAAa,aAAa;IAExB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAEnE;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpD,OAAO,CAAC,MAAM,CAAC,gBAAgB;mBAuCV,oBAAoB;IAgBzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAKzB;mBAEc,aAAa;CAgBnC"}

package/dist/db-conn-factory.js

@@ -1,88 +0,0 @@
-import { createPool } from "generic-pool";
-import { PooledDbConn } from "./pooled-db-conn.js";
-import { MysqlDbConn } from "./connections/mysql-db-conn.js";
-import { MssqlDbConn } from "./connections/mssql-db-conn.js";
-import { PostgresqlDbConn } from "./connections/postgresql-db-conn.js";
-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

@@ -1,6 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/db-conn-factory.ts"],
-  "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/sd-orm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sd-orm.d.ts","sourceRoot":"","sources":["../src/sd-orm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,SAAS;IAElC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY;gBAFtB,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,EACtB,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,YAAY,YAAA;IAGjC;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhG;;;;;OAKG;IACG,yBAAyB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjF;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAYzB"}

package/dist/sd-orm.js

@@ -1,44 +0,0 @@
-import { NodeDbContextExecutor } from "./node-db-context-executor.js";
-class SdOrm {
-  constructor(dbContextType, config, options) {
-    this.dbContextType = dbContextType;
-    this.config = config;
-    this.options = options;
-  }
-  /**
-   * 트랜잭션 내에서 콜백 실행
-   *
-   * @param callback - DB 연결 후 실행할 콜백
-   * @param isolationLevel - 트랜잭션 격리 수준
-   * @returns 콜백 결과
-   */
-  async connect(callback, isolationLevel) {
-    const db = this._createDbContext();
-    return db.connect(async () => callback(db), isolationLevel);
-  }
-  /**
-   * 트랜잭션 없이 콜백 실행
-   *
-   * @param callback - DB 연결 후 실행할 콜백
-   * @returns 콜백 결과
-   */
-  async connectWithoutTransaction(callback) {
-    const db = this._createDbContext();
-    return db.connectWithoutTransaction(async () => callback(db));
-  }
-  /**
-   * DbContext 인스턴스 생성
-   */
-  _createDbContext() {
-    const database = this.options?.database ?? ("database" in this.config ? this.config.database : void 0);
-    const schema = this.options?.schema ?? ("schema" in this.config ? this.config.schema : void 0);
-    return new this.dbContextType(new NodeDbContextExecutor(this.config), {
-      database,
-      schema
-    });
-  }
-}
-export {
-  SdOrm
-};
-//# sourceMappingURL=sd-orm.js.map

package/dist/sd-orm.js.map

@@ -1,6 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/sd-orm.ts"],
-  "mappings": "AAGA,SAAS,6BAA6B;AAqD/B,MAAM,MAA2B;AAAA,EACtC,YACW,eACA,QACA,SACT;AAHS;AACA;AACA;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASH,MAAM,QAAW,UAAmC,gBAA6C;AAC/F,UAAM,KAAK,KAAK,iBAAiB;AACjC,WAAO,GAAG,QAAQ,YAAY,SAAS,EAAE,GAAG,cAAc;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,0BAA6B,UAA+C;AAChF,UAAM,KAAK,KAAK,iBAAiB;AACjC,WAAO,GAAG,0BAA0B,YAAY,SAAS,EAAE,CAAC;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA,EAKQ,mBAAsB;AAE5B,UAAM,WAAW,KAAK,SAAS,aAAa,cAAc,KAAK,SAAS,KAAK,OAAO,WAAW;AAG/F,UAAM,SAAS,KAAK,SAAS,WAAW,YAAY,KAAK,SAAS,KAAK,OAAO,SAAS;AAEvF,WAAO,IAAI,KAAK,cAAc,IAAI,sBAAsB,KAAK,MAAM,GAAG;AAAA,MACpE;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACF;",
-  "names": []
-}

package/src/db-conn-factory.ts

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

package/src/sd-orm.ts

@@ -1,102 +0,0 @@
-import type { DbContext, IsolationLevel } from "@simplysm/orm-common";
-import type { Type } from "@simplysm/core-common";
-import type { DbConnConfig } from "./types/db-conn";
-import { NodeDbContextExecutor } from "./node-db-context-executor";
-
-/**
- * SdOrm 옵션
- *
- * DbConnConfig보다 우선 적용되는 DbContext 옵션
- */
-export interface SdOrmOptions {
-  /**
-   * 데이터베이스 이름 (DbConnConfig의 database 대신 사용)
-   */
-  database?: string;
-
-  /**
-   * 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
-   */
-  schema?: string;
-}
-
-/**
- * Node.js ORM 클래스
- *
- * DbContext와 DB 연결을 관리하는 최상위 클래스입니다.
- * DbContext 타입과 연결 설정을 받아 트랜잭션을 관리합니다.
- *
- * @example
- * ```typescript
- * class MyDb extends DbContext {
- *   readonly user = queryable(this, User);
- * }
- *
- * const orm = new SdOrm(MyDb, {
- *   dialect: "mysql",
- *   host: "localhost",
- *   port: 3306,
- *   username: "root",
- *   password: "password",
- *   database: "mydb",
- * });
- *
- * // 트랜잭션 내에서 실행
- * await orm.connect(async (db) => {
- *   const users = await db.user().result();
- *   return users;
- * });
- *
- * // 트랜잭션 없이 실행
- * await orm.connectWithoutTransaction(async (db) => {
- *   const users = await db.user().result();
- *   return users;
- * });
- * ```
- */
-export class SdOrm<T extends DbContext> {
-  constructor(
-    readonly dbContextType: Type<T>,
-    readonly config: DbConnConfig,
-    readonly options?: SdOrmOptions,
-  ) {}
-
-  /**
-   * 트랜잭션 내에서 콜백 실행
-   *
-   * @param callback - DB 연결 후 실행할 콜백
-   * @param isolationLevel - 트랜잭션 격리 수준
-   * @returns 콜백 결과
-   */
-  async connect<R>(callback: (conn: T) => Promise<R>, isolationLevel?: IsolationLevel): Promise<R> {
-    const db = this._createDbContext();
-    return db.connect(async () => callback(db), isolationLevel);
-  }
-
-  /**
-   * 트랜잭션 없이 콜백 실행
-   *
-   * @param callback - DB 연결 후 실행할 콜백
-   * @returns 콜백 결과
-   */
-  async connectWithoutTransaction<R>(callback: (conn: T) => Promise<R>): Promise<R> {
-    const db = this._createDbContext();
-    return db.connectWithoutTransaction(async () => callback(db));
-  }
-
-  /**
-   * DbContext 인스턴스 생성
-   */
-  private _createDbContext(): T {
-    // database는 options에서 우선, 없으면 config에서
-    const database = this.options?.database ?? ("database" in this.config ? this.config.database : undefined);
-
-    // schema는 options에서 우선, 없으면 config에서
-    const schema = this.options?.schema ?? ("schema" in this.config ? this.config.schema : undefined);
-
-    return new this.dbContextType(new NodeDbContextExecutor(this.config), {
-      database,
-      schema,
-    });
-  }
-}