@simplysm/orm-common 13.0.0-beta.50 → 13.0.1

package/README.md

@@ -76,6 +76,134 @@ See [docs/expressions.md](docs/expressions.md) for full documentation.
 - **[Window Functions](docs/expressions.md#window-functions)** - `expr.rowNumber()`, `expr.rank()`, `expr.denseRank()`, `expr.lag()`, `expr.lead()`, `expr.sumOver()`, `expr.avgOver()`
 - **[Other Expressions](docs/expressions.md#other-expressions)** - `expr.val()`, `expr.raw()`, `expr.cast()`, `expr.subquery()`, `expr.random()`
 
+## DbContext API
+
+### Functional API (Recommended)
+
+The functional API uses `defineDbContext` + `createDbContext` for better type safety and composability.
+
+```typescript
+import { defineDbContext, createDbContext, createColumnFactory } from "@simplysm/orm-common";
+
+// Step 1: Define DbContext schema
+const MyDbDef = defineDbContext({
+  tables: { user: User, post: Post },
+  views: { activeUsers: ActiveUsers },
+  procedures: { getUserById: GetUserById },
+  migrations: [
+    {
+      name: "20260101_add_status",
+      up: async (db) => {
+        const c = createColumnFactory();
+        await db.addColumn(
+          { database: "mydb", name: "User" },
+          "status",
+          c.varchar(20).nullable(),
+        );
+      },
+    },
+  ],
+});
+
+// Step 2: Create instance with executor
+const db = createDbContext(MyDbDef, executor, { database: "mydb" });
+
+// Use queryable accessors
+await db.connect(async () => {
+  const users = await db.user().result();
+  const posts = await db.post().result();
+});
+```
+
+#### Type Definitions
+
+| Type | Description |
+|------|-------------|
+| `DbContextDef<TTables, TViews, TProcedures>` | DbContext definition (schema blueprint) |
+| `DbContextInstance<TDef>` | Full DbContext instance with queryable accessors and DDL methods |
+| `DbContextBase` | Core interface used internally (status, executeDefs, etc.) |
+
+### Class-based API (Deprecated)
+
+The old class-based API is deprecated. Migrate to the functional API for better type safety.
+
+```typescript
+// Old (deprecated):
+import { DbContext, queryable } from "@simplysm/orm-common";
+
+class MyDb extends DbContext {
+  readonly user = queryable(this, User);
+  readonly migrations = [...];
+}
+const db = new MyDb(executor, { database: "mydb" });
+
+// New (recommended):
+const MyDbDef = defineDbContext({
+  tables: { user: User },
+  migrations: [...],
+});
+const db = createDbContext(MyDbDef, executor, { database: "mydb" });
+```
+
+### Migration Guide
+
+To migrate from class-based to functional API:
+
+**Step 1: Replace class definition**
+
+```typescript
+// Before:
+class MyDb extends DbContext {
+  readonly user = queryable(this, User);
+  readonly post = queryable(this, Post);
+  readonly getUserById = executable(this, GetUserById);
+
+  readonly migrations = [
+    { name: "...", up: async (db: MyDb) => { ... } }
+  ];
+}
+
+// After:
+const MyDbDef = defineDbContext({
+  tables: { user: User, post: Post },
+  procedures: { getUserById: GetUserById },
+  migrations: [
+    { name: "...", up: async (db) => { ... } }
+  ],
+});
+```
+
+**Step 2: Replace instantiation**
+
+```typescript
+// Before:
+const db = new MyDb(executor, { database: "mydb" });
+
+// After:
+const db = createDbContext(MyDbDef, executor, { database: "mydb" });
+```
+
+**Step 3: Update usage (no changes needed)**
+
+```typescript
+// Both APIs use the same queryable accessors:
+await db.connect(async () => {
+  const users = await db.user().result();  // Same syntax
+});
+```
+
+**Type inference:**
+
+```typescript
+// Extract instance type:
+type MyDb = DbContextInstance<typeof MyDbDef>;
+
+// Use in function parameters:
+async function doSomething(db: MyDb) {
+  await db.user().result();
+}
+```
+
 ## Security Notes
 
 orm-common uses **enhanced string escaping** instead of parameter binding due to its dynamic query nature.
@@ -99,7 +227,7 @@ await db.user().where((u) => [expr.eq(u.id, userId)]).result();
 ## Quick Start
 
 ```typescript
-import { Table, DbContext, queryable, expr } from "@simplysm/orm-common";
+import { Table, defineDbContext, createDbContext, expr, DateTime } from "@simplysm/orm-common";
 
 // Define table schema
 const User = Table("User")
@@ -112,13 +240,13 @@ const User = Table("User")
   }))
   .primaryKey("id");
 
-// Create DbContext
-class MyDb extends DbContext {
-  readonly user = queryable(this, User);
-}
+// Define DbContext
+const MyDbDef = defineDbContext({
+  tables: { user: User },
+});
 
-// Use with executor (from orm-node package)
-const db = new MyDb(executor, { database: "mydb" });
+// Create DbContext instance with executor (from orm-node package)
+const db = createDbContext(MyDbDef, executor, { database: "mydb" });
 
 // Execute queries
 await db.connect(async () => {

package/dist/create-db-context.d.ts

@@ -0,0 +1,34 @@
+import type { DbContextDef, DbContextInstance } from "./types/db-context-def";
+import type { DbContextExecutor } from "./types/db";
+/**
+ * DbContext 인스턴스 팩토리
+ *
+ * DbContextDef(정의)와 DbContextExecutor(실행기)를 받아
+ * queryable 접근자, DDL 메서드, 연결/트랜잭션 관리를 포함한
+ * 완전한 DbContext 인스턴스를 생성
+ *
+ * @param def - defineDbContext()로 생성한 정의 객체
+ * @param executor - 쿼리 실행기 (NodeDbContextExecutor, ServiceDbContextExecutor 등)
+ * @param opt - 데이터베이스 옵션
+ * @param opt.database - 데이터베이스 이름
+ * @param opt.schema - 스키마 이름 (MSSQL: dbo, PostgreSQL: public)
+ * @returns 완전한 DbContext 인스턴스
+ *
+ * @example
+ * ```typescript
+ * const MyDb = defineDbContext({
+ *   tables: { user: User, post: Post },
+ * });
+ *
+ * const db = createDbContext(MyDb, executor, { database: "mydb" });
+ *
+ * await db.connect(async () => {
+ *   const users = await db.user().result();
+ * });
+ * ```
+ */
+export declare function createDbContext<TDef extends DbContextDef<any, any, any>>(def: TDef, executor: DbContextExecutor, opt: {
+    database: string;
+    schema?: string;
+}): DbContextInstance<TDef>;
+//# sourceMappingURL=create-db-context.d.ts.map

package/dist/create-db-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-db-context.d.ts","sourceRoot":"","sources":["../src/create-db-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAkC,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,KAAK,EAAc,iBAAiB,EAA8B,MAAM,YAAY,CAAC;AAuB5F;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACtE,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,iBAAiB,CAAC,IAAI,CAAC,CAwTzB"}

package/dist/create-db-context.js

@@ -0,0 +1,283 @@
+import { DDL_TYPES } from "./types/query-def.js";
+import { DbErrorCode, DbTransactionError } from "./errors/db-transaction-error.js";
+import { TableBuilder } from "./schema/table-builder.js";
+import { ViewBuilder } from "./schema/view-builder.js";
+import { queryable } from "./exec/queryable.js";
+import { executable } from "./exec/executable.js";
+import { objClearUndefined } from "@simplysm/core-common";
+import { SystemMigration } from "./models/system-migration.js";
+import * as tableDdl from "./ddl/table-ddl.js";
+import * as columnDdl from "./ddl/column-ddl.js";
+import * as relationDdl from "./ddl/relation-ddl.js";
+import * as schemaDdl from "./ddl/schema-ddl.js";
+import { initialize as initializeImpl, validateRelations as validateRelationsImpl } from "./ddl/initialize.js";
+function createDbContext(def, executor, opt) {
+  let aliasCounter = 0;
+  let status = "ready";
+  const base = {
+    get status() {
+      return status;
+    },
+    set status(v) {
+      status = v;
+    },
+    get database() {
+      return opt.database;
+    },
+    get schema() {
+      return opt.schema;
+    },
+    getNextAlias() {
+      return `T${++aliasCounter}`;
+    },
+    resetAliasCounter() {
+      aliasCounter = 0;
+    },
+    executeDefs(defs, resultMetas) {
+      if (status === "transact" && defs.some((d) => DDL_TYPES.includes(d.type))) {
+        throw new Error("TRANSACTION \uC0C1\uD0DC\uC5D0\uC11C\uB294 DDL\uC744 \uC2E4\uD589\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+      }
+      return executor.executeDefs(defs, resultMetas);
+    },
+    getQueryDefObjectName(tableOrView) {
+      return objClearUndefined({
+        database: tableOrView.meta.database ?? opt.database,
+        schema: tableOrView.meta.schema ?? opt.schema,
+        name: tableOrView.meta.name
+      });
+    },
+    async switchFk(table, switch_) {
+      await base.executeDefs([schemaDdl.getSwitchFkQueryDef(table, switch_)]);
+    }
+  };
+  const db = {
+    // Spread base properties (getters/setters need special handling)
+    get status() {
+      return base.status;
+    },
+    set status(v) {
+      base.status = v;
+    },
+    get database() {
+      return base.database;
+    },
+    get schema() {
+      return base.schema;
+    },
+    getNextAlias: base.getNextAlias,
+    resetAliasCounter: base.resetAliasCounter,
+    executeDefs: base.executeDefs,
+    getQueryDefObjectName: base.getQueryDefObjectName,
+    //#region ========== Connection management ==========
+    /**
+     * 트랜잭션 내에서 콜백 실행 (자동 커밋/롤백)
+     *
+     * 연결 -> 트랜잭션 시작 -> 콜백 실행 -> 커밋 -> 연결 종료
+     * 에러 발생 시 자동 롤백 후 연결 종료
+     */
+    async connect(fn, isolationLevel) {
+      validateRelationsImpl(def);
+      base.resetAliasCounter();
+      await executor.connect();
+      status = "connect";
+      await executor.beginTransaction(isolationLevel);
+      status = "transact";
+      let result;
+      try {
+        result = await fn();
+        await executor.commitTransaction();
+        status = "connect";
+      } catch (err) {
+        try {
+          await executor.rollbackTransaction();
+          status = "connect";
+        } catch (err1) {
+          if (err1 instanceof DbTransactionError) {
+            if (err1.code !== DbErrorCode.NO_ACTIVE_TRANSACTION) {
+              await executor.close();
+              status = "ready";
+              throw err1;
+            }
+          } else {
+            await executor.close();
+            status = "ready";
+            throw err1;
+          }
+        }
+        await executor.close();
+        status = "ready";
+        throw err;
+      }
+      await executor.close();
+      status = "ready";
+      return result;
+    },
+    /**
+     * 트랜잭션 없이 연결하여 콜백 실행 후 자동 종료
+     *
+     * DDL 작업이나 트랜잭션이 필요 없는 조회 작업에 사용
+     */
+    async connectWithoutTransaction(callback) {
+      validateRelationsImpl(def);
+      base.resetAliasCounter();
+      await executor.connect();
+      status = "connect";
+      let result;
+      try {
+        result = await callback();
+      } catch (err) {
+        await executor.close();
+        status = "ready";
+        throw err;
+      }
+      await executor.close();
+      status = "ready";
+      return result;
+    },
+    /**
+     * 이미 연결된 상태에서 트랜잭션 시작 (자동 커밋/롤백)
+     *
+     * connectWithoutTransaction 내에서 부분적으로 트랜잭션이 필요할 때 사용
+     */
+    async trans(fn, isolationLevel) {
+      if (status === "transact") {
+        throw new Error("\uC774\uBBF8 TRANSACTION \uC0C1\uD0DC\uC785\uB2C8\uB2E4.");
+      }
+      await executor.beginTransaction(isolationLevel);
+      status = "transact";
+      let result;
+      try {
+        result = await fn();
+        await executor.commitTransaction();
+        status = "connect";
+      } catch (err) {
+        try {
+          await executor.rollbackTransaction();
+          status = "connect";
+        } catch (err1) {
+          if (err1 instanceof DbTransactionError) {
+            if (err1.code !== DbErrorCode.NO_ACTIVE_TRANSACTION) {
+              throw err1;
+            }
+          } else {
+            throw err1;
+          }
+          status = "connect";
+        }
+        throw err;
+      }
+      return result;
+    },
+    //#endregion
+    //#region ========== DDL execution methods ==========
+    async createTable(table) {
+      await base.executeDefs([tableDdl.getCreateTableQueryDef(base, table)]);
+    },
+    async dropTable(table) {
+      await base.executeDefs([tableDdl.getDropTableQueryDef(table)]);
+    },
+    async renameTable(table, newName) {
+      await base.executeDefs([tableDdl.getRenameTableQueryDef(table, newName)]);
+    },
+    async createView(view) {
+      await base.executeDefs([tableDdl.getCreateViewQueryDef(db, view)]);
+    },
+    async dropView(view) {
+      await base.executeDefs([tableDdl.getDropViewQueryDef(view)]);
+    },
+    async createProc(procedure) {
+      await base.executeDefs([tableDdl.getCreateProcQueryDef(base, procedure)]);
+    },
+    async dropProc(procedure) {
+      await base.executeDefs([tableDdl.getDropProcQueryDef(procedure)]);
+    },
+    async addColumn(table, columnName, column) {
+      await base.executeDefs([columnDdl.getAddColumnQueryDef(table, columnName, column)]);
+    },
+    async dropColumn(table, column) {
+      await base.executeDefs([columnDdl.getDropColumnQueryDef(table, column)]);
+    },
+    async modifyColumn(table, columnName, column) {
+      await base.executeDefs([columnDdl.getModifyColumnQueryDef(table, columnName, column)]);
+    },
+    async renameColumn(table, column, newName) {
+      await base.executeDefs([columnDdl.getRenameColumnQueryDef(table, column, newName)]);
+    },
+    async addPk(table, columns) {
+      await base.executeDefs([relationDdl.getAddPkQueryDef(table, columns)]);
+    },
+    async dropPk(table) {
+      await base.executeDefs([relationDdl.getDropPkQueryDef(table)]);
+    },
+    async addFk(table, relationName, relationDef) {
+      await base.executeDefs([relationDdl.getAddFkQueryDef(base, table, relationName, relationDef)]);
+    },
+    async addIdx(table, indexBuilder) {
+      await base.executeDefs([relationDdl.getAddIdxQueryDef(table, indexBuilder)]);
+    },
+    async dropFk(table, relationName) {
+      await base.executeDefs([relationDdl.getDropFkQueryDef(table, relationName)]);
+    },
+    async dropIdx(table, columns) {
+      await base.executeDefs([relationDdl.getDropIdxQueryDef(table, columns)]);
+    },
+    async clearSchema(params) {
+      await base.executeDefs([schemaDdl.getClearSchemaQueryDef(params)]);
+    },
+    async schemaExists(database, schema) {
+      const result = await base.executeDefs([schemaDdl.getSchemaExistsQueryDef(database, schema)]);
+      return result[0].length > 0;
+    },
+    async truncate(table) {
+      await base.executeDefs([schemaDdl.getTruncateQueryDef(table)]);
+    },
+    async switchFk(table, switch_) {
+      await base.executeDefs([schemaDdl.getSwitchFkQueryDef(table, switch_)]);
+    },
+    //#endregion
+    //#region ========== DDL QueryDef generators ==========
+    getCreateTableQueryDef: (table) => tableDdl.getCreateTableQueryDef(base, table),
+    getCreateViewQueryDef: (view) => tableDdl.getCreateViewQueryDef(db, view),
+    getCreateProcQueryDef: (procedure) => tableDdl.getCreateProcQueryDef(base, procedure),
+    getCreateObjectQueryDef: (builder) => tableDdl.getCreateObjectQueryDef(db, builder),
+    getDropTableQueryDef: tableDdl.getDropTableQueryDef,
+    getRenameTableQueryDef: tableDdl.getRenameTableQueryDef,
+    getDropViewQueryDef: tableDdl.getDropViewQueryDef,
+    getDropProcQueryDef: tableDdl.getDropProcQueryDef,
+    getAddColumnQueryDef: columnDdl.getAddColumnQueryDef,
+    getDropColumnQueryDef: columnDdl.getDropColumnQueryDef,
+    getModifyColumnQueryDef: columnDdl.getModifyColumnQueryDef,
+    getRenameColumnQueryDef: columnDdl.getRenameColumnQueryDef,
+    getAddPkQueryDef: relationDdl.getAddPkQueryDef,
+    getDropPkQueryDef: relationDdl.getDropPkQueryDef,
+    getAddFkQueryDef: (table, relationName, relationDef) => relationDdl.getAddFkQueryDef(base, table, relationName, relationDef),
+    getAddIdxQueryDef: relationDdl.getAddIdxQueryDef,
+    getDropFkQueryDef: relationDdl.getDropFkQueryDef,
+    getDropIdxQueryDef: relationDdl.getDropIdxQueryDef,
+    getClearSchemaQueryDef: schemaDdl.getClearSchemaQueryDef,
+    getSchemaExistsQueryDef: schemaDdl.getSchemaExistsQueryDef,
+    getTruncateQueryDef: schemaDdl.getTruncateQueryDef,
+    getSwitchFkQueryDef: schemaDdl.getSwitchFkQueryDef,
+    //#endregion
+    //#region ========== Initialize ==========
+    async initialize(options) {
+      await initializeImpl(db, def, options);
+    }
+    //#endregion
+  };
+  for (const [key, tableOrView] of Object.entries(def.meta.tables)) {
+    db[key] = queryable(db, tableOrView);
+  }
+  for (const [key, view] of Object.entries(def.meta.views)) {
+    db[key] = queryable(db, view);
+  }
+  for (const [key, proc] of Object.entries(def.meta.procedures)) {
+    db[key] = executable(base, proc);
+  }
+  db.systemMigration = queryable(db, SystemMigration);
+  return db;
+}
+export {
+  createDbContext
+};
+//# sourceMappingURL=create-db-context.js.map

package/dist/create-db-context.js.map

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

package/dist/ddl/column-ddl.d.ts

@@ -0,0 +1,19 @@
+import type { ColumnBuilder } from "../schema/factory/column-builder";
+import type { QueryDefObjectName, AddColumnQueryDef, DropColumnQueryDef, ModifyColumnQueryDef, RenameColumnQueryDef } from "../types/query-def";
+/**
+ * ADD COLUMN QueryDef 생성
+ */
+export declare function getAddColumnQueryDef(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): AddColumnQueryDef;
+/**
+ * DROP COLUMN QueryDef 생성
+ */
+export declare function getDropColumnQueryDef(table: QueryDefObjectName, column: string): DropColumnQueryDef;
+/**
+ * MODIFY COLUMN QueryDef 생성
+ */
+export declare function getModifyColumnQueryDef(table: QueryDefObjectName, columnName: string, column: ColumnBuilder<any, any>): ModifyColumnQueryDef;
+/**
+ * RENAME COLUMN QueryDef 생성
+ */
+export declare function getRenameColumnQueryDef(table: QueryDefObjectName, column: string, newName: string): RenameColumnQueryDef;
+//# sourceMappingURL=column-ddl.d.ts.map

package/dist/ddl/column-ddl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-ddl.d.ts","sourceRoot":"","sources":["../../src/ddl/column-ddl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,GAC9B,iBAAiB,CAYnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAEnG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,GAC9B,oBAAoB,CAYtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,oBAAoB,CAEtB"}

package/dist/ddl/column-ddl.js

@@ -0,0 +1,39 @@
+function getAddColumnQueryDef(table, columnName, column) {
+  return {
+    type: "addColumn",
+    table,
+    column: {
+      name: columnName,
+      dataType: column.meta.dataType,
+      autoIncrement: column.meta.autoIncrement,
+      nullable: column.meta.nullable,
+      default: column.meta.default
+    }
+  };
+}
+function getDropColumnQueryDef(table, column) {
+  return { type: "dropColumn", table, column };
+}
+function getModifyColumnQueryDef(table, columnName, column) {
+  return {
+    type: "modifyColumn",
+    table,
+    column: {
+      name: columnName,
+      dataType: column.meta.dataType,
+      autoIncrement: column.meta.autoIncrement,
+      nullable: column.meta.nullable,
+      default: column.meta.default
+    }
+  };
+}
+function getRenameColumnQueryDef(table, column, newName) {
+  return { type: "renameColumn", table, column, newName };
+}
+export {
+  getAddColumnQueryDef,
+  getDropColumnQueryDef,
+  getModifyColumnQueryDef,
+  getRenameColumnQueryDef
+};
+//# sourceMappingURL=column-ddl.js.map

package/dist/ddl/column-ddl.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/ddl/column-ddl.ts"],
+  "mappings": "AAYO,SAAS,qBACd,OACA,YACA,QACmB;AACnB,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU,OAAO,KAAK;AAAA,MACtB,eAAe,OAAO,KAAK;AAAA,MAC3B,UAAU,OAAO,KAAK;AAAA,MACtB,SAAS,OAAO,KAAK;AAAA,IACvB;AAAA,EACF;AACF;AAKO,SAAS,sBAAsB,OAA2B,QAAoC;AACnG,SAAO,EAAE,MAAM,cAAc,OAAO,OAAO;AAC7C;AAKO,SAAS,wBACd,OACA,YACA,QACsB;AACtB,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU,OAAO,KAAK;AAAA,MACtB,eAAe,OAAO,KAAK;AAAA,MAC3B,UAAU,OAAO,KAAK;AAAA,MACtB,SAAS,OAAO,KAAK;AAAA,IACvB;AAAA,EACF;AACF;AAKO,SAAS,wBACd,OACA,QACA,SACsB;AACtB,SAAO,EAAE,MAAM,gBAAgB,OAAO,QAAQ,QAAQ;AACxD;",
+  "names": []
+}

package/dist/ddl/initialize.d.ts

@@ -0,0 +1,36 @@
+import type { DbContextBase, DbContextDef, DbContextDdlMethods } from "../types/db-context-def";
+import type { Queryable } from "../exec/queryable";
+/**
+ * Code First 데이터베이스 초기화
+ *
+ * DbContext에 정의된 테이블/뷰/프로시저를 데이터베이스에 생성하고,
+ * 마이그레이션을 적용
+ *
+ * @param db - DbContext 인스턴스
+ * @param def - 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만 실행
+ */
+export declare function initialize(db: DbContextBase & DbContextDdlMethods & {
+    systemMigration: () => Queryable<{
+        code: string;
+    }, any>;
+}, def: DbContextDef<any, any, any>, options?: {
+    dbs?: string[];
+    force?: boolean;
+}): Promise<void>;
+/**
+ * ForeignKeyTarget/RelationKeyTarget 관계의 유효성 검증
+ * - targetTableFn()이 반환하는 테이블에 relationName에 해당하는 FK/RelationKey가 있는지 확인
+ */
+export declare function validateRelations(def: DbContextDef<any, any, any>): void;
+//# sourceMappingURL=initialize.d.ts.map

package/dist/ddl/initialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../src/ddl/initialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAenD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,aAAa,GAAG,mBAAmB,GAAG;IAAE,eAAe,EAAE,MAAM,SAAS,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,CAAC,CAAA;CAAE,EACrG,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAChC,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CA6Df;AA+ED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAyBxE"}