@simplysm/orm-common 13.0.82 → 13.0.84

package/dist/schema/view-builder.d.ts

@@ -5,12 +5,12 @@ import { createRelationFactory, type InferDeepRelations, type RelationBuilderRec
 /**
  * Database View definition builder
  *
- * Fluent API를 통해 View의 query, 관계를 definition
- * DbContext에서 queryable()과 함께 사용하여 type 안전한 query 작성
+ * Define View query and relations via Fluent API
+ * Use with DbContext's queryable() for type-safe query composition
  *
  * @template TDbContext - DbContext type
  * @template TData - View data record type
- * @template TRelations - relationship definition record type
+ * @template TRelations - Relation definition record type
  *
  * @example
  * ```typescript
@@ -29,7 +29,7 @@ import { createRelationFactory, type InferDeepRelations, type RelationBuilderRec
  *       }))
  *   );
  *
- * // DbContextused in
+ * // Used in DbContext
  * class MyDb extends DbContext {
  *   readonly userSummary = queryable(this, UserSummary);
  * }
@@ -47,18 +47,18 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
         viewFn?: (db: TDbContext) => Queryable<TData, any>;
         relations?: TRelations;
     };
-    /** relationship definition (type for inference) */
+    /** Relation definition (type for inference) */
     readonly $relations: TRelations;
-    /** 전체 Type inference */
+    /** Full Type inference */
     readonly $inferSelect: TData;
     /**
      * @param meta - View Metadata
-     * @param meta.name - View 이름
-     * @param meta.description - View description (주석)
-     * @param meta.database - Database 이름
-     * @param meta.schema - Schema 이름 (MSSQL/PostgreSQL)
+     * @param meta.name - View name
+     * @param meta.description - View description (comment)
+     * @param meta.database - Database name
+     * @param meta.schema - Schema name (MSSQL/PostgreSQL)
      * @param meta.viewFn - View Query definition function
-     * @param meta.relations - relationship definition
+     * @param meta.relations - Relation definition
      */
     constructor(meta: {
         name: string;
@@ -71,14 +71,14 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
     /**
      * View set description
      *
-     * @param desc - View description (DDL Comment으로 사용)
+     * @param desc - View description (used as DDL Comment)
      * @returns new ViewBuilder instance
      */
     description(desc: string): ViewBuilder<TDbContext, TData, TRelations>;
     /**
      * Database set name
      *
-     * @param db - Database 이름
+     * @param db - Database name
      * @returns new ViewBuilder instance
      *
      * @example
@@ -90,20 +90,20 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
     /**
      * schema set name
      *
-     * MSSQL, PostgreSQLused in
+     * Used in MSSQL, PostgreSQL
      *
-     * @param schema - Schema 이름 (MSSQL: dbo, PostgreSQL: public)
+     * @param schema - Schema name (MSSQL: dbo, PostgreSQL: public)
      * @returns new ViewBuilder instance
      */
     schema(schema: string): ViewBuilder<TDbContext, TData, TRelations>;
     /**
      * View Query definition
      *
-     * SELECT query를 통해 View의 data 소스 definition
+     * Define the View's data source through a SELECT query
      *
      * @template TViewData - View data type
      * @template TDb - DbContext type
-     * @param viewFn - DbContext를 받아 Queryable을 반환하는 function
+     * @param viewFn - Function that receives a DbContext and returns a Queryable
      * @returns new ViewBuilder instance
      *
      * @example
@@ -123,12 +123,12 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
      */
     query<TViewData extends DataRecord, TDb extends DbContextBase>(viewFn: (db: TDb) => Queryable<TViewData, any>): ViewBuilder<TDb, TViewData, TRelations>;
     /**
-     * relationship definition
+     * Relation definition
      *
-     * 다른 Table/View와의 relationship 설정
+     * Set up relations with other Tables/Views
      *
-     * @template T - relationship definition type
-     * @param fn - relationship factory를 받아 relationship 정의를 반환하는 function
+     * @template T - Relation definition type
+     * @param fn - Function that receives a relation factory and returns relation definitions
      * @returns new ViewBuilder instance
      *
      * @example
@@ -141,21 +141,21 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
      * ```
      *
      * @see {@link ForeignKeyBuilder} FK builder
-     * @see {@link ForeignKeyTargetBuilder} FK 역참조 builder
+     * @see {@link ForeignKeyTargetBuilder} FK reverse-reference builder
      */
     relations<T extends RelationBuilderRecord>(fn: (r: ReturnType<typeof createRelationFactory<this, keyof TData & string>>) => T): ViewBuilder<TDbContext, TData & InferDeepRelations<T>, TRelations>;
 }
 /**
- * View builder Generate factory function
+ * View builder factory function
  *
- * ViewBuilder를 생성하여 Fluent API로 View schema definition
+ * Creates a ViewBuilder for defining View schema via Fluent API
  *
- * @param name - View 이름
+ * @param name - View name
  * @returns ViewBuilder instance
  *
  * @example
  * ```typescript
- * // Basic 사용
+ * // Basic usage
  * const ActiveUsers = View("ActiveUsers")
  *   .database("mydb")
  *   .query((db: MyDb) =>

package/dist/schema/view-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-builder.d.ts","sourceRoot":"","sources":["..\\..\\src\\schema\\view-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AAMpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,WAAW,CACtB,UAAU,SAAS,aAAa,EAChC,KAAK,SAAS,UAAU,EACxB,UAAU,SAAS,qBAAqB;IAiBtC,QAAQ,CAAC,IAAI,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnD,SAAS,CAAC,EAAE,UAAU,CAAC;KACxB;IAtBH,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAG,UAAU,CAAC;IACjC,wBAAwB;IACxB,QAAQ,CAAC,YAAY,EAAG,KAAK,CAAC;IAE9B;;;;;;;;OAQG;gBAEQ,IAAI,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnD,SAAS,CAAC,EAAE,UAAU,CAAC;KACxB;IAGH;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;IAIrE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;IAIhE;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;IAIlE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,SAAS,SAAS,UAAU,EAAE,GAAG,SAAS,aAAa,EAC3D,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,GAC7C,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC;IAI1C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,CAAC,SAAS,qBAAqB,EACvC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,GACjF,WAAW,CAAC,UAAU,EAAE,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC;CAQtE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,iEAEhC"}
+{"version":3,"file":"view-builder.d.ts","sourceRoot":"","sources":["..\\..\\src\\schema\\view-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AAMpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,WAAW,CACtB,UAAU,SAAS,aAAa,EAChC,KAAK,SAAS,UAAU,EACxB,UAAU,SAAS,qBAAqB;IAiBtC,QAAQ,CAAC,IAAI,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnD,SAAS,CAAC,EAAE,UAAU,CAAC;KACxB;IAtBH,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAG,UAAU,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAG,KAAK,CAAC;IAE9B;;;;;;;;OAQG;gBAEQ,IAAI,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnD,SAAS,CAAC,EAAE,UAAU,CAAC;KACxB;IAGH;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;IAIrE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;IAIhE;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;IAIlE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,SAAS,SAAS,UAAU,EAAE,GAAG,SAAS,aAAa,EAC3D,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,GAC7C,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC;IAI1C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,CAAC,SAAS,qBAAqB,EACvC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,GACjF,WAAW,CAAC,UAAU,EAAE,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC;CAQtE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,iEAEhC"}

package/dist/schema/view-builder.js

@@ -4,24 +4,24 @@ import {
 class ViewBuilder {
   /**
    * @param meta - View Metadata
-   * @param meta.name - View 이름
-   * @param meta.description - View description (주석)
-   * @param meta.database - Database 이름
-   * @param meta.schema - Schema 이름 (MSSQL/PostgreSQL)
+   * @param meta.name - View name
+   * @param meta.description - View description (comment)
+   * @param meta.database - Database name
+   * @param meta.schema - Schema name (MSSQL/PostgreSQL)
    * @param meta.viewFn - View Query definition function
-   * @param meta.relations - relationship definition
+   * @param meta.relations - Relation definition
    */
   constructor(meta) {
     this.meta = meta;
   }
-  /** relationship definition (type for inference) */
+  /** Relation definition (type for inference) */
   $relations;
-  /** 전체 Type inference */
+  /** Full Type inference */
   $inferSelect;
   /**
    * View set description
    *
-   * @param desc - View description (DDL Comment으로 사용)
+   * @param desc - View description (used as DDL Comment)
    * @returns new ViewBuilder instance
    */
   description(desc) {
@@ -30,7 +30,7 @@ class ViewBuilder {
   /**
    * Database set name
    *
-   * @param db - Database 이름
+   * @param db - Database name
    * @returns new ViewBuilder instance
    *
    * @example
@@ -44,9 +44,9 @@ class ViewBuilder {
   /**
    * schema set name
    *
-   * MSSQL, PostgreSQLused in
+   * Used in MSSQL, PostgreSQL
    *
-   * @param schema - Schema 이름 (MSSQL: dbo, PostgreSQL: public)
+   * @param schema - Schema name (MSSQL: dbo, PostgreSQL: public)
    * @returns new ViewBuilder instance
    */
   schema(schema) {
@@ -55,11 +55,11 @@ class ViewBuilder {
   /**
    * View Query definition
    *
-   * SELECT query를 통해 View의 data 소스 definition
+   * Define the View's data source through a SELECT query
    *
    * @template TViewData - View data type
    * @template TDb - DbContext type
-   * @param viewFn - DbContext를 받아 Queryable을 반환하는 function
+   * @param viewFn - Function that receives a DbContext and returns a Queryable
    * @returns new ViewBuilder instance
    *
    * @example
@@ -81,12 +81,12 @@ class ViewBuilder {
     return new ViewBuilder({ ...this.meta, viewFn });
   }
   /**
-   * relationship definition
+   * Relation definition
    *
-   * 다른 Table/View와의 relationship 설정
+   * Set up relations with other Tables/Views
    *
-   * @template T - relationship definition type
-   * @param fn - relationship factory를 받아 relationship 정의를 반환하는 function
+   * @template T - Relation definition type
+   * @param fn - Function that receives a relation factory and returns relation definitions
    * @returns new ViewBuilder instance
    *
    * @example
@@ -99,7 +99,7 @@ class ViewBuilder {
    * ```
    *
    * @see {@link ForeignKeyBuilder} FK builder
-   * @see {@link ForeignKeyTargetBuilder} FK 역참조 builder
+   * @see {@link ForeignKeyTargetBuilder} FK reverse-reference builder
    */
   relations(fn) {
     return new ViewBuilder({

package/dist/types/db.d.ts

@@ -2,7 +2,7 @@ import type { ColumnPrimitive, ColumnPrimitiveStr } from "./column";
 import type { QueryDef } from "./query-def";
 import type { DbContextBase, DbContextDdlMethods } from "./db-context-def";
 /**
- * 지원하는 Database 방언
+ * Supported Database dialects
  *
  * - `mysql`: MySQL 8.0.14+
  * - `mssql`: Microsoft SQL Server 2012+
@@ -10,9 +10,9 @@ import type { DbContextBase, DbContextDdlMethods } from "./db-context-def";
  */
 export type Dialect = "mysql" | "mssql" | "postgresql";
 /**
- * 지원하는 모든 Database 방언 목록
+ * List of all supported Database dialects
  *
- * testing에서 dialect별 Validation 시 사용
+ * Used for per-dialect validation in testing
  *
  * @example
  * ```typescript
@@ -26,14 +26,14 @@ export declare const dialects: Dialect[];
 /**
  * QueryBuilder.build() return type
  *
- * 빌드된 SQL 문자열과 다중 결과셋 processing를 위한 Metadata
+ * Built SQL string and metadata for multiple result set processing
  *
- * @property sql - 빌드된 SQL 문자열
- * @property resultSetIndex - Result를 가져올 결과셋 Index (Basic: 0)
- *   - MySQL INSERT with OUTPUT: 1 (INSERT + SELECT 중 SELECT)
- * @property resultSetStride - 다중 결과에서 N번째마다 결과셋 추출
- *   - 예: index=1, stride=2 → 1, 3, 5, 7... 의 결과셋 return
- *   - MySQL 다중 INSERT: INSERT;SELECT; × N → 1, 3, 5...
+ * @property sql - Built SQL string
+ * @property resultSetIndex - Result set index to fetch results from (default: 0)
+ *   - MySQL INSERT with OUTPUT: 1 (SELECT from INSERT + SELECT)
+ * @property resultSetStride - Extract every Nth result set from multiple results
+ *   - Example: index=1, stride=2 -> returns result sets 1, 3, 5, 7...
+ *   - MySQL multiple INSERT: INSERT;SELECT; x N -> 1, 3, 5...
  */
 export interface QueryBuildResult {
     sql: string;
@@ -43,23 +43,23 @@ export interface QueryBuildResult {
 /**
  * Transaction isolation level
  *
- * - `READ_UNCOMMITTED`: commit되지 않은 data read 가능 (Dirty Read)
- * - `READ_COMMITTED`: commit된 data만 read (default)
- * - `REPEATABLE_READ`: Transaction 내 동일 query 동일 result 보장
- * - `SERIALIZABLE`: 완전 serialize (가장 엄격)
+ * - `READ_UNCOMMITTED`: Can read uncommitted data (Dirty Read)
+ * - `READ_COMMITTED`: Read only committed data (default)
+ * - `REPEATABLE_READ`: Guarantees same query returns same result within transaction
+ * - `SERIALIZABLE`: Full serialization (most strict)
  */
 export type IsolationLevel = "READ_UNCOMMITTED" | "READ_COMMITTED" | "REPEATABLE_READ" | "SERIALIZABLE";
 /**
  * Query result data record type
  *
- * 재귀적 structure로 중첩 관계(include) result 표현
+ * Represents nested relation (include) results with recursive structure
  *
  * @example
  * ```typescript
- * // 단순 레코드
+ * // Simple record
  * type User = { id: number; name: string; }
  *
- * // 중첩 relationship include
+ * // Nested relation include
  * type UserWithPosts = {
  *   id: number;
  *   name: string;
@@ -72,14 +72,14 @@ export type DataRecord = {
     [key: string]: ColumnPrimitive | DataRecord | DataRecord[];
 };
 /**
- * DbContext 실행기 interface
+ * DbContext executor interface
  *
- * 실제 DB 연결과 Execute query을 담당
- * NodeDbContextExecutor (서버) 또는 SdOrmServiceClientDbContextExecutor (클라이언트) 구현
+ * Responsible for actual DB connection and query execution
+ * Implemented by NodeDbContextExecutor (server) or SdOrmServiceClientDbContextExecutor (client)
  *
  * @example
  * ```typescript
- * // 서버 측 구현 예시
+ * // Server-side implementation example
  * class NodeDbContextExecutor implements IDbContextExecutor {
  *   async connect(): Promise<void> {
  *     await this.connection.connect();
@@ -88,48 +88,48 @@ export type DataRecord = {
  * }
  * ```
  *
- * @see {@link DbContext} DbContextused in
+ * @see {@link DbContext} Used in DbContext
  */
 export interface DbContextExecutor {
     /**
-     * DB 연결 수립
+     * Establish DB connection
      */
     connect(): Promise<void>;
     /**
-     * DB 연결 end
+     * Close DB connection
      */
     close(): Promise<void>;
     /**
-     * Transaction start
+     * Begin transaction
      *
-     * @param isolationLevel - isolation level (Select)
+     * @param isolationLevel - Isolation level (optional)
      */
     beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;
     /**
-     * Transaction commit
+     * Commit transaction
      */
     commitTransaction(): Promise<void>;
     /**
-     * Transaction rollback
+     * Rollback transaction
      */
     rollbackTransaction(): Promise<void>;
     /**
-     * QueryDef array 실행
+     * Execute QueryDef array
      *
      * @template T - Result record type
-     * @param defs - Execute할 QueryDef array
-     * @param resultMetas - Result Transform을 위한 Metadata (Select)
-     * @returns 각 QueryDef별 result 배열의 array
+     * @param defs - QueryDef array to execute
+     * @param resultMetas - Metadata for result transformation (optional)
+     * @returns Array of result arrays per QueryDef
      */
     executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]>;
 }
 /**
- * Query result Transform을 위한 Metadata
+ * Metadata for query result transformation
  *
- * SELECT 결과를 TypeScript 객체로 Transform 시 사용
+ * Used when transforming SELECT results into TypeScript objects
  *
- * @property columns - Column명 → ColumnPrimitiveStr Mapping
- * @property joins - JOIN 별칭 → 단일/array 여부
+ * @property columns - Column name -> ColumnPrimitiveStr mapping
+ * @property joins - JOIN alias -> single/array indicator
  */
 export interface ResultMeta {
     columns: Record<string, ColumnPrimitiveStr>;
@@ -140,10 +140,10 @@ export interface ResultMeta {
 /**
  * Database migration definition
  *
- * schema 변경을 version control
+ * Version-control schema changes
  *
- * @property name - Migration 고유 이름 (타임스탬프 권장)
- * @property up - Migration 실행 function
+ * @property name - Unique Migration name (timestamp recommended)
+ * @property up - Migration execution function
  *
  * @example
  * ```typescript
@@ -166,7 +166,7 @@ export interface ResultMeta {
  * ];
  * ```
  *
- * @see {@link DbContext.initialize} migration 실행
+ * @see {@link DbContext.initialize} migration execution
  */
 export interface Migration {
     name: string;