@simplysm/orm-common 13.0.99 → 14.0.1

package/dist/errors/db-transaction-error.d.ts

@@ -1,23 +1,23 @@
 /**
- * Transaction-related error codes
+ * 트랜잭션 관련 에러 코드
  *
- * Abstracts DBMS-specific native error codes for DBMS-independent error handling
+ * DBMS별 네이티브 에러 코드를 추상화하여 DBMS 독립적인 에러 처리를 지원한다
  */
 export declare enum DbErrorCode {
-    /** No active transaction (no transaction during ROLLBACK) */
+    /** 활성 트랜잭션 없음 (ROLLBACK 시 트랜잭션 없음) */
     NO_ACTIVE_TRANSACTION = "NO_ACTIVE_TRANSACTION",
-    /** Transaction already started */
+    /** 트랜잭션 이미 시작됨 */
     TRANSACTION_ALREADY_STARTED = "TRANSACTION_ALREADY_STARTED",
-    /** Deadlock occurred */
+    /** 데드락 발생 */
     DEADLOCK = "DEADLOCK",
-    /** Lock timeout */
+    /** 잠금 타임아웃 */
     LOCK_TIMEOUT = "LOCK_TIMEOUT"
 }
 /**
- * Database transaction error
+ * 데이터베이스 트랜잭션 에러
  *
- * Wraps DBMS-specific native errors with standardized error codes for
- * DBMS-independent error handling
+ * DBMS별 네이티브 에러를 표준화된 에러 코드로 래핑하여
+ * DBMS 독립적인 에러 처리를 지원한다
  *
  * @example
  * ```typescript
@@ -26,7 +26,7 @@ export declare enum DbErrorCode {
  * } catch (err) {
  *   if (err instanceof DbTransactionError) {
  *     if (err.code === DbErrorCode.NO_ACTIVE_TRANSACTION) {
- *       // Ignore if already rolled back
+ *       // 이미 롤백된 경우 무시
  *       return;
  *     }
  *   }
@@ -35,17 +35,17 @@ export declare enum DbErrorCode {
  * ```
  */
 export declare class DbTransactionError extends Error {
-    /** Standardized error code */
+    /** 표준화된 에러 코드 */
     readonly code: DbErrorCode;
-    /** Original DBMS error (for debugging) */
+    /** 원본 DBMS 에러 (디버깅용) */
     readonly originalError?: unknown | undefined;
     readonly name = "DbTransactionError";
     constructor(
-    /** Standardized error code */
+    /** 표준화된 에러 코드 */
     code: DbErrorCode, 
-    /** Error message */
+    /** 에러 메시지 */
     message: string, 
-    /** Original DBMS error (for debugging) */
+    /** 원본 DBMS 에러 (디버깅용) */
     originalError?: unknown | undefined);
 }
 //# sourceMappingURL=db-transaction-error.d.ts.map

package/dist/errors/db-transaction-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-transaction-error.d.ts","sourceRoot":"","sources":["..\\..\\src\\errors\\db-transaction-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,WAAW;IACrB,6DAA6D;IAC7D,qBAAqB,0BAA0B;IAE/C,kCAAkC;IAClC,2BAA2B,gCAAgC;IAE3D,wBAAwB;IACxB,QAAQ,aAAa;IAErB,mBAAmB;IACnB,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAIzC,8BAA8B;aACd,IAAI,EAAE,WAAW;IAGjC,0CAA0C;aAC1B,aAAa,CAAC,EAAE,OAAO;IARzC,SAAkB,IAAI,wBAAwB;;IAG5C,8BAA8B;IACd,IAAI,EAAE,WAAW;IACjC,oBAAoB;IACpB,OAAO,EAAE,MAAM;IACf,0CAA0C;IAC1B,aAAa,CAAC,EAAE,OAAO,YAAA;CAI1C"}
+{"version":3,"file":"db-transaction-error.d.ts","sourceRoot":"","sources":["..\\..\\src\\errors\\db-transaction-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,WAAW;IACrB,sCAAsC;IACtC,qBAAqB,0BAA0B;IAE/C,kBAAkB;IAClB,2BAA2B,gCAAgC;IAE3D,aAAa;IACb,QAAQ,aAAa;IAErB,cAAc;IACd,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAIzC,iBAAiB;aACD,IAAI,EAAE,WAAW;IAGjC,wBAAwB;aACR,aAAa,CAAC,EAAE,OAAO;IARzC,SAAkB,IAAI,wBAAwB;;IAG5C,iBAAiB;IACD,IAAI,EAAE,WAAW;IACjC,aAAa;IACb,OAAO,EAAE,MAAM;IACf,wBAAwB;IACR,aAAa,CAAC,EAAE,OAAO,YAAA;CAI1C"}

package/dist/errors/db-transaction-error.js

@@ -1,20 +1,54 @@
-var DbErrorCode = /* @__PURE__ */ ((DbErrorCode2) => {
-  DbErrorCode2["NO_ACTIVE_TRANSACTION"] = "NO_ACTIVE_TRANSACTION";
-  DbErrorCode2["TRANSACTION_ALREADY_STARTED"] = "TRANSACTION_ALREADY_STARTED";
-  DbErrorCode2["DEADLOCK"] = "DEADLOCK";
-  DbErrorCode2["LOCK_TIMEOUT"] = "LOCK_TIMEOUT";
-  return DbErrorCode2;
-})(DbErrorCode || {});
-class DbTransactionError extends Error {
-  constructor(code, message, originalError) {
-    super(message);
-    this.code = code;
-    this.originalError = originalError;
-  }
-  name = "DbTransactionError";
+/**
+ * 트랜잭션 관련 에러 코드
+ *
+ * DBMS별 네이티브 에러 코드를 추상화하여 DBMS 독립적인 에러 처리를 지원한다
+ */
+export var DbErrorCode;
+(function (DbErrorCode) {
+    /** 활성 트랜잭션 없음 (ROLLBACK 시 트랜잭션 없음) */
+    DbErrorCode["NO_ACTIVE_TRANSACTION"] = "NO_ACTIVE_TRANSACTION";
+    /** 트랜잭션 이미 시작됨 */
+    DbErrorCode["TRANSACTION_ALREADY_STARTED"] = "TRANSACTION_ALREADY_STARTED";
+    /** 데드락 발생 */
+    DbErrorCode["DEADLOCK"] = "DEADLOCK";
+    /** 잠금 타임아웃 */
+    DbErrorCode["LOCK_TIMEOUT"] = "LOCK_TIMEOUT";
+})(DbErrorCode || (DbErrorCode = {}));
+/**
+ * 데이터베이스 트랜잭션 에러
+ *
+ * DBMS별 네이티브 에러를 표준화된 에러 코드로 래핑하여
+ * DBMS 독립적인 에러 처리를 지원한다
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await db.rollbackTransaction();
+ * } catch (err) {
+ *   if (err instanceof DbTransactionError) {
+ *     if (err.code === DbErrorCode.NO_ACTIVE_TRANSACTION) {
+ *       // 이미 롤백된 경우 무시
+ *       return;
+ *     }
+ *   }
+ *   throw err;
+ * }
+ * ```
+ */
+export class DbTransactionError extends Error {
+    code;
+    originalError;
+    name = "DbTransactionError";
+    constructor(
+    /** 표준화된 에러 코드 */
+    code, 
+    /** 에러 메시지 */
+    message, 
+    /** 원본 DBMS 에러 (디버깅용) */
+    originalError) {
+        super(message);
+        this.code = code;
+        this.originalError = originalError;
+    }
 }
-export {
-  DbErrorCode,
-  DbTransactionError
-};
-//# sourceMappingURL=db-transaction-error.js.map
+//# sourceMappingURL=db-transaction-error.js.map

package/dist/errors/db-transaction-error.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/errors/db-transaction-error.ts"],
-  "mappings": "AAKO,IAAK,cAAL,kBAAKA,iBAAL;AAEL,EAAAA,aAAA,2BAAwB;AAGxB,EAAAA,aAAA,iCAA8B;AAG9B,EAAAA,aAAA,cAAW;AAGX,EAAAA,aAAA,kBAAe;AAXL,SAAAA;AAAA,GAAA;AAmCL,MAAM,2BAA2B,MAAM;AAAA,EAG5C,YAEkB,MAEhB,SAEgB,eAChB;AACA,UAAM,OAAO;AANG;AAIA;AAAA,EAGlB;AAAA,EAXkB,OAAO;AAY3B;",
-  "names": ["DbErrorCode"]
-}
+{"version":3,"file":"db-transaction-error.js","sourceRoot":"","sources":["..\\..\\src\\errors\\db-transaction-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,WAYX;AAZD,WAAY,WAAW;IACrB,sCAAsC;IACtC,8DAA+C,CAAA;IAE/C,kBAAkB;IAClB,0EAA2D,CAAA;IAE3D,aAAa;IACb,oCAAqB,CAAA;IAErB,cAAc;IACd,4CAA6B,CAAA;AAC/B,CAAC,EAZW,WAAW,KAAX,WAAW,QAYtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAKzB;IAIA;IARA,IAAI,GAAG,oBAAoB,CAAC;IAE9C;IACE,iBAAiB;IACD,IAAiB;IACjC,aAAa;IACb,OAAe;IACf,wBAAwB;IACR,aAAuB;QAEvC,KAAK,CAAC,OAAO,CAAC,CAAC;QANC,SAAI,GAAJ,IAAI,CAAa;QAIjB,kBAAa,GAAb,aAAa,CAAU;IAGzC,CAAC;CACF"}

package/dist/exec/executable.d.ts

@@ -2,29 +2,29 @@ import type { ColumnBuilderRecord, InferColumnExprs } from "../schema/factory/co
 import type { ProcedureBuilder } from "../schema/procedure-builder";
 import type { DbContextBase } from "../types/db-context-def";
 /**
- * Stored procedure execution wrapper class
+ * 저장 프로시저 실행 래퍼 클래스
  *
- * Class for executing procedures defined by ProcedureBuilder.
- * Created and used through the executable() factory function in DbContext.
+ * ProcedureBuilder로 정의된 프로시저를 실행하기 위한 클래스.
+ * DbContext에서 executable() 팩토리 함수를 통해 생성 및 사용된다.
  *
- * @template TParams - Procedure parameter type
- * @template TReturns - Procedure return type
+ * @template TParams - 프로시저 파라미터 타입
+ * @template TReturns - 프로시저 반환 타입
  *
  * @example
  * ```typescript
- * // Execute procedure
+ * // 프로시저 실행
  * const result = await db.getUserById().execute({ userId: 1n });
  * ```
  *
- * @see {@link executable} Factory function
- * @see {@link ProcedureBuilder} Procedure definition
+ * @see {@link executable} 팩토리 함수
+ * @see {@link ProcedureBuilder} 프로시저 정의
  */
 export declare class Executable<TParams extends ColumnBuilderRecord, TReturns extends ColumnBuilderRecord> {
     private readonly _db;
     private readonly _builder;
     constructor(_db: DbContextBase, _builder: ProcedureBuilder<TParams, TReturns>);
     /**
-     * Generate procedure execution QueryDef
+     * 프로시저 실행 QueryDef 생성
      */
     getExecProcQueryDef(params?: InferColumnExprs<TParams>): {
         type: "execProc";
@@ -38,42 +38,42 @@ export declare class Executable<TParams extends ColumnBuilderRecord, TReturns ex
         } | undefined;
     };
     /**
-     * Execute procedure
+     * 프로시저 실행
      */
     execute(params: InferColumnExprs<TParams>): Promise<InferColumnExprs<TReturns>[][]>;
 }
 /**
- * Factory function to create Executable
+ * Executable 생성 팩토리 함수
  *
- * Used when registering procedures in DbContext.
- * Wraps procedures defined by ProcedureBuilder and returns them as Executable.
+ * DbContext에 프로시저를 등록할 때 사용한다.
+ * ProcedureBuilder로 정의된 프로시저를 Executable로 래핑하여 반환한다.
  *
- * @template TParams - Procedure parameter type
- * @template TReturns - Procedure return type
- * @param db - DbContext instance
- * @param builder - ProcedureBuilder instance
- * @returns Executable factory function
+ * @template TParams - 프로시저 파라미터 타입
+ * @template TReturns - 프로시저 반환 타입
+ * @param db - DbContext 인스턴스
+ * @param builder - ProcedureBuilder 인스턴스
+ * @returns Executable 팩토리 함수
  *
  * @example
  * ```typescript
- * // Define procedure
+ * // 프로시저 정의
  * const GetUserById = Procedure("GetUserById")
  *   .database("mydb")
  *   .params((c) => ({ userId: c.bigint() }))
  *   .returns((c) => ({ id: c.bigint(), name: c.varchar(100) }))
  *   .body("SELECT id, name FROM User WHERE id = userId");
  *
- * // Register in DbContext
+ * // DbContext에 등록
  * class MyDb extends DbContext {
  *   getUserById = executable(this, GetUserById);
  * }
  *
- * // Use
+ * // 사용
  * const result = await db.getUserById().execute({ userId: 1n });
  * ```
  *
- * @see {@link Executable} Execution class
- * @see {@link ProcedureBuilder} Procedure definition
+ * @see {@link Executable} 실행 클래스
+ * @see {@link ProcedureBuilder} 프로시저 정의
  */
 export declare function executable<TParams extends ColumnBuilderRecord, TReturns extends ColumnBuilderRecord>(db: DbContextBase, builder: ProcedureBuilder<TParams, TReturns>): () => Executable<TParams, TReturns>;
 //# sourceMappingURL=executable.d.ts.map

package/dist/exec/executable.js

@@ -1,45 +1,99 @@
 import { ExprUnit } from "../expr/expr-unit.js";
 import { expr } from "../expr/expr.js";
-class Executable {
-  constructor(_db, _builder) {
-    this._db = _db;
-    this._builder = _builder;
-  }
-  /**
-   * Generate procedure execution QueryDef
-   */
-  getExecProcQueryDef(params) {
-    const meta = this._builder.meta;
-    if (params && !meta.params) {
-      throw new Error(`Procedure '${meta.name}' has no parameters.`);
+/**
+ * 저장 프로시저 실행 래퍼 클래스
+ *
+ * ProcedureBuilder로 정의된 프로시저를 실행하기 위한 클래스.
+ * DbContext에서 executable() 팩토리 함수를 통해 생성 및 사용된다.
+ *
+ * @template TParams - 프로시저 파라미터 타입
+ * @template TReturns - 프로시저 반환 타입
+ *
+ * @example
+ * ```typescript
+ * // 프로시저 실행
+ * const result = await db.getUserById().execute({ userId: 1n });
+ * ```
+ *
+ * @see {@link executable} 팩토리 함수
+ * @see {@link ProcedureBuilder} 프로시저 정의
+ */
+export class Executable {
+    _db;
+    _builder;
+    constructor(_db, _builder) {
+        this._db = _db;
+        this._builder = _builder;
+    }
+    /**
+     * 프로시저 실행 QueryDef 생성
+     */
+    getExecProcQueryDef(params) {
+        const meta = this._builder.meta;
+        if (params && !meta.params) {
+            throw new Error(`Procedure '${meta.name}'에 파라미터가 없습니다.`);
+        }
+        return {
+            type: "execProc",
+            procedure: {
+                database: meta.database ?? this._db.database,
+                schema: meta.schema ?? this._db.schema,
+                name: meta.name,
+            },
+            params: params && meta.params
+                ? Object.fromEntries(Object.keys(params).map((key) => [
+                    key,
+                    params[key] instanceof ExprUnit
+                        ? params[key].expr
+                        : expr.val(meta.params[key].meta.type, params[key]).expr,
+                ]))
+                : undefined,
+        };
+    }
+    /**
+     * 프로시저 실행
+     */
+    async execute(params) {
+        return this._db.executeDefs([this.getExecProcQueryDef(params)]);
     }
-    return {
-      type: "execProc",
-      procedure: {
-        database: meta.database ?? this._db.database,
-        schema: meta.schema ?? this._db.schema,
-        name: meta.name
-      },
-      params: params && meta.params ? Object.fromEntries(
-        Object.keys(params).map((key) => [
-          key,
-          params[key] instanceof ExprUnit ? params[key].expr : expr.val(meta.params[key].meta.type, params[key]).expr
-        ])
-      ) : void 0
-    };
-  }
-  /**
-   * Execute procedure
-   */
-  async execute(params) {
-    return this._db.executeDefs([this.getExecProcQueryDef(params)]);
-  }
 }
-function executable(db, builder) {
-  return () => new Executable(db, builder);
+// ============================================
+// executable 함수
+// ============================================
+/**
+ * Executable 생성 팩토리 함수
+ *
+ * DbContext에 프로시저를 등록할 때 사용한다.
+ * ProcedureBuilder로 정의된 프로시저를 Executable로 래핑하여 반환한다.
+ *
+ * @template TParams - 프로시저 파라미터 타입
+ * @template TReturns - 프로시저 반환 타입
+ * @param db - DbContext 인스턴스
+ * @param builder - ProcedureBuilder 인스턴스
+ * @returns Executable 팩토리 함수
+ *
+ * @example
+ * ```typescript
+ * // 프로시저 정의
+ * const GetUserById = Procedure("GetUserById")
+ *   .database("mydb")
+ *   .params((c) => ({ userId: c.bigint() }))
+ *   .returns((c) => ({ id: c.bigint(), name: c.varchar(100) }))
+ *   .body("SELECT id, name FROM User WHERE id = userId");
+ *
+ * // DbContext에 등록
+ * class MyDb extends DbContext {
+ *   getUserById = executable(this, GetUserById);
+ * }
+ *
+ * // 사용
+ * const result = await db.getUserById().execute({ userId: 1n });
+ * ```
+ *
+ * @see {@link Executable} 실행 클래스
+ * @see {@link ProcedureBuilder} 프로시저 정의
+ */
+export function executable(db, builder) {
+    return () => new Executable(db, builder);
 }
-export {
-  Executable,
-  executable
-};
-//# sourceMappingURL=executable.js.map
+//# sourceMappingURL=executable.js.map

package/dist/exec/executable.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/exec/executable.ts"],
-  "mappings": "AAGA,SAAS,gBAAgB;AACzB,SAAS,YAAY;AAoBd,MAAM,WAAsF;AAAA,EACjG,YACmB,KACA,UACjB;AAFiB;AACA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKH,oBAAoB,QAAoC;AACtD,UAAM,OAAO,KAAK,SAAS;AAC3B,QAAI,UAAU,CAAC,KAAK,QAAQ;AAC1B,YAAM,IAAI,MAAM,cAAc,KAAK,IAAI,sBAAsB;AAAA,IAC/D;AAEA,WAAO;AAAA,MACL,MAAM;AAAA,MACN,WAAW;AAAA,QACT,UAAU,KAAK,YAAY,KAAK,IAAI;AAAA,QACpC,QAAQ,KAAK,UAAU,KAAK,IAAI;AAAA,QAChC,MAAM,KAAK;AAAA,MACb;AAAA,MACA,QACE,UAAU,KAAK,SACX,OAAO;AAAA,QACL,OAAO,KAAK,MAAM,EAAE,IAAI,CAAC,QAAQ;AAAA,UAC/B;AAAA,UACA,OAAO,GAAG,aAAa,WACnB,OAAO,GAAG,EAAE,OACZ,KAAK,IAAI,KAAK,OAAQ,GAAG,EAAE,KAAK,MAAM,OAAO,GAAG,CAAC,EAAE;AAAA,QACzD,CAAC;AAAA,MACH,IACA;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAQ,QAA4E;AACxF,WAAO,KAAK,IAAI,YAAwC,CAAC,KAAK,oBAAoB,MAAM,CAAC,CAAC;AAAA,EAC5F;AACF;AAuCO,SAAS,WAId,IACA,SACqC;AACrC,SAAO,MAAM,IAAI,WAAW,IAAI,OAAO;AACzC;",
-  "names": []
-}
+{"version":3,"file":"executable.js","sourceRoot":"","sources":["..\\..\\src\\exec\\executable.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,UAAU;IAEF;IACA;IAFnB,YACmB,GAAkB,EAClB,QAA6C;QAD7C,QAAG,GAAH,GAAG,CAAe;QAClB,aAAQ,GAAR,QAAQ,CAAqC;IAC7D,CAAC;IAEJ;;OAEG;IACH,mBAAmB,CAAC,MAAkC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChC,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,gBAAgB,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO;YACL,IAAI,EAAE,UAAmB;YACzB,SAAS,EAAE;gBACT,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAC5C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM;gBACtC,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB;YACD,MAAM,EACJ,MAAM,IAAI,IAAI,CAAC,MAAM;gBACnB,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;oBAC/B,GAAG;oBACH,MAAM,CAAC,GAAG,CAAC,YAAY,QAAQ;wBAC7B,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI;wBAClB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;iBAC5D,CAAC,CACH;gBACH,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,MAAiC;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAA6B,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF;AAED,+CAA+C;AAC/C,gBAAgB;AAChB,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,UAAU,CAIxB,EAAiB,EACjB,OAA4C;IAE5C,OAAO,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}