@simplysm/orm-node 13.0.0-beta.6

package/dist/orm-common/src/schema/procedure-builder.d.ts

@@ -0,0 +1,202 @@
+import { type ColumnBuilderRecord, createColumnFactory } from "./factory/column-builder";
+/**
+ * 저장 프로시저 정의 빌더
+ *
+ * Fluent API를 통해 프로시저의 파라미터, 반환 타입, 본문을 정의
+ * DbContext의 executable()과 함께 사용하여 타입 안전한 프로시저 호출
+ *
+ * @template TParams - 파라미터 컬럼 정의 타입
+ * @template TReturns - 반환 컬럼 정의 타입
+ *
+ * @example
+ * ```typescript
+ * // 프로시저 정의
+ * const GetUserById = Procedure("GetUserById")
+ *   .database("mydb")
+ *   .params((c) => ({
+ *     userId: c.bigint(),
+ *   }))
+ *   .returns((c) => ({
+ *     id: c.bigint(),
+ *     name: c.varchar(100),
+ *     email: c.varchar(200),
+ *   }))
+ *   .body("SELECT id, name, email FROM User WHERE id = userId");
+ *
+ * // DbContext에서 사용
+ * class MyDb extends DbContext {
+ *   readonly getUserById = executable(this, GetUserById);
+ * }
+ *
+ * // 호출
+ * const users = await db.getUserById({ userId: 1n }).result();
+ * ```
+ *
+ * @see {@link Procedure} 팩토리 함수
+ * @see {@link executable} Executable 생성
+ */
+export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TReturns extends ColumnBuilderRecord> {
+    readonly meta: {
+        name: string;
+        description?: string;
+        database?: string;
+        schema?: string;
+        params?: TParams;
+        returns?: TReturns;
+        query?: string;
+    };
+    /** 파라미터 정의 (타입 추론용) */
+    readonly $params: TParams;
+    /** 반환 타입 정의 (타입 추론용) */
+    readonly $returns: TReturns;
+    /**
+     * @param meta - 프로시저 메타데이터
+     * @param meta.name - 프로시저 이름
+     * @param meta.description - 프로시저 설명 (주석)
+     * @param meta.database - 데이터베이스 이름
+     * @param meta.schema - 스키마 이름 (MSSQL/PostgreSQL)
+     * @param meta.params - 파라미터 정의
+     * @param meta.returns - 반환 타입 정의
+     * @param meta.query - 프로시저 본문 SQL
+     */
+    constructor(meta: {
+        name: string;
+        description?: string;
+        database?: string;
+        schema?: string;
+        params?: TParams;
+        returns?: TReturns;
+        query?: string;
+    });
+    /**
+     * 프로시저 설명 설정
+     *
+     * @param desc - 프로시저 설명 (DDL 주석으로 사용)
+     * @returns 새 ProcedureBuilder 인스턴스
+     */
+    description(desc: string): ProcedureBuilder<TParams, TReturns>;
+    /**
+     * 데이터베이스 이름 설정
+     *
+     * @param db - 데이터베이스 이름
+     * @returns 새 ProcedureBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const GetUser = Procedure("GetUser").database("mydb");
+     * ```
+     */
+    database(db: string): ProcedureBuilder<TParams, TReturns>;
+    /**
+     * 스키마 이름 설정
+     *
+     * MSSQL, PostgreSQL에서 사용
+     *
+     * @param schema - 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
+     * @returns 새 ProcedureBuilder 인스턴스
+     */
+    schema(schema: string): ProcedureBuilder<TParams, TReturns>;
+    /**
+     * 파라미터 정의
+     *
+     * 프로시저 입력 파라미터 정의
+     * DBMS별 파라미터 문법 차이 주의 (MSSQL: @param, MySQL/PostgreSQL: param)
+     *
+     * @template T - 새 파라미터 정의 타입
+     * @param fn - 컬럼 팩토리를 받아 파라미터 정의를 반환하는 함수
+     * @returns 새 ProcedureBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const GetUserById = Procedure("GetUserById")
+     *   .params((c) => ({
+     *     userId: c.bigint(),
+     *     includeDeleted: c.boolean().default(false),
+     *   }));
+     * ```
+     */
+    params<T extends ColumnBuilderRecord>(fn: (c: ReturnType<typeof createColumnFactory>) => T): ProcedureBuilder<T, TReturns>;
+    /**
+     * 반환 타입 정의
+     *
+     * 프로시저 반환 결과 컬럼 정의
+     *
+     * @template T - 새 반환 타입 정의
+     * @param fn - 컬럼 팩토리를 받아 반환 컬럼 정의를 반환하는 함수
+     * @returns 새 ProcedureBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const GetUserById = Procedure("GetUserById")
+     *   .params((c) => ({ userId: c.bigint() }))
+     *   .returns((c) => ({
+     *     id: c.bigint(),
+     *     name: c.varchar(100),
+     *     email: c.varchar(200).nullable(),
+     *   }));
+     * ```
+     */
+    returns<T extends ColumnBuilderRecord>(fn: (c: ReturnType<typeof createColumnFactory>) => T): ProcedureBuilder<TParams, T>;
+    /**
+     * 프로시저 본문 SQL 설정
+     *
+     * DBMS별 SQL 문법 차이 주의:
+     * - MySQL: 파라미터명 그대로 (userId)
+     * - MSSQL: @ 접두사 (@userId)
+     * - PostgreSQL: RETURN QUERY 필요
+     *
+     * @param sql - 프로시저 본문 SQL
+     * @returns 새 ProcedureBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * // MySQL/PostgreSQL
+     * const GetUser = Procedure("GetUser")
+     *   .params((c) => ({ userId: c.bigint() }))
+     *   .body("SELECT * FROM User WHERE id = userId");
+     *
+     * // MSSQL
+     * const GetUser = Procedure("GetUser")
+     *   .params((c) => ({ userId: c.bigint() }))
+     *   .body("SELECT * FROM [User] WHERE id = @userId");
+     * ```
+     */
+    body(sql: string): ProcedureBuilder<TParams, TReturns>;
+}
+/**
+ * 프로시저 빌더 생성 팩토리 함수
+ *
+ * ProcedureBuilder를 생성하여 Fluent API로 저장 프로시저 스키마 정의
+ *
+ * @param name - 프로시저 이름
+ * @returns ProcedureBuilder 인스턴스
+ *
+ * @example
+ * ```typescript
+ * // 기본 사용
+ * const GetUserById = Procedure("GetUserById")
+ *   .database("mydb")
+ *   .params((c) => ({
+ *     userId: c.bigint(),
+ *   }))
+ *   .returns((c) => ({
+ *     id: c.bigint(),
+ *     name: c.varchar(100),
+ *     email: c.varchar(200),
+ *   }))
+ *   .body("SELECT id, name, email FROM User WHERE id = userId");
+ *
+ * // 파라미터 없는 프로시저
+ * const GetAllActiveUsers = Procedure("GetAllActiveUsers")
+ *   .database("mydb")
+ *   .returns((c) => ({
+ *     id: c.bigint(),
+ *     name: c.varchar(100),
+ *   }))
+ *   .body("SELECT id, name FROM User WHERE status = 'active'");
+ * ```
+ *
+ * @see {@link ProcedureBuilder} 빌더 클래스
+ */
+export declare function Procedure(name: string): ProcedureBuilder<never, never>;
+//# sourceMappingURL=procedure-builder.d.ts.map

package/dist/orm-common/src/schema/procedure-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-builder.d.ts","sourceRoot":"","sources":["../../../../../orm-common/src/schema/procedure-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,gBAAgB,CAAC,OAAO,SAAS,mBAAmB,EAAE,QAAQ,SAAS,mBAAmB;IAiBnG,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,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IAxBH,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAG,OAAO,CAAC;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAC;IAE7B;;;;;;;;;OASG;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,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IAGH;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC;IAI9D;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC;IAIzD;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC;IAI3D;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,CAAC,SAAS,mBAAmB,EAClC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,KAAK,CAAC,GACnD,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC;IAIhC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,CAAC,SAAS,mBAAmB,EACnC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,KAAK,CAAC,GACnD,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;IAI/B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC;CAGvD;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAEtE"}

package/dist/orm-common/src/schema/table-builder.d.ts

@@ -0,0 +1,259 @@
+import { type ColumnBuilderRecord, createColumnFactory, type InferColumns, type InferInsertColumns, type InferUpdateColumns } from "./factory/column-builder";
+import { createIndexFactory, type IndexBuilder } from "./factory/index-builder";
+import { createRelationFactory, type InferDeepRelations, type RelationBuilderRecord } from "./factory/relation-builder";
+/**
+ * 데이터베이스 테이블 정의 빌더
+ *
+ * Fluent API를 통해 테이블의 컬럼, PK, 인덱스, 관계를 정의
+ * DbContext에서 queryable()과 함께 사용하여 타입 안전한 쿼리 작성
+ *
+ * @template TColumns - 컬럼 정의 레코드 타입
+ * @template TRelations - 관계 정의 레코드 타입
+ *
+ * @example
+ * ```typescript
+ * // 테이블 정의
+ * const User = Table("User")
+ *   .database("mydb")
+ *   .columns((c) => ({
+ *     id: c.bigint().autoIncrement(),
+ *     name: c.varchar(100),
+ *     email: c.varchar(200).nullable(),
+ *     status: c.varchar(20).default("active"),
+ *   }))
+ *   .primaryKey("id")
+ *   .indexes((i) => [i.index("email").unique()]);
+ *
+ * // DbContext에서 사용
+ * class MyDb extends DbContext {
+ *   readonly user = queryable(this, User);
+ * }
+ * ```
+ *
+ * @see {@link Table} 팩토리 함수
+ * @see {@link queryable} Queryable 생성
+ */
+export declare class TableBuilder<TColumns extends ColumnBuilderRecord, TRelations extends RelationBuilderRecord> {
+    readonly meta: {
+        name: string;
+        description?: string;
+        database?: string;
+        schema?: string;
+        columns?: TColumns;
+        primaryKey?: (keyof TColumns & string)[];
+        relations?: TRelations;
+        indexes?: IndexBuilder<(keyof TColumns & string)[]>[];
+    };
+    /** 컬럼 정의 (타입 추론용) */
+    readonly $columns: TColumns;
+    /** 관계 정의 (타입 추론용) */
+    readonly $relations: TRelations;
+    /** 전체 타입 추론 (컬럼 + 관계) */
+    readonly $infer: InferColumns<TColumns> & InferDeepRelations<TRelations>;
+    /** 컬럼만 타입 추론 */
+    readonly $inferColumns: InferColumns<TColumns>;
+    /** INSERT용 타입 추론 (autoIncrement 제외, nullable/default는 optional) */
+    readonly $inferInsert: InferInsertColumns<TColumns>;
+    /** UPDATE용 타입 추론 (모든 필드 optional) */
+    readonly $inferUpdate: InferUpdateColumns<TColumns>;
+    /**
+     * @param meta - 테이블 메타데이터
+     * @param meta.name - 테이블 이름
+     * @param meta.description - 테이블 설명 (주석)
+     * @param meta.database - 데이터베이스 이름
+     * @param meta.schema - 스키마 이름 (MSSQL/PostgreSQL)
+     * @param meta.columns - 컬럼 정의
+     * @param meta.primaryKey - PK 컬럼 배열
+     * @param meta.relations - 관계 정의
+     * @param meta.indexes - 인덱스 정의
+     */
+    constructor(meta: {
+        name: string;
+        description?: string;
+        database?: string;
+        schema?: string;
+        columns?: TColumns;
+        primaryKey?: (keyof TColumns & string)[];
+        relations?: TRelations;
+        indexes?: IndexBuilder<(keyof TColumns & string)[]>[];
+    });
+    /**
+     * 테이블 설명 설정
+     *
+     * @param desc - 테이블 설명 (DDL 주석으로 사용)
+     * @returns 새 TableBuilder 인스턴스
+     */
+    description(desc: string): TableBuilder<TColumns, TRelations>;
+    /**
+     * 데이터베이스 이름 설정
+     *
+     * @param db - 데이터베이스 이름
+     * @returns 새 TableBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const User = Table("User").database("mydb");
+     * ```
+     */
+    database(db: string): TableBuilder<TColumns, TRelations>;
+    /**
+     * 스키마 이름 설정
+     *
+     * MSSQL, PostgreSQL에서 사용
+     *
+     * @param schema - 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
+     * @returns 새 TableBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const User = Table("User")
+     *   .database("mydb")
+     *   .schema("custom_schema");
+     * ```
+     */
+    schema(schema: string): TableBuilder<TColumns, TRelations>;
+    /**
+     * 컬럼 정의
+     *
+     * 컬럼 팩토리를 통해 타입 안전한 컬럼 정의
+     *
+     * @template TNewColumnDefs - 새 컬럼 정의 타입
+     * @param fn - 컬럼 팩토리를 받아 컬럼 정의를 반환하는 함수
+     * @returns 새 TableBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const User = Table("User")
+     *   .columns((c) => ({
+     *     id: c.bigint().autoIncrement(),
+     *     name: c.varchar(100),
+     *     email: c.varchar(200).nullable(),
+     *     createdAt: c.datetime().default("CURRENT_TIMESTAMP"),
+     *   }));
+     * ```
+     */
+    columns<TNewColumnDefs extends ColumnBuilderRecord>(fn: (c: ReturnType<typeof createColumnFactory>) => TNewColumnDefs): TableBuilder<TNewColumnDefs, TRelations>;
+    /**
+     * Primary Key 설정
+     *
+     * @param columns - PK를 구성할 컬럼 이름들 (복합 PK 가능)
+     * @returns 새 TableBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * // 단일 PK
+     * const User = Table("User")
+     *   .columns((c) => ({ id: c.bigint() }))
+     *   .primaryKey("id");
+     *
+     * // 복합 PK
+     * const UserRole = Table("UserRole")
+     *   .columns((c) => ({
+     *     userId: c.bigint(),
+     *     roleId: c.bigint(),
+     *   }))
+     *   .primaryKey("userId", "roleId");
+     * ```
+     */
+    primaryKey(...columns: (keyof TColumns & string)[]): TableBuilder<TColumns, TRelations>;
+    /**
+     * 인덱스 정의
+     *
+     * @param fn - 인덱스 팩토리를 받아 인덱스 배열을 반환하는 함수
+     * @returns 새 TableBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const User = Table("User")
+     *   .columns((c) => ({
+     *     id: c.bigint(),
+     *     email: c.varchar(200),
+     *     name: c.varchar(100),
+     *   }))
+     *   .indexes((i) => [
+     *     i.index("email").unique(),
+     *     i.index("name").orderBy("ASC"),
+     *   ]);
+     * ```
+     */
+    indexes(fn: (i: ReturnType<typeof createIndexFactory<keyof TColumns & string>>) => IndexBuilder<string[]>[]): TableBuilder<TColumns, TRelations>;
+    /**
+     * 관계 정의
+     *
+     * FK, 역참조 등 테이블 간 관계 설정
+     *
+     * @template T - 관계 정의 타입
+     * @param fn - 관계 팩토리를 받아 관계 정의를 반환하는 함수
+     * @returns 새 TableBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const Post = Table("Post")
+     *   .columns((c) => ({
+     *     id: c.bigint().autoIncrement(),
+     *     authorId: c.bigint(),
+     *     title: c.varchar(200),
+     *   }))
+     *   .primaryKey("id")
+     *   .relations((r) => ({
+     *     // FK 관계 (N:1)
+     *     author: r.foreignKey(["authorId"], () => User),
+     *   }));
+     *
+     * const User = Table("User")
+     *   .columns((c) => ({
+     *     id: c.bigint().autoIncrement(),
+     *     name: c.varchar(100),
+     *   }))
+     *   .primaryKey("id")
+     *   .relations((r) => ({
+     *     // 역참조 (1:N)
+     *     posts: r.foreignKeyTarget(() => Post, "author"),
+     *   }));
+     * ```
+     *
+     * @see {@link ForeignKeyBuilder} FK 빌더
+     * @see {@link ForeignKeyTargetBuilder} FK 역참조 빌더
+     */
+    relations<T extends RelationBuilderRecord>(fn: (r: ReturnType<typeof createRelationFactory<this, keyof TColumns & string>>) => T): TableBuilder<TColumns, T>;
+}
+/**
+ * 테이블 빌더 생성 팩토리 함수
+ *
+ * TableBuilder를 생성하여 Fluent API로 테이블 스키마 정의
+ *
+ * @param name - 테이블 이름
+ * @returns TableBuilder 인스턴스
+ *
+ * @example
+ * ```typescript
+ * // 기본 사용
+ * const User = Table("User")
+ *   .database("mydb")
+ *   .columns((c) => ({
+ *     id: c.bigint().autoIncrement(),
+ *     name: c.varchar(100),
+ *     email: c.varchar(200).nullable(),
+ *   }))
+ *   .primaryKey("id")
+ *   .indexes((i) => [i.index("email").unique()]);
+ *
+ * // 관계 포함
+ * const Post = Table("Post")
+ *   .database("mydb")
+ *   .columns((c) => ({
+ *     id: c.bigint().autoIncrement(),
+ *     authorId: c.bigint(),
+ *     title: c.varchar(200),
+ *     content: c.text(),
+ *   }))
+ *   .primaryKey("id")
+ *   .relations((r) => ({
+ *     author: r.foreignKey(["authorId"], () => User),
+ *   }));
+ * ```
+ *
+ * @see {@link TableBuilder} 빌더 클래스
+ */
+export declare function Table(name: string): TableBuilder<ColumnBuilderRecord, RelationBuilderRecord>;
+//# sourceMappingURL=table-builder.d.ts.map

package/dist/orm-common/src/schema/table-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-builder.d.ts","sourceRoot":"","sources":["../../../../../orm-common/src/schema/table-builder.ts"],"names":[],"mappings":"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"}

package/dist/orm-common/src/schema/view-builder.d.ts

@@ -0,0 +1,183 @@
+import type { DbContext } from "../db-context";
+import type { Queryable } from "../exec/queryable";
+import type { DataRecord } from "../types/db";
+import { createRelationFactory, type InferDeepRelations, type RelationBuilderRecord } from "./factory/relation-builder";
+/**
+ * 데이터베이스 뷰 정의 빌더
+ *
+ * Fluent API를 통해 뷰의 쿼리, 관계를 정의
+ * DbContext에서 queryable()과 함께 사용하여 타입 안전한 쿼리 작성
+ *
+ * @template TDbContext - DbContext 타입
+ * @template TData - 뷰 데이터 레코드 타입
+ * @template TRelations - 관계 정의 레코드 타입
+ *
+ * @example
+ * ```typescript
+ * // 뷰 정의
+ * 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)
+ *         ),
+ *       }))
+ *   );
+ *
+ * // DbContext에서 사용
+ * class MyDb extends DbContext {
+ *   readonly userSummary = queryable(this, UserSummary);
+ * }
+ * ```
+ *
+ * @see {@link View} 팩토리 함수
+ * @see {@link queryable} Queryable 생성
+ */
+export declare class ViewBuilder<TDbContext extends DbContext, TData extends DataRecord, TRelations extends RelationBuilderRecord> {
+    readonly meta: {
+        name: string;
+        description?: string;
+        database?: string;
+        schema?: string;
+        viewFn?: (db: TDbContext) => Queryable<TData, any>;
+        relations?: TRelations;
+    };
+    /** 관계 정의 (타입 추론용) */
+    readonly $relations: TRelations;
+    /** 전체 타입 추론 */
+    readonly $infer: TData;
+    /**
+     * @param meta - 뷰 메타데이터
+     * @param meta.name - 뷰 이름
+     * @param meta.description - 뷰 설명 (주석)
+     * @param meta.database - 데이터베이스 이름
+     * @param meta.schema - 스키마 이름 (MSSQL/PostgreSQL)
+     * @param meta.viewFn - 뷰 쿼리 정의 함수
+     * @param meta.relations - 관계 정의
+     */
+    constructor(meta: {
+        name: string;
+        description?: string;
+        database?: string;
+        schema?: string;
+        viewFn?: (db: TDbContext) => Queryable<TData, any>;
+        relations?: TRelations;
+    });
+    /**
+     * 뷰 설명 설정
+     *
+     * @param desc - 뷰 설명 (DDL 주석으로 사용)
+     * @returns 새 ViewBuilder 인스턴스
+     */
+    description(desc: string): ViewBuilder<TDbContext, TData, TRelations>;
+    /**
+     * 데이터베이스 이름 설정
+     *
+     * @param db - 데이터베이스 이름
+     * @returns 새 ViewBuilder 인스턴스
+     *
+     * @example
+     * ```typescript
+     * const UserSummary = View("UserSummary").database("mydb");
+     * ```
+     */
+    database(db: string): ViewBuilder<TDbContext, TData, TRelations>;
+    /**
+     * 스키마 이름 설정
+     *
+     * MSSQL, PostgreSQL에서 사용
+     *
+     * @param schema - 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
+     * @returns 새 ViewBuilder 인스턴스
+     */
+    schema(schema: string): ViewBuilder<TDbContext, TData, TRelations>;
+    /**
+     * 뷰 쿼리 정의
+     *
+     * SELECT 쿼리를 통해 뷰의 데이터 소스 정의
+     *
+     * @template TViewData - 뷰 데이터 타입
+     * @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<TViewData extends DataRecord, TDb extends DbContext>(viewFn: (db: TDb) => Queryable<TViewData, any>): ViewBuilder<TDb, TViewData, TRelations>;
+    /**
+     * 관계 정의
+     *
+     * 다른 테이블/뷰와의 관계 설정
+     *
+     * @template T - 관계 정의 타입
+     * @param fn - 관계 팩토리를 받아 관계 정의를 반환하는 함수
+     * @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 빌더
+     * @see {@link ForeignKeyTargetBuilder} FK 역참조 빌더
+     */
+    relations<T extends RelationBuilderRecord>(fn: (r: ReturnType<typeof createRelationFactory<this, keyof TData & string>>) => T): ViewBuilder<TDbContext, TData & InferDeepRelations<T>, TRelations>;
+}
+/**
+ * 뷰 빌더 생성 팩토리 함수
+ *
+ * ViewBuilder를 생성하여 Fluent API로 뷰 스키마 정의
+ *
+ * @param name - 뷰 이름
+ * @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 }))
+ *   );
+ *
+ * // 집계 뷰
+ * 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} 빌더 클래스
+ */
+export declare function View(name: string): ViewBuilder<DbContext, DataRecord, RelationBuilderRecord>;
+//# sourceMappingURL=view-builder.d.ts.map

package/dist/orm-common/src/schema/view-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-builder.d.ts","sourceRoot":"","sources":["../../../../../orm-common/src/schema/view-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAMxH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,WAAW,CACtB,UAAU,SAAS,SAAS,EAC5B,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,MAAM,EAAG,KAAK,CAAC;IAExB;;;;;;;;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,SAAS,EACvD,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,6DAEhC"}