@simplysm/orm-common 13.0.100 → 14.0.4

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) {
+        // TypeScript 제네릭 타입 추론 한계로 인해 캐스팅이 불가피
+        // TRelations 타입 파라미터와 새로 생성된 관계 타입 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,uCAAuC;QACvC,kDAAkD;QAClD,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.d.ts

@@ -1,8 +1,8 @@
 import { DateOnly, DateTime, Time, Uuid, type Bytes } from "@simplysm/core-common";
 /**
- * SQL data type definition
+ * SQL 데이터 타입 정의
  *
- * DBMS Mapping:
+ * DBMS 매핑:
  * - `int`: INT (4 bytes)
  * - `bigint`: BIGINT (8 bytes)
  * - `float`: FLOAT/REAL (4 bytes)
@@ -59,9 +59,9 @@ export type DataType = {
     type: "uuid";
 };
 /**
- * Column primitive type mapping
+ * Column 원시 타입 매핑
  *
- * TypeScript type name (string) → Actual TypeScript type mapping
+ * TypeScript 타입 이름 (문자열) → 실제 TypeScript 타입 매핑
  *
  * @example
  * ```typescript
@@ -80,7 +80,7 @@ export type ColumnPrimitiveMap = {
     Bytes: Bytes;
 };
 /**
- * Column primitive type name (string)
+ * Column 원시 타입 이름 (문자열)
  *
  * @example
  * ```typescript
@@ -90,13 +90,13 @@ export type ColumnPrimitiveMap = {
  */
 export type ColumnPrimitiveStr = keyof ColumnPrimitiveMap;
 /**
- * All primitive types that can be stored in columns
+ * Column에 저장 가능한 모든 원시 타입
  *
- * undefined represents NULL
+ * undefined는 NULL을 나타냄
  */
 export type ColumnPrimitive = ColumnPrimitiveMap[ColumnPrimitiveStr] | undefined;
 /**
- * SQL DataType → TypeScript type name mapping
+ * SQL DataType → TypeScript 타입 이름 매핑
  *
  * @example
  * ```typescript
@@ -121,7 +121,7 @@ export declare const dataTypeStrToColumnPrimitiveStr: {
     uuid: "Uuid";
 };
 /**
- * TypeScript Type inference from DataType
+ * DataType으로부터 TypeScript 타입 추론
  *
  * @template T - DataType
  *
@@ -133,11 +133,11 @@ export declare const dataTypeStrToColumnPrimitiveStr: {
  */
 export type InferColumnPrimitiveFromDataType<TDataType extends DataType> = ColumnPrimitiveMap[(typeof dataTypeStrToColumnPrimitiveStr)[TDataType["type"]]];
 /**
- * Infer ColumnPrimitiveStr from runtime value
+ * 런타임 값에서 ColumnPrimitiveStr 추론
  *
- * @param value - Column value
- * @returns ColumnPrimitiveStr type name
- * @throws Error if value type is unknown
+ * @param value - Column 값
+ * @returns ColumnPrimitiveStr 타입 이름
+ * @throws 값 타입이 알 수 없을 때 Error
  *
  * @example
  * ```typescript
@@ -148,16 +148,16 @@ export type InferColumnPrimitiveFromDataType<TDataType extends DataType> = Colum
  */
 export declare function inferColumnPrimitiveStr(value: ColumnPrimitive): ColumnPrimitiveStr;
 /**
- * Column metadata
+ * Column 메타데이터
  *
- * Generated by ColumnBuilder and passed to TableBuilder
+ * ColumnBuilder에서 생성되어 TableBuilder에 전달됨
  *
- * @property type - TypeScript type name (ColumnPrimitiveStr)
- * @property dataType - SQL data type
- * @property autoIncrement - Whether to auto-increment
- * @property nullable - Whether to allow NULL
- * @property default - Default value
- * @property description - Column description (DDL comment)
+ * @property type - TypeScript 타입 이름 (ColumnPrimitiveStr)
+ * @property dataType - SQL 데이터 타입
+ * @property autoIncrement - 자동 증가 여부
+ * @property nullable - NULL 허용 여부
+ * @property default - 기본값
+ * @property description - Column 설명 (DDL 코멘트)
  *
  * @see {@link ColumnBuilder} Column builder
  */