@simplysm/orm-node 13.0.0-beta.11

package/dist/orm-common/src/db-context.d.ts

@@ -0,0 +1,669 @@
+import type { DataRecord, DbContextExecutor, IsolationLevel, Migration, ResultMeta } from "./types/db";
+import { type AddColumnQueryDef, type AddPkQueryDef, type ClearSchemaQueryDef, type DropColumnQueryDef, type DropFkQueryDef, type DropIdxQueryDef, type DropPkQueryDef, type DropProcQueryDef, type DropTableQueryDef, type DropViewQueryDef, type ModifyColumnQueryDef, type QueryDef, type QueryDefObjectName, type RenameColumnQueryDef, type RenameTableQueryDef, type SchemaExistsQueryDef, type SwitchFkQueryDef, type TruncateQueryDef } from "./types/query-def";
+import { TableBuilder } from "./schema/table-builder";
+import { ViewBuilder } from "./schema/view-builder";
+import { ProcedureBuilder } from "./schema/procedure-builder";
+import { Queryable } from "./exec/queryable";
+import { ColumnBuilder } from "./schema/factory/column-builder";
+import { ForeignKeyBuilder } from "./schema/factory/relation-builder";
+import type { IndexBuilder } from "./schema/factory/index-builder";
+/**
+ * DbContext 연결 상태
+ *
+ * @property ready - 연결 대기 상태 (초기 상태)
+ * @property connect - 연결됨 (트랜잭션 없음)
+ * @property transact - 트랜잭션 진행 중
+ */
+export type DbContextStatus = "ready" | "connect" | "transact";
+/**
+ * 데이터베이스 컨텍스트 추상 클래스
+ *
+ * ORM의 핵심 진입점으로, 테이블/뷰/프로시저 정의와 데이터베이스 연결,
+ * 트랜잭션 관리, DDL/DML 실행을 담당
+ *
+ * @example
+ * ```typescript
+ * // 1. DbContext 상속하여 테이블 정의
+ * class MyDb extends DbContext {
+ *   readonly user = queryable(this, User);
+ *   readonly post = queryable(this, Post);
+ * }
+ *
+ * // 2. Executor와 함께 인스턴스 생성
+ * const db = new MyDb(executor, { database: "mydb" });
+ *
+ * // 3. 트랜잭션 내에서 쿼리 실행
+ * await db.connect(async () => {
+ *   const users = await db.user().result();
+ *   await db.user().insert([{ name: "홍길동" }]);
+ * });
+ * ```
+ *
+ * @see {@link queryable} 테이블 Queryable 생성
+ * @see {@link DbContextExecutor} 쿼리 실행기 인터페이스
+ */
+export declare abstract class DbContext {
+    private readonly _executor;
+    private readonly _opt;
+    /**
+     * 현재 연결 상태
+     *
+     * - `ready`: 연결 대기 (초기 상태)
+     * - `connect`: DB 연결됨 (트랜잭션 없음)
+     * - `transact`: 트랜잭션 진행 중
+     */
+    status: DbContextStatus;
+    /**
+     * 마이그레이션 목록
+     *
+     * 서브클래스에서 override하여 마이그레이션 정의
+     *
+     * @example
+     * ```typescript
+     * class MyDb extends DbContext {
+     *   readonly migrations: Migration[] = [
+     *     {
+     *       name: "20240101_add_status",
+     *       up: async (db) => {
+     *         await db.addColumn(
+     *           { database: "mydb", name: "User" },
+     *           "status",
+     *           c.varchar(20).nullable(),
+     *         );
+     *       },
+     *     },
+     *   ];
+     * }
+     * ```
+     */
+    readonly migrations: Migration[];
+    /** alias 카운터 (queryable/executable 호출 시 증가) */
+    private _aliasCounter;
+    /**
+     * DbContext 생성자
+     *
+     * @param _executor - 쿼리 실행기 (NodeDbContextExecutor, ServiceDbContextExecutor 등)
+     * @param _opt - 데이터베이스 옵션
+     * @param _opt.database - 데이터베이스 이름
+     * @param _opt.schema - 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
+     */
+    constructor(_executor: DbContextExecutor, _opt: {
+        database: string;
+        schema?: string;
+    });
+    /** 데이터베이스 이름 */
+    get database(): string | undefined;
+    /** 스키마 이름 (MSSQL: dbo, PostgreSQL: public) */
+    get schema(): string | undefined;
+    /**
+     * 다음 테이블 alias 반환
+     *
+     * 서브쿼리/JOIN/재귀 CTE에서 alias 충돌 방지를 위해 T1, T2, T3... 형식으로 생성
+     * queryable() 함수 호출 시 내부적으로 사용
+     *
+     * @returns 순차 증가하는 alias (T1, T2, T3...)
+     */
+    getNextAlias(): string;
+    /**
+     * alias 카운터 초기화
+     *
+     * connect() 또는 connectWithoutTransaction() 시작 시 자동 호출
+     */
+    resetAliasCounter(): void;
+    /**
+     * 시스템 마이그레이션 테이블 Queryable
+     *
+     * 적용된 마이그레이션 이력을 관리하는 내부 테이블
+     */
+    get systemMigration(): () => Queryable<import(".").InferColumns<{
+        code: ColumnBuilder<string, {
+            type: "string";
+            dataType: {
+                type: "varchar";
+                length: number;
+            };
+        }>;
+    }> & import(".").InferDeepRelations<import(".").RelationBuilderRecord>, TableBuilder<{
+        code: ColumnBuilder<string, {
+            type: "string";
+            dataType: {
+                type: "varchar";
+                length: number;
+            };
+        }>;
+    }, import(".").RelationBuilderRecord>>;
+    /**
+     * 트랜잭션 없이 연결하여 콜백 실행 후 자동 종료
+     *
+     * DDL 작업이나 트랜잭션이 필요 없는 조회 작업에 사용
+     *
+     * @template R - 콜백 반환 타입
+     * @param callback - 연결 내에서 실행할 콜백
+     * @returns 콜백 반환값
+     * @throws 콜백 실행 중 발생한 에러 (연결은 자동 종료됨)
+     *
+     * @example
+     * ```typescript
+     * // DDL 작업 (트랜잭션 내 실행 불가)
+     * await db.connectWithoutTransaction(async () => {
+     *   await db.createTable(User);
+     *   await db.addColumn(
+     *     { database: "mydb", name: "User" },
+     *     "status",
+     *     c.varchar(20),
+     *   );
+     * });
+     * ```
+     */
+    connectWithoutTransaction<R>(callback: () => Promise<R>): Promise<R>;
+    /**
+     * 트랜잭션 내에서 콜백 실행 (자동 커밋/롤백)
+     *
+     * 연결 → 트랜잭션 시작 → 콜백 실행 → 커밋 → 연결 종료
+     * 에러 발생 시 자동 롤백 후 연결 종료
+     *
+     * @template R - 콜백 반환 타입
+     * @param fn - 트랜잭션 내에서 실행할 콜백
+     * @param isolationLevel - 트랜잭션 격리 수준 (선택)
+     * @returns 콜백 반환값
+     * @throws 콜백 실행 중 발생한 에러 (롤백 및 연결 종료됨)
+     *
+     * @example
+     * ```typescript
+     * // 기본 사용
+     * const result = await db.connect(async () => {
+     *   const users = await db.user().result();
+     *   await db.user().insert([{ name: "홍길동" }]);
+     *   return users;
+     * });
+     *
+     * // 격리 수준 지정
+     * await db.connect(async () => {
+     *   await db.user().update({ name: "김철수" }, (u) => [
+     *     expr.eq(u.id, 1),
+     *   ]);
+     * }, "SERIALIZABLE");
+     * ```
+     *
+     * @see {@link trans} 이미 연결된 상태에서 트랜잭션 시작
+     */
+    connect<R>(fn: () => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>;
+    /**
+     * 이미 연결된 상태에서 트랜잭션 시작 (자동 커밋/롤백)
+     *
+     * connectWithoutTransaction 내에서 부분적으로 트랜잭션이 필요할 때 사용
+     * 연결 관리는 외부에서 담당하므로 연결 종료하지 않음
+     *
+     * @template R - 콜백 반환 타입
+     * @param fn - 트랜잭션 내에서 실행할 콜백
+     * @param isolationLevel - 트랜잭션 격리 수준 (선택)
+     * @returns 콜백 반환값
+     * @throws {Error} 이미 트랜잭션 상태일 때
+     * @throws 콜백 실행 중 발생한 에러 (롤백됨)
+     *
+     * @example
+     * ```typescript
+     * await db.connectWithoutTransaction(async () => {
+     *   // DDL 작업 (트랜잭션 외부)
+     *   await db.createTable(User);
+     *
+     *   // DML 작업 (트랜잭션 내부)
+     *   await db.trans(async () => {
+     *     await db.user().insert([{ name: "홍길동" }]);
+     *   });
+     * });
+     * ```
+     *
+     * @see {@link connect} 연결부터 트랜잭션까지 한번에 처리
+     */
+    trans<R>(fn: () => Promise<R>, isolationLevel?: IsolationLevel): Promise<R>;
+    /**
+     * QueryDef 배열 실행
+     *
+     * Queryable/Executable이 생성한 QueryDef를 직접 실행
+     * 트랜잭션 상태에서 DDL 실행 시 에러 발생
+     *
+     * @template T - 결과 레코드 타입
+     * @param defs - 실행할 QueryDef 배열
+     * @param resultMetas - 결과 메타데이터 (타입 변환용)
+     * @returns 각 QueryDef 실행 결과 배열
+     * @throws {Error} 트랜잭션 상태에서 DDL 실행 시
+     *
+     * @example
+     * ```typescript
+     * // 일반적으로는 Queryable 메서드 사용을 권장
+     * // 직접 실행이 필요한 경우만 사용
+     * const selectDef = db.user().getSelectQueryDef();
+     * const results = await db.executeDefs([selectDef]);
+     * ```
+     */
+    executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]>;
+    /**
+     * Code First 데이터베이스 초기화
+     *
+     * DbContext에 정의된 테이블/뷰/프로시저를 데이터베이스에 생성하고,
+     * 마이그레이션을 적용
+     *
+     * @param options - 초기화 옵션
+     * @param options.dbs - 초기화 대상 데이터베이스 목록 (미지정 시 현재 database)
+     * @param options.force - true 시 기존 스키마 삭제 후 전체 재생성
+     * @throws {Error} 초기화할 데이터베이스가 없을 때
+     * @throws {Error} 지정한 데이터베이스가 존재하지 않을 때
+     *
+     * 동작 방식:
+     * - **force=true**: clearSchema → 전체 생성 → 모든 migration "적용됨" 등록
+     * - **force=false** (기본):
+     *   - SystemMigration 테이블 없음: 전체 생성 + 모든 migration 등록
+     *   - SystemMigration 테이블 있음: 미적용 migration만 실행
+     *
+     * @example
+     * ```typescript
+     * // 기본 초기화 (마이그레이션 기반)
+     * await db.connectWithoutTransaction(async () => {
+     *   await db.initialize();
+     * });
+     *
+     * // 강제 초기화 (기존 데이터 삭제)
+     * await db.connectWithoutTransaction(async () => {
+     *   await db.initialize({ force: true });
+     * });
+     * ```
+     */
+    initialize(options?: {
+        dbs?: string[];
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * 전체 객체 생성 (테이블/뷰/프로시저/FK/Index)
+     */
+    private _createAllObjects;
+    /**
+     * ForeignKeyTarget/RelationKeyTarget 관계의 유효성 검증
+     * - targetTableFn()이 반환하는 테이블에 relationName에 해당하는 FK/RelationKey가 있는지 확인
+     */
+    private _validateRelations;
+    /**
+     * DbContext의 모든 Builder 수집 (Table/View/Procedure)
+     */
+    private _getBuilders;
+    /**
+     * 테이블 생성
+     *
+     * @param table - 생성할 테이블 빌더
+     *
+     * @example
+     * ```typescript
+     * await db.createTable(User);
+     * ```
+     */
+    createTable(table: TableBuilder<any, any>): Promise<void>;
+    /**
+     * 테이블 삭제
+     *
+     * @param table - 삭제할 테이블 정보 (database, schema, name)
+     *
+     * @example
+     * ```typescript
+     * await db.dropTable({ database: "mydb", name: "User" });
+     * ```
+     */
+    dropTable(table: QueryDefObjectName): Promise<void>;
+    /**
+     * 테이블 이름 변경
+     *
+     * @param table - 변경할 테이블 정보
+     * @param newName - 새 테이블 이름
+     *
+     * @example
+     * ```typescript
+     * await db.renameTable({ database: "mydb", name: "User" }, "Member");
+     * ```
+     */
+    renameTable(table: QueryDefObjectName, newName: string): Promise<void>;
+    /**
+     * 뷰 생성
+     *
+     * @param view - 생성할 뷰 빌더
+     *
+     * @example
+     * ```typescript
+     * await db.createView(UserSummary);
+     * ```
+     */
+    createView(view: ViewBuilder<any, any, any>): Promise<void>;
+    /**
+     * 뷰 삭제
+     *
+     * @param view - 삭제할 뷰 정보
+     *
+     * @example
+     * ```typescript
+     * await db.dropView({ database: "mydb", name: "UserSummary" });
+     * ```
+     */
+    dropView(view: QueryDefObjectName): Promise<void>;
+    /**
+     * 저장 프로시저 생성
+     *
+     * @param procedure - 생성할 프로시저 빌더
+     *
+     * @example
+     * ```typescript
+     * await db.createProc(GetUserById);
+     * ```
+     */
+    createProc(procedure: ProcedureBuilder<any, any>): Promise<void>;
+    /**
+     * 저장 프로시저 삭제
+     *
+     * @param procedure - 삭제할 프로시저 정보
+     *
+     * @example
+     * ```typescript
+     * await db.dropProc({ database: "mydb", name: "GetUserById" });
+     * ```
+     */
+    dropProc(procedure: QueryDefObjectName): Promise<void>;
+    /**
+     * Builder를 CREATE QueryDef로 변환
+     *
+     * @param builder - Table/View/Procedure 빌더
+     * @returns CREATE TABLE/VIEW/PROCEDURE QueryDef
+     * @throws {Error} 알 수 없는 빌더 타입일 때
+     */
+    getCreateObjectQueryDef(builder: TableBuilder<any, any> | ViewBuilder<any, any, any> | ProcedureBuilder<any, any>): QueryDef;
+    /**
+     * CREATE TABLE QueryDef 생성
+     *
+     * @param table - 테이블 빌더
+     * @returns CREATE TABLE QueryDef
+     * @throws {Error} 테이블에 컬럼이 없을 때
+     */
+    getCreateTableQueryDef(table: TableBuilder<any, any>): QueryDef;
+    /**
+     * CREATE VIEW QueryDef 생성
+     *
+     * @param view - 뷰 빌더
+     * @returns CREATE VIEW QueryDef
+     * @throws {Error} 뷰에 viewFn이 없을 때
+     */
+    getCreateViewQueryDef(view: ViewBuilder<any, any, any>): QueryDef;
+    /**
+     * CREATE PROCEDURE QueryDef 생성
+     *
+     * @param procedure - 프로시저 빌더
+     * @returns CREATE PROCEDURE QueryDef
+     * @throws {Error} 프로시저에 본문이 없을 때
+     */
+    getCreateProcQueryDef(procedure: ProcedureBuilder<any, any>): QueryDef;
+    /** DROP TABLE QueryDef 생성 */
+    getDropTableQueryDef(table: QueryDefObjectName): DropTableQueryDef;
+    /** RENAME TABLE QueryDef 생성 */
+    getRenameTableQueryDef(table: QueryDefObjectName, newName: string): RenameTableQueryDef;
+    /** DROP VIEW QueryDef 생성 */
+    getDropViewQueryDef(view: QueryDefObjectName): DropViewQueryDef;
+    /** DROP PROCEDURE QueryDef 생성 */
+    getDropProcQueryDef(procedure: QueryDefObjectName): DropProcQueryDef;
+    /**
+     * 컬럼 추가
+     *
+     * @param table - 테이블 정보
+     * @param columnName - 추가할 컬럼 이름
+     * @param column - 컬럼 빌더 (타입, nullable, default 등)
+     *
+     * @example
+     * ```typescript
+     * await db.addColumn(
+     *   { database: "mydb", name: "User" },
+     *   "status",
+     *   c.varchar(20).nullable(),
+     * );
+     * ```
+     */
+    addColumn(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): Promise<void>;
+    /**
+     * 컬럼 삭제
+     *
+     * @param table - 테이블 정보
+     * @param column - 삭제할 컬럼 이름
+     *
+     * @example
+     * ```typescript
+     * await db.dropColumn(
+     *   { database: "mydb", name: "User" },
+     *   "status",
+     * );
+     * ```
+     */
+    dropColumn(table: QueryDefObjectName, column: string): Promise<void>;
+    /**
+     * 컬럼 수정
+     *
+     * @param table - 테이블 정보
+     * @param columnName - 수정할 컬럼 이름
+     * @param column - 새 컬럼 정의
+     *
+     * @example
+     * ```typescript
+     * await db.modifyColumn(
+     *   { database: "mydb", name: "User" },
+     *   "status",
+     *   c.varchar(50).nullable(),  // 길이 변경
+     * );
+     * ```
+     */
+    modifyColumn(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): Promise<void>;
+    /**
+     * 컬럼 이름 변경
+     *
+     * @param table - 테이블 정보
+     * @param column - 현재 컬럼 이름
+     * @param newName - 새 컬럼 이름
+     *
+     * @example
+     * ```typescript
+     * await db.renameColumn(
+     *   { database: "mydb", name: "User" },
+     *   "status",
+     *   "userStatus",
+     * );
+     * ```
+     */
+    renameColumn(table: QueryDefObjectName, column: string, newName: string): Promise<void>;
+    /** ADD COLUMN QueryDef 생성 */
+    getAddColumnQueryDef(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): AddColumnQueryDef;
+    /** DROP COLUMN QueryDef 생성 */
+    getDropColumnQueryDef(table: QueryDefObjectName, column: string): DropColumnQueryDef;
+    /** MODIFY COLUMN QueryDef 생성 */
+    getModifyColumnQueryDef(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): ModifyColumnQueryDef;
+    /** RENAME COLUMN QueryDef 생성 */
+    getRenameColumnQueryDef(table: QueryDefObjectName, column: string, newName: string): RenameColumnQueryDef;
+    /**
+     * Primary Key 추가
+     *
+     * @param table - 테이블 정보
+     * @param columns - PK 구성 컬럼 배열
+     *
+     * @example
+     * ```typescript
+     * await db.addPk(
+     *   { database: "mydb", name: "User" },
+     *   ["id"],
+     * );
+     * ```
+     */
+    addPk(table: QueryDefObjectName, columns: string[]): Promise<void>;
+    /**
+     * Primary Key 삭제
+     *
+     * @param table - 테이블 정보
+     *
+     * @example
+     * ```typescript
+     * await db.dropPk({ database: "mydb", name: "User" });
+     * ```
+     */
+    dropPk(table: QueryDefObjectName): Promise<void>;
+    /**
+     * Foreign Key 추가
+     *
+     * @param table - 테이블 정보
+     * @param relationName - 관계 이름 (FK_테이블명_관계이름 형식으로 FK 이름 생성)
+     * @param relationDef - ForeignKey 빌더
+     *
+     * @example
+     * ```typescript
+     * await db.addFk(
+     *   { database: "mydb", name: "Post" },
+     *   "author",
+     *   ForeignKey(User, ["authorId"]),
+     * );
+     * ```
+     */
+    addFk(table: QueryDefObjectName, relationName: string, relationDef: ForeignKeyBuilder<any, any>): Promise<void>;
+    /**
+     * 인덱스 추가
+     *
+     * @param table - 테이블 정보
+     * @param indexBuilder - 인덱스 빌더
+     *
+     * @example
+     * ```typescript
+     * await db.addIdx(
+     *   { database: "mydb", name: "User" },
+     *   Index(["email"]).unique(),
+     * );
+     * ```
+     */
+    addIdx(table: QueryDefObjectName, indexBuilder: IndexBuilder<string[]>): Promise<void>;
+    /**
+     * Foreign Key 삭제
+     *
+     * @param table - 테이블 정보
+     * @param relationName - 관계 이름
+     *
+     * @example
+     * ```typescript
+     * await db.dropFk({ database: "mydb", name: "Post" }, "author");
+     * ```
+     */
+    dropFk(table: QueryDefObjectName, relationName: string): Promise<void>;
+    /**
+     * 인덱스 삭제
+     *
+     * @param table - 테이블 정보
+     * @param columns - 인덱스 구성 컬럼 배열 (인덱스 이름 추론용)
+     *
+     * @example
+     * ```typescript
+     * await db.dropIdx({ database: "mydb", name: "User" }, ["email"]);
+     * ```
+     */
+    dropIdx(table: QueryDefObjectName, columns: string[]): Promise<void>;
+    /** DROP PRIMARY KEY QueryDef 생성 */
+    getDropPkQueryDef(table: QueryDefObjectName): DropPkQueryDef;
+    /** ADD PRIMARY KEY QueryDef 생성 */
+    getAddPkQueryDef(table: QueryDefObjectName, columns: string[]): AddPkQueryDef;
+    /** ADD FOREIGN KEY QueryDef 생성 */
+    getAddFkQueryDef(table: QueryDefObjectName, relationName: string, relationDef: ForeignKeyBuilder<any, any>): QueryDef;
+    /** ADD INDEX QueryDef 생성 */
+    getAddIdxQueryDef(table: QueryDefObjectName, indexBuilder: IndexBuilder<string[]>): QueryDef;
+    /** DROP FOREIGN KEY QueryDef 생성 */
+    getDropFkQueryDef(table: QueryDefObjectName, relationName: string): DropFkQueryDef;
+    /** DROP INDEX QueryDef 생성 */
+    getDropIdxQueryDef(table: QueryDefObjectName, columns: string[]): DropIdxQueryDef;
+    /**
+     * 스키마 내 모든 객체 삭제
+     *
+     * 지정한 database/schema 내의 모든 테이블, 뷰, 프로시저 등을 삭제
+     *
+     * @param params - 대상 database/schema
+     * @param params.database - 데이터베이스 이름
+     * @param params.schema - 스키마 이름 (MSSQL/PostgreSQL)
+     *
+     * @example
+     * ```typescript
+     * await db.clearSchema({ database: "mydb", schema: "public" });
+     * ```
+     */
+    clearSchema(params: {
+        database: string;
+        schema?: string;
+    }): Promise<void>;
+    /**
+     * 스키마 존재 여부 확인
+     *
+     * @param database - 데이터베이스 이름
+     * @param schema - 스키마 이름 (MSSQL/PostgreSQL)
+     * @returns 스키마 존재 여부
+     *
+     * @example
+     * ```typescript
+     * const exists = await db.schemaExists("mydb");
+     * if (!exists) {
+     *   throw new Error("Database not found");
+     * }
+     * ```
+     */
+    schemaExists(database: string, schema?: string): Promise<boolean>;
+    /** CLEAR SCHEMA QueryDef 생성 */
+    getClearSchemaQueryDef(params: {
+        database: string;
+        schema?: string;
+    }): ClearSchemaQueryDef;
+    /** SCHEMA EXISTS QueryDef 생성 */
+    getSchemaExistsQueryDef(database: string, schema?: string): SchemaExistsQueryDef;
+    /**
+     * 테이블 데이터 전체 삭제 (TRUNCATE)
+     *
+     * DELETE와 달리 로그 없이 빠르게 삭제하며, AUTO_INCREMENT 초기화
+     *
+     * @param table - 테이블 정보
+     *
+     * @example
+     * ```typescript
+     * await db.truncate({ database: "mydb", name: "User" });
+     * ```
+     */
+    truncate(table: QueryDefObjectName): Promise<void>;
+    /**
+     * Foreign Key 제약 조건 ON/OFF
+     *
+     * 대량 데이터 작업 시 FK 제약 임시 해제에 사용
+     * 트랜잭션 내에서 사용 가능 (DDL이 아님)
+     *
+     * @param table - 테이블 정보
+     * @param switch_ - "on" 또는 "off"
+     *
+     * @example
+     * ```typescript
+     * await db.connect(async () => {
+     *   await db.switchFk({ database: "mydb", name: "Post" }, "off");
+     *   await db.post().deleteAsync(() => []);
+     *   await db.switchFk({ database: "mydb", name: "Post" }, "on");
+     * });
+     * ```
+     */
+    switchFk(table: QueryDefObjectName, switch_: "on" | "off"): Promise<void>;
+    /** TRUNCATE TABLE QueryDef 생성 */
+    getTruncateQueryDef(table: QueryDefObjectName): TruncateQueryDef;
+    /** SWITCH FK QueryDef 생성 */
+    getSwitchFkQueryDef(table: QueryDefObjectName, switch_: "on" | "off"): SwitchFkQueryDef;
+    /**
+     * TableBuilder/ViewBuilder를 QueryDefObjectName으로 변환
+     *
+     * @param tableOrView - 테이블 또는 뷰 빌더
+     * @returns QueryDef에서 사용할 객체 이름 정보
+     */
+    getQueryDefObjectName(tableOrView: TableBuilder<any, any> | ViewBuilder<any, any, any>): QueryDefObjectName;
+    /**
+     * 테이블 없음 에러인지 확인
+     *
+     * DBMS별 에러 코드/메시지 패턴:
+     * - MySQL: errno 1146 (ER_NO_SUCH_TABLE), "Table 'xxx' doesn't exist"
+     * - MSSQL: number 208, "Invalid object name 'xxx'"
+     * - PostgreSQL: code "42P01", "relation \"xxx\" does not exist"
+     */
+    private _isTableNotExistsError;
+}
+//# sourceMappingURL=db-context.d.ts.map

package/dist/orm-common/src/db-context.d.ts.map

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