@simplysm/orm-common 13.0.83 → 13.0.84

package/dist/ddl/initialize.d.ts

@@ -29,8 +29,8 @@ export declare function initialize(db: DbContextBase & DbContextDdlMethods & {
     force?: boolean;
 }): Promise<void>;
 /**
- * ForeignKeyTarget/RelationKeyTarget 관계의 유효성 Validation
- * - targetTableFn()이 반환하는 Table에 relationName에 해당하는 FK/RelationKey가 있는지 확인
+ * Validate ForeignKeyTarget/RelationKeyTarget relations
+ * - Checks if the table returned by targetTableFn() has a FK/RelationKey matching the relationName
  */
 export declare function validateRelations(def: DbContextDef<any, any, any>): void;
 //# sourceMappingURL=initialize.d.ts.map

package/dist/ddl/initialize.js

@@ -125,7 +125,7 @@ function validateRelations(def) {
       const fkRel = (_a = targetTable.meta.relations) == null ? void 0 : _a[fkRelName];
       if (!(fkRel instanceof ForeignKeyBuilder) && !(fkRel instanceof RelationKeyBuilder)) {
         throw new Error(
-          `Invalid relation target: ${table.meta.name}.${relName}\uC774 \uCC38\uC870\uD558\uB294 '${fkRelName}'\uC774(\uAC00) ${targetTable.meta.name}\uC758 \uC720\uD6A8\uD55C ForeignKey/RelationKey\uAC00 \uC544\uB2D9\uB2C8\uB2E4.`
+          `Invalid relation target: '${fkRelName}' referenced by ${table.meta.name}.${relName} is not a valid ForeignKey/RelationKey in ${targetTable.meta.name}.`
         );
       }
     }

package/dist/ddl/initialize.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/ddl/initialize.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/ddl/table-ddl.d.ts

@@ -4,7 +4,7 @@ import { ProcedureBuilder } from "../schema/procedure-builder";
 import type { QueryDef, QueryDefObjectName, DropTableQueryDef, RenameTableQueryDef, DropViewQueryDef, DropProcQueryDef } from "../types/query-def";
 import type { DbContextBase } from "../types/db-context-def";
 /**
- * Builder를 CREATE QueryDef로 Transform
+ * Transform Builder to CREATE QueryDef
  *
  * @param db - DbContext instance
  * @param builder - Table/View/Procedure builder

package/dist/exec/queryable.d.ts

@@ -190,21 +190,21 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      *
      * @param fn - function returning columns to sort by
      * @param orderBy - Sort direction (ASC/DESC). Default: ASC
-     * @returns sorting 조건이 추가된 Queryable
+     * @returns Queryable with sorting conditions added
      *
      * @example
      * ```typescript
      * db.user
-     *   .orderBy((u) => u.name)           // 이름 ASC
-     *   .orderBy((u) => u.age, "DESC")    // 나이 DESC
+     *   .orderBy((u) => u.name)           // name ASC
+     *   .orderBy((u) => u.age, "DESC")    // age DESC
      * ```
      */
     orderBy(fn: (columns: QueryableRecord<TData>) => ExprUnit<ColumnPrimitive>, orderBy?: "ASC" | "DESC"): Queryable<TData, TFrom>;
     /**
-     * WHERE condition을 추가합니다. 여러 번 호출하면 AND로 결합됩니다.
+     * Add WHERE condition. Multiple calls are combined with AND.
      *
-     * @param predicate - Condition 배열을 반환하는 function
-     * @returns 조건이 추가된 Queryable
+     * @param predicate - Function returning an array of conditions
+     * @returns Queryable with conditions added
      *
      * @example
      * ```typescript
@@ -215,28 +215,28 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     where(predicate: (columns: QueryableRecord<TData>) => WhereExprUnit[]): Queryable<TData, TFrom>;
     /**
-     * 텍스트 검색을 수행
+     * Perform text search
      *
-     * 검색 문법은 {@link parseSearchQuery}를 참조
-     * - 공백으로 구분된 단어는 OR condition
-     * - `+`로 시작하는 단어는 required include (AND Condition)
-     * - `-`로 시작하는 단어는 exclude (NOT Condition)
+     * See {@link parseSearchQuery} for search syntax
+     * - Space-separated words are OR conditions
+     * - Words starting with `+` are required includes (AND condition)
+     * - Words starting with `-` are excludes (NOT condition)
      *
-     * @param fn - 검색 대상 column을 반환하는 function
-     * @param searchText - 검색 텍스트
-     * @returns 검색 조건이 추가된 Queryable
+     * @param fn - Function returning target columns to search
+     * @param searchText - Search text
+     * @returns Queryable with search conditions added
      *
      * @example
      * ```typescript
      * db.user()
-     *   .search((u) => [u.name, u.email], "Gildong Hong -탈퇴")
+     *   .search((u) => [u.name, u.email], "John Doe -withdrawn")
      * ```
      */
     search(fn: (columns: QueryableRecord<TData>) => ExprUnit<string | undefined>[], searchText: string): Queryable<TData, TFrom>;
     /**
-     * GROUP BY 절을 Add
+     * Add GROUP BY clause
      *
-     * @param fn - Group화 기준 column을 반환하는 function
+     * @param fn - Function returning columns to group by
      * @returns Queryable with GROUP BY applied
      *
      * @example
@@ -251,10 +251,10 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     groupBy(fn: (columns: QueryableRecord<TData>) => ExprUnit<ColumnPrimitive>[]): Queryable<TData, never>;
     /**
-     * HAVING 절을 Add (GROUP BY 후 filtering)
+     * Add HAVING clause (filtering after GROUP BY)
      *
-     * @param predicate - Condition 배열을 반환하는 function
-     * @returns HAVING이 apply된 Queryable
+     * @param predicate - Function returning an array of conditions
+     * @returns Queryable with HAVING applied
      *
      * @example
      * ```typescript
@@ -269,11 +269,11 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     having(predicate: (columns: QueryableRecord<TData>) => WhereExprUnit[]): Queryable<TData, never>;
     /**
-     * 1:N 관계의 LEFT OUTER JOIN을 수행 (배열로 result Add)
+     * Perform LEFT OUTER JOIN for 1:N relation (added as array to result)
      *
-     * @param as - Result에 추가할 property 이름
-     * @param fn - Join 조건을 정의하는 콜백 function
-     * @returns join 결과가 배열로 추가된 Queryable
+     * @param as - Property name to add to result
+     * @param fn - Callback function defining join conditions
+     * @returns Queryable with join result added as array
      *
      * @example
      * ```typescript
@@ -289,11 +289,11 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
         [K in A]?: R[];
     }, TFrom>;
     /**
-     * N:1 또는 1:1 관계의 LEFT OUTER JOIN을 수행 (단일 객체로 result Add)
+     * Perform LEFT OUTER JOIN for N:1 or 1:1 relation (added as single object to result)
      *
-     * @param as - Result에 추가할 property 이름
-     * @param fn - Join 조건을 정의하는 콜백 function
-     * @returns join 결과가 단일 객체로 추가된 Queryable
+     * @param as - Property name to add to result
+     * @param fn - Callback function defining join conditions
+     * @returns Queryable with join result added as single object
      *
      * @example
      * ```typescript
@@ -311,22 +311,22 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
         [K in A]?: R;
     }, TFrom>;
     /**
-     * 관계된 Table을 automatic으로 JOIN합니다.
-     * TableBuilder에 정의된 FK/FKT 관계를 기반으로 동작합니다.
+     * Automatically JOIN related tables.
+     * Operates based on FK/FKT relations defined in TableBuilder.
      *
-     * @param fn - 포함할 관계를 선택하는 function (PathProxy를 통해 type 체크됨)
-     * @returns JOIN이 추가된 Queryable
-     * @throws 관계가 정의되지 않은 경우 에러
+     * @param fn - Function selecting relations to include (type-checked via PathProxy)
+     * @returns Queryable with JOINs added
+     * @throws Error if relation is not defined
      *
      * @example
      * ```typescript
-     * // 단일 relationship include
+     * // Single relationship include
      * db.post.include((p) => p.user)
      *
-     * // 중첩 relationship include
+     * // Nested relationship include
      * db.post.include((p) => p.user.company)
      *
-     * // 다중 relationship include
+     * // Multiple relationship include
      * db.user
      *   .include((u) => u.company)
      *   .include((u) => u.posts)
@@ -335,15 +335,15 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
     include(fn: (item: PathProxy<TData>) => PathProxy<any>): Queryable<TData, TFrom>;
     private _include;
     /**
-     * 현재 Queryable을 Subquery로 감싸기
+     * Wrap the current Queryable as a Subquery
      *
-     * distinct() 또는 groupBy() 후 count() 사용 시 필요
+     * Required when using count() after distinct() or groupBy()
      *
-     * @returns Subquery로 감싸진 Queryable
+     * @returns Queryable wrapped as a Subquery
      *
      * @example
      * ```typescript
-     * // DISTINCT 후 카운트
+     * // Count after DISTINCT
      * const count = await db.user()
      *   .select((u) => ({ name: u.name }))
      *   .distinct()
@@ -369,18 +369,18 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     static union<TData extends DataRecord>(...queries: Queryable<TData, any>[]): Queryable<TData, never>;
     /**
-     * recursive CTE(Common Table Expression)를 Generate
+     * Generate a recursive CTE (Common Table Expression)
      *
-     * 계층 structure data(조직도, 카테고리 트리 등)를 조회할 때 사용
+     * Used for querying hierarchical data (org charts, category trees, etc.)
      *
-     * @param fn - recursive part을 정의하는 콜백 function
-     * @returns recursive CTE가 apply된 Queryable
+     * @param fn - Callback function that defines the recursive part
+     * @returns Queryable with the recursive CTE applied
      *
      * @example
      * ```typescript
-     * // 조직도 계층 조회
+     * // Query org chart hierarchy
      * db.employee()
-     *   .where((e) => [expr.null(e.managerId)]) // 루트 노드
+     *   .where((e) => [expr.null(e.managerId)]) // Root nodes
      *   .recursive((cte) =>
      *     cte.from(Employee)
      *       .where((e) => [expr.eq(e.managerId, e.self[0].id)])
@@ -389,7 +389,7 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     recursive(fn: (qr: RecursiveQueryable<TData>) => Queryable<TData, any>): Queryable<TData, never>;
     /**
-     * SELECT query를 실행하고 result 배열을 return
+     * Execute a SELECT query and return the result array
      *
      * @returns Query result array
      *
@@ -402,10 +402,10 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     execute(): Promise<TData[]>;
     /**
-     * 단일 결과를 return (2개 이상이면 Error)
+     * Return a single result (Error if more than 1)
      *
-     * @returns 단일 result 또는 undefined
-     * @throws 2개 이상의 결과가 반환된 경우
+     * @returns Single result or undefined
+     * @throws When more than one result is returned
      *
      * @example
      * ```typescript
@@ -416,13 +416,13 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     single(): Promise<TData | undefined>;
     /**
-     * query 소스 이름 return (error message용)
+     * Return query source name (for error messages)
      */
     private _getSourceName;
     /**
-     * 첫 번째 결과를 return (여러 개여도 첫 번째만)
+     * Return the first result (only the first even if multiple exist)
      *
-     * @returns 첫 번째 result 또는 undefined
+     * @returns First result or undefined
      *
      * @example
      * ```typescript
@@ -433,11 +433,11 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     first(): Promise<TData | undefined>;
     /**
-     * result row 수를 return
+     * Return the number of result rows
      *
-     * @param fn - 카운트할 column을 지정하는 function (Select)
-     * @returns row 수
-     * @throws distinct() 또는 groupBy() 후 직접 호출 시 에러 (wrap() 필요)
+     * @param fn - Function to specify the column to count (optional)
+     * @returns Number of rows
+     * @throws Error when called directly after distinct() or groupBy() (use wrap() first)
      *
      * @example
      * ```typescript
@@ -448,9 +448,9 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      */
     count(fn?: (cols: QueryableRecord<TData>) => ExprUnit<ColumnPrimitive>): Promise<number>;
     /**
-     * 조건에 맞는 data 존재 여부를 확인
+     * Check whether data matching the conditions exists
      *
-     * @returns 존재하면 true, 없으면 false
+     * @returns true if exists, false otherwise
      *
      * @example
      * ```typescript
@@ -466,22 +466,22 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
     private _buildJoinDefs;
     getResultMeta(outputColumns?: string[]): ResultMeta;
     /**
-     * INSERT query를 실행
+     * Execute an INSERT query
      *
-     * MSSQL의 1000개 제한을 위해 automatic으로 1000개씩 청크로 분할하여 실행
+     * Automatically splits into chunks of 1000 for MSSQL's row limit
      *
-     * @param records - Insert할 레코드 array
-     * @param outputColumns - column name array to receive (Select)
-     * @returns outputColumns 지정 시 삽입된 레코드 array return
+     * @param records - Array of records to insert
+     * @param outputColumns - Column name array to receive (optional)
+     * @returns When outputColumns specified, returns array of inserted records
      *
      * @example
      * ```typescript
-     * // 단순 삽입
+     * // Simple insert
      * await db.user().insert([
      *   { name: "Gildong Hong", email: "hong@test.com" },
      * ]);
      *
-     * // 삽입 후 ID return
+     * // Return ID after insert
      * const [inserted] = await db.user().insert(
      *   [{ name: "Gildong Hong" }],
      *   ["id"],
@@ -491,11 +491,11 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
     insert(records: TFrom["$inferInsert"][]): Promise<void>;
     insert<K extends keyof TFrom["$inferColumns"] & string>(records: TFrom["$inferInsert"][], outputColumns: K[]): Promise<Pick<TFrom["$inferColumns"], K>[]>;
     /**
-     * WHERE condition에 맞는 data가 없으면 INSERT
+     * INSERT if no data matches the WHERE condition
      *
-     * @param record - Insert할 레코드
-     * @param outputColumns - column name array to receive (Select)
-     * @returns outputColumns 지정 시 삽입된 레코드 return
+     * @param record - Record to insert
+     * @param outputColumns - Column name array to receive (optional)
+     * @returns When outputColumns specified, returns the inserted record
      *
      * @example
      * ```typescript
@@ -507,11 +507,11 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
     insertIfNotExists(record: TFrom["$inferInsert"]): Promise<void>;
     insertIfNotExists<K extends keyof TFrom["$inferColumns"] & string>(record: TFrom["$inferInsert"], outputColumns: K[]): Promise<Pick<TFrom["$inferColumns"], K>>;
     /**
-     * INSERT INTO ... SELECT (현재 SELECT 결과를 다른 Table에 INSERT)
+     * INSERT INTO ... SELECT (INSERT the current SELECT results into another Table)
      *
-     * @param targetTable - Insert 대상 Table
-     * @param outputColumns - column name array to receive (Select)
-     * @returns outputColumns 지정 시 삽입된 레코드 array return
+     * @param targetTable - Target Table to insert into
+     * @param outputColumns - Column name array to receive (optional)
+     * @returns When outputColumns specified, returns array of inserted records
      *
      * @example
      * ```typescript
@@ -527,15 +527,15 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
     getInsertIfNotExistsQueryDef(record: TFrom["$inferInsert"], outputColumns?: (keyof TFrom["$inferColumns"] & string)[]): InsertIfNotExistsQueryDef;
     getInsertIntoQueryDef<TTable extends TableBuilder<DataToColumnBuilderRecord<TData>, any>>(targetTable: TTable, outputColumns?: (keyof TTable["$inferColumns"] & string)[]): InsertIntoQueryDef;
     /**
-     * UPDATE query를 실행
+     * Execute an UPDATE query
      *
-     * @param recordFwd - Update할 column과 값을 반환하는 function
-     * @param outputColumns - column name array to receive (Select)
-     * @returns outputColumns 지정 시 업데이트된 레코드 array return
+     * @param recordFwd - Function that returns the columns and values to update
+     * @param outputColumns - Column name array to receive (optional)
+     * @returns When outputColumns specified, returns array of updated records
      *
      * @example
      * ```typescript
-     * // 단순 업데이트
+     * // Simple update
      * await db.user()
      *   .where((u) => [expr.eq(u.id, 1)])
      *   .update((u) => ({
@@ -543,7 +543,7 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      *     updatedAt: expr.val("DateTime", DateTime.now()),
      *   }));
      *
-     * // 기존 value 참조
+     * // Reference existing value
      * await db.product()
      *   .update((p) => ({
      *     price: expr.mul(p.price, expr.val("number", 1.1)),
@@ -553,19 +553,19 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
     update(recordFwd: (cols: QueryableRecord<TData>) => QueryableWriteRecord<TFrom["$inferUpdate"]>): Promise<void>;
     update<K extends keyof TFrom["$columns"] & string>(recordFwd: (cols: QueryableRecord<TData>) => QueryableWriteRecord<TFrom["$inferUpdate"]>, outputColumns: K[]): Promise<Pick<TFrom["$columns"], K>[]>;
     /**
-     * DELETE query를 실행
+     * Execute a DELETE query
      *
-     * @param outputColumns - column name array to receive (Select)
-     * @returns outputColumns 지정 시 삭제된 레코드 array return
+     * @param outputColumns - Column name array to receive (optional)
+     * @returns When outputColumns specified, returns array of deleted records
      *
      * @example
      * ```typescript
-     * // 단순 Delete
+     * // Simple delete
      * await db.user()
      *   .where((u) => [expr.eq(u.id, 1)])
      *   .delete();
      *
-     * // 삭제된 data return
+     * // Return deleted data
      * const deleted = await db.user()
      *   .where((u) => [expr.eq(u.isExpired, true)])
      *   .delete(["id", "name"]);
@@ -576,18 +576,18 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
     getUpdateQueryDef(recordFwd: (cols: QueryableRecord<TData>) => QueryableWriteRecord<TFrom["$inferUpdate"]>, outputColumns?: (keyof TFrom["$inferColumns"] & string)[]): UpdateQueryDef;
     getDeleteQueryDef(outputColumns?: (keyof TFrom["$inferColumns"] & string)[]): DeleteQueryDef;
     /**
-     * UPSERT (UPDATE or INSERT) query를 실행
+     * Execute an UPSERT (UPDATE or INSERT) query
      *
-     * WHERE condition에 맞는 data가 있으면 UPDATE, 없으면 INSERT
+     * UPDATE if data matching the WHERE condition exists, otherwise INSERT
      *
-     * @param updateFn - Update할 column과 값을 반환하는 function
-     * @param insertFn - Insert할 레코드를 반환하는 function (selection, 미지정 시 updateFn와 동일)
-     * @param outputColumns - column name array to receive (Select)
-     * @returns outputColumns 지정 시 영향받은 레코드 array return
+     * @param updateFn - Function that returns the columns and values to update
+     * @param insertFn - Function that returns the record to insert (optional, defaults to same as updateFn)
+     * @param outputColumns - Column name array to receive (optional)
+     * @returns When outputColumns specified, returns array of affected records
      *
      * @example
      * ```typescript
-     * // UPDATE/INSERT 동일 data
+     * // Same data for UPDATE/INSERT
      * await db.user()
      *   .where((u) => [expr.eq(u.email, "test@test.com")])
      *   .upsert(() => ({
@@ -595,7 +595,7 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
      *     email: expr.val("string", "test@test.com"),
      *   }));
      *
-     * // UPDATE/INSERT 다른 data
+     * // Different data for UPDATE/INSERT
      * await db.user()
      *   .where((u) => [expr.eq(u.email, "test@test.com")])
      *   .upsert(
@@ -610,18 +610,18 @@ export declare class Queryable<TData extends DataRecord, TFrom extends TableBuil
     upsert<U extends QueryableWriteRecord<TFrom["$inferUpdate"]>, K extends keyof TFrom["$inferColumns"] & string>(updateFn: (cols: QueryableRecord<TData>) => U, insertFn: (updateRecord: U) => QueryableWriteRecord<TFrom["$inferInsert"]>, outputColumns?: K[]): Promise<Pick<TFrom["$inferColumns"], K>[]>;
     getUpsertQueryDef<U extends QueryableWriteRecord<TFrom["$inferUpdate"]>>(updateRecordFn: (cols: QueryableRecord<TData>) => U, insertRecordFn: (updateRecord: U) => QueryableWriteRecord<TFrom["$inferInsert"]>, outputColumns?: (keyof TFrom["$inferColumns"] & string)[]): UpsertQueryDef;
     /**
-     * FK constraint on/off (transaction 내 사용 가능)
+     * FK constraint on/off (can be used within a transaction)
      */
     switchFk(enabled: boolean): Promise<void>;
     private _getCudOutputDef;
 }
 /**
- * FK column 배열과 대상 Table의 PK를 매칭하여 PK column명 배열을 return
+ * Match FK column array with the target Table's PK and return PK column name array
  *
- * @param fkCols - FK column명 array
- * @param targetTable - 참조 대상 Table builder
- * @returns 매칭된 PK column명 array
- * @throws FK/PK column 수 불일치 시
+ * @param fkCols - FK column name array
+ * @param targetTable - Target Table builder being referenced
+ * @returns Matched PK column name array
+ * @throws When FK/PK column count mismatch
  */
 export declare function getMatchedPrimaryKeys(fkCols: string[], targetTable: TableBuilder<any, any>): string[];
 interface QueryableMeta<TData extends DataRecord> {
@@ -659,33 +659,33 @@ export type NullableQueryableRecord<TData extends DataRecord> = {
     [K in keyof TData]: TData[K] extends ColumnPrimitive ? ExprUnit<TData[K] | undefined> : TData[K] extends (infer U)[] ? U extends DataRecord ? NullableQueryableRecord<U>[] : never : TData[K] extends (infer U)[] | undefined ? U extends DataRecord ? NullableQueryableRecord<U>[] | undefined : never : TData[K] extends DataRecord ? NullableQueryableRecord<TData[K]> : TData[K] extends DataRecord | undefined ? NullableQueryableRecord<Exclude<TData[K], undefined>> | undefined : never;
 };
 /**
- * QueryableRecord에서 DataRecord로 역transform
+ * Reverse-transform from QueryableRecord to DataRecord
  *
- * ExprUnit<T>를 T로, 중첩 object/배열을 재귀적으로 풀어냄
+ * Unwraps ExprUnit<T> to T, recursively unwrapping nested objects/arrays
  */
 export type UnwrapQueryableRecord<R> = {
     [K in keyof R]: R[K] extends ExprUnit<infer T> ? T : NonNullable<R[K]> extends (infer U)[] ? U extends Record<string, any> ? UnwrapQueryableRecord<U>[] | Extract<R[K], undefined> : never : NonNullable<R[K]> extends Record<string, any> ? UnwrapQueryableRecord<NonNullable<R[K]>> | Extract<R[K], undefined> : never;
 };
 /**
- * include()에서 relationship 경로를 type 안전하게 지정하기 위한 Proxy type
- * ColumnPrimitive가 아닌 필드(FK, FKT relationship)만 access 가능
+ * Proxy type for specifying relationship paths in include() in a type-safe manner
+ * Only non-ColumnPrimitive fields (FK, FKT relationships) are accessible
  *
  * @example
  * ```typescript
- * // item.user.company access 시 내부적으로 ["user", "company"] 경로 수집
+ * // Accessing item.user.company internally collects path ["user", "company"]
  * db.post.include(item => item.user.company)
  *
- * // item.title은 string(ColumnPrimitive)이므로 컴파일 에러
- * db.post.include(item => item.title) // ❌ 에러
+ * // item.title is string (ColumnPrimitive), so this is a compile error
+ * db.post.include(item => item.title) // compile error
  * ```
  */
 /**
- * 배열이면 요소 type 추출
+ * Extract element type if array
  */
 type UnwrapArray<TArray> = TArray extends (infer TElement)[] ? TElement : TArray;
 declare const PATH_SYMBOL: unique symbol;
 /**
- * include()용 type 안전 경로 프록시
+ * Type-safe path proxy for include()
  */
 export type PathProxy<TObject> = {
     [K in keyof TObject as TObject[K] extends ColumnPrimitive ? never : K]-?: PathProxy<UnwrapArray<TObject[K]>>;
@@ -693,22 +693,22 @@ export type PathProxy<TObject> = {
     readonly [PATH_SYMBOL]: string[];
 };
 /**
- * Table 또는 View에 대한 Queryable factory 함수를 Generate
+ * Generate a Queryable factory function for a Table or View
  *
- * DbContext에서 Table/View별 getter를 정의할 때 사용
+ * Used when defining per-Table/View getters in DbContext
  *
  * @param db - DbContext instance
- * @param tableOrView - TableBuilder 또는 ViewBuilder instance
- * @param as - alias 지정 (selection, 미지정 시 automatic Create)
- * @returns Queryable을 반환하는 factory function
+ * @param tableOrView - TableBuilder or ViewBuilder instance
+ * @param as - Alias specification (optional, auto-created if not specified)
+ * @returns Factory function that returns a Queryable
  *
  * @example
  * ```typescript
  * class AppDbContext extends DbContext {
- *   // 호출 시마다 새로운 alias 할당
+ *   // A new alias is assigned on each call
  *   user = queryable(this, User);
  *
- *   // 사용 예시
+ *   // Usage example
  *   async getActiveUsers() {
  *     return this.user()
  *       .where((u) => [expr.eq(u.isActive, true)])