@simplysm/orm-common 13.0.100 → 14.0.1

package/src/query-builder/mssql/mssql-expr-renderer.ts

@@ -69,22 +69,22 @@ import type { DataType } from "../../types/column";
 import { ExprRendererBase } from "../base/expr-renderer-base";
 
 /**
- * MSSQL expression renderer
+ * MSSQL 표현식 렌더러
  */
 export class MssqlExprRenderer extends ExprRendererBase {
-  //#region ========== Utilities (public - also used by QueryBuilder) ==========
+  //#region ========== 유틸리티 (public - QueryBuilder에서도 사용) ==========
 
-  /** Wrap identifier */
+  /** 식별자 감싸기 */
   wrap(name: string): string {
     return `[${name.replace(/]/g, "]]")}]`;
   }
 
-  /** Escape for SQL string literals (returns without quotes) */
+  /** SQL 문자열 리터럴용 이스케이프 (따옴표 제외) */
   escapeString(value: string): string {
     return value.replace(/'/g, "''");
   }
 
-  /** Value escape */
+  /** 값 이스케이프 */
   escapeValue(value: unknown): string {
     if (value == null) {
       return "NULL";
@@ -113,7 +113,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
     if (value instanceof Uint8Array) {
       return `0x${bytes.toHex(value)}`;
     }
-    throw new Error(`Unknown value type: ${typeof value}`);
+    throw new Error(`알 수 없는 값 타입: ${typeof value}`);
   }
 
   /** DataType → SQL type */
@@ -217,13 +217,13 @@ export class MssqlExprRenderer extends ExprRendererBase {
   }
 
   protected like(expr: ExprLike): string {
-    // Always add ESCAPE '\'
+    // 항상 ESCAPE '\' 추가
     return `${this.render(expr.source)} LIKE ${this.render(expr.pattern)} ESCAPE '\\'`;
   }
 
   protected regexp(_expr: ExprRegexp): string {
-    // MSSQL does not support REGEXP - needs LIKE pattern or CLR
-    throw new Error("MSSQL does not natively support REGEXP.");
+    // MSSQL은 REGEXP을 지원하지 않음 - LIKE 패턴 또는 CLR 필요
+    throw new Error("MSSQL은 기본적으로 REGEXP을 지원하지 않습니다.");
   }
 
   protected in(expr: ExprIn): string {
@@ -502,7 +502,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   //#region ========== Other ==========
 
   protected greatest(expr: ExprGreatest): string {
-    if (expr.args.length === 0) throw new Error("greatest requires at least one argument.");
+    if (expr.args.length === 0) throw new Error("greatest에는 최소 1개의 인수가 필요합니다.");
     if (expr.args.length === 1) return this.render(expr.args[0]);
     // MSSQL 2012+: VALUES + MAX approach
     const values = expr.args.map((a) => `(${this.render(a)})`).join(", ");
@@ -510,7 +510,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   }
 
   protected least(expr: ExprLeast): string {
-    if (expr.args.length === 0) throw new Error("least requires at least one argument.");
+    if (expr.args.length === 0) throw new Error("least에는 최소 1개의 인수가 필요합니다.");
     if (expr.args.length === 1) return this.render(expr.args[0]);
     // MSSQL 2012+: VALUES + MIN approach
     const values = expr.args.map((a) => `(${this.render(a)})`).join(", ");

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

@@ -157,7 +157,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
     const table = this.tableName(def.table);
 
     if (def.records.length === 0) {
-      throw new Error("INSERT requires at least one record.");
+      throw new Error("INSERT에는 최소 1개의 레코드가 필요합니다.");
     }
 
     const columns = Object.keys(def.records[0]);
@@ -574,13 +574,13 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
   //#region ========== Utils ==========
 
   protected clearSchema(def: ClearSchemaQueryDef): QueryBuildResult {
-    // SQL injection prevention: identifier validation
+    // SQL 인젝션 방지: 식별자 유효성 검사
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(def.database)) {
-      throw new Error(`Invalid database name: ${def.database}`);
+      throw new Error(`잘못된 데이터베이스 이름: ${def.database}`);
     }
     const schemaName = def.schema ?? "dbo";
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(schemaName)) {
-      throw new Error(`Invalid schema name: ${schemaName}`);
+      throw new Error(`잘못된 schema 이름: ${schemaName}`);
     }
 
     const db = this.expr.wrap(def.database);
@@ -590,22 +590,22 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
 DECLARE @sql NVARCHAR(MAX);
 SET @sql = N'';
 
--- Drop FK constraints
+-- FK 제약조건 삭제
 SELECT @sql = @sql + N'ALTER TABLE ' + QUOTENAME(OBJECT_SCHEMA_NAME(parent_object_id)) + '.' + QUOTENAME(OBJECT_NAME(parent_object_id)) + N' DROP CONSTRAINT ' + QUOTENAME(name) + N';' + CHAR(13)
 FROM ${db}.sys.foreign_keys
 WHERE OBJECT_SCHEMA_NAME(parent_object_id) = '${schema}';
 
--- Drop tables
+-- 테이블 삭제
 SELECT @sql = @sql + N'DROP TABLE ' + QUOTENAME(SCHEMA_NAME(schema_id)) + '.' + QUOTENAME(name) + N';' + CHAR(13)
 FROM ${db}.sys.tables
 WHERE SCHEMA_NAME(schema_id) = '${schema}';
 
--- Drop views
+-- 뷰 삭제
 SELECT @sql = @sql + N'DROP VIEW ' + QUOTENAME(SCHEMA_NAME(schema_id)) + '.' + QUOTENAME(name) + N';' + CHAR(13)
 FROM ${db}.sys.views
 WHERE schema_id = SCHEMA_ID('${schema}');
 
--- Drop procedures
+-- 프로시저 삭제
 SELECT @sql = @sql + N'DROP PROCEDURE ' + QUOTENAME(SCHEMA_NAME(schema_id)) + '.' + QUOTENAME(name) + N';' + CHAR(13)
 FROM ${db}.sys.procedures
 WHERE SCHEMA_NAME(schema_id) = '${schema}';
@@ -615,13 +615,13 @@ EXEC sp_executesql @sql;`,
   }
 
   protected schemaExists(def: SchemaExistsQueryDef): QueryBuildResult {
-    // SQL injection prevention: identifier validation
+    // SQL 인젝션 방지: 식별자 유효성 검사
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(def.database)) {
-      throw new Error(`Invalid database name: ${def.database}`);
+      throw new Error(`잘못된 데이터베이스 이름: ${def.database}`);
     }
     const schemaName = def.schema ?? "dbo";
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(schemaName)) {
-      throw new Error(`Invalid schema name: ${schemaName}`);
+      throw new Error(`잘못된 schema 이름: ${schemaName}`);
     }
 
     const dbName = this.expr.escapeString(def.database);

package/src/query-builder/mysql/mysql-expr-renderer.ts

@@ -69,28 +69,28 @@ import type { DataType } from "../../types/column";
 import { ExprRendererBase } from "../base/expr-renderer-base";
 
 /**
- * MySQL expression renderer
+ * MySQL 표현식 렌더러
  */
 export class MysqlExprRenderer extends ExprRendererBase {
-  //#region ========== Utilities (public - also used by QueryBuilder) ==========
+  //#region ========== 유틸리티 (public - QueryBuilder에서도 사용) ==========
 
-  /** Wrap identifier */
+  /** 식별자 감싸기 */
   wrap(name: string): string {
     return `\`${name.replace(/`/g, "``")}\``;
   }
 
-  /** Escape for SQL string literals (returns without quotes) */
+  /** SQL 문자열 리터럴용 이스케이프 (따옴표 제외) */
   escapeString(value: string): string {
     return value
-      .replace(/\\/g, "\\\\") // backslash (highest priority)
-      .replace(/'/g, "''") // single quote
-      .replace(/\0/g, "\\0") // NULL byte
-      .replace(/\n/g, "\\n") // newline
-      .replace(/\r/g, "\\r") // carriage return
-      .replace(/\t/g, "\\t"); // tab
+      .replace(/\\/g, "\\\\") // 백슬래시 (최우선)
+      .replace(/'/g, "''") // 작은따옴표
+      .replace(/\0/g, "\\0") // NULL 바이트
+      .replace(/\n/g, "\\n") // 줄바꿈
+      .replace(/\r/g, "\\r") // 캐리지 리턴
+      .replace(/\t/g, "\\t"); // 탭
   }
 
-  /** value escape */
+  /** 값 이스케이프 */
   escapeValue(value: unknown): string {
     if (value == null) {
       return "NULL";
@@ -119,7 +119,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
     if (value instanceof Uint8Array) {
       return `0x${bytes.toHex(value)}`;
     }
-    throw new Error(`Unknown value type: ${typeof value}`);
+    throw new Error(`알 수 없는 값 타입: ${typeof value}`);
   }
 
   /** DataType → SQL type */
@@ -221,7 +221,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   protected like(expr: ExprLike): string {
-    // Always add ESCAPE '\'
+    // 항상 ESCAPE '\' 추가
     return `${this.render(expr.source)} LIKE ${this.render(expr.pattern)} ESCAPE '\\\\'`;
   }
 
@@ -512,12 +512,12 @@ export class MysqlExprRenderer extends ExprRendererBase {
   //#region ========== Other ==========
 
   protected greatest(expr: ExprGreatest): string {
-    if (expr.args.length === 0) throw new Error("greatest requires at least one argument.");
+    if (expr.args.length === 0) throw new Error("greatest에는 최소 1개의 인수가 필요합니다.");
     return `GREATEST(${expr.args.map((a) => this.render(a)).join(", ")})`;
   }
 
   protected least(expr: ExprLeast): string {
-    if (expr.args.length === 0) throw new Error("least requires at least one argument.");
+    if (expr.args.length === 0) throw new Error("least에는 최소 1개의 인수가 필요합니다.");
     return `LEAST(${expr.args.map((a) => this.render(a)).join(", ")})`;
   }
 

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

@@ -165,7 +165,7 @@ export class MysqlQueryBuilder extends QueryBuilderBase {
     const table = this.tableName(def.table);
 
     if (def.records.length === 0) {
-      throw new Error("INSERT requires at least one record.");
+      throw new Error("INSERT에는 최소 1개의 레코드가 필요합니다.");
     }
 
     const columns = Object.keys(def.records[0]);
@@ -721,9 +721,9 @@ export class MysqlQueryBuilder extends QueryBuilderBase {
   protected clearSchema(def: ClearSchemaQueryDef): QueryBuildResult {
     // MySQL: DROP all tables (in MySQL, database and schema are synonymous)
     // Query table list from information_schema then DROP
-    // SQL injection prevention: identifier validation
+    // SQL 인젝션 방지: 식별자 유효성 검사
     if (!/^[a-zA-Z0-9_]+$/.test(def.database)) {
-      throw new Error(`Invalid database name: ${def.database}`);
+      throw new Error(`잘못된 데이터베이스 이름: ${def.database}`);
     }
 
     const dbName = this.expr.escapeString(def.database);

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

@@ -69,22 +69,22 @@ import type { DataType } from "../../types/column";
 import { ExprRendererBase } from "../base/expr-renderer-base";
 
 /**
- * PostgreSQL expression renderer
+ * PostgreSQL 표현식 렌더러
  */
 export class PostgresqlExprRenderer extends ExprRendererBase {
-  //#region ========== Utilities (public - also used by QueryBuilder) ==========
+  //#region ========== 유틸리티 (public - QueryBuilder에서도 사용) ==========
 
-  /** Wrap identifier */
+  /** 식별자 감싸기 */
   wrap(name: string): string {
     return `"${name.replace(/"/g, '""')}"`;
   }
 
-  /** Escape for SQL string literals (returns without quotes) */
+  /** SQL 문자열 리터럴용 이스케이프 (따옴표 제외) */
   escapeString(value: string): string {
     return value.replace(/'/g, "''");
   }
 
-  /** value escape */
+  /** 값 이스케이프 */
   escapeValue(value: unknown): string {
     if (value == null) {
       return "NULL";
@@ -113,7 +113,7 @@ export class PostgresqlExprRenderer extends ExprRendererBase {
     if (value instanceof Uint8Array) {
       return `'\\x${bytes.toHex(value)}'::bytea`;
     }
-    throw new Error(`Unknown value type: ${typeof value}`);
+    throw new Error(`알 수 없는 값 타입: ${typeof value}`);
   }
 
   /** DataType → SQL type */
@@ -217,7 +217,7 @@ export class PostgresqlExprRenderer extends ExprRendererBase {
   }
 
   protected like(expr: ExprLike): string {
-    // Always add ESCAPE '\'
+    // 항상 ESCAPE '\' 추가
     return `${this.render(expr.source)} LIKE ${this.render(expr.pattern)} ESCAPE '\\'`;
   }
 
@@ -510,13 +510,13 @@ export class PostgresqlExprRenderer extends ExprRendererBase {
   //#region ========== Other ==========
 
   protected greatest(expr: ExprGreatest): string {
-    if (expr.args.length === 0) throw new Error("greatest requires at least one argument.");
+    if (expr.args.length === 0) throw new Error("greatest에는 최소 1개의 인수가 필요합니다.");
     // PostgreSQL: native GREATEST support
     return `GREATEST(${expr.args.map((a) => this.render(a)).join(", ")})`;
   }
 
   protected least(expr: ExprLeast): string {
-    if (expr.args.length === 0) throw new Error("least requires at least one argument.");
+    if (expr.args.length === 0) throw new Error("least에는 최소 1개의 인수가 필요합니다.");
     // PostgreSQL: native LEAST support
     return `LEAST(${expr.args.map((a) => this.render(a)).join(", ")})`;
   }

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

@@ -156,7 +156,7 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
     const table = this.tableName(def.table);
 
     if (def.records.length === 0) {
-      throw new Error("INSERT requires at least one record.");
+      throw new Error("INSERT에는 최소 1개의 레코드가 필요합니다.");
     }
 
     const columns = Object.keys(def.records[0]);
@@ -625,9 +625,9 @@ export class PostgresqlQueryBuilder extends QueryBuilderBase {
 
   protected clearSchema(def: ClearSchemaQueryDef): QueryBuildResult {
     const schemaName = def.schema ?? "public";
-    // SQL injection prevention: schema name validation
+    // SQL 인젝션 방지: schema 이름 유효성 검사
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(schemaName)) {
-      throw new Error(`Invalid schema name: ${schemaName}`);
+      throw new Error(`잘못된 schema 이름: ${schemaName}`);
     }
     const schema = this.expr.escapeString(schemaName);
     return {
@@ -636,7 +636,7 @@ DO $$
 DECLARE
   r RECORD;
 BEGIN
-  -- Drop FK constraints
+  -- FK 제약조건 삭제
   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 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 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;
 
-  -- Drop functions
+  -- 함수 삭제
   FOR r IN (SELECT proname, pg_get_function_identity_arguments(oid) AS args
             FROM pg_proc WHERE pronamespace = '${schema}'::regnamespace)
   LOOP

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";
 
 /**
- * Generate a QueryBuilder instance matching the given Dialect
+ * 주어진 Dialect에 맞는 QueryBuilder 인스턴스 생성
  */
 export function createQueryBuilder(dialect: Dialect): QueryBuilderBase {
   switch (dialect) {