sonamu 0.2.48 → 0.2.49

package/dist/index.d.ts

@@ -761,6 +761,7 @@ type FixtureRecord = {
     fetchedRecords: string[];
     belongsRecords: string[];
     target?: FixtureRecord;
+    unique?: FixtureRecord;
     override?: boolean;
 };
 type FixtureImportResult = {
@@ -1100,7 +1101,10 @@ declare class SonamuClass {
     set secrets(secrets: SonamuSecrets);
     get secrets(): SonamuSecrets | null;
     init(doSilent?: boolean, enableSync?: boolean, apiRootPath?: string): Promise<void>;
-    withFastify(server: FastifyInstance<Server, IncomingMessage, ServerResponse>, config: SonamuFastifyConfig): Promise<void>;
+    withFastify(server: FastifyInstance<Server, IncomingMessage, ServerResponse>, config: SonamuFastifyConfig, options?: {
+        enableSync?: boolean;
+        doSilent?: boolean;
+    }): Promise<void>;
     destroy(): Promise<void>;
 }
 declare const Sonamu: SonamuClass;
@@ -1145,12 +1149,12 @@ declare class UpsertBuilder {
     register<T extends string>(tableName: string, row: {
         [key in T]?: UBRef | string | number | boolean | bigint | null | object | unknown;
     }): UBRef;
-    upsert(wdb: Knex, tableName: string): Promise<number[]>;
-    insertOnly(wdb: Knex, tableName: string): Promise<number[]>;
-    upsertOrInsert(wdb: Knex, tableName: string, mode: "upsert" | "insert"): Promise<number[]>;
+    upsert(wdb: Knex, tableName: string, chunkSize?: number): Promise<number[]>;
+    insertOnly(wdb: Knex, tableName: string, chunkSize?: number): Promise<number[]>;
+    upsertOrInsert(wdb: Knex, tableName: string, mode: "upsert" | "insert", chunkSize?: number): Promise<number[]>;
     updateBatch(wdb: Knex, tableName: string, options?: {
         chunkSize?: number;
-        where?: string;
+        where?: string | string[];
     }): Promise<void>;
 }
 
@@ -1452,14 +1456,18 @@ declare class FixtureManagerClass {
     getImportQueries(entityId: string, field: string, id: number): Promise<string[]>;
     destory(): Promise<void>;
     getFixtures(sourceDBName: keyof SonamuDBConfig, targetDBName: keyof SonamuDBConfig, searchOptions: FixtureSearchOptions): Promise<FixtureRecord[]>;
-    createFixtureRecord(entity: Entity, row: any, visitedEntities: Set<string>, records: FixtureRecord[], singleRecord?: boolean, _db?: Knex): Promise<void>;
-    insertFixtures(dbName: keyof SonamuDBConfig, fixtures: FixtureRecord[]): Promise<FixtureImportResult[]>;
+    createFixtureRecord(entity: Entity, row: any, options?: {
+        singleRecord?: boolean;
+        _db?: Knex;
+    }, visitedEntities?: Set<string>): Promise<FixtureRecord[]>;
+    insertFixtures(dbName: keyof SonamuDBConfig, _fixtures: FixtureRecord[]): Promise<FixtureImportResult[]>;
     private getInsertionOrder;
     private prepareInsertData;
     private buildDependencyGraph;
     private insertFixture;
     private handleManyToManyRelations;
     addFixtureLoader(code: string): Promise<void>;
+    private checkUniqueViolation;
 }
 declare const FixtureManager: FixtureManagerClass;
 

package/dist/index.js

@@ -80,13 +80,13 @@
 
 
 
-var _chunk76VBQWGEjs = require('./chunk-76VBQWGE.js');
+var _chunkHATLA54Zjs = require('./chunk-HATLA54Z.js');
 
 // src/exceptions/error-handler.ts
 function setupErrorHandler(server) {
   server.setErrorHandler((error, request, reply) => {
     _nullishCoalesce(error.statusCode, () => ( (error.statusCode = 400)));
-    if (_chunk76VBQWGEjs.isSoException.call(void 0, error) && error.payload && Array.isArray(error.payload)) {
+    if (_chunkHATLA54Zjs.isSoException.call(void 0, error) && error.payload && Array.isArray(error.payload)) {
       const issues = error.payload;
       const [issue] = issues;
       const message = `${issue.message} (${issue.path.join("/")})`;
@@ -423,5 +423,5 @@ function unique(columns) {
 
 
 
-exports.AlreadyProcessedException = _chunk76VBQWGEjs.AlreadyProcessedException; exports.ApiParamType = _chunk76VBQWGEjs.ApiParamType; exports.BadRequestException = _chunk76VBQWGEjs.BadRequestException; exports.BaseModel = _chunk76VBQWGEjs.BaseModel; exports.BaseModelClass = _chunk76VBQWGEjs.BaseModelClass; exports.DB = _chunk76VBQWGEjs.DB; exports.DuplicateRowException = _chunk76VBQWGEjs.DuplicateRowException; exports.Entity = _chunk76VBQWGEjs.Entity; exports.EntityManager = _chunk76VBQWGEjs.EntityManager; exports.FixtureManager = _chunk76VBQWGEjs.FixtureManager; exports.FixtureManagerClass = _chunk76VBQWGEjs.FixtureManagerClass; exports.GenerateOptions = _chunk76VBQWGEjs.GenerateOptions; exports.InternalServerErrorException = _chunk76VBQWGEjs.InternalServerErrorException; exports.Migrator = _chunk76VBQWGEjs.Migrator; exports.NotFoundException = _chunk76VBQWGEjs.NotFoundException; exports.PathAndCode = _chunk76VBQWGEjs.PathAndCode; exports.RenderingNode = _chunk76VBQWGEjs.RenderingNode; exports.SQLDateTimeString = _chunk76VBQWGEjs.SQLDateTimeString; exports.ServiceUnavailableException = _chunk76VBQWGEjs.ServiceUnavailableException; exports.SoException = _chunk76VBQWGEjs.SoException; exports.Sonamu = _chunk76VBQWGEjs.Sonamu; exports.SonamuQueryMode = _chunk76VBQWGEjs.SonamuQueryMode; exports.Syncer = _chunk76VBQWGEjs.Syncer; exports.TargetNotFoundException = _chunk76VBQWGEjs.TargetNotFoundException; exports.TemplateKey = _chunk76VBQWGEjs.TemplateKey; exports.TemplateOptions = _chunk76VBQWGEjs.TemplateOptions; exports.UnauthorizedException = _chunk76VBQWGEjs.UnauthorizedException; exports.UpsertBuilder = _chunk76VBQWGEjs.UpsertBuilder; exports.api = _chunk76VBQWGEjs.api; exports.apiParamToTsCode = _chunk76VBQWGEjs.apiParamToTsCode; exports.apiParamTypeToTsType = _chunk76VBQWGEjs.apiParamTypeToTsType; exports.asArray = asArray; exports.findApiRootPath = _chunk76VBQWGEjs.findApiRootPath; exports.findAppRootPath = _chunk76VBQWGEjs.findAppRootPath; exports.getTextTypeLength = _chunk76VBQWGEjs.getTextTypeLength; exports.getZodObjectFromApi = _chunk76VBQWGEjs.getZodObjectFromApi; exports.getZodObjectFromApiParams = _chunk76VBQWGEjs.getZodObjectFromApiParams; exports.getZodTypeFromApiParamType = _chunk76VBQWGEjs.getZodTypeFromApiParamType; exports.globAsync = _chunk76VBQWGEjs.globAsync; exports.i = i; exports.importMultiple = _chunk76VBQWGEjs.importMultiple; exports.isBelongsToOneRelationProp = _chunk76VBQWGEjs.isBelongsToOneRelationProp; exports.isBigIntegerProp = _chunk76VBQWGEjs.isBigIntegerProp; exports.isBooleanProp = _chunk76VBQWGEjs.isBooleanProp; exports.isCustomJoinClause = _chunk76VBQWGEjs.isCustomJoinClause; exports.isDaemonServer = _chunk76VBQWGEjs.isDaemonServer; exports.isDateProp = _chunk76VBQWGEjs.isDateProp; exports.isDateTimeProp = _chunk76VBQWGEjs.isDateTimeProp; exports.isDecimalProp = _chunk76VBQWGEjs.isDecimalProp; exports.isDevelopment = _chunk76VBQWGEjs.isDevelopment; exports.isDoubleProp = _chunk76VBQWGEjs.isDoubleProp; exports.isEnumProp = _chunk76VBQWGEjs.isEnumProp; exports.isFloatProp = _chunk76VBQWGEjs.isFloatProp; exports.isHasManyRelationProp = _chunk76VBQWGEjs.isHasManyRelationProp; exports.isInDocker = _chunk76VBQWGEjs.isInDocker; exports.isIntegerProp = _chunk76VBQWGEjs.isIntegerProp; exports.isJsonProp = _chunk76VBQWGEjs.isJsonProp; exports.isKnexError = _chunk76VBQWGEjs.isKnexError; exports.isLocal = _chunk76VBQWGEjs.isLocal; exports.isManyToManyRelationProp = _chunk76VBQWGEjs.isManyToManyRelationProp; exports.isOneToOneRelationProp = _chunk76VBQWGEjs.isOneToOneRelationProp; exports.isProduction = _chunk76VBQWGEjs.isProduction; exports.isRefField = _chunk76VBQWGEjs.isRefField; exports.isRelationProp = _chunk76VBQWGEjs.isRelationProp; exports.isRemote = _chunk76VBQWGEjs.isRemote; exports.isSoException = _chunk76VBQWGEjs.isSoException; exports.isStaging = _chunk76VBQWGEjs.isStaging; exports.isStringProp = _chunk76VBQWGEjs.isStringProp; exports.isTest = _chunk76VBQWGEjs.isTest; exports.isTextProp = _chunk76VBQWGEjs.isTextProp; exports.isTimeProp = _chunk76VBQWGEjs.isTimeProp; exports.isTimestampProp = _chunk76VBQWGEjs.isTimestampProp; exports.isUuidProp = _chunk76VBQWGEjs.isUuidProp; exports.isVirtualProp = _chunk76VBQWGEjs.isVirtualProp; exports.nonNullable = _chunk76VBQWGEjs.nonNullable; exports.objToMap = objToMap; exports.p = p; exports.propNodeToZodTypeDef = _chunk76VBQWGEjs.propNodeToZodTypeDef; exports.propToZodTypeDef = _chunk76VBQWGEjs.propToZodTypeDef; exports.registeredApis = _chunk76VBQWGEjs.registeredApis; exports.serializeZodType = _chunk76VBQWGEjs.serializeZodType; exports.setupErrorHandler = setupErrorHandler; exports.unwrapPromiseOnce = _chunk76VBQWGEjs.unwrapPromiseOnce; exports.zArrayable = _chunk76VBQWGEjs.zArrayable; exports.zodTypeToTsTypeDef = _chunk76VBQWGEjs.zodTypeToTsTypeDef; exports.zodTypeToZodCode = _chunk76VBQWGEjs.zodTypeToZodCode;
+exports.AlreadyProcessedException = _chunkHATLA54Zjs.AlreadyProcessedException; exports.ApiParamType = _chunkHATLA54Zjs.ApiParamType; exports.BadRequestException = _chunkHATLA54Zjs.BadRequestException; exports.BaseModel = _chunkHATLA54Zjs.BaseModel; exports.BaseModelClass = _chunkHATLA54Zjs.BaseModelClass; exports.DB = _chunkHATLA54Zjs.DB; exports.DuplicateRowException = _chunkHATLA54Zjs.DuplicateRowException; exports.Entity = _chunkHATLA54Zjs.Entity; exports.EntityManager = _chunkHATLA54Zjs.EntityManager; exports.FixtureManager = _chunkHATLA54Zjs.FixtureManager; exports.FixtureManagerClass = _chunkHATLA54Zjs.FixtureManagerClass; exports.GenerateOptions = _chunkHATLA54Zjs.GenerateOptions; exports.InternalServerErrorException = _chunkHATLA54Zjs.InternalServerErrorException; exports.Migrator = _chunkHATLA54Zjs.Migrator; exports.NotFoundException = _chunkHATLA54Zjs.NotFoundException; exports.PathAndCode = _chunkHATLA54Zjs.PathAndCode; exports.RenderingNode = _chunkHATLA54Zjs.RenderingNode; exports.SQLDateTimeString = _chunkHATLA54Zjs.SQLDateTimeString; exports.ServiceUnavailableException = _chunkHATLA54Zjs.ServiceUnavailableException; exports.SoException = _chunkHATLA54Zjs.SoException; exports.Sonamu = _chunkHATLA54Zjs.Sonamu; exports.SonamuQueryMode = _chunkHATLA54Zjs.SonamuQueryMode; exports.Syncer = _chunkHATLA54Zjs.Syncer; exports.TargetNotFoundException = _chunkHATLA54Zjs.TargetNotFoundException; exports.TemplateKey = _chunkHATLA54Zjs.TemplateKey; exports.TemplateOptions = _chunkHATLA54Zjs.TemplateOptions; exports.UnauthorizedException = _chunkHATLA54Zjs.UnauthorizedException; exports.UpsertBuilder = _chunkHATLA54Zjs.UpsertBuilder; exports.api = _chunkHATLA54Zjs.api; exports.apiParamToTsCode = _chunkHATLA54Zjs.apiParamToTsCode; exports.apiParamTypeToTsType = _chunkHATLA54Zjs.apiParamTypeToTsType; exports.asArray = asArray; exports.findApiRootPath = _chunkHATLA54Zjs.findApiRootPath; exports.findAppRootPath = _chunkHATLA54Zjs.findAppRootPath; exports.getTextTypeLength = _chunkHATLA54Zjs.getTextTypeLength; exports.getZodObjectFromApi = _chunkHATLA54Zjs.getZodObjectFromApi; exports.getZodObjectFromApiParams = _chunkHATLA54Zjs.getZodObjectFromApiParams; exports.getZodTypeFromApiParamType = _chunkHATLA54Zjs.getZodTypeFromApiParamType; exports.globAsync = _chunkHATLA54Zjs.globAsync; exports.i = i; exports.importMultiple = _chunkHATLA54Zjs.importMultiple; exports.isBelongsToOneRelationProp = _chunkHATLA54Zjs.isBelongsToOneRelationProp; exports.isBigIntegerProp = _chunkHATLA54Zjs.isBigIntegerProp; exports.isBooleanProp = _chunkHATLA54Zjs.isBooleanProp; exports.isCustomJoinClause = _chunkHATLA54Zjs.isCustomJoinClause; exports.isDaemonServer = _chunkHATLA54Zjs.isDaemonServer; exports.isDateProp = _chunkHATLA54Zjs.isDateProp; exports.isDateTimeProp = _chunkHATLA54Zjs.isDateTimeProp; exports.isDecimalProp = _chunkHATLA54Zjs.isDecimalProp; exports.isDevelopment = _chunkHATLA54Zjs.isDevelopment; exports.isDoubleProp = _chunkHATLA54Zjs.isDoubleProp; exports.isEnumProp = _chunkHATLA54Zjs.isEnumProp; exports.isFloatProp = _chunkHATLA54Zjs.isFloatProp; exports.isHasManyRelationProp = _chunkHATLA54Zjs.isHasManyRelationProp; exports.isInDocker = _chunkHATLA54Zjs.isInDocker; exports.isIntegerProp = _chunkHATLA54Zjs.isIntegerProp; exports.isJsonProp = _chunkHATLA54Zjs.isJsonProp; exports.isKnexError = _chunkHATLA54Zjs.isKnexError; exports.isLocal = _chunkHATLA54Zjs.isLocal; exports.isManyToManyRelationProp = _chunkHATLA54Zjs.isManyToManyRelationProp; exports.isOneToOneRelationProp = _chunkHATLA54Zjs.isOneToOneRelationProp; exports.isProduction = _chunkHATLA54Zjs.isProduction; exports.isRefField = _chunkHATLA54Zjs.isRefField; exports.isRelationProp = _chunkHATLA54Zjs.isRelationProp; exports.isRemote = _chunkHATLA54Zjs.isRemote; exports.isSoException = _chunkHATLA54Zjs.isSoException; exports.isStaging = _chunkHATLA54Zjs.isStaging; exports.isStringProp = _chunkHATLA54Zjs.isStringProp; exports.isTest = _chunkHATLA54Zjs.isTest; exports.isTextProp = _chunkHATLA54Zjs.isTextProp; exports.isTimeProp = _chunkHATLA54Zjs.isTimeProp; exports.isTimestampProp = _chunkHATLA54Zjs.isTimestampProp; exports.isUuidProp = _chunkHATLA54Zjs.isUuidProp; exports.isVirtualProp = _chunkHATLA54Zjs.isVirtualProp; exports.nonNullable = _chunkHATLA54Zjs.nonNullable; exports.objToMap = objToMap; exports.p = p; exports.propNodeToZodTypeDef = _chunkHATLA54Zjs.propNodeToZodTypeDef; exports.propToZodTypeDef = _chunkHATLA54Zjs.propToZodTypeDef; exports.registeredApis = _chunkHATLA54Zjs.registeredApis; exports.serializeZodType = _chunkHATLA54Zjs.serializeZodType; exports.setupErrorHandler = setupErrorHandler; exports.unwrapPromiseOnce = _chunkHATLA54Zjs.unwrapPromiseOnce; exports.zArrayable = _chunkHATLA54Zjs.zArrayable; exports.zodTypeToTsTypeDef = _chunkHATLA54Zjs.zodTypeToTsTypeDef; exports.zodTypeToZodCode = _chunkHATLA54Zjs.zodTypeToZodCode;
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonamu",
-  "version": "0.2.48",
+  "version": "0.2.49",
   "description": "Sonamu — TypeScript Fullstack API Framework",
   "keywords": [
     "typescript",

package/src/api/sonamu.ts

@@ -185,10 +185,11 @@ class SonamuClass {
 
   async withFastify(
     server: FastifyInstance<Server, IncomingMessage, ServerResponse>,
-    config: SonamuFastifyConfig
+    config: SonamuFastifyConfig,
+    options?: { enableSync?: boolean; doSilent?: boolean }
   ) {
     if (this.isInitialized === false) {
-      await this.init();
+      await this.init(options?.doSilent, options?.enableSync);
     }
 
     // 전체 라우팅 리스트

package/src/bin/cli-wrapper.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env ts-node
 
 import { spawnSync } from "child_process";
-import { resolve } from "path";
+import { extname, resolve } from "path";
 import { existsSync, readFileSync } from "fs";
 
 const cjsPath = resolve(__dirname, "bin/cli.js");
@@ -9,10 +9,29 @@ const esmPath = resolve(__dirname, "bin/cli.mjs");
 
 const isESM = () => {
   const packageJsonPath = resolve(process.cwd(), "package.json");
+  const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+
+  // package.json에 "type": "module" 설정 확인
+  if (packageJson.type === "module") {
+    return true;
+  }
+
+  // 환경 변수에서 ESM 여부 확인
+  if (process.env.USE_ESM === "true") {
+    return true;
+  }
+
+  // package.json에 "type": "module" 설정
   if (existsSync(packageJsonPath)) {
     const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
     return packageJson.type === "module";
   }
+
+  // main 필드가 .mjs로 끝나는지 확인
+  if (packageJson.main && extname(packageJson.main) === ".mjs") {
+    return true;
+  }
+
   return false;
 };
 

package/src/bin/cli.ts

@@ -166,9 +166,13 @@ async function fixture_init() {
   console.log("DUMP...");
   const dumpFilename = `/tmp/sonamu-fixture-init-${Date.now()}.sql`;
   const srcConn = srcConfig.connection as Knex.ConnectionConfig;
+  const migrationsDump = `/tmp/sonamu-fixture-init-migrations-${Date.now()}.sql`;
   execSync(
     `mysqldump -h${srcConn.host} -u${srcConn.user} -p${srcConn.password} --single-transaction -d --no-create-db --triggers ${srcConn.database} > ${dumpFilename}`
   );
+  execSync(
+    `mysqldump -h${srcConn.host} -u${srcConn.user} -p${srcConn.password} --single-transaction --no-create-db --triggers ${srcConn.database} knex_migrations knex_migrations_lock > ${migrationsDump}`
+  );
 
   // 2. 대상DB 각각에 대하여 존재여부 확인 후 붓기
   for await (const { label, config, toSkip } of targets) {
@@ -200,21 +204,7 @@ async function fixture_init() {
     execSync(`${mysqlCmd} -e 'DROP DATABASE IF EXISTS \`${conn.database}\`'`);
     execSync(`${mysqlCmd} -e 'CREATE DATABASE \`${conn.database}\`'`);
     execSync(`${mysqlCmd} ${conn.database} < ${dumpFilename}`);
-
-    // 3. knex migration 정보 복사
-    await Promise.all(
-      ["knex_migrations", "knex_migrations_lock"].map(async (tableName) => {
-        const [table] = await db.raw(
-          `SHOW TABLES FROM \`${srcConn.database}\` LIKE '${tableName}'`
-        );
-        if (table?.length) {
-          await db.raw(
-            `INSERT INTO \`${conn.database}\`.${tableName}
-          SELECT * FROM \`${srcConn.database}\`.${tableName}`
-          );
-        }
-      })
-    );
+    execSync(`${mysqlCmd} ${conn.database} < ${migrationsDump}`);
 
     await db.destroy();
   }

package/src/database/_batch_update.ts

@@ -13,7 +13,7 @@ export type RowWithId<Id extends string> = {
  * Batch update rows in a table. Technically its a patch since it only updates the specified columns. Any omitted columns will not be affected
  * @param knex
  * @param tableName
- * @param id
+ * @param ids
  * @param rows
  * @param chunkSize
  * @param trx
@@ -21,7 +21,7 @@ export type RowWithId<Id extends string> = {
 export async function batchUpdate<Id extends string>(
   knex: Knex,
   tableName: string,
-  id: Id,
+  ids: Id[],
   rows: RowWithId<Id>[],
   chunkSize = 50,
   trx: Knex.Transaction | null = null
@@ -35,7 +35,7 @@ export async function batchUpdate<Id extends string>(
     chunk: RowWithId<Id>[],
     transaction: Knex.Transaction
   ) => {
-    const sql = generateBatchUpdateSQL(knex, tableName, chunk, id);
+    const sql = generateBatchUpdateSQL(knex, tableName, chunk, ids);
     return knex.raw(sql).transacting(transaction);
   };
 
@@ -73,20 +73,30 @@ function generateBatchUpdateSQL<Id extends string>(
   knex: Knex,
   tableName: string,
   data: Record<string, any>[],
-  identifier: Id
+  identifiers: Id[]
 ) {
   const keySet = generateKeySetFromData(data);
   const bindings = [];
 
+  const invalidIdentifiers = identifiers.filter((id) => !keySet.has(id));
+  if (invalidIdentifiers.length > 0) {
+    throw new Error(
+      `Invalid identifiers: ${invalidIdentifiers.join(", ")}. Identifiers must exist in the data`
+    );
+  }
+
   const cases = [];
   for (const key of keySet) {
-    if (key === identifier) continue;
+    if (identifiers.includes(key as Id)) continue;
 
     const rows = [];
     for (const row of data) {
       if (Object.hasOwnProperty.call(row, key)) {
-        rows.push(`WHEN \`${identifier}\` = ? THEN ?`);
-        bindings.push(row[identifier], row[key]);
+        const whereClause = identifiers
+          .map((id) => `\`${id}\` = ?`)
+          .join(" AND ");
+        rows.push(`WHEN (${whereClause}) THEN ?`);
+        bindings.push(...identifiers.map((i) => row[i]), row[key]);
       }
     }
 
@@ -94,13 +104,18 @@ function generateBatchUpdateSQL<Id extends string>(
     cases.push(`\`${key}\` = CASE ${whenThen} ELSE \`${key}\` END`);
   }
 
-  const whereInIds = data.map((row) => row[identifier]);
-  const whereInPlaceholders = whereInIds.map(() => "?").join(", ");
+  const whereInClauses = identifiers
+    .map((col) => `${col} IN (${data.map(() => "?").join(", ")})`)
+    .join(" AND ");
+
+  const whereInBindings = identifiers.flatMap((col) =>
+    data.map((row) => row[col])
+  );
+
   const sql = knex.raw(
-    `UPDATE \`${tableName}\` SET ${cases.join(
-      ", "
-    )} WHERE ${identifier} IN (${whereInPlaceholders})`,
-    [...bindings, ...whereInIds]
+    `UPDATE \`${tableName}\` SET ${cases.join(", ")} WHERE ${whereInClauses}`,
+    [...bindings, ...whereInBindings]
   );
-  return sql.toString();
+
+  return sql.toQuery();
 }

package/src/database/upsert-builder.ts

@@ -144,17 +144,26 @@ export class UpsertBuilder {
     };
   }
 
-  async upsert(wdb: Knex, tableName: string): Promise<number[]> {
-    return this.upsertOrInsert(wdb, tableName, "upsert");
+  async upsert(
+    wdb: Knex,
+    tableName: string,
+    chunkSize?: number
+  ): Promise<number[]> {
+    return this.upsertOrInsert(wdb, tableName, "upsert", chunkSize);
   }
-  async insertOnly(wdb: Knex, tableName: string): Promise<number[]> {
-    return this.upsertOrInsert(wdb, tableName, "insert");
+  async insertOnly(
+    wdb: Knex,
+    tableName: string,
+    chunkSize?: number
+  ): Promise<number[]> {
+    return this.upsertOrInsert(wdb, tableName, "insert", chunkSize);
   }
 
   async upsertOrInsert(
     wdb: Knex,
     tableName: string,
-    mode: "upsert" | "insert"
+    mode: "upsert" | "insert",
+    chunkSize?: number
   ): Promise<number[]> {
     if (this.hasTable(tableName) === false) {
       return [];
@@ -177,22 +186,6 @@ export class UpsertBuilder {
       throw new Error(`${tableName} 해결되지 않은 참조가 있습니다.`);
     }
 
-    // 내부 참조 있는 경우 필터하여 분리
-    const groups = _.groupBy(table.rows, (row) =>
-      Object.entries(row).some(([, value]) => isRefField(value))
-        ? "selfRef"
-        : "normal"
-    );
-    const targetRows = groups.normal;
-
-    // Insert On Duplicate Update
-    const q = wdb.insert(targetRows).into(tableName);
-    if (mode === "insert") {
-      await q;
-    } else if (mode === "upsert") {
-      await q.onDuplicateUpdate.apply(q, Object.keys(targetRows[0]));
-    }
-
     // 전체 테이블 순회하여 현재 테이블 참조하는 모든 테이블 추출
     const { references, refTables } = Array.from(this.tables).reduce(
       (r, [, table]) => {
@@ -211,19 +204,39 @@ export class UpsertBuilder {
         refTables: [] as TableData[],
       }
     );
-
     const extractFields = _.uniq(references).map(
       (reference) => reference.split(".")[1]
     );
 
-    // UUID 기준으로 id 추출
-    const uuids = table.rows.map((row) => row.uuid);
-    const upsertedRows = await wdb(tableName)
-      .select(_.uniq(["uuid", "id", ...extractFields]))
-      .whereIn("uuid", uuids);
-    const uuidMap = new Map<string, any>(
-      upsertedRows.map((row: any) => [row.uuid, row])
+    // 내부 참조 있는 경우 필터하여 분리
+    const groups = _.groupBy(table.rows, (row) =>
+      Object.entries(row).some(([, value]) => isRefField(value))
+        ? "selfRef"
+        : "normal"
     );
+    const normalRows = groups.normal ?? [];
+    const selfRefRows = groups.selfRef ?? [];
+
+    const chunks = chunkSize ? _.chunk(normalRows, chunkSize) : [normalRows];
+    const uuidMap = new Map<string, any>();
+
+    for (const chunk of chunks) {
+      const q = wdb.insert(chunk).into(tableName);
+      if (mode === "insert") {
+        await q;
+      } else if (mode === "upsert") {
+        await q.onDuplicateUpdate.apply(q, Object.keys(normalRows[0]));
+      }
+
+      // upsert된 row들을 다시 조회하여 uuidMap에 저장
+      const uuids = chunk.map((row) => row.uuid);
+      const upsertedRows = await wdb(tableName)
+        .select(_.uniq(["uuid", "id", ...extractFields]))
+        .whereIn("uuid", uuids);
+      upsertedRows.forEach((row: any) => {
+        uuidMap.set(row.uuid, row);
+      });
+    }
 
     // 해당 테이블 참조를 실제 밸류로 변경
     refTables.map((table) => {
@@ -245,14 +258,17 @@ export class UpsertBuilder {
       });
     });
 
-    const ids = Array.from(uuidMap.values()).map((val) => val.id);
+    const allIds = Array.from(uuidMap.values()).map((row) => row.id);
 
-    if (groups.selfRef) {
-      const selfRefIds = await this.upsert(wdb, tableName);
-      return [...ids, ...selfRefIds];
+    // 자기 참조가 있는 경우 재귀적으로 upsert
+    if (selfRefRows.length > 0) {
+      // 처리된 데이터를 제외하고 다시 upsert
+      table.rows = selfRefRows;
+      const selfRefIds = await this.upsert(wdb, tableName, chunkSize);
+      allIds.push(...selfRefIds);
     }
 
-    return ids;
+    return allIds;
   }
 
   async updateBatch(
@@ -260,7 +276,7 @@ export class UpsertBuilder {
     tableName: string,
     options?: {
       chunkSize?: number;
-      where?: string;
+      where?: string | string[];
     }
   ): Promise<void> {
     options = _.defaults(options, {
@@ -276,16 +292,14 @@ export class UpsertBuilder {
       return;
     }
 
+    const whereColumns = Array.isArray(options.where)
+      ? options.where
+      : [options.where ?? "id"];
     const rows = table.rows.map((_row) => {
       const { uuid, ...row } = _row;
       return row as RowWithId<string>;
     });
-    await batchUpdate(
-      wdb,
-      tableName,
-      options.where ?? "id",
-      rows,
-      options.chunkSize
-    );
+
+    await batchUpdate(wdb, tableName, whereColumns, rows, options.chunkSize);
   }
 }