@simplysm/orm-common 13.0.99 → 14.0.1

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

@@ -1,142 +1,280 @@
 import {} from "./column-builder.js";
-class ForeignKeyBuilder {
-  /**
-   * @param meta - FK Metadata
-   * @param meta.ownerFn - Owner Table factory
-   * @param meta.columns - FK column name array
-   * @param meta.targetFn - Target Table factory
-   * @param meta.description - Relation description
-   */
-  constructor(meta) {
-    this.meta = meta;
-  }
-  /**
-   * Set relation description
-   *
-   * @param desc - Relation description
-   * @returns New ForeignKeyBuilder instance
-   */
-  description(desc) {
-    return new ForeignKeyBuilder({ ...this.meta, description: desc });
-  }
-}
-class ForeignKeyTargetBuilder {
-  /**
-   * @param meta - FK reverse-reference Metadata
-   * @param meta.targetTableFn - Referencing Table factory
-   * @param meta.relationName - FK relation name of the referencing Table
-   * @param meta.description - Relation description
-   * @param meta.isSingle - Whether it is a single object
-   */
-  constructor(meta) {
-    this.meta = meta;
-  }
-  /**
-   * Set relation description
-   *
-   * @param desc - Relation description
-   * @returns New ForeignKeyTargetBuilder instance
-   */
-  description(desc) {
-    return new ForeignKeyTargetBuilder({ ...this.meta, description: desc });
-  }
-  /**
-   * Set as single object relation (1:1)
-   *
-   * Default is array (1:N), single object when single() is called
-   *
-   * @returns New ForeignKeyTargetBuilder instance (isSingle=true)
-   *
-   * @example
-   * ```typescript
-   * profile: r.foreignKeyTarget(() => Profile, "user").single()
-   * ```
-   */
-  single() {
-    return new ForeignKeyTargetBuilder({ ...this.meta, isSingle: true });
-  }
+// ============================================
+// ForeignKeyBuilder
+// ============================================
+/**
+ * Foreign Key 관계 builder (N:1)
+ *
+ * 현재 Table에서 대상 Table로의 FK 관계를 정의
+ * DB에 실제 FK 제약조건을 생성
+ *
+ * @template TOwner - 소유 Table builder 타입
+ * @template TTargetFn - 대상 Table builder factory 타입
+ *
+ * @example
+ * ```typescript
+ * const Post = Table("Post")
+ *   .columns((c) => ({
+ *     id: c.bigint().autoIncrement(),
+ *     authorId: c.bigint(),  // FK column
+ *   }))
+ *   .primaryKey("id")
+ *   .relations((r) => ({
+ *     // N:1 relationship - Post → User
+ *     author: r.foreignKey(["authorId"], () => User),
+ *   }));
+ * ```
+ *
+ * @see {@link ForeignKeyTargetBuilder} 역참조 builder
+ * @see {@link RelationKeyBuilder} DB FK 없는 관계
+ */
+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 - 관계 설명
+     */
+    constructor(meta) {
+        this.meta = meta;
+    }
+    /**
+     * 관계 설명 설정
+     *
+     * @param desc - 관계 설명
+     * @returns 새 ForeignKeyBuilder 인스턴스
+     */
+    description(desc) {
+        return new ForeignKeyBuilder({ ...this.meta, description: desc });
+    }
 }
-class RelationKeyBuilder {
-  /**
-   * @param meta - Relation Metadata
-   * @param meta.ownerFn - Owner Table/View factory
-   * @param meta.columns - Relation column name array
-   * @param meta.targetFn - Target Table/View factory
-   * @param meta.description - Relation description
-   */
-  constructor(meta) {
-    this.meta = meta;
-  }
-  /**
-   * Set relation description
-   *
-   * @param desc - Relation description
-   * @returns New RelationKeyBuilder instance
-   */
-  description(desc) {
-    return new RelationKeyBuilder({ ...this.meta, description: desc });
-  }
+/**
+ * Foreign Key 역참조 builder (1:N)
+ *
+ * 다른 Table이 현재 Table을 참조하는 FK의 역참조를 정의
+ * include() 시 배열로 로드됨 (single() 호출 시 단일 객체)
+ *
+ * @template TTargetTableFn - 참조하는 Table builder factory 타입
+ * @template TIsSingle - 단일 객체 여부
+ *
+ * @example
+ * ```typescript
+ * const User = Table("User")
+ *   .columns((c) => ({
+ *     id: c.bigint().autoIncrement(),
+ *     name: c.varchar(100),
+ *   }))
+ *   .primaryKey("id")
+ *   .relations((r) => ({
+ *     // 1:N relationship - User ← Post.author
+ *     posts: r.foreignKeyTarget(() => Post, "author"),
+ *
+ *     // 1:1 relation (single object)
+ *     profile: r.foreignKeyTarget(() => Profile, "user").single(),
+ *   }));
+ * ```
+ *
+ * @see {@link ForeignKeyBuilder} FK builder
+ */
+export class ForeignKeyTargetBuilder {
+    meta;
+    /**
+     * @param meta - FK 역참조 메타데이터
+     * @param meta.targetTableFn - 참조하는 Table factory
+     * @param meta.relationName - 참조하는 Table의 FK 관계 이름
+     * @param meta.description - 관계 설명
+     * @param meta.isSingle - 단일 객체 여부
+     */
+    constructor(meta) {
+        this.meta = meta;
+    }
+    /**
+     * 관계 설명 설정
+     *
+     * @param desc - 관계 설명
+     * @returns 새 ForeignKeyTargetBuilder 인스턴스
+     */
+    description(desc) {
+        return new ForeignKeyTargetBuilder({ ...this.meta, description: desc });
+    }
+    /**
+     * 단일 객체 관계로 설정 (1:1)
+     *
+     * 기본값은 배열(1:N), single() 호출 시 단일 객체
+     *
+     * @returns 새 ForeignKeyTargetBuilder 인스턴스 (isSingle=true)
+     *
+     * @example
+     * ```typescript
+     * profile: r.foreignKeyTarget(() => Profile, "user").single()
+     * ```
+     */
+    single() {
+        return new ForeignKeyTargetBuilder({ ...this.meta, isSingle: true });
+    }
 }
-class RelationKeyTargetBuilder {
-  /**
-   * @param meta - Relation reverse-reference Metadata
-   * @param meta.targetTableFn - Referencing Table/View factory
-   * @param meta.relationName - Relation name of the referencing Table/View
-   * @param meta.description - Relation description
-   * @param meta.isSingle - Whether it is a single object
-   */
-  constructor(meta) {
-    this.meta = meta;
-  }
-  /**
-   * Set relation description
-   *
-   * @param desc - Relation description
-   * @returns New RelationKeyTargetBuilder instance
-   */
-  description(desc) {
-    return new RelationKeyTargetBuilder({ ...this.meta, description: desc });
-  }
-  /**
-   * Set as single object relation (1:1)
-   *
-   * Default is array (1:N), single object when single() is called
-   *
-   * @returns New RelationKeyTargetBuilder instance (isSingle=true)
-   */
-  single() {
-    return new RelationKeyTargetBuilder({ ...this.meta, isSingle: true });
-  }
+// ============================================
+// RelationKeyBuilder (same as FK but does not register FK in DB)
+// ============================================
+/**
+ * 논리적 관계 builder (N:1) - DB FK 미생성
+ *
+ * ForeignKeyBuilder와 동일하지만 DB에 FK 제약조건을 생성하지 않음
+ * View에서도 사용 가능
+ *
+ * @template TOwner - 소유 Table/View builder 타입
+ * @template TTargetFn - 대상 Table/View builder factory 타입
+ *
+ * @example
+ * ```typescript
+ * // Relation definition from View to Table
+ * const UserSummary = View("UserSummary")
+ *   .query((db: MyDb) => db.user().select(...))
+ *   .relations((r) => ({
+ *     // View → Table (no FK creation)
+ *     company: r.relationKey(["companyId"], () => Company),
+ *   }));
+ *
+ * // Relation definition from Table without FK
+ * const Report = Table("Report")
+ *   .columns((c) => ({ userId: c.bigint() }))
+ *   .relations((r) => ({
+ *     user: r.relationKey(["userId"], () => User),
+ *   }));
+ * ```
+ *
+ * @see {@link ForeignKeyBuilder} DB FK 생성 버전
+ */
+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 - 관계 설명
+     */
+    constructor(meta) {
+        this.meta = meta;
+    }
+    /**
+     * 관계 설명 설정
+     *
+     * @param desc - 관계 설명
+     * @returns 새 RelationKeyBuilder 인스턴스
+     */
+    description(desc) {
+        return new RelationKeyBuilder({ ...this.meta, description: desc });
+    }
 }
-function createRelationFactory(ownerFn) {
-  return {
-    foreignKey(columns, targetFn) {
-      return new ForeignKeyBuilder({
-        ownerFn,
-        columns,
-        targetFn
-      });
-    },
-    foreignKeyTarget(targetTableFn, relationName) {
-      return new ForeignKeyTargetBuilder({ targetTableFn, relationName });
-    },
-    relationKey(columns, targetFn) {
-      return new RelationKeyBuilder({
-        ownerFn,
-        columns,
-        targetFn
-      });
-    },
-    relationKeyTarget(targetTableFn, relationName) {
-      return new RelationKeyTargetBuilder({ targetTableFn, relationName });
+/**
+ * 논리적 관계 역참조 builder (1:N) - DB FK 미생성
+ *
+ * ForeignKeyTargetBuilder와 동일하지만 DB에 FK 제약조건을 생성하지 않음
+ * View에서도 사용 가능
+ *
+ * @template TTargetTableFn - 참조하는 Table/View builder factory 타입
+ * @template TIsSingle - 단일 객체 여부
+ *
+ * @example
+ * ```typescript
+ * const Company = Table("Company")
+ *   .columns((c) => ({ id: c.bigint() }))
+ *   .relations((r) => ({
+ *     // Reverse-reference (no FK creation)
+ *     employees: r.relationKeyTarget(() => UserSummary, "company"),
+ *   }));
+ * ```
+ *
+ * @see {@link ForeignKeyTargetBuilder} DB FK 생성 버전
+ */
+export class RelationKeyTargetBuilder {
+    meta;
+    /**
+     * @param meta - 관계 역참조 메타데이터
+     * @param meta.targetTableFn - 참조하는 Table/View factory
+     * @param meta.relationName - 참조하는 Table/View의 관계 이름
+     * @param meta.description - 관계 설명
+     * @param meta.isSingle - 단일 객체 여부
+     */
+    constructor(meta) {
+        this.meta = meta;
+    }
+    /**
+     * 관계 설명 설정
+     *
+     * @param desc - 관계 설명
+     * @returns 새 RelationKeyTargetBuilder 인스턴스
+     */
+    description(desc) {
+        return new RelationKeyTargetBuilder({ ...this.meta, description: desc });
     }
-  };
+    /**
+     * 단일 객체 관계로 설정 (1:1)
+     *
+     * 기본값은 배열(1:N), single() 호출 시 단일 객체
+     *
+     * @returns 새 RelationKeyTargetBuilder 인스턴스 (isSingle=true)
+     */
+    single() {
+        return new RelationKeyTargetBuilder({ ...this.meta, isSingle: true });
+    }
+}
+/**
+ * 관계 builder factory 생성
+ *
+ * TableBuilder.relations()와 ViewBuilder.relations()에서 사용
+ * Table은 FK + RelationKey 모두 사용 가능, View는 RelationKey만 사용 가능
+ *
+ * @template TOwner - 소유 Table/View builder 타입
+ * @template TColumnKey - Column key 타입
+ * @param ownerFn - 소유 Table/View factory 함수
+ * @returns 관계 builder factory
+ *
+ * @example
+ * ```typescript
+ * // Table - both FK and RelationKey available
+ * const Post = Table("Post")
+ *   .columns((c) => ({
+ *     id: c.bigint(),
+ *     authorId: c.bigint(),
+ *   }))
+ *   .relations((r) => ({
+ *     author: r.foreignKey(["authorId"], () => User),  // FK Generate
+ *   }));
+ *
+ * // View - only RelationKey available
+ * const UserSummary = View("UserSummary")
+ *   .query(...)
+ *   .relations((r) => ({
+ *     posts: r.relationKeyTarget(() => Post, "author"),  // No FK creation
+ *   }));
+ * ```
+ */
+export function createRelationFactory(ownerFn) {
+    return {
+        foreignKey(columns, targetFn) {
+            return new ForeignKeyBuilder({
+                ownerFn: ownerFn,
+                columns,
+                targetFn,
+            });
+        },
+        foreignKeyTarget(targetTableFn, relationName) {
+            return new ForeignKeyTargetBuilder({ targetTableFn, relationName });
+        },
+        relationKey(columns, targetFn) {
+            return new RelationKeyBuilder({
+                ownerFn: ownerFn,
+                columns,
+                targetFn,
+            });
+        },
+        relationKeyTarget(targetTableFn, relationName) {
+            return new RelationKeyTargetBuilder({ targetTableFn, relationName });
+        },
+    };
 }
-export {
-  ForeignKeyBuilder,
-  ForeignKeyTargetBuilder,
-  RelationKeyBuilder,
-  RelationKeyTargetBuilder,
-  createRelationFactory
-};
-//# sourceMappingURL=relation-builder.js.map
+//# sourceMappingURL=relation-builder.js.map

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

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../../src/schema/factory/relation-builder.ts"],
-  "mappings": "AAAA,eAAkC;AAkC3B,MAAM,kBAGX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YACW,MAMT;AANS;AAAA,EAMR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQH,YAAY,MAAoD;AAC9D,WAAO,IAAI,kBAAkB,EAAE,GAAG,KAAK,MAAM,aAAa,KAAK,CAAC;AAAA,EAClE;AACF;AA8BO,MAAM,wBAGX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YACW,MAMT;AANS;AAAA,EAMR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQH,YAAY,MAAkE;AAC5E,WAAO,IAAI,wBAAwB,EAAE,GAAG,KAAK,MAAM,aAAa,KAAK,CAAC;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,SAAwD;AACtD,WAAO,IAAI,wBAAwB,EAAE,GAAG,KAAK,MAAM,UAAU,KAAK,CAAC;AAAA,EACrE;AACF;AAmCO,MAAM,mBAGX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YACW,MAMT;AANS;AAAA,EAMR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQH,YAAY,MAAqD;AAC/D,WAAO,IAAI,mBAAmB,EAAE,GAAG,KAAK,MAAM,aAAa,KAAK,CAAC;AAAA,EACnE;AACF;AAuBO,MAAM,yBAGX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YACW,MAMT;AANS;AAAA,EAMR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQH,YAAY,MAAmE;AAC7E,WAAO,IAAI,yBAAyB,EAAE,GAAG,KAAK,MAAM,aAAa,KAAK,CAAC;AAAA,EACzE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,SAAyD;AACvD,WAAO,IAAI,yBAAyB,EAAE,GAAG,KAAK,MAAM,UAAU,KAAK,CAAC;AAAA,EACtE;AACF;AA4EO,SAAS,sBAId,SAGwC;AACxC,SAAO;AAAA,IACL,WAAW,SAAS,UAAU;AAC5B,aAAO,IAAI,kBAAkB;AAAA,QAC3B;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,iBAAiB,eAAe,cAAc;AAC5C,aAAO,IAAI,wBAAwB,EAAE,eAAe,aAAa,CAAC;AAAA,IACpE;AAAA,IACA,YAAY,SAAS,UAAU;AAC7B,aAAO,IAAI,mBAAmB;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,kBAAkB,eAAe,cAAc;AAC7C,aAAO,IAAI,yBAAyB,EAAE,eAAe,aAAa,CAAC;AAAA,IACrE;AAAA,EACF;AAGF;",
-  "names": []
-}
+{"version":3,"file":"relation-builder.js","sourceRoot":"","sources":["..\\..\\..\\src\\schema\\factory\\relation-builder.ts"],"names":[],"mappings":"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"}

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

@@ -1,12 +1,12 @@
 import { type ColumnBuilderRecord, createColumnFactory } from "./factory/column-builder";
 /**
- * Stored Procedure definition builder
+ * Stored Procedure 정의 builder
  *
- * Define Procedure parameters, return type, and body via Fluent API
- * Use with DbContext's executable() for type-safe Procedure invocation
+ * Fluent API로 Procedure 파라미터, 반환 타입, 본문을 정의
+ * DbContext의 executable()과 함께 사용하여 타입 안전한 Procedure 호출
  *
- * @template TParams - Parameter Column definition type
- * @template TReturns - Return Column definition type
+ * @template TParams - 파라미터 Column 정의 타입
+ * @template TReturns - 반환 Column 정의 타입
  *
  * @example
  * ```typescript
@@ -32,8 +32,8 @@ import { type ColumnBuilderRecord, createColumnFactory } from "./factory/column-
  * const users = await db.getUserById({ userId: 1n }).execute();
  * ```
  *
- * @see {@link Procedure} factory function
- * @see {@link executable} Executable Generate
+ * @see {@link Procedure} factory 함수
+ * @see {@link executable} Executable 생성
  */
 export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TReturns extends ColumnBuilderRecord> {
     readonly meta: {
@@ -45,19 +45,19 @@ export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TRetu
         returns?: TReturns;
         query?: string;
     };
-    /** Parameter definition (type for inference) */
+    /** 파라미터 정의 (타입 추론용) */
     readonly $params: TParams;
-    /** return type definition (type for inference) */
+    /** 반환 타입 정의 (타입 추론용) */
     readonly $returns: TReturns;
     /**
-     * @param meta - Procedure Metadata
-     * @param meta.name - Procedure name
-     * @param meta.description - Procedure description (comment)
-     * @param meta.database - Database name
-     * @param meta.schema - Schema name (MSSQL/PostgreSQL)
-     * @param meta.params - Parameter definition
-     * @param meta.returns - Return type definition
-     * @param meta.query - Procedure body SQL
+     * @param meta - Procedure 메타데이터
+     * @param meta.name - Procedure 이름
+     * @param meta.description - Procedure 설명 (comment)
+     * @param meta.database - Database 이름
+     * @param meta.schema - Schema 이름 (MSSQL/PostgreSQL)
+     * @param meta.params - 파라미터 정의
+     * @param meta.returns - 반환 타입 정의
+     * @param meta.query - Procedure 본문 SQL
      */
     constructor(meta: {
         name: string;
@@ -69,17 +69,17 @@ export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TRetu
         query?: string;
     });
     /**
-     * Procedure set description
+     * Procedure 설명 설정
      *
-     * @param desc - Procedure description (used as DDL Comment)
-     * @returns new ProcedureBuilder instance
+     * @param desc - Procedure 설명 (DDL Comment로 사용됨)
+     * @returns 새 ProcedureBuilder 인스턴스
      */
     description(desc: string): ProcedureBuilder<TParams, TReturns>;
     /**
-     * Database set name
+     * Database 이름 설정
      *
-     * @param db - Database name
-     * @returns new ProcedureBuilder instance
+     * @param db - Database 이름
+     * @returns 새 ProcedureBuilder 인스턴스
      *
      * @example
      * ```typescript
@@ -88,23 +88,23 @@ export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TRetu
      */
     database(db: string): ProcedureBuilder<TParams, TReturns>;
     /**
-     * schema set name
+     * Schema 이름 설정
      *
-     * MSSQL, PostgreSQLused in
+     * MSSQL, PostgreSQL에서 사용
      *
-     * @param schema - Schema name (MSSQL: dbo, PostgreSQL: public)
-     * @returns new ProcedureBuilder instance
+     * @param schema - Schema 이름 (MSSQL: dbo, PostgreSQL: public)
+     * @returns 새 ProcedureBuilder 인스턴스
      */
     schema(schema: string): ProcedureBuilder<TParams, TReturns>;
     /**
-     * Parameter definition
+     * 파라미터 정의
      *
-     * Define Procedure input parameters
-     * Note DBMS-specific parameter syntax differences (MSSQL: @param, MySQL/PostgreSQL: param)
+     * Procedure 입력 파라미터를 정의
+     * DBMS별 파라미터 구문 차이에 주의 (MSSQL: @param, MySQL/PostgreSQL: param)
      *
-     * @template T - New parameter definition type
-     * @param fn - Function that receives a Column factory and returns parameter definitions
-     * @returns new ProcedureBuilder instance
+     * @template T - 새 파라미터 정의 타입
+     * @param fn - Column factory를 받아 파라미터 정의를 반환하는 함수
+     * @returns 새 ProcedureBuilder 인스턴스
      *
      * @example
      * ```typescript
@@ -117,13 +117,13 @@ export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TRetu
      */
     params<T extends ColumnBuilderRecord>(fn: (c: ReturnType<typeof createColumnFactory>) => T): ProcedureBuilder<T, TReturns>;
     /**
-     * Return type definition
+     * 반환 타입 정의
      *
-     * Define Procedure return result columns
+     * Procedure 반환 결과 column을 정의
      *
-     * @template T - New return type definition
-     * @param fn - Function that receives a Column factory and returns Column definitions
-     * @returns new ProcedureBuilder instance
+     * @template T - 새 반환 타입 정의
+     * @param fn - Column factory를 받아 column 정의를 반환하는 함수
+     * @returns 새 ProcedureBuilder 인스턴스
      *
      * @example
      * ```typescript
@@ -138,15 +138,15 @@ export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TRetu
      */
     returns<T extends ColumnBuilderRecord>(fn: (c: ReturnType<typeof createColumnFactory>) => T): ProcedureBuilder<TParams, T>;
     /**
-     * Set Procedure body SQL
+     * Procedure 본문 SQL 설정
      *
-     * Note DBMS-specific SQL syntax differences:
-     * - MySQL: parameter name as-is (userId)
-     * - MSSQL: @ prefix (@userId)
-     * - PostgreSQL: RETURN QUERY required
+     * DBMS별 SQL 구문 차이에 주의:
+     * - MySQL: 파라미터 이름 그대로 (userId)
+     * - MSSQL: @ 접두사 (@userId)
+     * - PostgreSQL: RETURN QUERY 필요
      *
-     * @param sql - Procedure body SQL
-     * @returns new ProcedureBuilder instance
+     * @param sql - Procedure 본문 SQL
+     * @returns 새 ProcedureBuilder 인스턴스
      *
      * @example
      * ```typescript
@@ -164,12 +164,12 @@ export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TRetu
     body(sql: string): ProcedureBuilder<TParams, TReturns>;
 }
 /**
- * Procedure builder factory function
+ * Procedure builder factory 함수
  *
- * Creates a ProcedureBuilder for defining stored Procedure schema via Fluent API
+ * Fluent API로 stored Procedure schema를 정의하기 위한 ProcedureBuilder를 생성
  *
- * @param name - Procedure name
- * @returns ProcedureBuilder instance
+ * @param name - Procedure 이름
+ * @returns ProcedureBuilder 인스턴스
  *
  * @example
  * ```typescript
@@ -186,7 +186,7 @@ export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TRetu
  *   }))
  *   .body("SELECT id, name, email FROM User WHERE id = userId");
  *
- * // Procedure without parameters
+ * // 파라미터 없는 Procedure
  * const GetAllActiveUsers = Procedure("GetAllActiveUsers")
  *   .database("mydb")
  *   .returns((c) => ({
@@ -196,7 +196,7 @@ export declare class ProcedureBuilder<TParams extends ColumnBuilderRecord, TRetu
  *   .body("SELECT id, name FROM User WHERE status = 'active'");
  * ```
  *
- * @see {@link ProcedureBuilder} builder class
+ * @see {@link ProcedureBuilder} builder 클래스
  */
 export declare function Procedure(name: string): ProcedureBuilder<never, never>;
 //# sourceMappingURL=procedure-builder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"procedure-builder.d.ts","sourceRoot":"","sources":["..\\..\\src\\schema\\procedure-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,gBAAgB,CAC3B,OAAO,SAAS,mBAAmB,EACnC,QAAQ,SAAS,mBAAmB;IAkBlC,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,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAG,OAAO,CAAC;IAC3B,kDAAkD;IAClD,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"}
+{"version":3,"file":"procedure-builder.d.ts","sourceRoot":"","sources":["..\\..\\src\\schema\\procedure-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,gBAAgB,CAC3B,OAAO,SAAS,mBAAmB,EACnC,QAAQ,SAAS,mBAAmB;IAkBlC,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"}