@simplysm/orm-common 13.0.83 → 13.0.84

package/dist/schema/factory/column-builder.d.ts

@@ -5,8 +5,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
@@ -19,7 +19,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"),
  *   }));
  * ```
  *
@@ -33,9 +33,9 @@ export declare class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends
      */
     constructor(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
      *
@@ -48,9 +48,9 @@ export declare class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends
         autoIncrement: true;
     }>;
     /**
-     * Nullable 설정
+     * Nullable configuration
      *
-     * Allow NULL. value 타입에 undefined Add
+     * Allow NULL. Adds undefined to the value type
      *
      * @returns new ColumnBuilder instance
      *
@@ -63,9 +63,9 @@ export declare class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends
         nullable: true;
     }>;
     /**
-     * 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
@@ -82,12 +82,12 @@ export declare class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends
     /**
      * 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 & {
@@ -95,12 +95,12 @@ export declare class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends
     }>;
 }
 /**
- * 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
@@ -111,12 +111,12 @@ export declare class ColumnBuilder<TValue extends ColumnPrimitive, TMeta extends
  *     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(),
@@ -154,7 +154,7 @@ export declare function createColumnFactory(): {
         };
     }>;
     /**
-     * FLOAT column (4 bytes, 단정밀도 부동소수점)
+     * FLOAT column (4 bytes, single-precision floating point)
      *
      * @returns ColumnBuilder instance
      */
@@ -165,7 +165,7 @@ export declare function createColumnFactory(): {
         };
     }>;
     /**
-     * DOUBLE column (8 bytes, 배정밀도 부동소수점)
+     * DOUBLE column (8 bytes, double-precision floating point)
      *
      * @returns ColumnBuilder instance
      */
@@ -176,10 +176,10 @@ export declare 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
@@ -196,9 +196,9 @@ export declare function createColumnFactory(): {
         };
     }>;
     /**
-     * VARCHAR column (가변 길이 문자열)
+     * VARCHAR column (variable-length string)
      *
-     * @param length - 최대 길이
+     * @param length - Maximum length
      * @returns ColumnBuilder instance
      *
      * @example
@@ -214,9 +214,9 @@ export declare function createColumnFactory(): {
         };
     }>;
     /**
-     * CHAR column (고정 길이 문자열)
+     * CHAR column (fixed-length string)
      *
-     * @param length - 고정 길이
+     * @param length - Fixed length
      * @returns ColumnBuilder instance
      *
      * @example
@@ -232,7 +232,7 @@ export declare function createColumnFactory(): {
         };
     }>;
     /**
-     * TEXT column (대용량 문자열)
+     * TEXT column (large text)
      *
      * @returns ColumnBuilder instance
      */
@@ -243,9 +243,9 @@ export declare 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
      */
@@ -258,7 +258,7 @@ export declare function createColumnFactory(): {
     /**
      * BOOLEAN column
      *
-     * DBMS별: MySQL=TINYINT(1), MSSQL=BIT, PostgreSQL=BOOLEAN
+     * Per DBMS: MySQL=TINYINT(1), MSSQL=BIT, PostgreSQL=BOOLEAN
      *
      * @returns ColumnBuilder instance
      */
@@ -269,7 +269,7 @@ export declare function createColumnFactory(): {
         };
     }>;
     /**
-     * DATETIME column (Date + 시간)
+     * DATETIME column (date + time)
      *
      * @returns ColumnBuilder instance
      */
@@ -280,7 +280,7 @@ export declare function createColumnFactory(): {
         };
     }>;
     /**
-     * DATE column (Date만)
+     * DATE column (date only)
      *
      * @returns ColumnBuilder instance
      */
@@ -291,7 +291,7 @@ export declare function createColumnFactory(): {
         };
     }>;
     /**
-     * TIME column (시간만)
+     * TIME column (time only)
      *
      * @returns ColumnBuilder instance
      */
@@ -304,7 +304,7 @@ export declare function createColumnFactory(): {
     /**
      * UUID column
      *
-     * DBMS별: MySQL=BINARY(16), MSSQL=UNIQUEIDENTIFIER, PostgreSQL=UUID
+     * Per DBMS: MySQL=BINARY(16), MSSQL=UNIQUEIDENTIFIER, PostgreSQL=UUID
      *
      * @returns ColumnBuilder instance
      */
@@ -318,11 +318,11 @@ export declare function createColumnFactory(): {
 /**
  * Column builder record type
  *
- * TableBuilder.columns()의 return 타입으로 사용
+ * Used as the return type of TableBuilder.columns()
  */
 export type ColumnBuilderRecord = Record<string, ColumnBuilder<ColumnPrimitive, ColumnMeta>>;
 /**
- * Column builder 레코드에서 실제 value Type inference
+ * Infer actual value types from a Column builder record
  *
  * @template T - Column builder record type
  *
@@ -336,7 +336,7 @@ export type InferColumns<TBuilders extends ColumnBuilderRecord> = {
     [K in keyof TBuilders]: TBuilders[K] extends ColumnBuilder<infer V, any> ? V : never;
 };
 /**
- * Column builder 레코드에서 expression 입력 Type inference
+ * Infer expression input types from a Column builder record
  *
  * @template T - Column builder record type
  */
@@ -344,9 +344,9 @@ export type InferColumnExprs<TBuilders extends ColumnBuilderRecord> = {
     [K in keyof TBuilders]: TBuilders[K] extends ColumnBuilder<infer V, any> ? ExprInput<V> : never;
 };
 /**
- * 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
  */
@@ -354,17 +354,17 @@ export type RequiredInsertKeys<TBuilders extends ColumnBuilderRecord> = {
     [K in keyof TBuilders]: TBuilders[K]["meta"] extends infer M extends ColumnMeta ? M["autoIncrement"] extends true ? never : M["nullable"] extends true ? never : M["default"] extends undefined ? K : never : never;
 }[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
  */
 export type OptionalInsertKeys<TBuilders extends ColumnBuilderRecord> = Exclude<keyof TBuilders, RequiredInsertKeys<TBuilders>>;
 /**
- * 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
  *
@@ -376,15 +376,15 @@ export type OptionalInsertKeys<TBuilders extends ColumnBuilderRecord> = Exclude<
  */
 export type InferInsertColumns<TBuilders extends ColumnBuilderRecord> = Pick<InferColumns<TBuilders>, RequiredInsertKeys<TBuilders>> & Partial<Pick<InferColumns<TBuilders>, OptionalInsertKeys<TBuilders>>>;
 /**
- * UPDATE용 Type inference
+ * UPDATE Type inference
  *
- * 모든 column이 optional
+ * All columns are optional
  *
  * @template T - Column builder record type
  */
 export type InferUpdateColumns<TBuilders extends ColumnBuilderRecord> = Partial<InferColumns<TBuilders>>;
 /**
- * data 레코드에서 Column builder 레코드로 Transform
+ * Transform from data record to Column builder record
  *
  * @template TData - data record type
  */

package/dist/schema/factory/column-builder.js

@@ -6,9 +6,9 @@ class ColumnBuilder {
     this.meta = meta;
   }
   /**
-   * 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
    *
@@ -21,9 +21,9 @@ class ColumnBuilder {
     return new ColumnBuilder({ ...this.meta, autoIncrement: true });
   }
   /**
-   * Nullable 설정
+   * Nullable configuration
    *
-   * Allow NULL. value 타입에 undefined Add
+   * Allow NULL. Adds undefined to the value type
    *
    * @returns new ColumnBuilder instance
    *
@@ -36,9 +36,9 @@ class ColumnBuilder {
     return new ColumnBuilder({ ...this.meta, nullable: true });
   }
   /**
-   * 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
@@ -55,12 +55,12 @@ class ColumnBuilder {
   /**
    * 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) {
@@ -86,7 +86,7 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "number", dataType: { type: "bigint" } });
     },
     /**
-     * FLOAT column (4 bytes, 단정밀도 부동소수점)
+     * FLOAT column (4 bytes, single-precision floating point)
      *
      * @returns ColumnBuilder instance
      */
@@ -94,7 +94,7 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "number", dataType: { type: "float" } });
     },
     /**
-     * DOUBLE column (8 bytes, 배정밀도 부동소수점)
+     * DOUBLE column (8 bytes, double-precision floating point)
      *
      * @returns ColumnBuilder instance
      */
@@ -102,10 +102,10 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "number", dataType: { type: "double" } });
     },
     /**
-     * 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
@@ -117,9 +117,9 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "number", dataType: { type: "decimal", precision, scale } });
     },
     /**
-     * VARCHAR column (가변 길이 문자열)
+     * VARCHAR column (variable-length string)
      *
-     * @param length - 최대 길이
+     * @param length - Maximum length
      * @returns ColumnBuilder instance
      *
      * @example
@@ -131,9 +131,9 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "string", dataType: { type: "varchar", length } });
     },
     /**
-     * CHAR column (고정 길이 문자열)
+     * CHAR column (fixed-length string)
      *
-     * @param length - 고정 길이
+     * @param length - Fixed length
      * @returns ColumnBuilder instance
      *
      * @example
@@ -145,7 +145,7 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "string", dataType: { type: "char", length } });
     },
     /**
-     * TEXT column (대용량 문자열)
+     * TEXT column (large text)
      *
      * @returns ColumnBuilder instance
      */
@@ -153,9 +153,9 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "string", dataType: { type: "text" } });
     },
     /**
-     * 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
      */
@@ -165,7 +165,7 @@ function createColumnFactory() {
     /**
      * BOOLEAN column
      *
-     * DBMS별: MySQL=TINYINT(1), MSSQL=BIT, PostgreSQL=BOOLEAN
+     * Per DBMS: MySQL=TINYINT(1), MSSQL=BIT, PostgreSQL=BOOLEAN
      *
      * @returns ColumnBuilder instance
      */
@@ -173,7 +173,7 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "boolean", dataType: { type: "boolean" } });
     },
     /**
-     * DATETIME column (Date + 시간)
+     * DATETIME column (date + time)
      *
      * @returns ColumnBuilder instance
      */
@@ -181,7 +181,7 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "DateTime", dataType: { type: "datetime" } });
     },
     /**
-     * DATE column (Date만)
+     * DATE column (date only)
      *
      * @returns ColumnBuilder instance
      */
@@ -189,7 +189,7 @@ function createColumnFactory() {
       return new ColumnBuilder({ type: "DateOnly", dataType: { type: "date" } });
     },
     /**
-     * TIME column (시간만)
+     * TIME column (time only)
      *
      * @returns ColumnBuilder instance
      */
@@ -199,7 +199,7 @@ function createColumnFactory() {
     /**
      * UUID column
      *
-     * DBMS별: MySQL=BINARY(16), MSSQL=UNIQUEIDENTIFIER, PostgreSQL=UUID
+     * Per DBMS: MySQL=BINARY(16), MSSQL=UNIQUEIDENTIFIER, PostgreSQL=UUID
      *
      * @returns ColumnBuilder instance
      */

package/dist/schema/factory/index-builder.d.ts

@@ -1,8 +1,8 @@
 /**
  * Index definition builder
  *
- * Fluent API를 통해 Index의 column, 유니크 여부, sorting 순서를 definition
- * TableBuilder.indexes()used in
+ * Define Index columns, uniqueness, and sort order via Fluent API
+ * Used in TableBuilder.indexes()
  *
  * @template TKeys - Index column key array type
  *
@@ -16,13 +16,13 @@
  *     createdAt: c.datetime(),
  *   }))
  *   .indexes((i) => [
- *     // 유니크 Index
+ *     // Unique index
  *     i.index("email").unique(),
  *
- *     // 복합 Index + sorting order
+ *     // Composite index + sort order
  *     i.index("name", "createdAt").orderBy("ASC", "DESC"),
  *
- *     // 커스텀 이름
+ *     // Custom name
  *     i.index("createdAt").name("IX_User_CreatedAt"),
  *   ]);
  * ```
@@ -43,9 +43,9 @@ export declare class IndexBuilder<TKeys extends string[]> {
     /**
      * @param meta - Index Metadata
      * @param meta.columns - Index column array
-     * @param meta.name - Index 이름 (Select)
-     * @param meta.unique - 유니크 Index 여부
-     * @param meta.orderBy - Column별 sorting order
+     * @param meta.name - Index name (optional)
+     * @param meta.unique - Whether it is a unique index
+     * @param meta.orderBy - Sort order per column
      * @param meta.description - Index description
      */
     constructor(meta: {
@@ -60,7 +60,7 @@ export declare class IndexBuilder<TKeys extends string[]> {
     /**
      * Index set name
      *
-     * @param name - Index 이름
+     * @param name - Index name
      * @returns new IndexBuilder instance
      *
      * @example
@@ -70,7 +70,7 @@ export declare class IndexBuilder<TKeys extends string[]> {
      */
     name(name: string): IndexBuilder<TKeys>;
     /**
-     * 유니크 Index 설정
+     * Unique index configuration
      *
      * @returns new IndexBuilder instance
      *
@@ -81,19 +81,19 @@ export declare class IndexBuilder<TKeys extends string[]> {
      */
     unique(): IndexBuilder<TKeys>;
     /**
-     * sorting order 설정
+     * Sort order configuration
      *
-     * 각 column에 대해 ASC 또는 DESC 지정
+     * Specify ASC or DESC for each column
      *
-     * @param orderBy - Column별 sorting order (column 수와 동일해야 함)
+     * @param orderBy - Sort order per column (must match the number of columns)
      * @returns new IndexBuilder instance
      *
      * @example
      * ```typescript
-     * // 단일 column
+     * // Single column
      * i.index("createdAt").orderBy("DESC")
      *
-     * // 복합 column
+     * // Composite column
      * i.index("status", "createdAt").orderBy("ASC", "DESC")
      * ```
      */
@@ -103,18 +103,18 @@ export declare class IndexBuilder<TKeys extends string[]> {
     /**
      * Index set description
      *
-     * @param description - Index description (DDL Comment으로 사용)
+     * @param description - Index description (used as DDL Comment)
      * @returns new IndexBuilder instance
      */
     description(description: string): IndexBuilder<TKeys>;
 }
 /**
- * Index builder factory Generate
+ * Index builder factory creation
  *
- * TableBuilder.indexes()used in하는 Index factory
+ * Index factory used in TableBuilder.indexes()
  *
  * @template TColumnKey - Table column key type
- * @returns Index Generate 메서드를 포함한 object
+ * @returns Object containing Index creation methods
  *
  * @example
  * ```typescript
@@ -137,13 +137,13 @@ export declare function createIndexFactory<TColumnKey extends string>(): {
      * Index Generate
      *
      * @template TKeys - Index column key array type
-     * @param columns - Index column명들
+     * @param columns - Index column names
      * @returns IndexBuilder instance
      *
      * @example
      * ```typescript
-     * i.index("email")          // 단일 column
-     * i.index("name", "email")  // 복합 column
+     * i.index("email")          // Single column
+     * i.index("name", "email")  // Composite column
      * ```
      */
     index<TKeys extends TColumnKey[]>(...columns: TKeys): IndexBuilder<TKeys>;

package/dist/schema/factory/index-builder.js

@@ -2,9 +2,9 @@ class IndexBuilder {
   /**
    * @param meta - Index Metadata
    * @param meta.columns - Index column array
-   * @param meta.name - Index 이름 (Select)
-   * @param meta.unique - 유니크 Index 여부
-   * @param meta.orderBy - Column별 sorting order
+   * @param meta.name - Index name (optional)
+   * @param meta.unique - Whether it is a unique index
+   * @param meta.orderBy - Sort order per column
    * @param meta.description - Index description
    */
   constructor(meta) {
@@ -13,7 +13,7 @@ class IndexBuilder {
   /**
    * Index set name
    *
-   * @param name - Index 이름
+   * @param name - Index name
    * @returns new IndexBuilder instance
    *
    * @example
@@ -25,7 +25,7 @@ class IndexBuilder {
     return new IndexBuilder({ ...this.meta, name });
   }
   /**
-   * 유니크 Index 설정
+   * Unique index configuration
    *
    * @returns new IndexBuilder instance
    *
@@ -38,19 +38,19 @@ class IndexBuilder {
     return new IndexBuilder({ ...this.meta, unique: true });
   }
   /**
-   * sorting order 설정
+   * Sort order configuration
    *
-   * 각 column에 대해 ASC 또는 DESC 지정
+   * Specify ASC or DESC for each column
    *
-   * @param orderBy - Column별 sorting order (column 수와 동일해야 함)
+   * @param orderBy - Sort order per column (must match the number of columns)
    * @returns new IndexBuilder instance
    *
    * @example
    * ```typescript
-   * // 단일 column
+   * // Single column
    * i.index("createdAt").orderBy("DESC")
    *
-   * // 복합 column
+   * // Composite column
    * i.index("status", "createdAt").orderBy("ASC", "DESC")
    * ```
    */
@@ -60,7 +60,7 @@ class IndexBuilder {
   /**
    * Index set description
    *
-   * @param description - Index description (DDL Comment으로 사용)
+   * @param description - Index description (used as DDL Comment)
    * @returns new IndexBuilder instance
    */
   description(description) {
@@ -73,13 +73,13 @@ function createIndexFactory() {
      * Index Generate
      *
      * @template TKeys - Index column key array type
-     * @param columns - Index column명들
+     * @param columns - Index column names
      * @returns IndexBuilder instance
      *
      * @example
      * ```typescript
-     * i.index("email")          // 단일 column
-     * i.index("name", "email")  // 복합 column
+     * i.index("email")          // Single column
+     * i.index("name", "email")  // Composite column
      * ```
      */
     index(...columns) {