@simplysm/orm-common 13.0.100 → 14.0.1

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

@@ -3,14 +3,14 @@ import type { Queryable } from "../exec/queryable";
 import type { DataRecord } from "../types/db";
 import { createRelationFactory, type InferDeepRelations, type RelationBuilderRecord } from "./factory/relation-builder";
 /**
- * Database View definition builder
+ * Database View 정의 builder
  *
- * Define View query and relations via Fluent API
- * Use with DbContext's queryable() for type-safe query composition
+ * Fluent API로 View query와 관계를 정의
+ * DbContext의 queryable()과 함께 사용하여 타입 안전한 query 구성
  *
- * @template TDbContext - DbContext type
- * @template TData - View data record type
- * @template TRelations - Relation definition record type
+ * @template TDbContext - DbContext 타입
+ * @template TData - View 데이터 레코드 타입
+ * @template TRelations - 관계 정의 레코드 타입
  *
  * @example
  * ```typescript
@@ -35,8 +35,8 @@ import { createRelationFactory, type InferDeepRelations, type RelationBuilderRec
  * }
  * ```
  *
- * @see {@link View} factory function
- * @see {@link queryable} Queryable Generate
+ * @see {@link View} factory 함수
+ * @see {@link queryable} Queryable 생성
  */
 export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends DataRecord, TRelations extends RelationBuilderRecord> {
     readonly meta: {
@@ -47,18 +47,18 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
         viewFn?: (db: TDbContext) => Queryable<TData, any>;
         relations?: TRelations;
     };
-    /** Relation definition (type for inference) */
+    /** 관계 정의 (타입 추론용) */
     readonly $relations: TRelations;
-    /** Full Type inference */
+    /** 전체 타입 추론 */
     readonly $inferSelect: TData;
     /**
-     * @param meta - View Metadata
-     * @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 - Relation definition
+     * @param meta - View 메타데이터
+     * @param meta.name - View 이름
+     * @param meta.description - View 설명 (comment)
+     * @param meta.database - Database 이름
+     * @param meta.schema - Schema 이름 (MSSQL/PostgreSQL)
+     * @param meta.viewFn - View query 정의 함수
+     * @param meta.relations - 관계 정의
      */
     constructor(meta: {
         name: string;
@@ -69,17 +69,17 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
         relations?: TRelations;
     });
     /**
-     * View set description
+     * View 설명 설정
      *
-     * @param desc - View description (used as DDL Comment)
-     * @returns new ViewBuilder instance
+     * @param desc - View 설명 (DDL Comment로 사용됨)
+     * @returns 새 ViewBuilder 인스턴스
      */
     description(desc: string): ViewBuilder<TDbContext, TData, TRelations>;
     /**
-     * Database set name
+     * Database 이름 설정
      *
-     * @param db - Database name
-     * @returns new ViewBuilder instance
+     * @param db - Database 이름
+     * @returns 새 ViewBuilder 인스턴스
      *
      * @example
      * ```typescript
@@ -88,23 +88,23 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
      */
     database(db: string): ViewBuilder<TDbContext, TData, TRelations>;
     /**
-     * schema set name
+     * Schema 이름 설정
      *
-     * Used in MSSQL, PostgreSQL
+     * MSSQL, PostgreSQL에서 사용
      *
-     * @param schema - Schema name (MSSQL: dbo, PostgreSQL: public)
-     * @returns new ViewBuilder instance
+     * @param schema - Schema 이름 (MSSQL: dbo, PostgreSQL: public)
+     * @returns 새 ViewBuilder 인스턴스
      */
     schema(schema: string): ViewBuilder<TDbContext, TData, TRelations>;
     /**
-     * View Query definition
+     * View query 정의
      *
-     * Define the View's data source through a SELECT query
+     * SELECT query를 통해 View의 데이터 소스를 정의
      *
-     * @template TViewData - View data type
-     * @template TDb - DbContext type
-     * @param viewFn - Function that receives a DbContext and returns a Queryable
-     * @returns new ViewBuilder instance
+     * @template TViewData - View 데이터 타입
+     * @template TDb - DbContext 타입
+     * @param viewFn - DbContext를 받아 Queryable을 반환하는 함수
+     * @returns 새 ViewBuilder 인스턴스
      *
      * @example
      * ```typescript
@@ -123,13 +123,13 @@ 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>;
     /**
-     * Relation definition
+     * 관계 정의
      *
-     * Set up relations with other Tables/Views
+     * 다른 Table/View와의 관계를 설정
      *
-     * @template T - Relation definition type
-     * @param fn - Function that receives a relation factory and returns relation definitions
-     * @returns new ViewBuilder instance
+     * @template T - 관계 정의 타입
+     * @param fn - 관계 factory를 받아 관계 정의를 반환하는 함수
+     * @returns 새 ViewBuilder 인스턴스
      *
      * @example
      * ```typescript
@@ -146,12 +146,12 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
     relations<T extends RelationBuilderRecord>(fn: (r: ReturnType<typeof createRelationFactory<this, keyof TData & string>>) => T): ViewBuilder<TDbContext, TData & InferDeepRelations<T>, TRelations>;
 }
 /**
- * View builder factory function
+ * View builder factory 함수
  *
- * Creates a ViewBuilder for defining View schema via Fluent API
+ * Fluent API로 View schema를 정의하기 위한 ViewBuilder를 생성
  *
- * @param name - View name
- * @returns ViewBuilder instance
+ * @param name - View 이름
+ * @returns ViewBuilder 인스턴스
  *
  * @example
  * ```typescript
@@ -164,7 +164,7 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
  *       .select(u => ({ id: u.id, name: u.name }))
  *   );
  *
- * // aggregation View
+ * // 집계 View
  * const UserStats = View("UserStats")
  *   .database("mydb")
  *   .query((db: MyDb) =>
@@ -177,7 +177,7 @@ export declare class ViewBuilder<TDbContext extends DbContextBase, TData extends
  *   );
  * ```
  *
- * @see {@link ViewBuilder} builder class
+ * @see {@link ViewBuilder} builder 클래스
  */
 export declare function View(name: string): ViewBuilder<DbContextBase, DataRecord, RelationBuilderRecord>;
 //# sourceMappingURL=view-builder.d.ts.map

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,+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"}
+{"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,qBAAqB;IACrB,QAAQ,CAAC,UAAU,EAAG,UAAU,CAAC;IACjC,eAAe;IACf,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

@@ -1,118 +1,191 @@
-import {
-  createRelationFactory
-} from "./factory/relation-builder.js";
-class ViewBuilder {
-  /**
-   * @param meta - View Metadata
-   * @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 - Relation definition
-   */
-  constructor(meta) {
-    this.meta = meta;
-  }
-  /** Relation definition (type for inference) */
-  $relations;
-  /** Full Type inference */
-  $inferSelect;
-  /**
-   * View set description
-   *
-   * @param desc - View description (used as DDL Comment)
-   * @returns new ViewBuilder instance
-   */
-  description(desc) {
-    return new ViewBuilder({ ...this.meta, description: desc });
-  }
-  /**
-   * Database set name
-   *
-   * @param db - Database name
-   * @returns new ViewBuilder instance
-   *
-   * @example
-   * ```typescript
-   * const UserSummary = View("UserSummary").database("mydb");
-   * ```
-   */
-  database(db) {
-    return new ViewBuilder({ ...this.meta, database: db });
-  }
-  /**
-   * schema set name
-   *
-   * Used in MSSQL, PostgreSQL
-   *
-   * @param schema - Schema name (MSSQL: dbo, PostgreSQL: public)
-   * @returns new ViewBuilder instance
-   */
-  schema(schema) {
-    return new ViewBuilder({ ...this.meta, schema });
-  }
-  /**
-   * View Query definition
-   *
-   * Define the View's data source through a SELECT query
-   *
-   * @template TViewData - View data type
-   * @template TDb - DbContext type
-   * @param viewFn - Function that receives a DbContext and returns a Queryable
-   * @returns new ViewBuilder instance
-   *
-   * @example
-   * ```typescript
-   * const ActiveUsers = View("ActiveUsers")
-   *   .database("mydb")
-   *   .query((db: MyDb) =>
-   *     db.user()
-   *       .where(u => [expr.eq(u.status, "active")])
-   *       .select(u => ({
-   *         id: u.id,
-   *         name: u.name,
-   *         email: u.email,
-   *       }))
-   *   );
-   * ```
-   */
-  query(viewFn) {
-    return new ViewBuilder({ ...this.meta, viewFn });
-  }
-  /**
-   * Relation definition
-   *
-   * Set up relations with other Tables/Views
-   *
-   * @template T - Relation definition type
-   * @param fn - Function that receives a relation factory and returns relation definitions
-   * @returns new ViewBuilder instance
-   *
-   * @example
-   * ```typescript
-   * const UserSummary = View("UserSummary")
-   *   .query((db: MyDb) => db.user().select(...))
-   *   .relations((r) => ({
-   *     posts: r.foreignKeyTarget(Post, "author"),
-   *   }));
-   * ```
-   *
-   * @see {@link ForeignKeyBuilder} FK builder
-   * @see {@link ForeignKeyTargetBuilder} FK reverse-reference builder
-   */
-  relations(fn) {
-    return new ViewBuilder({
-      ...this.meta,
-      relations: fn(createRelationFactory(() => this))
-    });
-  }
+import { createRelationFactory, } from "./factory/relation-builder.js";
+// ============================================
+// ViewBuilder
+// ============================================
+/**
+ * Database View 정의 builder
+ *
+ * Fluent API로 View query와 관계를 정의
+ * DbContext의 queryable()과 함께 사용하여 타입 안전한 query 구성
+ *
+ * @template TDbContext - DbContext 타입
+ * @template TData - View 데이터 레코드 타입
+ * @template TRelations - 관계 정의 레코드 타입
+ *
+ * @example
+ * ```typescript
+ * // View definition
+ * const UserSummary = View("UserSummary")
+ *   .database("mydb")
+ *   .query((db: MyDb) =>
+ *     db.user()
+ *       .select(u => ({
+ *         id: u.id,
+ *         name: u.name,
+ *         postCount: expr.subquery(
+ *           db.post().where(p => [expr.eq(p.authorId, u.id)]),
+ *           q => expr.count(q.id)
+ *         ),
+ *       }))
+ *   );
+ *
+ * // Used in DbContext
+ * class MyDb extends DbContext {
+ *   readonly userSummary = queryable(this, UserSummary);
+ * }
+ * ```
+ *
+ * @see {@link View} factory 함수
+ * @see {@link queryable} Queryable 생성
+ */
+export class ViewBuilder {
+    meta;
+    /** 관계 정의 (타입 추론용) */
+    $relations;
+    /** 전체 타입 추론 */
+    $inferSelect;
+    /**
+     * @param meta - View 메타데이터
+     * @param meta.name - View 이름
+     * @param meta.description - View 설명 (comment)
+     * @param meta.database - Database 이름
+     * @param meta.schema - Schema 이름 (MSSQL/PostgreSQL)
+     * @param meta.viewFn - View query 정의 함수
+     * @param meta.relations - 관계 정의
+     */
+    constructor(meta) {
+        this.meta = meta;
+    }
+    /**
+     * View 설명 설정
+     *
+     * @param desc - View 설명 (DDL Comment로 사용됨)
+     * @returns 새 ViewBuilder 인스턴스
+     */
+    description(desc) {
+        return new ViewBuilder({ ...this.meta, description: desc });
+    }
+    /**
+     * Database 이름 설정
+     *
+     * @param db - Database 이름
+     * @returns 새 ViewBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const UserSummary = View("UserSummary").database("mydb");
+     * ```
+     */
+    database(db) {
+        return new ViewBuilder({ ...this.meta, database: db });
+    }
+    /**
+     * Schema 이름 설정
+     *
+     * MSSQL, PostgreSQL에서 사용
+     *
+     * @param schema - Schema 이름 (MSSQL: dbo, PostgreSQL: public)
+     * @returns 새 ViewBuilder 인스턴스
+     */
+    schema(schema) {
+        return new ViewBuilder({ ...this.meta, schema });
+    }
+    /**
+     * View query 정의
+     *
+     * SELECT query를 통해 View의 데이터 소스를 정의
+     *
+     * @template TViewData - View 데이터 타입
+     * @template TDb - DbContext 타입
+     * @param viewFn - DbContext를 받아 Queryable을 반환하는 함수
+     * @returns 새 ViewBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const ActiveUsers = View("ActiveUsers")
+     *   .database("mydb")
+     *   .query((db: MyDb) =>
+     *     db.user()
+     *       .where(u => [expr.eq(u.status, "active")])
+     *       .select(u => ({
+     *         id: u.id,
+     *         name: u.name,
+     *         email: u.email,
+     *       }))
+     *   );
+     * ```
+     */
+    query(viewFn) {
+        return new ViewBuilder({ ...this.meta, viewFn });
+    }
+    /**
+     * 관계 정의
+     *
+     * 다른 Table/View와의 관계를 설정
+     *
+     * @template T - 관계 정의 타입
+     * @param fn - 관계 factory를 받아 관계 정의를 반환하는 함수
+     * @returns 새 ViewBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const UserSummary = View("UserSummary")
+     *   .query((db: MyDb) => db.user().select(...))
+     *   .relations((r) => ({
+     *     posts: r.foreignKeyTarget(Post, "author"),
+     *   }));
+     * ```
+     *
+     * @see {@link ForeignKeyBuilder} FK builder
+     * @see {@link ForeignKeyTargetBuilder} FK reverse-reference builder
+     */
+    relations(fn) {
+        // Casting is unavoidable due to TypeScript generic type inference limitations
+        // Resolves type mismatch between TRelations type parameter and newly created relation type T
+        return new ViewBuilder({
+            ...this.meta,
+            relations: fn(createRelationFactory(() => this)),
+        });
+    }
 }
-function View(name) {
-  return new ViewBuilder({ name });
+// ============================================
+// View 함수
+// ============================================
+/**
+ * View builder factory 함수
+ *
+ * Fluent API로 View schema를 정의하기 위한 ViewBuilder를 생성
+ *
+ * @param name - View 이름
+ * @returns ViewBuilder 인스턴스
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const ActiveUsers = View("ActiveUsers")
+ *   .database("mydb")
+ *   .query((db: MyDb) =>
+ *     db.user()
+ *       .where(u => [expr.eq(u.status, "active")])
+ *       .select(u => ({ id: u.id, name: u.name }))
+ *   );
+ *
+ * // 집계 View
+ * const UserStats = View("UserStats")
+ *   .database("mydb")
+ *   .query((db: MyDb) =>
+ *     db.user()
+ *       .groupBy(u => ({ status: u.status }))
+ *       .select(u => ({
+ *         status: u.status,
+ *         count: expr.count(u.id),
+ *       }))
+ *   );
+ * ```
+ *
+ * @see {@link ViewBuilder} builder 클래스
+ */
+export function View(name) {
+    return new ViewBuilder({ name });
 }
-export {
-  View,
-  ViewBuilder
-};
-//# sourceMappingURL=view-builder.js.map
+//# sourceMappingURL=view-builder.js.map

package/dist/schema/view-builder.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/schema/view-builder.ts"],
-  "mappings": "AAGA;AAAA,EACE;AAAA,OAGK;AA0CA,MAAM,YAIX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,YACW,MAQT;AARS;AAAA,EAQR;AAAA;AAAA,EAtBM;AAAA;AAAA,EAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BT,YAAY,MAA0D;AACpE,WAAO,IAAI,YAAY,EAAE,GAAG,KAAK,MAAM,aAAa,KAAK,CAAC;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,SAAS,IAAwD;AAC/D,WAAO,IAAI,YAAY,EAAE,GAAG,KAAK,MAAM,UAAU,GAAG,CAAC;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,QAA4D;AACjE,WAAO,IAAI,YAAY,EAAE,GAAG,KAAK,MAAM,OAAO,CAAC;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BA,MACE,QACyC;AACzC,WAAO,IAAI,YAAY,EAAE,GAAG,KAAK,MAAM,OAAO,CAAC;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBA,UACE,IACoE;AAGpE,WAAO,IAAI,YAAY;AAAA,MACrB,GAAG,KAAK;AAAA,MACR,WAAW,GAAG,sBAAkD,MAAM,IAAI,CAAC;AAAA,IAC7E,CAAC;AAAA,EACH;AACF;AAwCO,SAAS,KAAK,MAAc;AACjC,SAAO,IAAI,YAAY,EAAE,KAAK,CAAC;AACjC;",
-  "names": []
-}
+{"version":3,"file":"view-builder.js","sourceRoot":"","sources":["..\\..\\src\\schema\\view-builder.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,qBAAqB,GAGtB,MAAM,4BAA4B,CAAC;AAEpC,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,OAAO,WAAW;IAoBX;IAfX,qBAAqB;IACZ,UAAU,CAAc;IACjC,eAAe;IACN,YAAY,CAAS;IAE9B;;;;;;;;OAQG;IACH,YACW,IAOR;QAPQ,SAAI,GAAJ,IAAI,CAOZ;IACA,CAAC;IAEJ;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,WAAW,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,WAAW,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,WAAW,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CACH,MAA8C;QAE9C,OAAO,IAAI,WAAW,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CACP,EAAkF;QAElF,8EAA8E;QAC9E,6FAA6F;QAC7F,OAAO,IAAI,WAAW,CAAC;YACrB,GAAG,IAAI,CAAC,IAAI;YACZ,SAAS,EAAE,EAAE,CAAC,qBAAqB,CAA6B,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;SAC7E,CAAQ,CAAC;IACZ,CAAC;CACF;AAED,+CAA+C;AAC/C,UAAU;AACV,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/types/column.js

@@ -1,33 +1,63 @@
 import { DateOnly, DateTime, Time, Uuid } from "@simplysm/core-common";
-const dataTypeStrToColumnPrimitiveStr = {
-  int: "number",
-  bigint: "number",
-  float: "number",
-  double: "number",
-  decimal: "number",
-  varchar: "string",
-  char: "string",
-  text: "string",
-  binary: "Bytes",
-  boolean: "boolean",
-  datetime: "DateTime",
-  date: "DateOnly",
-  time: "Time",
-  uuid: "Uuid"
+// ============================================
+// DataType ↔ ColumnPrimitive Mapping
+// ============================================
+/**
+ * SQL DataType → TypeScript type name mapping
+ *
+ * @example
+ * ```typescript
+ * const tsType = dataTypeStrToColumnPrimitiveStr["int"];  // "number"
+ * const tsType2 = dataTypeStrToColumnPrimitiveStr["datetime"];  // "DateTime"
+ * ```
+ */
+export const dataTypeStrToColumnPrimitiveStr = {
+    int: "number",
+    bigint: "number",
+    float: "number",
+    double: "number",
+    decimal: "number",
+    varchar: "string",
+    char: "string",
+    text: "string",
+    binary: "Bytes",
+    boolean: "boolean",
+    datetime: "DateTime",
+    date: "DateOnly",
+    time: "Time",
+    uuid: "Uuid",
 };
-function inferColumnPrimitiveStr(value) {
-  if (typeof value === "string") return "string";
-  if (typeof value === "number") return "number";
-  if (typeof value === "boolean") return "boolean";
-  if (value instanceof DateTime) return "DateTime";
-  if (value instanceof DateOnly) return "DateOnly";
-  if (value instanceof Time) return "Time";
-  if (value instanceof Uuid) return "Uuid";
-  if (value instanceof Uint8Array) return "Bytes";
-  throw new Error(`Unknown value type: ${typeof value}`);
+/**
+ * Infer ColumnPrimitiveStr from runtime value
+ *
+ * @param value - Column value
+ * @returns ColumnPrimitiveStr type name
+ * @throws Error if value type is unknown
+ *
+ * @example
+ * ```typescript
+ * inferColumnPrimitiveStr("hello");  // "string"
+ * inferColumnPrimitiveStr(123);  // "number"
+ * inferColumnPrimitiveStr(new DateTime());  // "DateTime"
+ * ```
+ */
+export function inferColumnPrimitiveStr(value) {
+    if (typeof value === "string")
+        return "string";
+    if (typeof value === "number")
+        return "number";
+    if (typeof value === "boolean")
+        return "boolean";
+    if (value instanceof DateTime)
+        return "DateTime";
+    if (value instanceof DateOnly)
+        return "DateOnly";
+    if (value instanceof Time)
+        return "Time";
+    if (value instanceof Uuid)
+        return "Uuid";
+    if (value instanceof Uint8Array)
+        return "Bytes";
+    throw new Error(`알 수 없는 값 타입: ${typeof value}`);
 }
-export {
-  dataTypeStrToColumnPrimitiveStr,
-  inferColumnPrimitiveStr
-};
-//# sourceMappingURL=column.js.map
+//# sourceMappingURL=column.js.map

package/dist/types/column.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/types/column.ts"],
-  "mappings": "AAAA,SAAS,UAAU,UAAU,MAAM,YAAwB;AAyGpD,MAAM,kCAAkC;AAAA,EAC7C,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AACR;AA8BO,SAAS,wBAAwB,OAA4C;AAClF,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,UAAW,QAAO;AACvC,MAAI,iBAAiB,SAAU,QAAO;AACtC,MAAI,iBAAiB,SAAU,QAAO;AACtC,MAAI,iBAAiB,KAAM,QAAO;AAClC,MAAI,iBAAiB,KAAM,QAAO;AAClC,MAAI,iBAAiB,WAAY,QAAO;AACxC,QAAM,IAAI,MAAM,uBAAuB,OAAO,KAAK,EAAE;AACvD;",
-  "names": []
-}
+{"version":3,"file":"column.js","sourceRoot":"","sources":["..\\..\\src\\types\\column.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAc,MAAM,uBAAuB,CAAC;AA4FnF,+CAA+C;AAC/C,qCAAqC;AACrC,+CAA+C;AAE/C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,GAAG,EAAE,QAAiB;IACtB,MAAM,EAAE,QAAiB;IACzB,KAAK,EAAE,QAAiB;IACxB,MAAM,EAAE,QAAiB;IACzB,OAAO,EAAE,QAAiB;IAC1B,OAAO,EAAE,QAAiB;IAC1B,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,QAAiB;IACvB,MAAM,EAAE,OAAgB;IACxB,OAAO,EAAE,SAAkB;IAC3B,QAAQ,EAAE,UAAmB;IAC7B,IAAI,EAAE,UAAmB;IACzB,IAAI,EAAE,MAAe;IACrB,IAAI,EAAE,MAAe;CACtB,CAAC;AAgBF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAsB;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,UAAU,CAAC;IACjD,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,UAAU,CAAC;IACjD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,OAAO,CAAC;IAChD,MAAM,IAAI,KAAK,CAAC,gBAAgB,OAAO,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/types/db-context-def.d.ts

@@ -7,11 +7,11 @@ import type { IndexBuilder } from "../schema/factory/index-builder";
 import type { DataRecord, IsolationLevel, Migration, ResultMeta } from "./db";
 import type { QueryDef, QueryDefObjectName } from "./query-def";
 /**
- * DbContext core interface
+ * DbContext 핵심 인터페이스
  *
- * Internal interface used by Queryable, Executable, and ViewBuilder.
- * Both the old DbContext class and new createDbContext return objects
- * that satisfy this interface.
+ * Queryable, Executable, ViewBuilder에서 사용하는 내부 인터페이스.
+ * 기존 DbContext 클래스와 새로운 createDbContext 반환 객체 모두
+ * 이 인터페이스를 만족함.
  */
 export interface DbContextBase {
     status: DbContextStatus;
@@ -25,9 +25,9 @@ export interface DbContextBase {
 }
 export type DbContextStatus = "ready" | "connect" | "transact";
 /**
- * DbContext definition (blueprint)
+ * DbContext 정의 (blueprint)
  *
- * Created by defineDbContext(). Contains schema metadata but no runtime state.
+ * defineDbContext()로 생성됨. Schema 메타데이터만 포함하며 런타임 상태는 없음.
  */
 export interface DbContextDef<TTables extends Record<string, TableBuilder<any, any>>, TViews extends Record<string, ViewBuilder<any, any, any>>, TProcedures extends Record<string, ProcedureBuilder<any, any>> = {}> {
     readonly meta: {
@@ -38,10 +38,10 @@ export interface DbContextDef<TTables extends Record<string, TableBuilder<any, a
     };
 }
 /**
- * Full DbContext instance type (created by createDbContext)
+ * 전체 DbContext 인스턴스 타입 (createDbContext로 생성)
  *
- * Extends DbContextBase with queryable accessors, DDL methods,
- * and connection/transaction management.
+ * DbContextBase를 queryable 접근자, DDL 메서드,
+ * 연결/트랜잭션 관리로 확장.
  */
 export type DbContextInstance<TDef extends DbContextDef<any, any, any>> = DbContextBase & DbContextConnectionMethods & DbContextDdlMethods & {
     [K in keyof TDef["meta"]["tables"]]: () => import("../exec/queryable").Queryable<TDef["meta"]["tables"][K]["$inferSelect"], TDef["meta"]["tables"][K]>;