@simplysm/orm-common 14.1.2 → 14.1.6

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

@@ -10,28 +10,29 @@ import type { ViewBuilder } from "../view-builder";
  * description 설정은 factory 함수의 opts 파라미터로 전달한다.
  * 메서드 체이닝(.description())은 TypeScript 순환 참조 시 TS7022를 유발하므로 제거됨.
  *
- * @template TOwner - 소유 Table builder 타입
- * @template TTargetFn - 대상 Table builder factory 타입
+ * @template TTargetFn - 대상 Table builder factory 타입 (무제약)
+ *
+ * 대상 타겟을 잡는 제네릭은 **무제약**(`extends () => TableBuilder<...>` 제약 없음)이다.
+ * 제약이 있으면 모델 const 형성 중 `() => typeof X` 타겟 화살표를 eager 평가하여
+ * TS6 에서 순환 const(TS7022/7024)를 유발하기 때문이다. 대상 해소는 `$inferSelect`
+ * 접근 시점에 lazy 하게(`ExtractRelationTarget`) 이루어진다.
  *
  * @see {@link ForeignKeyTargetBuilder} 역참조 builder
  * @see {@link RelationKeyBuilder} DB FK 없는 관계
  */
-export declare class ForeignKeyBuilder<TOwner extends TableBuilder<any, any, any>, TTargetFn extends () => TableBuilder<any, any, any>> {
+export declare class ForeignKeyBuilder<TTargetFn> {
     readonly meta: {
-        ownerFn: () => TOwner;
         columns: string[];
         targetFn: TTargetFn;
         description?: string;
     };
     /**
      * @param meta - FK 메타데이터
-     * @param meta.ownerFn - 소유 Table factory
      * @param meta.columns - FK column 이름 배열
      * @param meta.targetFn - 대상 Table factory
      * @param meta.description - 관계 설명
      */
     constructor(meta: {
-        ownerFn: () => TOwner;
         columns: string[];
         targetFn: TTargetFn;
         description?: string;
@@ -46,12 +47,12 @@ export declare class ForeignKeyBuilder<TOwner extends TableBuilder<any, any, any
  * description, single 설정은 factory 함수의 opts 파라미터로 전달한다.
  * 메서드 체이닝(.description(), .single())은 TypeScript 순환 참조 시 TS7022를 유발하므로 제거됨.
  *
- * @template TTargetTableFn - 참조하는 Table builder factory 타입
+ * @template TTargetTableFn - 참조하는 Table builder factory 타입 (무제약)
  * @template TIsSingle - 단일 객체 여부
  *
  * @see {@link ForeignKeyBuilder} FK builder
  */
-export declare class ForeignKeyTargetBuilder<TTargetTableFn extends () => TableBuilder<any, any, any>, TIsSingle extends boolean> {
+export declare class ForeignKeyTargetBuilder<TTargetTableFn, TIsSingle> {
     readonly meta: {
         targetTableFn: TTargetTableFn;
         relationName: string;
@@ -80,27 +81,23 @@ export declare class ForeignKeyTargetBuilder<TTargetTableFn extends () => TableB
  *
  * description 설정은 factory 함수의 opts 파라미터로 전달한다.
  *
- * @template TOwner - 소유 Table/View builder 타입
- * @template TTargetFn - 대상 Table/View builder factory 타입
+ * @template TTargetFn - 대상 Table/View builder factory 타입 (무제약)
  *
  * @see {@link ForeignKeyBuilder} DB FK 생성 버전
  */
-export declare class RelationKeyBuilder<TOwner extends TableBuilder<any, any, any> | ViewBuilder<any, any, any>, TTargetFn extends () => TableBuilder<any, any, any> | ViewBuilder<any, any, any>> {
+export declare class RelationKeyBuilder<TTargetFn> {
     readonly meta: {
-        ownerFn: () => TOwner;
         columns: string[];
         targetFn: TTargetFn;
         description?: string;
     };
     /**
      * @param meta - 관계 메타데이터
-     * @param meta.ownerFn - 소유 Table/View factory
      * @param meta.columns - 관계 column 이름 배열
      * @param meta.targetFn - 대상 Table/View factory
      * @param meta.description - 관계 설명
      */
     constructor(meta: {
-        ownerFn: () => TOwner;
         columns: string[];
         targetFn: TTargetFn;
         description?: string;
@@ -114,12 +111,12 @@ export declare class RelationKeyBuilder<TOwner extends TableBuilder<any, any, an
  *
  * description, single 설정은 factory 함수의 opts 파라미터로 전달한다.
  *
- * @template TTargetTableFn - 참조하는 Table/View builder factory 타입
+ * @template TTargetTableFn - 참조하는 Table/View builder factory 타입 (무제약)
  * @template TIsSingle - 단일 객체 여부
  *
  * @see {@link ForeignKeyTargetBuilder} DB FK 생성 버전
  */
-export declare class RelationKeyTargetBuilder<TTargetTableFn extends () => TableBuilder<any, any, any> | ViewBuilder<any, any, any>, TIsSingle extends boolean> {
+export declare class RelationKeyTargetBuilder<TTargetTableFn, TIsSingle> {
     readonly meta: {
         targetTableFn: TTargetTableFn;
         relationName: string;
@@ -143,20 +140,22 @@ export declare class RelationKeyTargetBuilder<TTargetTableFn extends () => Table
 /**
  * FK 관계 factory 타입 (table 전용)
  *
- * @template TOwner - 소유 Table builder 타입
+ * 컬럼 키 제약(`TColumnKey extends string`)은 self-contained 하므로 **유지**한다.
+ * 대상 타겟을 잡는 제네릭(`TTargetFn`/`TTargetTableFn`)은 **무제약**이다.
+ *
  * @template TColumnKey - Column key 타입
  */
-type RelationFkFactory<TOwner extends TableBuilder<any, any, any>, TColumnKey extends string> = {
+export type RelationFkFactory<TColumnKey extends string> = {
     /** N:1 FK 관계 정의 (DB FK 생성) */
-    foreignKey<TTargetFn extends () => TableBuilder<any, any, any>>(columns: TColumnKey[], targetFn: TTargetFn, opts?: {
+    foreignKey<TTargetFn>(columns: TColumnKey[], targetFn: TTargetFn, opts?: {
         description?: string;
-    }): ForeignKeyBuilder<TOwner, TTargetFn>;
+    }): ForeignKeyBuilder<TTargetFn>;
     /** 1:N FK 역참조 정의 (single: true → 단일 객체) */
-    foreignKeyTarget<TTargetTableFn extends () => TableBuilder<any, any, any>>(targetTableFn: TTargetTableFn, relationName: string, opts: {
+    foreignKeyTarget<TTargetTableFn>(targetTableFn: TTargetTableFn, relationName: string, opts: {
         single: true;
         description?: string;
     }): ForeignKeyTargetBuilder<TTargetTableFn, true>;
-    foreignKeyTarget<TTargetTableFn extends () => TableBuilder<any, any, any>>(targetTableFn: TTargetTableFn, relationName: string, opts?: {
+    foreignKeyTarget<TTargetTableFn>(targetTableFn: TTargetTableFn, relationName: string, opts?: {
         single?: false;
         description?: string;
     }): ForeignKeyTargetBuilder<TTargetTableFn, false>;
@@ -164,68 +163,75 @@ type RelationFkFactory<TOwner extends TableBuilder<any, any, any>, TColumnKey ex
 /**
  * 논리적 관계 factory 타입 (table/View 공용)
  *
- * @template TOwner - 소유 Table/View builder 타입
  * @template TColumnKey - Column key 타입
  */
-type RelationRkFactory<TOwner extends TableBuilder<any, any, any> | ViewBuilder<any, any, any>, TColumnKey extends string> = {
+export type RelationRkFactory<TColumnKey extends string> = {
     /** N:1 논리적 관계 정의 (DB FK 미생성) */
-    relationKey<TTargetFn extends () => TableBuilder<any, any, any> | ViewBuilder<any, any, any>>(columns: TColumnKey[], targetFn: TTargetFn, opts?: {
+    relationKey<TTargetFn>(columns: TColumnKey[], targetFn: TTargetFn, opts?: {
         description?: string;
-    }): RelationKeyBuilder<TOwner, TTargetFn>;
+    }): RelationKeyBuilder<TTargetFn>;
     /** 1:N 논리적 역참조 정의 (single: true → 단일 객체) */
-    relationKeyTarget<TTargetTableFn extends () => TableBuilder<any, any, any> | ViewBuilder<any, any, any>>(targetTableFn: TTargetTableFn, relationName: string, opts: {
+    relationKeyTarget<TTargetTableFn>(targetTableFn: TTargetTableFn, relationName: string, opts: {
         single: true;
         description?: string;
     }): RelationKeyTargetBuilder<TTargetTableFn, true>;
-    relationKeyTarget<TTargetTableFn extends () => TableBuilder<any, any, any> | ViewBuilder<any, any, any>>(targetTableFn: TTargetTableFn, relationName: string, opts?: {
+    relationKeyTarget<TTargetTableFn>(targetTableFn: TTargetTableFn, relationName: string, opts?: {
         single?: false;
         description?: string;
     }): RelationKeyTargetBuilder<TTargetTableFn, false>;
 };
+/**
+ * Table용 관계 factory (FK + RelationKey 모두 사용 가능)
+ */
+export type TableRelationFactory<TColumnKey extends string> = RelationFkFactory<TColumnKey> & RelationRkFactory<TColumnKey>;
+/**
+ * View용 관계 factory (RelationKey만 사용 가능)
+ */
+export type ViewRelationFactory<TColumnKey extends string> = RelationRkFactory<TColumnKey>;
 /**
  * 관계 builder factory 생성
  *
- * TableBuilder.relations()와 ViewBuilder.relations()에서 사용
- * Table은 FK + RelationKey 모두 사용 가능, View는 RelationKey만 사용 가능
+ * `TableBuilder.relations(fn)` / `ViewBuilder.relations(fn)` 의 콜백 인자로 전달된다.
+ * Table은 FK + RelationKey 모두 사용 가능, View는 RelationKey만 사용 가능.
  *
- * @template TOwner - 소유 Table/View builder 타입
  * @template TColumnKey - Column key 타입
- * @param ownerFn - 소유 Table/View factory 함수
  * @returns 관계 builder factory
  */
-export declare function createRelationFactory<TOwner extends TableBuilder<any, any, any> | ViewBuilder<any, any, any>, TColumnKey extends string>(ownerFn: () => TOwner): TOwner extends TableBuilder<any, any, any> ? RelationFkFactory<TOwner, TColumnKey> & RelationRkFactory<TOwner, TColumnKey> : RelationRkFactory<TOwner, TColumnKey>;
+export declare function createRelationFactory<TColumnKey extends string = string>(): TableRelationFactory<TColumnKey>;
 /**
  * 관계 builder 레코드 타입
  *
- * TableBuilder.relations()와 ViewBuilder.relations()의 반환 타입
+ * `TableBuilder.relations(fn)` / `ViewBuilder.relations(fn)` 콜백의 반환 타입.
  */
-export type RelationBuilderRecord = Record<string, ForeignKeyBuilder<any, any> | ForeignKeyTargetBuilder<any, any> | RelationKeyBuilder<any, any> | RelationKeyTargetBuilder<any, any>>;
+export type RelationBuilderRecord = Record<string, ForeignKeyBuilder<any> | ForeignKeyTargetBuilder<any, any> | RelationKeyBuilder<any> | RelationKeyTargetBuilder<any, any>>;
 /**
- * FK/RelationKey에서 대상 타입 추출 (단일 객체)
+ * FK/RelationKey에서 대상 타입 추출 (단일 객체, N:1)
  *
- * N:1 관계의 대상 타입
+ * 대상이 Table이면 컬럼 + 심층 관계, View면 데이터 + 심층 관계를 반환한다.
  *
- * @template T - FK 또는 RelationKey builder 타입
+ * @template TRelation - FK 또는 RelationKey builder 타입
+ * @template TVisited - 순환 방지를 위한 방문 테이블/뷰명 집합
  */
-export type ExtractRelationTarget<TRelation, TVisited extends string = never> = TRelation extends ForeignKeyBuilder<any, infer TTargetFn> | RelationKeyBuilder<any, infer TTargetFn> ? ReturnType<TTargetFn> extends TableBuilder<infer TName, infer TCols, infer TRels> ? TName extends TVisited ? InferColumns<TCols> : InferColumns<TCols> & InferDeepRelations<TRels, TVisited | TName> : ReturnType<TTargetFn> extends ViewBuilder<any, infer TData, infer TRels> ? TData & InferDeepRelations<TRels, TVisited> : never : never;
+export type ExtractRelationTarget<TRelation, TVisited extends string = never> = TRelation extends ForeignKeyBuilder<infer TTargetFn> | RelationKeyBuilder<infer TTargetFn> ? TTargetFn extends () => infer TTarget ? TTarget extends TableBuilder<infer TName, infer TCols, infer TRels> ? TName extends TVisited ? InferColumns<TCols> : InferColumns<TCols> & InferDeepRelations<TRels, TVisited | TName> : TTarget extends ViewBuilder<any, infer TVName, infer TData, infer TVRels> ? TVName extends TVisited ? TData : TData & InferDeepRelations<TVRels, TVisited | TVName> : never : never : never;
 /**
- * FKTarget/RelationKeyTarget에서 대상 타입 추출 (배열 또는 단일 객체)
+ * FKTarget/RelationKeyTarget에서 대상 타입 추출 (배열 또는 단일 객체, 1:N)
  *
- * 1:N 관계의 대상 타입 (opts.single: true 시 단일 객체)
- * TTargetTableFn: 순환 참조 방지를 위한 지연 평가용 () => Post 형태
+ * opts.single: true 시 단일 객체, 아니면 배열.
  *
- * @template T - FKTarget 또는 RelationKeyTarget builder 타입
+ * @template TRelation - FKTarget 또는 RelationKeyTarget builder 타입
+ * @template TVisited - 순환 방지를 위한 방문 테이블/뷰명 집합
  */
-export type ExtractRelationTargetResult<TRelation, TVisited extends string = never> = TRelation extends ForeignKeyTargetBuilder<infer TTargetTableFn, infer TIsSingle> | RelationKeyTargetBuilder<infer TTargetTableFn, infer TIsSingle> ? ReturnType<TTargetTableFn> extends TableBuilder<infer TName, infer TCols, infer TRels> ? TName extends TVisited ? TIsSingle extends true ? InferColumns<TCols> : InferColumns<TCols>[] : TIsSingle extends true ? InferColumns<TCols> & InferDeepRelations<TRels, TVisited | TName> : (InferColumns<TCols> & InferDeepRelations<TRels, TVisited | TName>)[] : ReturnType<TTargetTableFn> extends ViewBuilder<any, infer TData, infer TRels> ? TIsSingle extends true ? TData & InferDeepRelations<TRels, TVisited> : (TData & InferDeepRelations<TRels, TVisited>)[] : never : never;
+export type ExtractRelationTargetResult<TRelation, TVisited extends string = never> = TRelation extends ForeignKeyTargetBuilder<infer TTargetTableFn, infer TIsSingle> | RelationKeyTargetBuilder<infer TTargetTableFn, infer TIsSingle> ? TTargetTableFn extends () => infer TTarget ? TTarget extends TableBuilder<infer TName, infer TCols, infer TRels> ? TName extends TVisited ? TIsSingle extends true ? InferColumns<TCols> : InferColumns<TCols>[] : TIsSingle extends true ? InferColumns<TCols> & InferDeepRelations<TRels, TVisited | TName> : (InferColumns<TCols> & InferDeepRelations<TRels, TVisited | TName>)[] : TTarget extends ViewBuilder<any, infer TVName, infer TData, infer TVRels> ? TVName extends TVisited ? TIsSingle extends true ? TData : TData[] : TIsSingle extends true ? TData & InferDeepRelations<TVRels, TVisited | TVName> : (TData & InferDeepRelations<TVRels, TVisited | TVName>)[] : never : never : never;
 /**
- * 관계 정의에서 심층 관계 타입 추론
+ * 관계 레코드에서 심층 관계 타입 추론
  *
- * include() 없이 접근 시 undefined가 되도록 모든 관계를 optional로 설정
+ * include() 없이 접근 시 undefined가 되도록 모든 관계를 optional로 설정.
+ * 입력 제약 없음(무제약) — 관계가 없는(`{}`) 테이블도 안전하게 빈 객체로 해소된다.
  *
- * @template TRelations - 관계 builder 레코드 타입
+ * @template TRelations - 관계 builder 레코드 타입 (무제약)
+ * @template TVisited - 순환 방지를 위한 방문 테이블/뷰명 집합
  */
-export type InferDeepRelations<TRelations extends RelationBuilderRecord, TVisited extends string = never> = {
+export type InferDeepRelations<TRelations, TVisited extends string = never> = {
     [K in keyof TRelations]?: ExtractRelationTarget<TRelations[K], TVisited> | ExtractRelationTargetResult<TRelations[K], TVisited>;
 };
-export {};
 //# sourceMappingURL=relation-builder.d.ts.map

package/dist/schema/factory/relation-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relation-builder.d.ts","sourceRoot":"","sources":["../../../src/schema/factory/relation-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAiB,CAC5B,MAAM,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC1C,SAAS,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAUjD,QAAQ,CAAC,IAAI,EAAE;QACb,OAAO,EAAE,MAAM,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,SAAS,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IAbH;;;;;;OAMG;gBAEQ,IAAI,EAAE;QACb,OAAO,EAAE,MAAM,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,SAAS,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;CAEJ;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAuB,CAClC,cAAc,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACxD,SAAS,SAAS,OAAO;IAUvB,QAAQ,CAAC,IAAI,EAAE;QACb,aAAa,EAAE,cAAc,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB;IAbH;;;;;;OAMG;gBAEQ,IAAI,EAAE;QACb,aAAa,EAAE,cAAc,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB;CAEJ;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAkB,CAC7B,MAAM,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACvE,SAAS,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAU9E,QAAQ,CAAC,IAAI,EAAE;QACb,OAAO,EAAE,MAAM,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,SAAS,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IAbH;;;;;;OAMG;gBAEQ,IAAI,EAAE;QACb,OAAO,EAAE,MAAM,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,SAAS,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;CAEJ;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,wBAAwB,CACnC,cAAc,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACrF,SAAS,SAAS,OAAO;IAUvB,QAAQ,CAAC,IAAI,EAAE;QACb,aAAa,EAAE,cAAc,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB;IAbH;;;;;;OAMG;gBAEQ,IAAI,EAAE;QACb,aAAa,EAAE,cAAc,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB;CAEJ;AAED;;;;;GAKG;AACH,KAAK,iBAAiB,CAAC,MAAM,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,UAAU,SAAS,MAAM,IAAI;IAC9F,8BAA8B;IAC9B,UAAU,CAAC,SAAS,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC5D,OAAO,EAAE,UAAU,EAAE,EACrB,QAAQ,EAAE,SAAS,EACnB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,2CAA2C;IAC3C,gBAAgB,CAAC,cAAc,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACvE,aAAa,EAAE,cAAc,EAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,uBAAuB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACjD,gBAAgB,CAAC,cAAc,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACvE,aAAa,EAAE,cAAc,EAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,KAAK,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,uBAAuB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;GAKG;AACH,KAAK,iBAAiB,CACpB,MAAM,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACvE,UAAU,SAAS,MAAM,IACvB;IACF,gCAAgC;IAChC,WAAW,CAAC,SAAS,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC1F,OAAO,EAAE,UAAU,EAAE,EACrB,QAAQ,EAAE,SAAS,EACnB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,4CAA4C;IAC5C,iBAAiB,CACf,cAAc,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAErF,aAAa,EAAE,cAAc,EAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,wBAAwB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAClD,iBAAiB,CACf,cAAc,SAAS,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAErF,aAAa,EAAE,cAAc,EAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,KAAK,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,wBAAwB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACvE,UAAU,SAAS,MAAM,EAEzB,OAAO,EAAE,MAAM,MAAM,GACpB,MAAM,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GACzC,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,GAC7E,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAqCxC;AAMD;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CACxC,MAAM,EACJ,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,GAC3B,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,GACjC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,GAC5B,wBAAwB,CAAC,GAAG,EAAE,GAAG,CAAC,CACrC,CAAC;AAMF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,CAAC,SAAS,EAAE,QAAQ,SAAS,MAAM,GAAG,KAAK,IAAI,SAAS,SACrF,iBAAiB,CAAC,GAAG,EAAE,MAAM,SAAS,CAAC,GACvC,kBAAkB,CAAC,GAAG,EAAE,MAAM,SAAS,CAAC,GACxC,UAAU,CAAC,SAAS,CAAC,SAAS,YAAY,CAAC,MAAM,KAAK,EAAE,MAAM,KAAK,EAAE,MAAM,KAAK,CAAC,GAC/E,KAAK,SAAS,QAAQ,GACpB,YAAY,CAAC,KAAK,CAAC,GACnB,YAAY,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC,GACnE,UAAU,CAAC,SAAS,CAAC,SAAS,WAAW,CAAC,GAAG,EAAE,MAAM,KAAK,EAAE,MAAM,KAAK,CAAC,GACtE,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,GAC3C,KAAK,GACT,KAAK,CAAC;AAEV;;;;;;;GAOG;AACH,MAAM,MAAM,2BAA2B,CAAC,SAAS,EAAE,QAAQ,SAAS,MAAM,GAAG,KAAK,IAChF,SAAS,SACL,uBAAuB,CAAC,MAAM,cAAc,EAAE,MAAM,SAAS,CAAC,GAC9D,wBAAwB,CAAC,MAAM,cAAc,EAAE,MAAM,SAAS,CAAC,GAC/D,UAAU,CAAC,cAAc,CAAC,SAAS,YAAY,CAAC,MAAM,KAAK,EAAE,MAAM,KAAK,EAAE,MAAM,KAAK,CAAC,GACpF,KAAK,SAAS,QAAQ,GACpB,SAAS,SAAS,IAAI,GACpB,YAAY,CAAC,KAAK,CAAC,GACnB,YAAY,CAAC,KAAK,CAAC,EAAE,GACvB,SAAS,SAAS,IAAI,GACpB,YAAY,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC,GACjE,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,GACzE,UAAU,CAAC,cAAc,CAAC,SAAS,WAAW,CAAC,GAAG,EAAE,MAAM,KAAK,EAAE,MAAM,KAAK,CAAC,GAC3E,SAAS,SAAS,IAAI,GACpB,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,GAC3C,CAAC,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,GACjD,KAAK,GACT,KAAK,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,UAAU,SAAS,qBAAqB,EAAE,QAAQ,SAAS,MAAM,GAAG,KAAK,IAAI;KACzG,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,EACpB,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAC9C,2BAA2B,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;CACzD,CAAC"}
+{"version":3,"file":"relation-builder.d.ts","sourceRoot":"","sources":["../../../src/schema/factory/relation-builder.ts"],"names":[],"mappings":"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"}

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

@@ -11,8 +11,12 @@ import {} from "./column-builder.js";
  * description 설정은 factory 함수의 opts 파라미터로 전달한다.
  * 메서드 체이닝(.description())은 TypeScript 순환 참조 시 TS7022를 유발하므로 제거됨.
  *
- * @template TOwner - 소유 Table builder 타입
- * @template TTargetFn - 대상 Table builder factory 타입
+ * @template TTargetFn - 대상 Table builder factory 타입 (무제약)
+ *
+ * 대상 타겟을 잡는 제네릭은 **무제약**(`extends () => TableBuilder<...>` 제약 없음)이다.
+ * 제약이 있으면 모델 const 형성 중 `() => typeof X` 타겟 화살표를 eager 평가하여
+ * TS6 에서 순환 const(TS7022/7024)를 유발하기 때문이다. 대상 해소는 `$inferSelect`
+ * 접근 시점에 lazy 하게(`ExtractRelationTarget`) 이루어진다.
  *
  * @see {@link ForeignKeyTargetBuilder} 역참조 builder
  * @see {@link RelationKeyBuilder} DB FK 없는 관계
@@ -21,7 +25,6 @@ export class ForeignKeyBuilder {
     meta;
     /**
      * @param meta - FK 메타데이터
-     * @param meta.ownerFn - 소유 Table factory
      * @param meta.columns - FK column 이름 배열
      * @param meta.targetFn - 대상 Table factory
      * @param meta.description - 관계 설명
@@ -39,7 +42,7 @@ export class ForeignKeyBuilder {
  * description, single 설정은 factory 함수의 opts 파라미터로 전달한다.
  * 메서드 체이닝(.description(), .single())은 TypeScript 순환 참조 시 TS7022를 유발하므로 제거됨.
  *
- * @template TTargetTableFn - 참조하는 Table builder factory 타입
+ * @template TTargetTableFn - 참조하는 Table builder factory 타입 (무제약)
  * @template TIsSingle - 단일 객체 여부
  *
  * @see {@link ForeignKeyBuilder} FK builder
@@ -68,8 +71,7 @@ export class ForeignKeyTargetBuilder {
  *
  * description 설정은 factory 함수의 opts 파라미터로 전달한다.
  *
- * @template TOwner - 소유 Table/View builder 타입
- * @template TTargetFn - 대상 Table/View builder factory 타입
+ * @template TTargetFn - 대상 Table/View builder factory 타입 (무제약)
  *
  * @see {@link ForeignKeyBuilder} DB FK 생성 버전
  */
@@ -77,7 +79,6 @@ export class RelationKeyBuilder {
     meta;
     /**
      * @param meta - 관계 메타데이터
-     * @param meta.ownerFn - 소유 Table/View factory
      * @param meta.columns - 관계 column 이름 배열
      * @param meta.targetFn - 대상 Table/View factory
      * @param meta.description - 관계 설명
@@ -94,7 +95,7 @@ export class RelationKeyBuilder {
  *
  * description, single 설정은 factory 함수의 opts 파라미터로 전달한다.
  *
- * @template TTargetTableFn - 참조하는 Table/View builder factory 타입
+ * @template TTargetTableFn - 참조하는 Table/View builder factory 타입 (무제약)
  * @template TIsSingle - 단일 객체 여부
  *
  * @see {@link ForeignKeyTargetBuilder} DB FK 생성 버전
@@ -115,19 +116,16 @@ export class RelationKeyTargetBuilder {
 /**
  * 관계 builder factory 생성
  *
- * TableBuilder.relations()와 ViewBuilder.relations()에서 사용
- * Table은 FK + RelationKey 모두 사용 가능, View는 RelationKey만 사용 가능
+ * `TableBuilder.relations(fn)` / `ViewBuilder.relations(fn)` 의 콜백 인자로 전달된다.
+ * Table은 FK + RelationKey 모두 사용 가능, View는 RelationKey만 사용 가능.
  *
- * @template TOwner - 소유 Table/View builder 타입
  * @template TColumnKey - Column key 타입
- * @param ownerFn - 소유 Table/View factory 함수
  * @returns 관계 builder factory
  */
-export function createRelationFactory(ownerFn) {
+export function createRelationFactory() {
     return {
         foreignKey(columns, targetFn, opts) {
             return new ForeignKeyBuilder({
-                ownerFn: ownerFn,
                 columns,
                 targetFn,
                 description: opts?.description,
@@ -143,7 +141,6 @@ export function createRelationFactory(ownerFn) {
         },
         relationKey(columns, targetFn, opts) {
             return new RelationKeyBuilder({
-                ownerFn: ownerFn,
                 columns,
                 targetFn,
                 description: opts?.description,

package/dist/schema/factory/relation-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"relation-builder.js","sourceRoot":"","sources":["../../../src/schema/factory/relation-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,kBAAkB,CAAC;AAIrD,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C;AAE/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,iBAAiB;IAYjB;IARX;;;;;;OAMG;IACH,YACW,IAKR;QALQ,SAAI,GAAJ,IAAI,CAKZ;IACA,CAAC;CACL;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,uBAAuB;IAYvB;IARX;;;;;;OAMG;IACH,YACW,IAKR;QALQ,SAAI,GAAJ,IAAI,CAKZ;IACA,CAAC;CACL;AAED,+CAA+C;AAC/C,iDAAiD;AACjD,+CAA+C;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAkB;IAYlB;IARX;;;;;;OAMG;IACH,YACW,IAKR;QALQ,SAAI,GAAJ,IAAI,CAKZ;IACA,CAAC;CACL;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,wBAAwB;IAYxB;IARX;;;;;;OAMG;IACH,YACW,IAKR;QALQ,SAAI,GAAJ,IAAI,CAKZ;IACA,CAAC;CACL;AA6DD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAInC,OAAqB;IAIrB,OAAO;QACL,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAK;YACjC,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,OAAO,EAAE,OAA4C;gBACrD,OAAO;gBACP,QAAQ;gBACR,WAAW,EAAE,IAAI,EAAE,WAAW;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,gBAAgB,CAAC,aAAa,EAAE,YAAY,EAAE,IAAK;YACjD,OAAO,IAAI,uBAAuB,CAAC;gBACjC,aAAa;gBACb,YAAY;gBACZ,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,QAAQ,EAAE,IAAI,EAAE,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QACD,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAK;YAClC,OAAO,IAAI,kBAAkB,CAAC;gBAC5B,OAAO,EAAE,OAAO;gBAChB,OAAO;gBACP,QAAQ;gBACR,WAAW,EAAE,IAAI,EAAE,WAAW;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,iBAAiB,CAAC,aAAa,EAAE,YAAY,EAAE,IAAK;YAClD,OAAO,IAAI,wBAAwB,CAAC;gBAClC,aAAa;gBACb,YAAY;gBACZ,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,QAAQ,EAAE,IAAI,EAAE,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;KAGsC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"relation-builder.js","sourceRoot":"","sources":["../../../src/schema/factory/relation-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,kBAAkB,CAAC;AAIrD,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,iBAAiB;IAQjB;IAPX;;;;;OAKG;IACH,YACW,IAIR;QAJQ,SAAI,GAAJ,IAAI,CAIZ;IACA,CAAC;CACL;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,uBAAuB;IASvB;IARX;;;;;;OAMG;IACH,YACW,IAKR;QALQ,SAAI,GAAJ,IAAI,CAKZ;IACA,CAAC;CACL;AAED,+CAA+C;AAC/C,iDAAiD;AACjD,+CAA+C;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAkB;IAQlB;IAPX;;;;;OAKG;IACH,YACW,IAIR;QAJQ,SAAI,GAAJ,IAAI,CAIZ;IACA,CAAC;CACL;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,wBAAwB;IASxB;IARX;;;;;;OAMG;IACH,YACW,IAKR;QALQ,SAAI,GAAJ,IAAI,CAKZ;IACA,CAAC;CACL;AAsED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAK;YACjC,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,OAAO;gBACP,QAAQ;gBACR,WAAW,EAAE,IAAI,EAAE,WAAW;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,gBAAgB,CAAC,aAAa,EAAE,YAAY,EAAE,IAAK;YACjD,OAAO,IAAI,uBAAuB,CAAC;gBACjC,aAAa;gBACb,YAAY;gBACZ,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,QAAQ,EAAE,IAAI,EAAE,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QACD,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAK;YAClC,OAAO,IAAI,kBAAkB,CAAC;gBAC5B,OAAO;gBACP,QAAQ;gBACR,WAAW,EAAE,IAAI,EAAE,WAAW;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,iBAAiB,CAAC,aAAa,EAAE,YAAY,EAAE,IAAK;YAClD,OAAO,IAAI,wBAAwB,CAAC;gBAClC,aAAa;gBACb,YAAY;gBACZ,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,QAAQ,EAAE,IAAI,EAAE,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;KACkC,CAAC;AACxC,CAAC"}

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

@@ -1,19 +1,25 @@
 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";
+import { type InferDeepRelations, type TableRelationFactory } from "./factory/relation-builder";
 /**
  * Database Table 정의 builder
  *
  * Fluent API로 Table column, PK, index, 관계를 정의
  * DbContext의 queryable()과 함께 사용하여 타입 안전한 query 구성
  *
+ * 관계는 `.relations((r) => ({ ... }))` 메서드 체이닝으로 정의한다.
+ * 관계를 잡는 3번째 제네릭 `TRelations` 는 **무제약**이라, `() => typeof X` 타겟
+ * 화살표가 const 형성 중 eager 평가되지 않는다(TS6 순환 회피). 관계 대상 해소는
+ * `$inferSelect` 접근 시점에 lazy 하게 이루어진다.
+ *
+ * @template TName - Table 이름
  * @template TColumns - Column 정의 레코드 타입
- * @template TRelations - 관계 정의 레코드 타입
+ * @template TRelations - 관계 정의 레코드 타입 (무제약, 기본값 `{}`)
  *
  * @see {@link Table} factory 함수
  * @see {@link queryable} Queryable 생성
  */
-export declare class TableBuilder<TName extends string, TColumns extends ColumnBuilderRecord, TRelations extends RelationBuilderRecord> {
+export declare class TableBuilder<TName extends string, TColumns extends ColumnBuilderRecord, TRelations = {}> {
     readonly meta: {
         name: TName;
         description?: string;
@@ -24,11 +30,12 @@ export declare class TableBuilder<TName extends string, TColumns extends ColumnB
         relations?: TRelations;
         indexes?: IndexBuilder<(keyof TColumns & string)[]>[];
     };
-    /** Column 정의 (타입 추론용) */
-    readonly $columns: TColumns;
-    /** 관계 정의 (타입 추론용) */
-    readonly $relations: TRelations;
-    /** 전체 타입 추론 (column + 관계) — 순환 감지: 같은 테이블 재방문 시 끊김 */
+    /**
+     * 전체 타입 추론 (column + 관계).
+     *
+     * 관계는 `TRelations` 를 구조적으로 lazy walk 하여 다단계로 해소된다.
+     * (순환 감지: 같은 테이블 재방문 시 컬럼만 반환하여 끊김)
+     */
     readonly $inferSelect: InferColumns<TColumns> & InferDeepRelations<TRelations>;
     /** Column 전용 타입 추론 */
     readonly $inferColumns: InferColumns<TColumns>;
@@ -44,7 +51,7 @@ export declare class TableBuilder<TName extends string, TColumns extends ColumnB
      * @param meta.schema - Schema 이름 (MSSQL/PostgreSQL)
      * @param meta.columns - Column 정의
      * @param meta.primaryKey - PK column 배열
-     * @param meta.relations - 관계 정의
+     * @param meta.relations - 관계 정의 (런타임: `.relations(fn)` 호출 시 부착됨)
      * @param meta.indexes - Index 정의
      */
     constructor(meta: {
@@ -105,18 +112,28 @@ export declare class TableBuilder<TName extends string, TColumns extends ColumnB
      */
     indexes(fn: (i: ReturnType<typeof createIndexFactory<keyof TColumns & string>>) => IndexBuilder<string[]>[]): TableBuilder<TName, TColumns, TRelations>;
     /**
-     * 관계 정의
+     * 관계 정의 (FK / FKTarget / RelationKey / RelationKeyTarget)
      *
-     * FK, 역참조 등 Table 간 관계를 설정
+     * 관계 타입 `T` 는 **무제약**으로 추론되며, 내부적으로 런타임 결과를
+     * `meta.relations` 에 저장한다(`as any`). 무제약이므로 콜백 안의 `() => typeof X`
+     * 타겟 화살표가 const 형성 중 eager 평가되지 않아 TS6 순환을 회피한다.
      *
-     * @template T - 관계 정의 타입
-     * @param fn - 관계 factory를 받아 관계 정의를 반환하는 함수
-     * @returns 새 TableBuilder 인스턴스
+     * @example
+     * ```ts
+     * export const User = Table("User")
+     *   .columns((c) => ({ id: c.bigint().autoIncrement(), companyId: c.bigint().nullable() }))
+     *   .primaryKey("id")
+     *   .relations((r) => ({
+     *     company: r.foreignKey(["companyId"], () => Company),
+     *     posts: r.foreignKeyTarget(() => Post, "user"),
+     *   }));
+     * ```
      *
-     * @see {@link ForeignKeyBuilder} FK builder
-     * @see {@link ForeignKeyTargetBuilder} FK reverse-reference builder
+     * @template T - 관계 정의 레코드 타입 (무제약)
+     * @param fn - 관계 factory를 받아 관계 정의를 반환하는 함수
+     * @returns 관계가 부착된 새 TableBuilder 인스턴스
      */
-    relations<T extends RelationBuilderRecord>(fn: (r: ReturnType<typeof createRelationFactory<this, keyof TColumns & string>>) => T): TableBuilder<TName, TColumns, T>;
+    relations<T>(fn: (r: TableRelationFactory<keyof TColumns & string>) => T): TableBuilder<TName, TColumns, T>;
 }
 /**
  * Table builder factory 함수
@@ -128,5 +145,5 @@ export declare class TableBuilder<TName extends string, TColumns extends ColumnB
  *
  * @see {@link TableBuilder} builder 클래스
  */
-export declare function Table<TName extends string>(name: TName): TableBuilder<TName, ColumnBuilderRecord, RelationBuilderRecord>;
+export declare function Table<TName extends string>(name: TName): TableBuilder<TName, ColumnBuilderRecord, {}>;
 //# sourceMappingURL=table-builder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"table-builder.d.ts","sourceRoot":"","sources":["../../src/schema/table-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"table-builder.d.ts","sourceRoot":"","sources":["../../src/schema/table-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AAMpC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAY,CACvB,KAAK,SAAS,MAAM,EACpB,QAAQ,SAAS,mBAAmB,EACpC,UAAU,GAAG,EAAE;IA4Bb,QAAQ,CAAC,IAAI,EAAE;QACb,IAAI,EAAE,KAAK,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,UAAU,CAAC,EAAE,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;QACzC,SAAS,CAAC,EAAE,UAAU,CAAC;QACvB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;KACvD;IApCH;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChF,sBAAsB;IACtB,QAAQ,CAAC,aAAa,EAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChD,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrD,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAErD;;;;;;;;;;OAUG;gBAEQ,IAAI,EAAE;QACb,IAAI,EAAE,KAAK,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,UAAU,CAAC,EAAE,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;QACzC,SAAS,CAAC,EAAE,UAAU,CAAC;QACvB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;KACvD;IAGH;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;IAIpE;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;IAI/D;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;IAIjE;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc,SAAS,mBAAmB,EAChD,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,KAAK,cAAc,GAChE,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,UAAU,CAAC;IAOlD;;;;;OAKG;IACH,UAAU,CAAC,GAAG,OAAO,EAAE,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;IAO9F;;;;;OAKG;IACH,OAAO,CACL,EAAE,EAAE,CACF,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,KAC9D,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,GAC5B,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;IAO5C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,CAAC,EACT,EAAE,EAAE,CAAC,CAAC,EAAE,oBAAoB,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAC1D,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;CAMpC;AAMD;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,EAAE,KAAK,gDAEtD"}

package/dist/schema/table-builder.js

@@ -10,19 +10,26 @@ import { createRelationFactory, } from "./factory/relation-builder.js";
  * Fluent API로 Table column, PK, index, 관계를 정의
  * DbContext의 queryable()과 함께 사용하여 타입 안전한 query 구성
  *
+ * 관계는 `.relations((r) => ({ ... }))` 메서드 체이닝으로 정의한다.
+ * 관계를 잡는 3번째 제네릭 `TRelations` 는 **무제약**이라, `() => typeof X` 타겟
+ * 화살표가 const 형성 중 eager 평가되지 않는다(TS6 순환 회피). 관계 대상 해소는
+ * `$inferSelect` 접근 시점에 lazy 하게 이루어진다.
+ *
+ * @template TName - Table 이름
  * @template TColumns - Column 정의 레코드 타입
- * @template TRelations - 관계 정의 레코드 타입
+ * @template TRelations - 관계 정의 레코드 타입 (무제약, 기본값 `{}`)
  *
  * @see {@link Table} factory 함수
  * @see {@link queryable} Queryable 생성
  */
 export class TableBuilder {
     meta;
-    /** Column 정의 (타입 추론용) */
-    $columns;
-    /** 관계 정의 (타입 추론용) */
-    $relations;
-    /** 전체 타입 추론 (column + 관계) — 순환 감지: 같은 테이블 재방문 시 끊김 */
+    /**
+     * 전체 타입 추론 (column + 관계).
+     *
+     * 관계는 `TRelations` 를 구조적으로 lazy walk 하여 다단계로 해소된다.
+     * (순환 감지: 같은 테이블 재방문 시 컬럼만 반환하여 끊김)
+     */
     $inferSelect;
     /** Column 전용 타입 추론 */
     $inferColumns;
@@ -38,7 +45,7 @@ export class TableBuilder {
      * @param meta.schema - Schema 이름 (MSSQL/PostgreSQL)
      * @param meta.columns - Column 정의
      * @param meta.primaryKey - PK column 배열
-     * @param meta.relations - 관계 정의
+     * @param meta.relations - 관계 정의 (런타임: `.relations(fn)` 호출 시 부착됨)
      * @param meta.indexes - Index 정의
      */
     constructor(meta) {
@@ -113,21 +120,31 @@ export class TableBuilder {
         });
     }
     /**
-     * 관계 정의
+     * 관계 정의 (FK / FKTarget / RelationKey / RelationKeyTarget)
      *
-     * FK, 역참조 등 Table 간 관계를 설정
+     * 관계 타입 `T` 는 **무제약**으로 추론되며, 내부적으로 런타임 결과를
+     * `meta.relations` 에 저장한다(`as any`). 무제약이므로 콜백 안의 `() => typeof X`
+     * 타겟 화살표가 const 형성 중 eager 평가되지 않아 TS6 순환을 회피한다.
      *
-     * @template T - 관계 정의 타입
-     * @param fn - 관계 factory를 받아 관계 정의를 반환하는 함수
-     * @returns 새 TableBuilder 인스턴스
+     * @example
+     * ```ts
+     * export const User = Table("User")
+     *   .columns((c) => ({ id: c.bigint().autoIncrement(), companyId: c.bigint().nullable() }))
+     *   .primaryKey("id")
+     *   .relations((r) => ({
+     *     company: r.foreignKey(["companyId"], () => Company),
+     *     posts: r.foreignKeyTarget(() => Post, "user"),
+     *   }));
+     * ```
      *
-     * @see {@link ForeignKeyBuilder} FK builder
-     * @see {@link ForeignKeyTargetBuilder} FK reverse-reference builder
+     * @template T - 관계 정의 레코드 타입 (무제약)
+     * @param fn - 관계 factory를 받아 관계 정의를 반환하는 함수
+     * @returns 관계가 부착된 새 TableBuilder 인스턴스
      */
     relations(fn) {
         return new TableBuilder({
             ...this.meta,
-            relations: fn(createRelationFactory(() => this)),
+            relations: fn(createRelationFactory()),
         });
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"table-builder.js","sourceRoot":"","sources":["../../src/schema/table-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,GAIpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACL,qBAAqB,GAGtB,MAAM,4BAA4B,CAAC;AAEpC,+CAA+C;AAC/C,eAAe;AACf,+CAA+C;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IA+BZ;IA1BX,yBAAyB;IAChB,QAAQ,CAAY;IAC7B,qBAAqB;IACZ,UAAU,CAAc;IAEjC,sDAAsD;IAC7C,YAAY,CAA2D;IAChF,sBAAsB;IACb,aAAa,CAA0B;IAChD,kEAAkE;IACzD,YAAY,CAAgC;IACrD,oCAAoC;IAC3B,YAAY,CAAgC;IAErD;;;;;;;;;;OAUG;IACH,YACW,IAUR;QAVQ,SAAI,GAAJ,IAAI,CAUZ;IACA,CAAC;IAEJ;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CACL,EAAiE;QAEjE,OAAO,IAAI,YAAY,CAAoC;YACzD,GAAG,IAAI,CAAC,IAAI;YACZ,OAAO,EAAE,EAAE,CAAC,mBAAmB,EAAE,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,GAAG,OAAoC;QAChD,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,IAAI,CAAC,IAAI;YACZ,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,OAAO,CACL,EAE6B;QAE7B,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,IAAI,CAAC,IAAI;YACZ,OAAO,EAAE,EAAE,CAAC,kBAAkB,EAA2B,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CACP,EAAqF;QAErF,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,IAAI,CAAC,IAAI;YACZ,SAAS,EAAE,EAAE,CAAC,qBAAqB,CAAgC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;SAChF,CAAC,CAAC;IACL,CAAC;CACF;AAED,+CAA+C;AAC/C,WAAW;AACX,+CAA+C;AAE/C;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAuB,IAAW;IACrD,OAAO,IAAI,YAAY,CAAoD,EAAE,IAAI,EAAE,CAAC,CAAC;AACvF,CAAC"}
+{"version":3,"file":"table-builder.js","sourceRoot":"","sources":["../../src/schema/table-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,GAIpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACL,qBAAqB,GAGtB,MAAM,4BAA4B,CAAC;AAEpC,+CAA+C;AAC/C,eAAe;AACf,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,YAAY;IA+BZ;IA1BX;;;;;OAKG;IACM,YAAY,CAA2D;IAChF,sBAAsB;IACb,aAAa,CAA0B;IAChD,kEAAkE;IACzD,YAAY,CAAgC;IACrD,oCAAoC;IAC3B,YAAY,CAAgC;IAErD;;;;;;;;;;OAUG;IACH,YACW,IAUR;QAVQ,SAAI,GAAJ,IAAI,CAUZ;IACA,CAAC;IAEJ;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CACL,EAAiE;QAEjE,OAAO,IAAI,YAAY,CAAoC;YACzD,GAAG,IAAI,CAAC,IAAI;YACZ,OAAO,EAAE,EAAE,CAAC,mBAAmB,EAAE,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,GAAG,OAAoC;QAChD,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,IAAI,CAAC,IAAI;YACZ,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,OAAO,CACL,EAE6B;QAE7B,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,IAAI,CAAC,IAAI;YACZ,OAAO,EAAE,EAAE,CAAC,kBAAkB,EAA2B,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CACP,EAA2D;QAE3D,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,IAAI,CAAC,IAAI;YACZ,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAA2B,CAAQ;SACvE,CAAC,CAAC;IACL,CAAC;CACF;AAED,+CAA+C;AAC/C,WAAW;AACX,+CAA+C;AAE/C;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAuB,IAAW;IACrD,OAAO,IAAI,YAAY,CAAiC,EAAE,IAAI,EAAE,CAAC,CAAC;AACpE,CAAC"}