@simplysm/orm-common 13.0.82 → 13.0.84

package/src/query-builder/postgresql/postgresql-query-builder.ts

@@ -38,25 +38,25 @@ import { PostgresqlExprRenderer } from "./postgresql-expr-renderer";
 /**
  * PostgreSQL QueryBuilder
  *
- * PostgreSQL 특이사항:
- * - OUTPUT: RETURNING 절 사용 (네이티브 지원)
- * - TRUNCATE: RESTART IDENTITY option 필요
- * - UPSERT: CTE 방식 (INSERT ... ON CONFLICT는 단일 unique 제약만 지원)
- * - AUTO_INCREMENT: GENERATED BY DEFAULT AS IDENTITY (explicit value 지정 가능)
- * - FK Add 시 Index 별도 Generate 필요 (MySQL과 달리)
+ * PostgreSQL specifics:
+ * - OUTPUT: uses RETURNING clause (native support)
+ * - TRUNCATE: RESTART IDENTITY option required
+ * - UPSERT: CTE approach (INSERT ... ON CONFLICT only supports single unique constraint)
+ * - AUTO_INCREMENT: GENERATED BY DEFAULT AS IDENTITY (allows explicit value assignment)
+ * - Separate index generation needed when adding FK (unlike MySQL)
  */
 export class PostgresqlQueryBuilder extends QueryBuilderBase {
   protected expr = new PostgresqlExprRenderer((def) => this.select(def).sql);
 
-  //#region ========== 유틸리티 ==========
+  //#region ========== Utilities ==========
 
-  /** Table명 Render (PostgreSQL: database는 connection에서 processing, schema.table만 사용) */
+  /** Render table name (PostgreSQL: database is handled by connection, uses schema.table only) */
   protected tableName(obj: QueryDefObjectName): string {
     const schema = obj.schema ?? "public";
     return `${this.expr.wrap(schema)}.${this.expr.wrap(obj.name)}`;
   }
 
-  /** LIMIT...OFFSET 절 Render */
+  /** Render LIMIT...OFFSET clause */
   protected renderLimit(limit: [number, number] | undefined, top: number | undefined): string {
     if (limit != null) {
       const [offset, count] = limit;
@@ -71,15 +71,15 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   protected renderJoin(join: SelectQueryDefJoin): string {
     const alias = this.expr.wrap(join.as);
 
-    // LATERAL JOIN 필요 여부 감지
+    // Detect if LATERAL JOIN is needed
     if (this.needsLateral(join)) {
-      // from이 배열(UNION ALL)이면 renderFrom(join.from),
-      // 그 외(orderBy, top, select 등)면 renderFrom(join)으로 Subquery Generate
+      // If from is an array (UNION ALL), use renderFrom(join.from),
+      // otherwise (orderBy, top, select, etc.) use renderFrom(join) to generate subquery
       const from = Array.isArray(join.from) ? this.renderFrom(join.from) : this.renderFrom(join);
       return ` LEFT OUTER JOIN LATERAL ${from} AS ${alias} ON TRUE`;
     }
 
-    // 일반 JOIN
+    // Normal JOIN
     const from = this.renderFrom(join.from);
     const where =
       join.where != null && join.where.length > 0
@@ -169,14 +169,14 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
 
     let sql = `INSERT INTO ${table} (${colList})`;
 
-    // GENERATED BY DEFAULT AS IDENTITY이므로 explicit value 삽입 시 Add 구문 불필요
-    // overrideIdentity 파라미터는 MSSQL(SET IDENTITY_INSERT) 호환성을 위해 유지되지만
-    // PostgreSQL에서는 GENERATED BY DEFAULT가 automatic으로 explicit 값을 허용함
-    // (참고: GENERATED ALWAYS였다면 OVERRIDING SYSTEM VALUE 필요)
+    // GENERATED BY DEFAULT AS IDENTITY, so no additional clause needed for explicit value insertion
+    // overrideIdentity parameter is kept for MSSQL (SET IDENTITY_INSERT) compatibility, but
+    // PostgreSQL's GENERATED BY DEFAULT automatically allows explicit values
+    // (note: OVERRIDING SYSTEM VALUE would be needed if GENERATED ALWAYS was used)
 
     sql += ` VALUES ${valuesList.join(", ")}`;
 
-    // RETURNING (PostgreSQL 네이티브 지원)
+    // RETURNING (PostgreSQL native support)
     if (def.output != null) {
       const outputCols = def.output.columns.map((c) => this.expr.wrap(c)).join(", ");
       sql += ` RETURNING ${outputCols}`;
@@ -192,7 +192,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
     const colList = columns.map((c) => this.expr.wrap(c)).join(", ");
     const values = columns.map((c) => this.expr.escapeValue(def.record[c])).join(", ");
 
-    // existsSelectQuery를 SELECT 1 AS _ 형태로 Render
+    // Render existsSelectQuery as SELECT 1 AS _
     const existsQuerySql = this.select({
       ...def.existsSelectQuery,
       select: { _: { type: "value", value: 1 } },
@@ -213,7 +213,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
     const table = this.tableName(def.table);
     const selectSql = this.select(def.recordsSelectQuery).sql;
 
-    // INSERT INTO SELECT에서 columns 추출
+    // Extract columns from INSERT INTO SELECT
     const selectDef = def.recordsSelectQuery;
     const colList =
       selectDef.select != null
@@ -248,7 +248,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
 
     let sql = `UPDATE ${table} AS ${alias} SET ${setParts.join(", ")}`;
 
-    // PostgreSQL: JOIN은 FROM 절로 processing
+    // PostgreSQL: JOINs are handled via FROM clause
     if (def.joins != null && def.joins.length > 0) {
       const joinTables = def.joins.map((j) => {
         const from = this.renderFrom(j.from);
@@ -256,7 +256,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
       });
       sql += ` FROM ${joinTables.join(", ")}`;
 
-      // JOIN ON 조건을 WHERE에 Add
+      // Add JOIN ON conditions to WHERE
       const joinConditions = def.joins
         .filter((j) => j.where != null && j.where.length > 0)
         .map((j) => this.expr.renderWhere(j.where!));
@@ -292,7 +292,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
 
     let sql = `DELETE FROM ${table} AS ${alias}`;
 
-    // PostgreSQL: JOIN은 USING 절로 processing
+    // PostgreSQL: JOINs are handled via USING clause
     if (def.joins != null && def.joins.length > 0) {
       const joinTables = def.joins.map((j) => {
         const from = this.renderFrom(j.from);
@@ -300,7 +300,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
       });
       sql += ` USING ${joinTables.join(", ")}`;
 
-      // JOIN ON 조건을 WHERE에 Add
+      // Add JOIN ON conditions to WHERE
       const joinConditions = def.joins
         .filter((j) => j.where != null && j.where.length > 0)
         .map((j) => this.expr.renderWhere(j.where!));
@@ -317,7 +317,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
       sql += this.renderWhere(def.where);
     }
 
-    // RETURNING (PostgreSQL: DELETE에서도 지원)
+    // RETURNING (PostgreSQL: also supported for DELETE)
     if (def.output != null) {
       const outputCols = def.output.columns.map((c) => this.expr.wrap(c)).join(", ");
       sql += ` RETURNING ${outputCols}`;
@@ -331,7 +331,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   //#region ========== DML - UPSERT ==========
 
   protected upsert(def: UpsertQueryDef): QueryBuildResult {
-    // PostgreSQL: CTE 방식 (ON CONFLICT는 단일 unique 제약만 지원하므로 범용성 위해 CTE 사용)
+    // PostgreSQL: CTE approach (uses CTE for generality since ON CONFLICT only supports single unique constraint)
     const table = this.tableName(def.table);
     const alias = this.expr.wrap(def.existsSelectQuery.as);
 
@@ -355,7 +355,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
     const outputCols =
       def.output != null ? def.output.columns.map((c) => this.expr.wrap(c)).join(", ") : "*";
 
-    // CTE 방식 UPSERT
+    // CTE-based UPSERT
     let sql = `WITH matched AS (\n`;
     sql += `  SELECT ${alias}.* FROM ${table} AS ${alias} WHERE ${whereCondition}\n`;
     sql += `),\n`;
@@ -424,7 +424,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   }
 
   protected truncate(def: TruncateQueryDef): QueryBuildResult {
-    // PostgreSQL: RESTART IDENTITY로 시퀀스 리셋
+    // PostgreSQL: reset sequence with RESTART IDENTITY
     return { sql: `TRUNCATE TABLE ${this.tableName(def.table)} RESTART IDENTITY` };
   }
 
@@ -466,22 +466,22 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
     const table = this.tableName(def.table);
     const col = def.column;
 
-    // PostgreSQL: ALTER COLUMN은 여러 ALTER 필요
+    // PostgreSQL: ALTER COLUMN requires multiple ALTER statements
     const parts: string[] = [];
 
-    // TYPE 변경
+    // Change TYPE
     parts.push(
       `ALTER COLUMN ${this.expr.wrap(col.name)} TYPE ${this.expr.renderDataType(col.dataType)}`,
     );
 
-    // NULL 변경
+    // Change NULL constraint
     if (col.nullable === false) {
       parts.push(`ALTER COLUMN ${this.expr.wrap(col.name)} SET NOT NULL`);
     } else {
       parts.push(`ALTER COLUMN ${this.expr.wrap(col.name)} DROP NOT NULL`);
     }
 
-    // DEFAULT 변경
+    // Change DEFAULT
     if (col.default !== undefined) {
       parts.push(
         `ALTER COLUMN ${this.expr.wrap(col.name)} SET DEFAULT ${this.expr.escapeValue(col.default)}`,
@@ -526,7 +526,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
 
     let sql = `ALTER TABLE ${table} ADD CONSTRAINT ${this.expr.wrap(fk.name)} FOREIGN KEY (${fkCols}) REFERENCES ${targetTable} (${targetCols})`;
 
-    // PostgreSQL: FK용 Index 별도 Generate 필요
+    // PostgreSQL: separate index generation needed for FK
     const idxName = `IDX_${def.table.name}_${fk.name.replace(/^FK_/, "")}`;
     sql += `;\nCREATE INDEX ${this.expr.wrap(idxName)} ON ${table} (${fkCols});`;
 
@@ -548,7 +548,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   }
 
   protected dropIndex(def: DropIndexQueryDef): QueryBuildResult {
-    // PostgreSQL: Index는 schema 레벨에서 유니크하므로 Table명 불필요하지만 스키마는 명시 필요
+    // PostgreSQL: indexes are unique at schema level so table name is not needed, but schema must be specified
     const schema = def.table.schema ?? "public";
     return { sql: `DROP INDEX ${this.expr.wrap(schema)}.${this.expr.wrap(def.index)}` };
   }
@@ -570,7 +570,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
   protected createProc(def: CreateProcQueryDef): QueryBuildResult {
     const proc = this.tableName(def.procedure);
 
-    // params processing
+    // Process params
     const paramList =
       def.params
         ?.map((p) => {
@@ -582,7 +582,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
         })
         .join(", ") ?? "";
 
-    // returns processing
+    // Process returns
     let returnClause = "VOID";
     if (def.returns && def.returns.length > 0) {
       const returnFields = def.returns
@@ -625,7 +625,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
 
   protected clearSchema(def: ClearSchemaQueryDef): QueryBuildResult {
     const schemaName = def.schema ?? "public";
-    // SQL Injection 방어: 스키마명 유효성 Validation
+    // SQL injection prevention: schema name validation
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(schemaName)) {
       throw new Error(`Invalid schema name: ${schemaName}`);
     }
@@ -636,7 +636,7 @@ DO $$
 DECLARE
   r RECORD;
 BEGIN
-  -- FK constraint Delete
+  -- Drop FK constraints
   FOR r IN (SELECT conname, conrelid::regclass AS tablename
             FROM pg_constraint
             WHERE contype = 'f' AND connamespace = '${schema}'::regnamespace)
@@ -644,19 +644,19 @@ BEGIN
     EXECUTE 'ALTER TABLE ' || r.tablename || ' DROP CONSTRAINT ' || quote_ident(r.conname);
   END LOOP;
 
-  -- Drop table
+  -- Drop tables
   FOR r IN (SELECT tablename FROM pg_tables WHERE schemaname = '${schema}')
   LOOP
     EXECUTE 'DROP TABLE IF EXISTS ' || quote_ident(r.tablename) || ' CASCADE';
   END LOOP;
 
-  -- Drop view
+  -- Drop views
   FOR r IN (SELECT viewname FROM pg_views WHERE schemaname = '${schema}')
   LOOP
     EXECUTE 'DROP VIEW IF EXISTS ' || quote_ident(r.viewname) || ' CASCADE';
   END LOOP;
 
-  -- function Delete
+  -- Drop functions
   FOR r IN (SELECT proname, pg_get_function_identity_arguments(oid) AS args
             FROM pg_proc WHERE pronamespace = '${schema}'::regnamespace)
   LOOP
@@ -675,10 +675,10 @@ END $$`,
   protected switchFk(def: SwitchFkQueryDef): QueryBuildResult {
     const table = this.tableName(def.table);
     if (def.enabled) {
-      // PostgreSQL: Table의 모든 FK 트리거 Enable
+      // PostgreSQL: enable all FK triggers on the table
       return { sql: `ALTER TABLE ${table} ENABLE TRIGGER ALL` };
     }
-    // PostgreSQL: Table의 모든 FK 트리거 Disable
+    // PostgreSQL: disable all FK triggers on the table
     return { sql: `ALTER TABLE ${table} DISABLE TRIGGER ALL` };
   }
 

package/src/query-builder/query-builder.ts

@@ -5,7 +5,7 @@ import { MysqlQueryBuilder } from "./mysql/mysql-query-builder";
 import { PostgresqlQueryBuilder } from "./postgresql/postgresql-query-builder";
 
 /**
- * Dialect에 맞는 QueryBuilder instance Generate
+ * Generate a QueryBuilder instance matching the given Dialect
  */
 export function createQueryBuilder(dialect: Dialect): QueryBuilderBase {
   switch (dialect) {

package/src/schema/factory/column-builder.ts

@@ -10,8 +10,8 @@ import type { DataRecord } from "../../types/db";
 /**
  * Column definition builder
  *
- * Fluent API를 통해 column의 type, nullable, autoIncrement, default, description을 definition
- * TableBuilder.columns()used in
+ * Define column type, nullable, autoIncrement, default, and description via Fluent API
+ * Used in TableBuilder.columns()
  *
  * @template TValue - Column value type
  * @template TMeta - Column Metadata type
@@ -24,7 +24,7 @@ import type { DataRecord } from "../../types/db";
  *     name: c.varchar(100),                     // varchar(100), required
  *     email: c.varchar(200).nullable(),         // varchar(200), nullable
  *     status: c.varchar(20).default("active"),  // varchar(20), default value
- *     createdAt: c.datetime().description("생성일시"),
+ *     createdAt: c.datetime().description("created datetime"),
  *   }));
  * ```
  *
@@ -38,9 +38,9 @@ export class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends ColumnM
   constructor(readonly meta: TMeta) {}
 
   /**
-   * Auto Increment 설정
+   * Auto Increment configuration
    *
-   * INSERT 시 Auto increment. INSERT용 Type inference에서 optional로 processing
+   * Auto increments on INSERT. Treated as optional in INSERT Type inference
    *
    * @returns new ColumnBuilder instance
    *
@@ -54,9 +54,9 @@ export class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends ColumnM
   }
 
   /**
-   * Nullable 설정
+   * Nullable configuration
    *
-   * Allow NULL. value 타입에 undefined Add
+   * Allow NULL. Adds undefined to the value type
    *
    * @returns new ColumnBuilder instance
    *
@@ -70,9 +70,9 @@ export class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends ColumnM
   }
 
   /**
-   * Default value 설정
+   * Default value configuration
    *
-   * INSERT 시 value 미지정 시 사용. INSERT용 Type inference에서 optional로 processing
+   * Used when no value is specified on INSERT. Treated as optional in INSERT Type inference
    *
    * @param value - Default value
    * @returns new ColumnBuilder instance
@@ -92,12 +92,12 @@ export class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends ColumnM
   /**
    * column set description
    *
-   * @param desc - Column description (DDL Comment으로 사용)
+   * @param desc - Column description (used as DDL Comment)
    * @returns new ColumnBuilder instance
    *
    * @example
    * ```typescript
-   * createdAt: c.datetime().description("레코드 Generate 일시")
+   * createdAt: c.datetime().description("record creation datetime")
    * ```
    */
   description(desc: string): ColumnBuilder<TValue, TMeta & { description: string }> {
@@ -110,12 +110,12 @@ export class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends ColumnM
 // ============================================
 
 /**
- * Column builder factory Generate
+ * Column builder factory creation
  *
- * TableBuilder.columns()used in하는 Column type factory
- * 모든 Basic data type에 대한 builder Generate method 제공
+ * Column type factory used in TableBuilder.columns()
+ * Provides builder creation methods for all basic data types
  *
- * @returns Column type별 builder Generate 메서드를 포함한 object
+ * @returns Object containing builder creation methods for each Column type
  *
  * @example
  * ```typescript
@@ -126,12 +126,12 @@ export class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends ColumnM
  *     count: c.int(),
  *     price: c.decimal(10, 2),
  *
- *     // 문자열 type
+ *     // String type
  *     name: c.varchar(100),
  *     code: c.char(10),
  *     content: c.text(),
  *
- *     // Date/시간 type
+ *     // Date/time type
  *     createdAt: c.datetime(),
  *     birthDate: c.date(),
  *     startTime: c.time(),
@@ -166,7 +166,7 @@ export function createColumnFactory() {
     },
 
     /**
-     * FLOAT column (4 bytes, 단정밀도 부동소수점)
+     * FLOAT column (4 bytes, single-precision floating point)
      *
      * @returns ColumnBuilder instance
      */
@@ -175,7 +175,7 @@ export function createColumnFactory() {
     },
 
     /**
-     * DOUBLE column (8 bytes, 배정밀도 부동소수점)
+     * DOUBLE column (8 bytes, double-precision floating point)
      *
      * @returns ColumnBuilder instance
      */
@@ -184,10 +184,10 @@ export function createColumnFactory() {
     },
 
     /**
-     * DECIMAL column (고정 소수점)
+     * DECIMAL column (fixed-point)
      *
-     * @param precision - 전체 자릿수
-     * @param scale - 소수점 이하 자릿수 (Select)
+     * @param precision - Total number of digits
+     * @param scale - Number of digits after the decimal point (optional)
      * @returns ColumnBuilder instance
      *
      * @example
@@ -206,9 +206,9 @@ export function createColumnFactory() {
     },
 
     /**
-     * VARCHAR column (가변 길이 문자열)
+     * VARCHAR column (variable-length string)
      *
-     * @param length - 최대 길이
+     * @param length - Maximum length
      * @returns ColumnBuilder instance
      *
      * @example
@@ -223,9 +223,9 @@ export function createColumnFactory() {
     },
 
     /**
-     * CHAR column (고정 길이 문자열)
+     * CHAR column (fixed-length string)
      *
-     * @param length - 고정 길이
+     * @param length - Fixed length
      * @returns ColumnBuilder instance
      *
      * @example
@@ -240,7 +240,7 @@ export function createColumnFactory() {
     },
 
     /**
-     * TEXT column (대용량 문자열)
+     * TEXT column (large text)
      *
      * @returns ColumnBuilder instance
      */
@@ -249,9 +249,9 @@ export function createColumnFactory() {
     },
 
     /**
-     * BINARY column (바이너리 data)
+     * BINARY column (binary data)
      *
-     * DBMS별: MySQL=LONGBLOB, MSSQL=VARBINARY(MAX), PostgreSQL=BYTEA
+     * Per DBMS: MySQL=LONGBLOB, MSSQL=VARBINARY(MAX), PostgreSQL=BYTEA
      *
      * @returns ColumnBuilder instance
      */
@@ -262,7 +262,7 @@ export function createColumnFactory() {
     /**
      * BOOLEAN column
      *
-     * DBMS별: MySQL=TINYINT(1), MSSQL=BIT, PostgreSQL=BOOLEAN
+     * Per DBMS: MySQL=TINYINT(1), MSSQL=BIT, PostgreSQL=BOOLEAN
      *
      * @returns ColumnBuilder instance
      */
@@ -271,7 +271,7 @@ export function createColumnFactory() {
     },
 
     /**
-     * DATETIME column (Date + 시간)
+     * DATETIME column (date + time)
      *
      * @returns ColumnBuilder instance
      */
@@ -280,7 +280,7 @@ export function createColumnFactory() {
     },
 
     /**
-     * DATE column (Date만)
+     * DATE column (date only)
      *
      * @returns ColumnBuilder instance
      */
@@ -289,7 +289,7 @@ export function createColumnFactory() {
     },
 
     /**
-     * TIME column (시간만)
+     * TIME column (time only)
      *
      * @returns ColumnBuilder instance
      */
@@ -300,7 +300,7 @@ export function createColumnFactory() {
     /**
      * UUID column
      *
-     * DBMS별: MySQL=BINARY(16), MSSQL=UNIQUEIDENTIFIER, PostgreSQL=UUID
+     * Per DBMS: MySQL=BINARY(16), MSSQL=UNIQUEIDENTIFIER, PostgreSQL=UUID
      *
      * @returns ColumnBuilder instance
      */
@@ -311,22 +311,22 @@ export function createColumnFactory() {
 }
 
 // ============================================
-// ColumnDefRecord - Column builder 레코드
+// ColumnDefRecord - Column builder record
 // ============================================
 
 /**
  * Column builder record type
  *
- * TableBuilder.columns()의 return 타입으로 사용
+ * Used as the return type of TableBuilder.columns()
  */
 export type ColumnBuilderRecord = Record<string, ColumnBuilder<ColumnPrimitive, ColumnMeta>>;
 
 // ============================================
-// Infer - Type inference 유틸리티
+// Infer - Type inference utilities
 // ============================================
 
 /**
- * Column builder 레코드에서 실제 value Type inference
+ * Infer actual value types from a Column builder record
  *
  * @template T - Column builder record type
  *
@@ -341,7 +341,7 @@ export type InferColumns<TBuilders extends ColumnBuilderRecord> = {
 };
 
 /**
- * Column builder 레코드에서 expression 입력 Type inference
+ * Infer expression input types from a Column builder record
  *
  * @template T - Column builder record type
  */
@@ -350,9 +350,9 @@ export type InferColumnExprs<TBuilders extends ColumnBuilderRecord> = {
 };
 
 /**
- * INSERT 시 required column key 추출
+ * Extract required column keys for INSERT
  *
- * autoIncrement, nullable, default가 없는 column만 required
+ * Only columns without autoIncrement, nullable, or default are required
  *
  * @template T - Column builder record type
  */
@@ -369,9 +369,9 @@ export type RequiredInsertKeys<TBuilders extends ColumnBuilderRecord> = {
 }[keyof TBuilders];
 
 /**
- * INSERT 시 optional column key 추출
+ * Extract optional column keys for INSERT
  *
- * autoIncrement, nullable, default가 있는 column은 optional
+ * Columns with autoIncrement, nullable, or default are optional
  *
  * @template T - Column builder record type
  */
@@ -381,9 +381,9 @@ export type OptionalInsertKeys<TBuilders extends ColumnBuilderRecord> = Exclude<
 >;
 
 /**
- * INSERT용 Type inference
+ * INSERT Type inference
  *
- * required column은 required, optional column은 Partial
+ * Required columns are required, optional columns are Partial
  *
  * @template T - Column builder record type
  *
@@ -400,9 +400,9 @@ export type InferInsertColumns<TBuilders extends ColumnBuilderRecord> = Pick<
   Partial<Pick<InferColumns<TBuilders>, OptionalInsertKeys<TBuilders>>>;
 
 /**
- * UPDATE용 Type inference
+ * UPDATE Type inference
  *
- * 모든 column이 optional
+ * All columns are optional
  *
  * @template T - Column builder record type
  */
@@ -411,7 +411,7 @@ export type InferUpdateColumns<TBuilders extends ColumnBuilderRecord> = Partial<
 >;
 
 /**
- * data 레코드에서 Column builder 레코드로 Transform
+ * Transform from data record to Column builder record
  *
  * @template TData - data record type
  */