@simplysm/orm-common 13.0.69 → 13.0.71

package/dist/exec/queryable.js

@@ -18,19 +18,19 @@ class JoinQueryable {
     this._joinAlias = _joinAlias;
   }
   /**
-   * 조인할 테이블을 지정
+   * Specify the table to join
    *
-   * @param table - 조인 대상 테이블
-   * @returns 조인된 Queryable
+   * @param table - Table to join
+   * @returns Joined Queryable
    */
   from(table) {
     return queryable(this._db, table, this._joinAlias)();
   }
   /**
-   * 조인 결과의 컬럼을 직접 지정
+   * Directly specify columns in join result
    *
-   * @param columns - 커스텀 컬럼 정의
-   * @returns 커스텀 컬럼이 적용된 Queryable
+   * @param columns - Custom column definition
+   * @returns Queryable with custom columns applied
    */
   select(columns) {
     return new Queryable({
@@ -41,15 +41,15 @@ class JoinQueryable {
     });
   }
   /**
-   * 여러 Queryable을 UNION으로 결합
+   * Combine multiple Queryables with UNION
    *
-   * @param queries - UNION할 Queryable 배열 (최소 2개)
-   * @returns UNION된 Queryable
-   * @throws 2개 미만의 queryable이 전달된 경우
+   * @param queries - Array of Queryables to UNION (minimum 2)
+   * @returns UNION-ed Queryable
+   * @throws If less than 2 queryables are passed
    */
   union(...queries) {
     if (queries.length < 2) {
-      throw new ArgumentError("union\uC740 \uCD5C\uC18C 2\uAC1C\uC758 queryable\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.", {
+      throw new ArgumentError("union requires at least 2 queryables.", {
         provided: queries.length,
         minimum: 2
       });
@@ -58,7 +58,7 @@ class JoinQueryable {
     return new Queryable({
       db: first.meta.db,
       from: queries,
-      // Queryable[] 배열로 저장
+      // stored as Queryable[] array
       as: this._joinAlias,
       columns: transformColumnsAlias(first.meta.columns, this._joinAlias, "")
     });
@@ -70,10 +70,10 @@ class RecursiveQueryable {
     this._cteName = _cteName;
   }
   /**
-   * 재귀 쿼리의 대상 테이블을 지정
+   * specify the target table for recursive query
    *
-   * @param table - 재귀할 대상 테이블
-   * @returns self 속성이 추가된 Queryable (자기 참조용)
+   * @param table - Target table to recurse
+   * @returns Queryable with self property added (for self-reference)
    */
   from(table) {
     const selfAlias = `${this._cteName}.self`;
@@ -89,10 +89,10 @@ class RecursiveQueryable {
     );
   }
   /**
-   * 재귀 쿼리의 컬럼을 직접 지정
+   * Directly specify columns in recursive query
    *
-   * @param columns - 커스텀 컬럼 정의
-   * @returns self 속성이 추가된 Queryable
+   * @param columns - Custom column definition
+   * @returns Queryable with self property added
    */
   select(columns) {
     const selfAlias = `${this._cteName}.self`;
@@ -113,15 +113,15 @@ class RecursiveQueryable {
     );
   }
   /**
-   * 여러 Queryable을 UNION으로 결합 (재귀 쿼리용)
+   * Combine multiple Queryables with UNION (for recursive query)
    *
-   * @param queries - UNION할 Queryable 배열 (최소 2개)
-   * @returns self 속성이 추가된 UNION Queryable
-   * @throws 2개 미만의 queryable이 전달된 경우
+   * @param queries - Array of Queryables to UNION (minimum 2)
+   * @returns UNION Queryable with self property added
+   * @throws If less than 2 queryables are passed
    */
   union(...queries) {
     if (queries.length < 2) {
-      throw new ArgumentError("union\uC740 \uCD5C\uC18C 2\uAC1C\uC758 queryable\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.", {
+      throw new ArgumentError("union requires at least 2 queryables.", {
         provided: queries.length,
         minimum: 2
       });
@@ -131,7 +131,7 @@ class RecursiveQueryable {
     return new Queryable({
       db: first.meta.db,
       from: queries,
-      // Queryable[] 배열로 저장
+      // stored as Queryable[] array
       as: this._cteName,
       columns: transformColumnsAlias(first.meta.columns, this._cteName, "")
     }).join(
@@ -150,12 +150,12 @@ class Queryable {
   constructor(meta) {
     this.meta = meta;
   }
-  //#region ========== 옵션 - SELECT / DISTINCT / LOCK ==========
+  //#region ========== option - SELECT / DISTINCT / LOCK ==========
   /**
-   * SELECT할 컬럼을 지정합니다.
+   * Specify columns to SELECT.
    *
-   * @param fn - 컬럼 매핑 함수. 원본 컬럼을 받아 새 컬럼 구조를 반환
-   * @returns 새로운 컬럼 구조가 적용된 Queryable
+   * @param fn - Column mapping function. Receives original columns and returns new column structure
+   * @returns Queryable with new column structure applied
    *
    * @example
    * ```typescript
@@ -182,9 +182,9 @@ class Queryable {
     });
   }
   /**
-   * DISTINCT 옵션을 적용하여 중복 행을 제거
+   * Apply DISTINCT option to remove duplicate rows
    *
-   * @returns DISTINCT가 적용된 Queryable
+   * @returns Queryable with DISTINCT applied
    *
    * @example
    * ```typescript
@@ -207,11 +207,11 @@ class Queryable {
     });
   }
   /**
-   * 행 잠금(FOR UPDATE)을 적용
+   * Apply row lock (FOR UPDATE)
    *
-   * 트랜잭션 내에서 선택된 행에 대한 배타적 잠금을 획득
+   * Acquire exclusive lock on selected rows within transaction
    *
-   * @returns 잠금이 적용된 Queryable
+   * @returns Queryable with lock applied
    *
    * @example
    * ```typescript
@@ -237,16 +237,16 @@ class Queryable {
     });
   }
   //#endregion
-  //#region ========== 제한 - TOP / LIMIT ==========
+  //#region ========== restrict - TOP / LIMIT ==========
   /**
-   * 상위 N개의 행만 조회 (ORDER BY 없이 사용 가능)
+   * Select only top N rows (can be used without ORDER BY)
    *
-   * @param count - 조회할 행 수
-   * @returns TOP이 적용된 Queryable
+   * @param count - number of rows to select
+   * @returns Queryable with TOP applied
    *
    * @example
    * ```typescript
-   * // 최신 사용자 10명
+   * // Latest 10 users
    * db.user()
    *   .orderBy((u) => u.createdAt, "DESC")
    *   .top(10)
@@ -266,19 +266,19 @@ class Queryable {
     });
   }
   /**
-   * 페이지네이션을 위한 LIMIT/OFFSET을 설정합니다.
-   * 반드시 orderBy()를 먼저 호출해야 합니다.
+   * Set LIMIT/OFFSET for pagination.
+   * Must call orderBy() first.
    *
-   * @param skip - 건너뛸 행 수 (OFFSET)
-   * @param take - 가져올 행 수 (LIMIT)
-   * @returns 페이지네이션이 적용된 Queryable
-   * @throws ORDER BY 절이 없으면 에러
+   * @param skip - number of rows to skip (OFFSET)
+   * @param take - number of rows to fetch (LIMIT)
+   * @returns Queryable with pagination applied
+   * @throws Error if no ORDER BY clause
    *
    * @example
    * ```typescript
    * db.user
    *   .orderBy((u) => u.createdAt)
-   *   .limit(0, 20) // 첫 20개
+   *   .limit(0, 20) // first 20
    * ```
    */
   limit(skip, take) {
@@ -290,7 +290,7 @@ class Queryable {
       });
     }
     if (!this.meta.orderBy) {
-      throw new ArgumentError("limit()\uC740 ORDER BY \uC808\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.", {
+      throw new ArgumentError("limit() requires ORDER BY clause.", {
         method: "limit",
         required: "orderBy"
       });
@@ -301,13 +301,13 @@ class Queryable {
     });
   }
   //#endregion
-  //#region ========== 정렬 - ORDER BY ==========
+  //#region ========== sorting - ORDER BY ==========
   /**
-   * 정렬 조건을 추가합니다. 여러 번 호출하면 순서대로 적용됩니다.
+   * Add sorting condition. Multiple calls apply in order.
    *
-   * @param fn - 정렬 기준 컬럼을 반환하는 함수
-   * @param orderBy - 정렬 방향 (ASC/DESC). 기본값: ASC
-   * @returns 정렬 조건이 추가된 Queryable
+   * @param fn - function returning columns to sort by
+   * @param orderBy - Sort direction (ASC/DESC). Default: ASC
+   * @returns sorting 조건이 추가된 Queryable
    *
    * @example
    * ```typescript
@@ -333,9 +333,9 @@ class Queryable {
   //#endregion
   //#region ========== 검색 - WHERE ==========
   /**
-   * WHERE 조건을 추가합니다. 여러 번 호출하면 AND로 결합됩니다.
+   * WHERE condition을 추가합니다. 여러 번 호출하면 AND로 결합됩니다.
    *
-   * @param predicate - 조건 배열을 반환하는 함수
+   * @param predicate - Condition 배열을 반환하는 function
    * @returns 조건이 추가된 Queryable
    *
    * @example
@@ -363,18 +363,18 @@ class Queryable {
    * 텍스트 검색을 수행
    *
    * 검색 문법은 {@link parseSearchQuery}를 참조
-   * - 공백으로 구분된 단어는 OR 조건
-   * - `+`로 시작하는 단어는 필수 포함 (AND 조건)
-   * - `-`로 시작하는 단어는 제외 (NOT 조건)
+   * - 공백으로 구분된 단어는 OR condition
+   * - `+`로 시작하는 단어는 required include (AND Condition)
+   * - `-`로 시작하는 단어는 exclude (NOT Condition)
    *
-   * @param fn - 검색 대상 컬럼을 반환하는 함수
+   * @param fn - 검색 대상 column을 반환하는 function
    * @param searchText - 검색 텍스트
    * @returns 검색 조건이 추가된 Queryable
    *
    * @example
    * ```typescript
    * db.user()
-   *   .search((u) => [u.name, u.email], "홍길동 -탈퇴")
+   *   .search((u) => [u.name, u.email], "Gildong Hong -탈퇴")
    * ```
    */
   search(fn, searchText) {
@@ -420,10 +420,10 @@ class Queryable {
   //#endregion
   //#region ========== 그룹 - GROUP BY / HAVING ==========
   /**
-   * GROUP BY 절을 추가
+   * GROUP BY 절을 Add
    *
-   * @param fn - 그룹화 기준 컬럼을 반환하는 함수
-   * @returns GROUP BY가 적용된 Queryable
+   * @param fn - Group화 기준 column을 반환하는 function
+   * @returns Queryable with GROUP BY applied
    *
    * @example
    * ```typescript
@@ -447,10 +447,10 @@ class Queryable {
     return new Queryable({ ...this.meta, groupBy });
   }
   /**
-   * HAVING 절을 추가 (GROUP BY 후 필터링)
+   * HAVING 절을 Add (GROUP BY 후 filtering)
    *
-   * @param predicate - 조건 배열을 반환하는 함수
-   * @returns HAVING이 적용된 Queryable
+   * @param predicate - Condition 배열을 반환하는 function
+   * @returns HAVING이 apply된 Queryable
    *
    * @example
    * ```typescript
@@ -478,13 +478,13 @@ class Queryable {
     });
   }
   //#endregion
-  //#region ========== 조인 - JOIN / JOIN SINGLE ==========
+  //#region ========== join - JOIN / JOIN SINGLE ==========
   /**
-   * 1:N 관계의 LEFT OUTER JOIN을 수행 (배열로 결과 추가)
+   * 1:N 관계의 LEFT OUTER JOIN을 수행 (배열로 result Add)
    *
-   * @param as - 결과에 추가할 속성 이름
-   * @param fwd - 조인 조건을 정의하는 콜백 함수
-   * @returns 조인 결과가 배열로 추가된 Queryable
+   * @param as - Result에 추가할 property 이름
+   * @param fwd - Join 조건을 정의하는 콜백 function
+   * @returns join 결과가 배열로 추가된 Queryable
    *
    * @example
    * ```typescript
@@ -493,7 +493,7 @@ class Queryable {
    *     qr.from(Post)
    *       .where((p) => [expr.eq(p.userId, u.id)])
    *   )
-   * // 결과: { id, name, posts: [{ id, title }, ...] }
+   * // Result: { id, name, posts: [{ id, title }, ...] }
    * ```
    */
   join(as, fwd) {
@@ -520,11 +520,11 @@ class Queryable {
     });
   }
   /**
-   * N:1 또는 1:1 관계의 LEFT OUTER JOIN을 수행 (단일 객체로 결과 추가)
+   * N:1 또는 1:1 관계의 LEFT OUTER JOIN을 수행 (단일 객체로 result Add)
    *
-   * @param as - 결과에 추가할 속성 이름
-   * @param fwd - 조인 조건을 정의하는 콜백 함수
-   * @returns 조인 결과가 단일 객체로 추가된 Queryable
+   * @param as - Result에 추가할 property 이름
+   * @param fwd - Join 조건을 정의하는 콜백 function
+   * @returns join 결과가 단일 객체로 추가된 Queryable
    *
    * @example
    * ```typescript
@@ -533,7 +533,7 @@ class Queryable {
    *     qr.from(User)
    *       .where((u) => [expr.eq(u.id, p.userId)])
    *   )
-   * // 결과: { id, title, user: { id, name } | undefined }
+   * // Result: { id, title, user: { id, name } | undefined }
    * ```
    */
   joinSingle(as, fwd) {
@@ -560,24 +560,24 @@ class Queryable {
     });
   }
   //#endregion
-  //#region ========== 조인 - INCLUDE ==========
+  //#region ========== join - INCLUDE ==========
   /**
-   * 관계된 테이블을 자동으로 JOIN합니다.
+   * 관계된 Table을 automatic으로 JOIN합니다.
    * TableBuilder에 정의된 FK/FKT 관계를 기반으로 동작합니다.
    *
-   * @param fn - 포함할 관계를 선택하는 함수 (PathProxy를 통해 타입 체크됨)
+   * @param fn - 포함할 관계를 선택하는 function (PathProxy를 통해 type 체크됨)
    * @returns JOIN이 추가된 Queryable
    * @throws 관계가 정의되지 않은 경우 에러
    *
    * @example
    * ```typescript
-   * // 단일 관계 포함
+   * // 단일 relationship include
    * db.post.include((p) => p.user)
    *
-   * // 중첩 관계 포함
+   * // 중첩 relationship include
    * db.post.include((p) => p.user.company)
    *
-   * // 다중 관계 포함
+   * // 다중 relationship include
    * db.user
    *   .include((u) => u.company)
    *   .include((u) => u.posts)
@@ -605,7 +605,7 @@ class Queryable {
     const chainParts = [];
     for (const relationName of relationNames) {
       if (!(currentTable instanceof TableBuilder)) {
-        throw new Error("include()\uB294 TableBuilder \uAE30\uBC18 queryable\uC5D0\uC11C\uB9CC \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
+        throw new Error("include() can only be used on TableBuilder-based queryables.");
       }
       const parentChain = chainParts.join(".");
       chainParts.push(relationName);
@@ -620,7 +620,7 @@ class Queryable {
       }
       const relationDef = (_b = currentTable.meta.relations) == null ? void 0 : _b[relationName];
       if (relationDef == null) {
-        throw new Error(`\uAD00\uACC4 '${relationName}'\uC744(\uB97C) \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);
+        throw new Error(`Relation '${relationName}' not found.`);
       }
       if (relationDef instanceof ForeignKeyBuilder || relationDef instanceof RelationKeyBuilder) {
         const targetTable = relationDef.meta.targetFn();
@@ -645,7 +645,7 @@ class Queryable {
         const sourceFk = (_c = targetTable.meta.relations) == null ? void 0 : _c[fkRelName];
         if (!(sourceFk instanceof ForeignKeyBuilder) && !(sourceFk instanceof RelationKeyBuilder)) {
           throw new Error(
-            `'${relationName}'\uC774 \uCC38\uC870\uD558\uB294 '${fkRelName}'\uC774(\uAC00) ${targetTable.meta.name} \uD14C\uC774\uBE14\uC758 \uC720\uD6A8\uD55C ForeignKey/RelationKey\uAC00 \uC544\uB2D9\uB2C8\uB2E4.`
+            `'${relationName}'\uC774 \uCC38\uC870\uD558\uB294 '${fkRelName}'\uC774(\uAC00) ${targetTable.meta.name} Table\uC758 \uC720\uD6A8\uD55C ForeignKey/RelationKey\uAC00 \uC544\uB2D9\uB2C8\uB2E4.`
           );
         }
         const sourceTable = targetTable;
@@ -671,13 +671,13 @@ class Queryable {
     return result;
   }
   //#endregion
-  //#region ========== 서브쿼리 - WRAP / UNION ==========
+  //#region ========== Subquery - WRAP / UNION ==========
   /**
-   * 현재 Queryable을 서브쿼리로 감싸기
+   * 현재 Queryable을 Subquery로 감싸기
    *
    * distinct() 또는 groupBy() 후 count() 사용 시 필요
    *
-   * @returns 서브쿼리로 감싸진 Queryable
+   * @returns Subquery로 감싸진 Queryable
    *
    * @example
    * ```typescript
@@ -699,11 +699,11 @@ class Queryable {
     });
   }
   /**
-   * 여러 Queryable을 UNION으로 결합 (중복 제거)
+   * Combine multiple Queryables with UNION (remove duplicates)
    *
-   * @param queries - UNION할 Queryable 배열 (최소 2개)
-   * @returns UNION된 Queryable
-   * @throws 2개 미만의 queryable이 전달된 경우
+   * @param queries - Array of Queryables to UNION (minimum 2)
+   * @returns UNION-ed Queryable
+   * @throws If less than 2 queryables are passed
    *
    * @example
    * ```typescript
@@ -715,7 +715,7 @@ class Queryable {
    */
   static union(...queries) {
     if (queries.length < 2) {
-      throw new ArgumentError("union\uC740 \uCD5C\uC18C 2\uAC1C\uC758 queryable\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.", {
+      throw new ArgumentError("union requires at least 2 queryables.", {
         provided: queries.length,
         minimum: 2
       });
@@ -725,20 +725,20 @@ class Queryable {
     return new Queryable({
       db: first.meta.db,
       from: queries,
-      // Queryable[] 배열로 저장
+      // stored as Queryable[] array
       as: unionAlias,
       columns: transformColumnsAlias(first.meta.columns, unionAlias, "")
     });
   }
   //#endregion
-  //#region ========== 재귀 - WITH RECURSIVE ==========
+  //#region ========== recursive - WITH RECURSIVE ==========
   /**
-   * 재귀 CTE(Common Table Expression)를 생성
+   * recursive CTE(Common Table Expression)를 Generate
    *
-   * 계층 구조 데이터(조직도, 카테고리 트리 등)를 조회할 때 사용
+   * 계층 structure data(조직도, 카테고리 트리 등)를 조회할 때 사용
    *
-   * @param fwd - 재귀 부분을 정의하는 콜백 함수
-   * @returns 재귀 CTE가 적용된 Queryable
+   * @param fwd - recursive part을 정의하는 콜백 function
+   * @returns recursive CTE가 apply된 Queryable
    *
    * @example
    * ```typescript
@@ -771,17 +771,17 @@ class Queryable {
       with: {
         name: cteName,
         base: this,
-        // 순환 참조 타입 추론 차단
+        // circular 참조 Type inference 차단
         recursive: resultQr
       }
     });
   }
   //#endregion
-  //#region ========== [쿼리] 조회 - SELECT ==========
+  //#region ========== [query] 조회 - SELECT ==========
   /**
-   * SELECT 쿼리를 실행하고 결과 배열을 반환
+   * SELECT query를 실행하고 result 배열을 return
    *
-   * @returns 쿼리 결과 배열
+   * @returns Query result array
    *
    * @example
    * ```typescript
@@ -798,9 +798,9 @@ class Queryable {
     return results[0];
   }
   /**
-   * 단일 결과를 반환 (2개 이상이면 에러)
+   * 단일 결과를 return (2개 이상이면 Error)
    *
-   * @returns 단일 결과 또는 undefined
+   * @returns 단일 result 또는 undefined
    * @throws 2개 이상의 결과가 반환된 경우
    *
    * @example
@@ -813,7 +813,7 @@ class Queryable {
   async single() {
     const result = await this.top(2).result();
     if (result.length > 1) {
-      throw new ArgumentError("\uB2E8\uC77C \uACB0\uACFC\uB97C \uAE30\uB300\uD588\uC9C0\uB9CC 2\uAC1C \uC774\uC0C1\uC758 \uACB0\uACFC\uAC00 \uBC18\uD658\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", {
+      throw new ArgumentError("Expected single result but multiple results returned.", {
         table: this._getSourceName(),
         resultCount: result.length
       });
@@ -821,7 +821,7 @@ class Queryable {
     return result[0];
   }
   /**
-   * 쿼리 소스 이름 반환 (에러 메시지용)
+   * query 소스 이름 return (error message용)
    */
   _getSourceName() {
     const from = this.meta.from;
@@ -834,9 +834,9 @@ class Queryable {
     return this.meta.as;
   }
   /**
-   * 첫 번째 결과를 반환 (여러 개여도 첫 번째만)
+   * 첫 번째 결과를 return (여러 개여도 첫 번째만)
    *
-   * @returns 첫 번째 결과 또는 undefined
+   * @returns 첫 번째 result 또는 undefined
    *
    * @example
    * ```typescript
@@ -850,10 +850,10 @@ class Queryable {
     return results[0];
   }
   /**
-   * 결과 행 수를 반환
+   * result row 수를 return
    *
-   * @param fwd - 카운트할 컬럼을 지정하는 함수 (선택)
-   * @returns 행 수
+   * @param fwd - 카운트할 column을 지정하는 function (Select)
+   * @returns row 수
    * @throws distinct() 또는 groupBy() 후 직접 호출 시 에러 (wrap() 필요)
    *
    * @example
@@ -865,17 +865,17 @@ class Queryable {
    */
   async count(fwd) {
     if (this.meta.distinct) {
-      throw new Error("distinct() \uD6C4\uC5D0\uB294 count()\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. wrap()\uC744 \uBA3C\uC800 \uC0AC\uC6A9\uD558\uC138\uC694.");
+      throw new Error("Cannot use count() after distinct(). Use wrap() first.");
     }
     if (this.meta.groupBy) {
-      throw new Error("groupBy() \uD6C4\uC5D0\uB294 count()\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. wrap()\uC744 \uBA3C\uC800 \uC0AC\uC6A9\uD558\uC138\uC694.");
+      throw new Error("Cannot use count() after groupBy(). Use wrap() first.");
     }
     const countQr = fwd ? this.select((c) => ({ cnt: expr.count(fwd(c)) })) : this.select(() => ({ cnt: expr.count() }));
     const result = await countQr.single();
     return (result == null ? void 0 : result.cnt) ?? 0;
   }
   /**
-   * 조건에 맞는 데이터 존재 여부를 확인
+   * 조건에 맞는 data 존재 여부를 확인
    *
    * @returns 존재하면 true, 없으면 false
    *
@@ -1160,7 +1160,7 @@ class Queryable {
   //#endregion
   //#region ========== DDL Helper ==========
   /**
-   * FK 제약조건 on/off (트랜잭션 내 사용 가능)
+   * FK constraint on/off (transaction 내 사용 가능)
    */
   async switchFk(switch_) {
     const from = this.meta.from;
@@ -1177,7 +1177,7 @@ class Queryable {
     const from = this.meta.from;
     if (from instanceof TableBuilder) {
       if (from.meta.columns == null) {
-        throw new Error(`\uD14C\uC774\uBE14 '${from.meta.name}'\uC5D0 \uCEEC\uB7FC \uC815\uC758\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.`);
+        throw new Error(`Table '${from.meta.name}' has no Column definition.`);
       }
       let aiColName;
       for (const [key, col] of Object.entries(from.meta.columns)) {
@@ -1190,7 +1190,7 @@ class Queryable {
         aiColName
       };
     }
-    throw new Error("CUD \uC791\uC5C5\uC740 TableBuilder \uAE30\uBC18 queryable\uC5D0\uC11C\uB9CC \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
+    throw new Error("CUD operations can only be used on TableBuilder-based queryables.");
   }
   //#endregion
 }
@@ -1198,7 +1198,7 @@ function getMatchedPrimaryKeys(fkCols, targetTable) {
   const pk = targetTable.meta.primaryKey;
   if (pk == null || fkCols.length !== pk.length) {
     throw new Error(
-      `FK/PK \uCEEC\uB7FC \uAC1C\uC218\uAC00 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 (\uB300\uC0C1: ${targetTable.meta.name}, FK: ${fkCols.length}\uAC1C, PK: ${(pk == null ? void 0 : pk.length) ?? 0}\uAC1C)`
+      `FK/PK column \uAC1C\uC218\uAC00 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 (\uB300\uC0C1: ${targetTable.meta.name}, FK: ${fkCols.length}\uAC1C, PK: ${(pk == null ? void 0 : pk.length) ?? 0}\uAC1C)`
     );
   }
   return pk;
@@ -1259,7 +1259,7 @@ function queryable(db, tableOrView, as) {
         columns: transformColumnsAlias(baseQr.meta.columns, finalAs)
       });
     }
-    throw new Error(`\uC798\uBABB\uB41C \uD14C\uC774\uBE14/\uBDF0 \uBA54\uD0C0\uB370\uC774\uD130: ${tableOrView.meta.name}`);
+    throw new Error(`Invalid Table/View Metadata: ${tableOrView.meta.name}`);
   };
 }
 export {