sonamu 0.7.4 → 0.7.5

package/dist/vector/vector-search.js

@@ -0,0 +1,176 @@
+import pgvector from "pgvector/knex";
+import { DEFAULT_VECTOR_CONFIG } from "./config.js";
+import { Embedding } from "./embedding.js";
+/**
+ * 벡터 검색
+ * pgvector를 활용한 벡터 검색 및 하이브리드 검색 지원
+ */ export class VectorSearch {
+    db;
+    config;
+    embedding;
+    tableName;
+    constructor(db, tableName, config = {}){
+        this.db = db;
+        this.tableName = tableName;
+        this.config = {
+            voyage: {
+                ...DEFAULT_VECTOR_CONFIG.voyage,
+                ...config.voyage
+            },
+            openai: {
+                ...DEFAULT_VECTOR_CONFIG.openai,
+                ...config.openai
+            },
+            chunking: {
+                ...DEFAULT_VECTOR_CONFIG.chunking,
+                ...config.chunking
+            },
+            search: {
+                ...DEFAULT_VECTOR_CONFIG.search,
+                ...config.search
+            },
+            pgvector: {
+                ...DEFAULT_VECTOR_CONFIG.pgvector,
+                ...config.pgvector
+            }
+        };
+        this.embedding = new Embedding(config);
+    }
+    /**
+   * 단일 항목에 임베딩 저장
+   */ async saveEmbedding(id, text, provider, embeddingColumn = "content_embedding") {
+        const { embedding } = await this.embedding.embedOne(text, provider, "document");
+        await this.db(this.tableName).where("id", id).update({
+            [embeddingColumn]: pgvector.toSql(embedding)
+        });
+    }
+    /**
+   * 여러 항목에 임베딩 일괄 저장
+   */ async saveEmbeddingsBatch(items, provider, embeddingColumn = "content_embedding", onProgress) {
+        const texts = items.map((item)=>item.text);
+        const embeddings = await this.embedding.embedBatch(texts, provider, "document", onProgress);
+        await this.db.transaction(async (trx)=>{
+            for(let i = 0; i < items.length; i++){
+                await trx(this.tableName).where("id", items[i].id).update({
+                    [embeddingColumn]: pgvector.toSql(embeddings[i].embedding)
+                });
+            }
+        });
+    }
+    /**
+   * 벡터 검색 (코사인 유사도)
+   */ async search(query, provider, options = {}) {
+        const { embeddingColumn = "content_embedding", limit = this.config.search.defaultLimit, threshold = this.config.search.similarityThreshold, where } = options;
+        // 쿼리 임베딩 (input_type: 'query' 중요!)
+        const { embedding } = await this.embedding.embedOne(query, provider, "query");
+        // pgvector 세션 설정
+        if (this.config.pgvector.iterativeScan) {
+            await this.db.raw("SET hnsw.iterative_scan = relaxed_order");
+        }
+        await this.db.raw(`SET hnsw.ef_search = ${this.config.pgvector.efSearch}`);
+        // 코사인 유사도 = 1 - 코사인 거리
+        const vectorStr = pgvector.toSql(embedding);
+        let queryBuilder = this.db(this.tableName).select("*").select(this.db.raw(`1 - (${embeddingColumn} <=> ?::vector) AS similarity`, [
+            vectorStr
+        ])).whereNotNull(embeddingColumn).orderByRaw(`${embeddingColumn} <=> ?::vector`, [
+            vectorStr
+        ]).limit(limit);
+        if (where) {
+            queryBuilder = queryBuilder.whereRaw(where);
+        }
+        const rows = await queryBuilder;
+        return rows.filter((row)=>row.similarity >= threshold).map((row)=>({
+                id: row.id,
+                similarity: parseFloat(String(row.similarity)),
+                data: row
+            }));
+    }
+    /**
+   * 하이브리드 검색 (Vector + FTS)
+   */ async hybridSearch(query, provider, options = {}) {
+        const { embeddingColumn = "content_embedding", ftsColumn = "content_tsv", limit = this.config.search.defaultLimit, vectorWeight = this.config.search.vectorWeight, ftsWeight = this.config.search.ftsWeight } = options;
+        const { embedding } = await this.embedding.embedOne(query, provider, "query");
+        const vectorStr = pgvector.toSql(embedding);
+        // pgvector 세션 설정
+        if (this.config.pgvector.iterativeScan) {
+            await this.db.raw("SET hnsw.iterative_scan = relaxed_order");
+        }
+        await this.db.raw(`SET hnsw.ef_search = ${this.config.pgvector.efSearch}`);
+        const sql = `
+      WITH vector_search AS (
+        SELECT
+          id,
+          ROW_NUMBER() OVER (ORDER BY ${embeddingColumn} <=> ?::vector) AS rank
+        FROM ${this.tableName}
+        WHERE ${embeddingColumn} IS NOT NULL
+        ORDER BY ${embeddingColumn} <=> ?::vector
+        LIMIT 50
+      ),
+      fts_search AS (
+        SELECT
+          id,
+          ROW_NUMBER() OVER (ORDER BY ts_rank(${ftsColumn}, query) DESC) AS rank
+        FROM ${this.tableName}, plainto_tsquery('simple', ?) query
+        WHERE ${ftsColumn} @@ query
+        LIMIT 50
+      ),
+      combined AS (
+        SELECT
+          COALESCE(v.id, f.id) AS id,
+          COALESCE(1.0 / (60 + v.rank), 0) AS vector_score,
+          COALESCE(1.0 / (60 + f.rank), 0) AS fts_score
+        FROM vector_search v
+        FULL OUTER JOIN fts_search f ON v.id = f.id
+      )
+      SELECT
+        t.*,
+        c.vector_score,
+        c.fts_score,
+        (c.vector_score * ? + c.fts_score * ?) AS similarity
+      FROM combined c
+      JOIN ${this.tableName} t ON c.id = t.id
+      ORDER BY similarity DESC
+      LIMIT ?
+    `;
+        const { rows } = await this.db.raw(sql, [
+            vectorStr,
+            vectorStr,
+            query,
+            vectorWeight,
+            ftsWeight,
+            limit
+        ]);
+        return rows.map((row)=>({
+                id: row.id,
+                similarity: parseFloat(String(row.similarity)),
+                vectorScore: parseFloat(String(row.vector_score)),
+                ftsScore: parseFloat(String(row.fts_score)),
+                data: row
+            }));
+    }
+    /**
+   * 임베딩 현황 조회
+   */ async getEmbeddingStatus(embeddingColumn = "content_embedding") {
+        const result = await this.db(this.tableName).count("* as total").count(`${embeddingColumn} as with_embedding`).first();
+        const total = parseInt(String(result?.total ?? 0), 10);
+        const withEmbedding = parseInt(String(result?.with_embedding ?? 0), 10);
+        return {
+            total,
+            withEmbedding,
+            withoutEmbedding: total - withEmbedding
+        };
+    }
+    /**
+   * 임베딩이 없는 항목 ID 조회
+   */ async getItemsWithoutEmbedding(embeddingColumn = "content_embedding", limit = 100) {
+        const rows = await this.db(this.tableName).select("id").whereNull(embeddingColumn).orderBy("id").limit(limit);
+        return rows.map((row)=>row.id);
+    }
+    /**
+   * Embedding 인스턴스 반환 (고급 사용)
+   */ getEmbedding() {
+        return this.embedding;
+    }
+}
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy92ZWN0b3IvdmVjdG9yLXNlYXJjaC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgdHlwZSB7IEtuZXggfSBmcm9tIFwia25leFwiO1xuaW1wb3J0IHBndmVjdG9yIGZyb20gXCJwZ3ZlY3Rvci9rbmV4XCI7XG5pbXBvcnQgeyBERUZBVUxUX1ZFQ1RPUl9DT05GSUcgfSBmcm9tIFwiLi9jb25maWdcIjtcbmltcG9ydCB7IEVtYmVkZGluZyB9IGZyb20gXCIuL2VtYmVkZGluZ1wiO1xuaW1wb3J0IHR5cGUge1xuICBFbWJlZGRpbmdJdGVtLFxuICBFbWJlZGRpbmdQcm92aWRlcixcbiAgSHlicmlkU2VhcmNoT3B0aW9ucyxcbiAgSHlicmlkU2VhcmNoUmVzdWx0LFxuICBQcm9ncmVzc0NhbGxiYWNrLFxuICBWZWN0b3JDb25maWcsXG4gIFZlY3RvclNlYXJjaE9wdGlvbnMsXG4gIFZlY3RvclNlYXJjaFJlc3VsdCxcbn0gZnJvbSBcIi4vdHlwZXNcIjtcblxuLyoqXG4gKiDrsqHthLAg6rKA7IOJXG4gKiBwZ3ZlY3RvcuulvCDtmZzsmqntlZwg67Kh7YSwIOqygOyDiSDrsI8g7ZWY7J2067iM66as65OcIOqygOyDiSDsp4Dsm5BcbiAqL1xuZXhwb3J0IGNsYXNzIFZlY3RvclNlYXJjaDxUID0gUmVjb3JkPHN0cmluZywgdW5rbm93bj4+IHtcbiAgcHJpdmF0ZSBkYjogS25leDtcbiAgcHJpdmF0ZSBjb25maWc6IFZlY3RvckNvbmZpZztcbiAgcHJpdmF0ZSBlbWJlZGRpbmc6IEVtYmVkZGluZztcbiAgcHJpdmF0ZSB0YWJsZU5hbWU6IHN0cmluZztcblxuICBjb25zdHJ1Y3RvcihkYjogS25leCwgdGFibGVOYW1lOiBzdHJpbmcsIGNvbmZpZzogUGFydGlhbDxWZWN0b3JDb25maWc+ID0ge30pIHtcbiAgICB0aGlzLmRiID0gZGI7XG4gICAgdGhpcy50YWJsZU5hbWUgPSB0YWJsZU5hbWU7XG4gICAgdGhpcy5jb25maWcgPSB7XG4gICAgICB2b3lhZ2U6IHsgLi4uREVGQVVMVF9WRUNUT1JfQ09ORklHLnZveWFnZSwgLi4uY29uZmlnLnZveWFnZSB9LFxuICAgICAgb3BlbmFpOiB7IC4uLkRFRkFVTFRfVkVDVE9SX0NPTkZJRy5vcGVuYWksIC4uLmNvbmZpZy5vcGVuYWkgfSxcbiAgICAgIGNodW5raW5nOiB7IC4uLkRFRkFVTFRfVkVDVE9SX0NPTkZJRy5jaHVua2luZywgLi4uY29uZmlnLmNodW5raW5nIH0sXG4gICAgICBzZWFyY2g6IHsgLi4uREVGQVVMVF9WRUNUT1JfQ09ORklHLnNlYXJjaCwgLi4uY29uZmlnLnNlYXJjaCB9LFxuICAgICAgcGd2ZWN0b3I6IHsgLi4uREVGQVVMVF9WRUNUT1JfQ09ORklHLnBndmVjdG9yLCAuLi5jb25maWcucGd2ZWN0b3IgfSxcbiAgICB9O1xuICAgIHRoaXMuZW1iZWRkaW5nID0gbmV3IEVtYmVkZGluZyhjb25maWcpO1xuICB9XG5cbiAgLyoqXG4gICAqIOuLqOydvCDtla3rqqnsl5Ag7J6E67Kg65SpIOyggOyepVxuICAgKi9cbiAgYXN5bmMgc2F2ZUVtYmVkZGluZyhcbiAgICBpZDogbnVtYmVyLFxuICAgIHRleHQ6IHN0cmluZyxcbiAgICBwcm92aWRlcjogRW1iZWRkaW5nUHJvdmlkZXIsXG4gICAgZW1iZWRkaW5nQ29sdW1uOiBzdHJpbmcgPSBcImNvbnRlbnRfZW1iZWRkaW5nXCIsXG4gICk6IFByb21pc2U8dm9pZD4ge1xuICAgIGNvbnN0IHsgZW1iZWRkaW5nIH0gPSBhd2FpdCB0aGlzLmVtYmVkZGluZy5lbWJlZE9uZSh0ZXh0LCBwcm92aWRlciwgXCJkb2N1bWVudFwiKTtcblxuICAgIGF3YWl0IHRoaXMuZGIodGhpcy50YWJsZU5hbWUpXG4gICAgICAud2hlcmUoXCJpZFwiLCBpZClcbiAgICAgIC51cGRhdGUoe1xuICAgICAgICBbZW1iZWRkaW5nQ29sdW1uXTogcGd2ZWN0b3IudG9TcWwoZW1iZWRkaW5nKSxcbiAgICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIOyXrOufrCDtla3rqqnsl5Ag7J6E67Kg65SpIOydvOq0hCDsoIDsnqVcbiAgICovXG4gIGFzeW5jIHNhdmVFbWJlZGRpbmdzQmF0Y2goXG4gICAgaXRlbXM6IEVtYmVkZGluZ0l0ZW1bXSxcbiAgICBwcm92aWRlcjogRW1iZWRkaW5nUHJvdmlkZXIsXG4gICAgZW1iZWRkaW5nQ29sdW1uOiBzdHJpbmcgPSBcImNvbnRlbnRfZW1iZWRkaW5nXCIsXG4gICAgb25Qcm9ncmVzcz86IFByb2dyZXNzQ2FsbGJhY2ssXG4gICk6IFByb21pc2U8dm9pZD4ge1xuICAgIGNvbnN0IHRleHRzID0gaXRlbXMubWFwKChpdGVtKSA9PiBpdGVtLnRleHQpO1xuICAgIGNvbnN0IGVtYmVkZGluZ3MgPSBhd2FpdCB0aGlzLmVtYmVkZGluZy5lbWJlZEJhdGNoKHRleHRzLCBwcm92aWRlciwgXCJkb2N1bWVudFwiLCBvblByb2dyZXNzKTtcblxuICAgIGF3YWl0IHRoaXMuZGIudHJhbnNhY3Rpb24oYXN5bmMgKHRyeCkgPT4ge1xuICAgICAgZm9yIChsZXQgaSA9IDA7IGkgPCBpdGVtcy5sZW5ndGg7IGkrKykge1xuICAgICAgICBhd2FpdCB0cngodGhpcy50YWJsZU5hbWUpXG4gICAgICAgICAgLndoZXJlKFwiaWRcIiwgaXRlbXNbaV0uaWQpXG4gICAgICAgICAgLnVwZGF0ZSh7XG4gICAgICAgICAgICBbZW1iZWRkaW5nQ29sdW1uXTogcGd2ZWN0b3IudG9TcWwoZW1iZWRkaW5nc1tpXS5lbWJlZGRpbmcpLFxuICAgICAgICAgIH0pO1xuICAgICAgfVxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIOuyoe2EsCDqsoDsg4kgKOy9lOyCrOyduCDsnKDsgqzrj4QpXG4gICAqL1xuICBhc3luYyBzZWFyY2goXG4gICAgcXVlcnk6IHN0cmluZyxcbiAgICBwcm92aWRlcjogRW1iZWRkaW5nUHJvdmlkZXIsXG4gICAgb3B0aW9uczogVmVjdG9yU2VhcmNoT3B0aW9ucyA9IHt9LFxuICApOiBQcm9taXNlPFZlY3RvclNlYXJjaFJlc3VsdDxUPltdPiB7XG4gICAgY29uc3Qge1xuICAgICAgZW1iZWRkaW5nQ29sdW1uID0gXCJjb250ZW50X2VtYmVkZGluZ1wiLFxuICAgICAgbGltaXQgPSB0aGlzLmNvbmZpZy5zZWFyY2guZGVmYXVsdExpbWl0LFxuICAgICAgdGhyZXNob2xkID0gdGhpcy5jb25maWcuc2VhcmNoLnNpbWlsYXJpdHlUaHJlc2hvbGQsXG4gICAgICB3aGVyZSxcbiAgICB9ID0gb3B0aW9ucztcblxuICAgIC8vIOy/vOumrCDsnoTrsqDrlKkgKGlucHV0X3R5cGU6ICdxdWVyeScg7KSR7JqUISlcbiAgICBjb25zdCB7IGVtYmVkZGluZyB9ID0gYXdhaXQgdGhpcy5lbWJlZGRpbmcuZW1iZWRPbmUocXVlcnksIHByb3ZpZGVyLCBcInF1ZXJ5XCIpO1xuXG4gICAgLy8gcGd2ZWN0b3Ig7IS47IWYIOyEpOyglVxuICAgIGlmICh0aGlzLmNvbmZpZy5wZ3ZlY3Rvci5pdGVyYXRpdmVTY2FuKSB7XG4gICAgICBhd2FpdCB0aGlzLmRiLnJhdyhcIlNFVCBobnN3Lml0ZXJhdGl2ZV9zY2FuID0gcmVsYXhlZF9vcmRlclwiKTtcbiAgICB9XG4gICAgYXdhaXQgdGhpcy5kYi5yYXcoYFNFVCBobnN3LmVmX3NlYXJjaCA9ICR7dGhpcy5jb25maWcucGd2ZWN0b3IuZWZTZWFyY2h9YCk7XG5cbiAgICAvLyDsvZTsgqzsnbgg7Jyg7IKs64+EID0gMSAtIOy9lOyCrOyduCDqsbDrpqxcbiAgICBjb25zdCB2ZWN0b3JTdHIgPSBwZ3ZlY3Rvci50b1NxbChlbWJlZGRpbmcpO1xuICAgIGxldCBxdWVyeUJ1aWxkZXIgPSB0aGlzLmRiKHRoaXMudGFibGVOYW1lKVxuICAgICAgLnNlbGVjdChcIipcIilcbiAgICAgIC5zZWxlY3QodGhpcy5kYi5yYXcoYDEgLSAoJHtlbWJlZGRpbmdDb2x1bW59IDw9PiA/Ojp2ZWN0b3IpIEFTIHNpbWlsYXJpdHlgLCBbdmVjdG9yU3RyXSkpXG4gICAgICAud2hlcmVOb3ROdWxsKGVtYmVkZGluZ0NvbHVtbilcbiAgICAgIC5vcmRlckJ5UmF3KGAke2VtYmVkZGluZ0NvbHVtbn0gPD0+ID86OnZlY3RvcmAsIFt2ZWN0b3JTdHJdKVxuICAgICAgLmxpbWl0KGxpbWl0KTtcblxuICAgIGlmICh3aGVyZSkge1xuICAgICAgcXVlcnlCdWlsZGVyID0gcXVlcnlCdWlsZGVyLndoZXJlUmF3KHdoZXJlKTtcbiAgICB9XG5cbiAgICBjb25zdCByb3dzID0gYXdhaXQgcXVlcnlCdWlsZGVyO1xuXG4gICAgcmV0dXJuIHJvd3NcbiAgICAgIC5maWx0ZXIoKHJvdzogeyBzaW1pbGFyaXR5OiBudW1iZXIgfSkgPT4gcm93LnNpbWlsYXJpdHkgPj0gdGhyZXNob2xkKVxuICAgICAgLm1hcCgocm93OiBUICYgeyBzaW1pbGFyaXR5OiBudW1iZXIgfSkgPT4gKHtcbiAgICAgICAgaWQ6IChyb3cgYXMgdW5rbm93biBhcyB7IGlkOiBudW1iZXIgfSkuaWQsXG4gICAgICAgIHNpbWlsYXJpdHk6IHBhcnNlRmxvYXQoU3RyaW5nKHJvdy5zaW1pbGFyaXR5KSksXG4gICAgICAgIGRhdGE6IHJvdyBhcyBULFxuICAgICAgfSkpO1xuICB9XG5cbiAgLyoqXG4gICAqIO2VmOydtOu4jOumrOuTnCDqsoDsg4kgKFZlY3RvciArIEZUUylcbiAgICovXG4gIGFzeW5jIGh5YnJpZFNlYXJjaChcbiAgICBxdWVyeTogc3RyaW5nLFxuICAgIHByb3ZpZGVyOiBFbWJlZGRpbmdQcm92aWRlcixcbiAgICBvcHRpb25zOiBIeWJyaWRTZWFyY2hPcHRpb25zID0ge30sXG4gICk6IFByb21pc2U8SHlicmlkU2VhcmNoUmVzdWx0PFQ+W10+IHtcbiAgICBjb25zdCB7XG4gICAgICBlbWJlZGRpbmdDb2x1bW4gPSBcImNvbnRlbnRfZW1iZWRkaW5nXCIsXG4gICAgICBmdHNDb2x1bW4gPSBcImNvbnRlbnRfdHN2XCIsXG4gICAgICBsaW1pdCA9IHRoaXMuY29uZmlnLnNlYXJjaC5kZWZhdWx0TGltaXQsXG4gICAgICB2ZWN0b3JXZWlnaHQgPSB0aGlzLmNvbmZpZy5zZWFyY2gudmVjdG9yV2VpZ2h0LFxuICAgICAgZnRzV2VpZ2h0ID0gdGhpcy5jb25maWcuc2VhcmNoLmZ0c1dlaWdodCxcbiAgICB9ID0gb3B0aW9ucztcblxuICAgIGNvbnN0IHsgZW1iZWRkaW5nIH0gPSBhd2FpdCB0aGlzLmVtYmVkZGluZy5lbWJlZE9uZShxdWVyeSwgcHJvdmlkZXIsIFwicXVlcnlcIik7XG4gICAgY29uc3QgdmVjdG9yU3RyID0gcGd2ZWN0b3IudG9TcWwoZW1iZWRkaW5nKTtcblxuICAgIC8vIHBndmVjdG9yIOyEuOyFmCDshKTsoJVcbiAgICBpZiAodGhpcy5jb25maWcucGd2ZWN0b3IuaXRlcmF0aXZlU2Nhbikge1xuICAgICAgYXdhaXQgdGhpcy5kYi5yYXcoXCJTRVQgaG5zdy5pdGVyYXRpdmVfc2NhbiA9IHJlbGF4ZWRfb3JkZXJcIik7XG4gICAgfVxuICAgIGF3YWl0IHRoaXMuZGIucmF3KGBTRVQgaG5zdy5lZl9zZWFyY2ggPSAke3RoaXMuY29uZmlnLnBndmVjdG9yLmVmU2VhcmNofWApO1xuXG4gICAgY29uc3Qgc3FsID0gYFxuICAgICAgV0lUSCB2ZWN0b3Jfc2VhcmNoIEFTIChcbiAgICAgICAgU0VMRUNUXG4gICAgICAgICAgaWQsXG4gICAgICAgICAgUk9XX05VTUJFUigpIE9WRVIgKE9SREVSIEJZICR7ZW1iZWRkaW5nQ29sdW1ufSA8PT4gPzo6dmVjdG9yKSBBUyByYW5rXG4gICAgICAgIEZST00gJHt0aGlzLnRhYmxlTmFtZX1cbiAgICAgICAgV0hFUkUgJHtlbWJlZGRpbmdDb2x1bW59IElTIE5PVCBOVUxMXG4gICAgICAgIE9SREVSIEJZICR7ZW1iZWRkaW5nQ29sdW1ufSA8PT4gPzo6dmVjdG9yXG4gICAgICAgIExJTUlUIDUwXG4gICAgICApLFxuICAgICAgZnRzX3NlYXJjaCBBUyAoXG4gICAgICAgIFNFTEVDVFxuICAgICAgICAgIGlkLFxuICAgICAgICAgIFJPV19OVU1CRVIoKSBPVkVSIChPUkRFUiBCWSB0c19yYW5rKCR7ZnRzQ29sdW1ufSwgcXVlcnkpIERFU0MpIEFTIHJhbmtcbiAgICAgICAgRlJPTSAke3RoaXMudGFibGVOYW1lfSwgcGxhaW50b190c3F1ZXJ5KCdzaW1wbGUnLCA/KSBxdWVyeVxuICAgICAgICBXSEVSRSAke2Z0c0NvbHVtbn0gQEAgcXVlcnlcbiAgICAgICAgTElNSVQgNTBcbiAgICAgICksXG4gICAgICBjb21iaW5lZCBBUyAoXG4gICAgICAgIFNFTEVDVFxuICAgICAgICAgIENPQUxFU0NFKHYuaWQsIGYuaWQpIEFTIGlkLFxuICAgICAgICAgIENPQUxFU0NFKDEuMCAvICg2MCArIHYucmFuayksIDApIEFTIHZlY3Rvcl9zY29yZSxcbiAgICAgICAgICBDT0FMRVNDRSgxLjAgLyAoNjAgKyBmLnJhbmspLCAwKSBBUyBmdHNfc2NvcmVcbiAgICAgICAgRlJPTSB2ZWN0b3Jfc2VhcmNoIHZcbiAgICAgICAgRlVMTCBPVVRFUiBKT0lOIGZ0c19zZWFyY2ggZiBPTiB2LmlkID0gZi5pZFxuICAgICAgKVxuICAgICAgU0VMRUNUXG4gICAgICAgIHQuKixcbiAgICAgICAgYy52ZWN0b3Jfc2NvcmUsXG4gICAgICAgIGMuZnRzX3Njb3JlLFxuICAgICAgICAoYy52ZWN0b3Jfc2NvcmUgKiA/ICsgYy5mdHNfc2NvcmUgKiA/KSBBUyBzaW1pbGFyaXR5XG4gICAgICBGUk9NIGNvbWJpbmVkIGNcbiAgICAgIEpPSU4gJHt0aGlzLnRhYmxlTmFtZX0gdCBPTiBjLmlkID0gdC5pZFxuICAgICAgT1JERVIgQlkgc2ltaWxhcml0eSBERVNDXG4gICAgICBMSU1JVCA/XG4gICAgYDtcblxuICAgIGNvbnN0IHsgcm93cyB9ID0gYXdhaXQgdGhpcy5kYi5yYXcoc3FsLCBbXG4gICAgICB2ZWN0b3JTdHIsXG4gICAgICB2ZWN0b3JTdHIsXG4gICAgICBxdWVyeSxcbiAgICAgIHZlY3RvcldlaWdodCxcbiAgICAgIGZ0c1dlaWdodCxcbiAgICAgIGxpbWl0LFxuICAgIF0pO1xuXG4gICAgcmV0dXJuIHJvd3MubWFwKFxuICAgICAgKFxuICAgICAgICByb3c6IFQgJiB7XG4gICAgICAgICAgc2ltaWxhcml0eTogbnVtYmVyO1xuICAgICAgICAgIHZlY3Rvcl9zY29yZTogbnVtYmVyO1xuICAgICAgICAgIGZ0c19zY29yZTogbnVtYmVyO1xuICAgICAgICB9LFxuICAgICAgKSA9PiAoe1xuICAgICAgICBpZDogKHJvdyBhcyB1bmtub3duIGFzIHsgaWQ6IG51bWJlciB9KS5pZCxcbiAgICAgICAgc2ltaWxhcml0eTogcGFyc2VGbG9hdChTdHJpbmcocm93LnNpbWlsYXJpdHkpKSxcbiAgICAgICAgdmVjdG9yU2NvcmU6IHBhcnNlRmxvYXQoU3RyaW5nKHJvdy52ZWN0b3Jfc2NvcmUpKSxcbiAgICAgICAgZnRzU2NvcmU6IHBhcnNlRmxvYXQoU3RyaW5nKHJvdy5mdHNfc2NvcmUpKSxcbiAgICAgICAgZGF0YTogcm93IGFzIFQsXG4gICAgICB9KSxcbiAgICApO1xuICB9XG5cbiAgLyoqXG4gICAqIOyehOuyoOuUqSDtmITtmakg7KGw7ZqMXG4gICAqL1xuICBhc3luYyBnZXRFbWJlZGRpbmdTdGF0dXMoZW1iZWRkaW5nQ29sdW1uOiBzdHJpbmcgPSBcImNvbnRlbnRfZW1iZWRkaW5nXCIpOiBQcm9taXNlPHtcbiAgICB0b3RhbDogbnVtYmVyO1xuICAgIHdpdGhFbWJlZGRpbmc6IG51bWJlcjtcbiAgICB3aXRob3V0RW1iZWRkaW5nOiBudW1iZXI7XG4gIH0+IHtcbiAgICBjb25zdCByZXN1bHQgPSBhd2FpdCB0aGlzLmRiKHRoaXMudGFibGVOYW1lKVxuICAgICAgLmNvdW50KFwiKiBhcyB0b3RhbFwiKVxuICAgICAgLmNvdW50KGAke2VtYmVkZGluZ0NvbHVtbn0gYXMgd2l0aF9lbWJlZGRpbmdgKVxuICAgICAgLmZpcnN0KCk7XG5cbiAgICBjb25zdCB0b3RhbCA9IHBhcnNlSW50KFN0cmluZyhyZXN1bHQ/LnRvdGFsID8/IDApLCAxMCk7XG4gICAgY29uc3Qgd2l0aEVtYmVkZGluZyA9IHBhcnNlSW50KFN0cmluZyhyZXN1bHQ/LndpdGhfZW1iZWRkaW5nID8/IDApLCAxMCk7XG5cbiAgICByZXR1cm4ge1xuICAgICAgdG90YWwsXG4gICAgICB3aXRoRW1iZWRkaW5nLFxuICAgICAgd2l0aG91dEVtYmVkZGluZzogdG90YWwgLSB3aXRoRW1iZWRkaW5nLFxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICog7J6E67Kg65Sp7J20IOyXhuuKlCDtla3rqqkgSUQg7KGw7ZqMXG4gICAqL1xuICBhc3luYyBnZXRJdGVtc1dpdGhvdXRFbWJlZGRpbmcoXG4gICAgZW1iZWRkaW5nQ29sdW1uOiBzdHJpbmcgPSBcImNvbnRlbnRfZW1iZWRkaW5nXCIsXG4gICAgbGltaXQ6IG51bWJlciA9IDEwMCxcbiAgKTogUHJvbWlzZTxudW1iZXJbXT4ge1xuICAgIGNvbnN0IHJvd3MgPSBhd2FpdCB0aGlzLmRiKHRoaXMudGFibGVOYW1lKVxuICAgICAgLnNlbGVjdChcImlkXCIpXG4gICAgICAud2hlcmVOdWxsKGVtYmVkZGluZ0NvbHVtbilcbiAgICAgIC5vcmRlckJ5KFwiaWRcIilcbiAgICAgIC5saW1pdChsaW1pdCk7XG5cbiAgICByZXR1cm4gcm93cy5tYXAoKHJvdzogeyBpZDogbnVtYmVyIH0pID0+IHJvdy5pZCk7XG4gIH1cblxuICAvKipcbiAgICogRW1iZWRkaW5nIOyduOyKpO2EtOyKpCDrsJjtmZggKOqzoOq4iSDsgqzsmqkpXG4gICAqL1xuICBnZXRFbWJlZGRpbmcoKTogRW1iZWRkaW5nIHtcbiAgICByZXR1cm4gdGhpcy5lbWJlZGRpbmc7XG4gIH1cbn1cbiJdLCJuYW1lcyI6WyJwZ3ZlY3RvciIsIkRFRkFVTFRfVkVDVE9SX0NPTkZJRyIsIkVtYmVkZGluZyIsIlZlY3RvclNlYXJjaCIsImRiIiwiY29uZmlnIiwiZW1iZWRkaW5nIiwidGFibGVOYW1lIiwidm95YWdlIiwib3BlbmFpIiwiY2h1bmtpbmciLCJzZWFyY2giLCJzYXZlRW1iZWRkaW5nIiwiaWQiLCJ0ZXh0IiwicHJvdmlkZXIiLCJlbWJlZGRpbmdDb2x1bW4iLCJlbWJlZE9uZSIsIndoZXJlIiwidXBkYXRlIiwidG9TcWwiLCJzYXZlRW1iZWRkaW5nc0JhdGNoIiwiaXRlbXMiLCJvblByb2dyZXNzIiwidGV4dHMiLCJtYXAiLCJpdGVtIiwiZW1iZWRkaW5ncyIsImVtYmVkQmF0Y2giLCJ0cmFuc2FjdGlvbiIsInRyeCIsImkiLCJsZW5ndGgiLCJxdWVyeSIsIm9wdGlvbnMiLCJsaW1pdCIsImRlZmF1bHRMaW1pdCIsInRocmVzaG9sZCIsInNpbWlsYXJpdHlUaHJlc2hvbGQiLCJpdGVyYXRpdmVTY2FuIiwicmF3IiwiZWZTZWFyY2giLCJ2ZWN0b3JTdHIiLCJxdWVyeUJ1aWxkZXIiLCJzZWxlY3QiLCJ3aGVyZU5vdE51bGwiLCJvcmRlckJ5UmF3Iiwid2hlcmVSYXciLCJyb3dzIiwiZmlsdGVyIiwicm93Iiwic2ltaWxhcml0eSIsInBhcnNlRmxvYXQiLCJTdHJpbmciLCJkYXRhIiwiaHlicmlkU2VhcmNoIiwiZnRzQ29sdW1uIiwidmVjdG9yV2VpZ2h0IiwiZnRzV2VpZ2h0Iiwic3FsIiwidmVjdG9yU2NvcmUiLCJ2ZWN0b3Jfc2NvcmUiLCJmdHNTY29yZSIsImZ0c19zY29yZSIsImdldEVtYmVkZGluZ1N0YXR1cyIsInJlc3VsdCIsImNvdW50IiwiZmlyc3QiLCJ0b3RhbCIsInBhcnNlSW50Iiwid2l0aEVtYmVkZGluZyIsIndpdGhfZW1iZWRkaW5nIiwid2l0aG91dEVtYmVkZGluZyIsImdldEl0ZW1zV2l0aG91dEVtYmVkZGluZyIsIndoZXJlTnVsbCIsIm9yZGVyQnkiLCJnZXRFbWJlZGRpbmciXSwibWFwcGluZ3MiOiJBQUNBLE9BQU9BLGNBQWMsZ0JBQWdCO0FBQ3JDLFNBQVNDLHFCQUFxQixRQUFRLGNBQVc7QUFDakQsU0FBU0MsU0FBUyxRQUFRLGlCQUFjO0FBWXhDOzs7Q0FHQyxHQUNELE9BQU8sTUFBTUM7SUFDSEMsR0FBUztJQUNUQyxPQUFxQjtJQUNyQkMsVUFBcUI7SUFDckJDLFVBQWtCO0lBRTFCLFlBQVlILEVBQVEsRUFBRUcsU0FB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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonamu",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "description": "Sonamu — TypeScript Fullstack API Framework",
   "keywords": [
     "typescript",
@@ -70,15 +70,16 @@
     "minimatch": "^10.0.3",
     "node-sql-parser": "^5.2.0",
     "pg": "^8.16.3",
+    "pgvector": "^0.2.1",
     "prompts": "^2.4.2",
     "qs": "^6.11.0",
     "radashi": "^12.2.0",
     "tsicli": "^1.0.5",
     "vitest": "^4.0.10",
     "zod": "^4.1.12",
+    "@sonamu-kit/hmr-runner": "^0.1.1",
     "@sonamu-kit/ts-loader": "^2.1.3",
-    "@sonamu-kit/hmr-hook": "^0.4.1",
-    "@sonamu-kit/hmr-runner": "^0.1.1"
+    "@sonamu-kit/hmr-hook": "^0.4.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.7",
@@ -94,15 +95,15 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
+    "@ai-sdk/openai": "^3.0.0-beta.75",
+    "@ai-sdk/provider": "^3.0.0-beta.22",
+    "@ai-sdk/provider-utils": "^4.0.0-beta.40",
     "@swc/cli": "^0.7.8",
     "@swc/core": "^1.13.5",
+    "ai": "^6.0.0-beta.138",
     "fastify": "^4.23.2",
     "knex": "^3.1.0",
-    "typescript": "^5.9.3",
-    "@ai-sdk/openai": "^3.0.0-beta.75",
-    "@ai-sdk/provider": "^3.0.0-beta.22",
-    "@ai-sdk/provider-utils": "^4.0.0-beta.40",
-    "ai": "^6.0.0-beta.138"
+    "typescript": "^5.9.3"
   },
   "peerDependenciesMeta": {
     "@ai-sdk/openai": {

package/src/api/config.ts

@@ -97,10 +97,6 @@ export type SonamuConfigExport =
   | (() => SonamuConfig)
   | (() => Promise<SonamuConfig>);
 
-export function defineConfig(config: SonamuConfig): Promise<SonamuConfig>;
-export function defineConfig(config: Promise<SonamuConfig>): Promise<SonamuConfig>;
-export function defineConfig(config: () => SonamuConfig): Promise<SonamuConfig>;
-export function defineConfig(config: () => Promise<SonamuConfig>): Promise<SonamuConfig>;
 export function defineConfig(config: SonamuConfigExport): Promise<SonamuConfig> {
   if (typeof config === "function") {
     return Promise.resolve(config());

package/src/api/sonamu.ts

@@ -17,6 +17,8 @@ import type { ExtendedApi } from "./decorators";
 
 export type SonamuSecrets = {
   anthropic_api_key?: string;
+  voyage_api_key?: string;
+  openai_api_key?: string;
 };
 class SonamuClass {
   public isInitialized: boolean = false;
@@ -155,10 +157,19 @@ class SonamuClass {
     // sonamu.config.ts 기본값 설정
     this.config.database.database = this.config.database.database ?? "postgresql";
 
+    // API 키 환경변수 로드
+    const secrets: SonamuSecrets = {};
     if (process.env.ANTHROPIC_API_KEY) {
-      this.secrets = {
-        anthropic_api_key: process.env.ANTHROPIC_API_KEY,
-      };
+      secrets.anthropic_api_key = process.env.ANTHROPIC_API_KEY;
+    }
+    if (process.env.VOYAGE_API_KEY) {
+      secrets.voyage_api_key = process.env.VOYAGE_API_KEY;
+    }
+    if (process.env.OPENAI_API_KEY) {
+      secrets.openai_api_key = process.env.OPENAI_API_KEY;
+    }
+    if (Object.keys(secrets).length > 0) {
+      this.secrets = secrets;
     }
 
     // DB 로드
@@ -169,16 +180,18 @@ class SonamuClass {
       console.log(chalk.green("DB Config Loaded!"));
     }
 
-    // 테스팅인 경우 엔티티 로드 & 싱크 없이 중단
+    // Entity 로드
+    // 테스트에서도 Entity 정보는 필요합니다.
+    // upsert가 제대로 작동하려면 entity의 unique index 정보가 필요하기 때문입니다.
+    const { EntityManager } = await import("../entity/entity-manager");
+    await EntityManager.autoload(doSilent);
+
+    // 테스팅인 경우 싱크 없이 중단
     if (forTesting) {
       this.isInitialized = true;
       return;
     }
 
-    // Entity 로드
-    const { EntityManager } = await import("../entity/entity-manager");
-    await EntityManager.autoload(doSilent);
-
     // Syncer
     const { Syncer } = await import("../syncer/syncer");
     this.syncer = new Syncer();
@@ -387,30 +400,6 @@ class SonamuClass {
       // Content-Type
       reply.type(api.options.contentType ?? "application/json");
 
-      // 캐시
-      const { cacheKey, cacheTtl, cachedData } = await (async () => {
-        if (config.cache) {
-          try {
-            const cacheKeyRes = config.cache.resolveKey(api.path, reqBody);
-            if (cacheKeyRes.cache === false) {
-              return { cacheKey: null, cachedData: null };
-            }
-
-            const cacheKey = cacheKeyRes.key;
-            const cacheTtl = cacheKeyRes.ttl;
-            const cachedData = await config.cache.get(cacheKey);
-            return { cacheKey, cacheTtl, cachedData };
-          } catch (e) {
-            console.error(e);
-          }
-          return { cacheKey: null, cachedData: null };
-        }
-        return { cacheKey: null, cachedData: null };
-      })();
-      if (cachedData !== null) {
-        return cachedData;
-      }
-
       // createSSEFactory 함수에 미리 request의 socket과 reply를 바인딩.
       const { createSSEFactory } = await import("../stream/sse");
       const createSSE = (<T extends ZodObject>(
@@ -458,10 +447,6 @@ class SonamuClass {
         );
         reply.type(api.options.contentType ?? "application/json");
 
-        // 캐시 키 있는 경우 갱신 후 저장
-        if (config.cache && cacheKey) {
-          await config.cache.put(cacheKey, result, cacheTtl);
-        }
         return result;
       });
     };

package/src/bin/cli.ts

@@ -22,7 +22,7 @@ import { BUILD_DIR, SWC_BUILD_COMMAND, TSC_TYPE_CHECK_COMMAND } from "./build-co
 let migrator: Migrator;
 
 async function bootstrap() {
-  const notToInit = ["dev", "build", "start"].includes(process.argv[2] ?? "");
+  const notToInit = ["dev", "build", "start", "ui"].includes(process.argv[2] ?? "");
   if (!notToInit) {
     await Sonamu.init(false, false);
   }
@@ -451,9 +451,11 @@ async function scaffold_model_test(entityId: string) {
 
 async function ui() {
   try {
+    const apiRootPath = findApiRootPath();
+
     // 사용자 프로젝트의 패키지들 중에서 @sonamu-kit/ui를 찾습니다.
     // 이를 위해서 createRequire를 사용하여 프로젝트 경로 기준으로 resolve합니다.
-    const projectRequire = createRequire(path.join(Sonamu.apiRootPath, "package.json"));
+    const projectRequire = createRequire(path.join(apiRootPath, "package.json"));
     const uiPackagePath = projectRequire.resolve("@sonamu-kit/ui"); // 없으면 여기서 터져요(MODULE_NOT_FOUND)
     const uiNodePath = path.join(path.dirname(uiPackagePath), "run-ui.js");
 
@@ -481,9 +483,7 @@ async function ui() {
         env: {
           ...process.env,
           HOT: "yes",
-          PROJECT_NAME: Sonamu.config.projectName ?? path.basename(Sonamu.apiRootPath),
-          API_ROOT_PATH: Sonamu.apiRootPath,
-          UI_PORT: (Sonamu.config.ui?.port ?? 57000).toString(),
+          API_ROOT_PATH: apiRootPath, // UI는 얘만 알면 돼요! 나머지는 얘가 떠서 알아서 할 것임 ㅎ
         },
       },
     );

package/src/database/base-model.ts

@@ -306,23 +306,32 @@ export class BaseModelClass<
    * Flat 레코드를 중첩 객체로 변환
    *
    * - `user__name` → `{ user: { name } }`
-   * - nullable relation의 경우 모든 필드가 null이면 객체 자체를 null로
+   * - nullable relation의 경우 id 필드가 null이면 객체 자체를 null로
    */
   hydrate<T extends UnknownDBRecord>(rows: T[]): T[] {
     return rows.map((row: T) => {
-      // nullable relation 처리: 관련 필드가 전부 null인 경우 방지
+      // nullable relation 처리: 그룹의 id 필드가 null이면 객체 전체를 null로
       const nestedKeys = Object.keys(row).filter((key) => key.includes("__"));
       const groups = Object.groupBy(nestedKeys, (key) => key.split("__")[0]);
+
+      // id 필드가 null인 그룹 찾기 (예: parent__id가 null이면 parent 그룹 전체가 null)
       const nullKeys = Object.entries(groups)
-        .filter(
-          ([_, data]) =>
-            data &&
-            data.length > 1 &&
-            data.every(
-              (field) =>
-                row[field] === null || (Array.isArray(row[field]) && row[field].length === 0),
-            ),
-        )
+        .filter(([groupKey, fields]) => {
+          if (!fields || fields.length === 0) return false;
+
+          // 그룹의 id 필드 찾기 (예: "parent__id")
+          const idField = `${groupKey}__id`;
+          if (idField in row) {
+            // id 필드가 null이면 객체 전체가 null
+            return row[idField] === null;
+          }
+
+          // id 필드가 없으면 기존 로직: 모든 필드가 null인지 확인
+          return fields.every(
+            (field) =>
+              row[field] === null || (Array.isArray(row[field]) && row[field].length === 0),
+          );
+        })
         .map(([key]) => key);
 
       const hydrated = Object.keys(row).reduce((r, field) => {

package/src/database/code-generator.ts

@@ -38,8 +38,12 @@ export class CodeGenerator {
       drop: [] as MigrationIndex[],
     };
     const extraIndexes = {
-      db: diff(dbIndexes, entityIndexes, (col) => [col.type, col.columns.join("-")].join("//")),
-      entity: diff(entityIndexes, dbIndexes, (col) => [col.type, col.columns.join("-")].join("//")),
+      db: diff(dbIndexes, entityIndexes, (col) =>
+        [col.type, col.columns.map((c) => c.name).join("-")].join("//"),
+      ),
+      entity: diff(entityIndexes, dbIndexes, (col) =>
+        [col.type, col.columns.map((c) => c.name).join("-")].join("//"),
+      ),
     };
     if (extraIndexes.entity.length > 0) {
       indexesTo.add = indexesTo.add.concat(extraIndexes.entity);

package/src/database/db.ts

@@ -1,6 +1,7 @@
 import { AsyncLocalStorage } from "async_hooks";
 import knex, { type Knex } from "knex";
 import { assign } from "radashi";
+
 import { Sonamu } from "../api";
 import type { DatabaseConfig, SonamuConfig } from "../api/config";
 import { TransactionContext } from "./transaction-context";

package/src/database/puri-wrapper.ts

@@ -5,8 +5,8 @@ import type { Knex } from "knex";
 import type { DatabaseSchemaExtend } from "../types/types";
 import type { DBPreset } from "./db";
 import { Puri } from "./puri";
-import type { ColumnKeys, OmitMetadataColumns, PuriTable } from "./puri.types";
-import type { UBRef, UpsertBuilder } from "./upsert-builder";
+import type { ColumnKeys, OmitInternalTypeKeys, PuriTable } from "./puri.types";
+import type { InsertOnlyOptions, UBRef, UpsertBuilder, UpsertOptions } from "./upsert-builder";
 
 type TableName<TSchema extends DatabaseSchemaExtend> = Extract<keyof TSchema, string>;
 
@@ -32,7 +32,7 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
   ): Puri<
     TSchema,
     Record<TTable, PuriTable<TSchema[TTable]>>,
-    OmitMetadataColumns<PuriTable<TSchema[TTable]>>
+    OmitInternalTypeKeys<PuriTable<TSchema[TTable]>>
   >;
   // 테이블명 + Alias로 시작
   from<TTable extends keyof TSchema, TAlias extends string>(
@@ -42,7 +42,7 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
   ): Puri<
     TSchema,
     Record<TAlias, PuriTable<TSchema[TTable]>>,
-    OmitMetadataColumns<PuriTable<TSchema[TTable]>>
+    OmitInternalTypeKeys<PuriTable<TSchema[TTable]>>
   >;
   // 서브쿼리로 시작
   from<TAlias extends string, TSubResult>(
@@ -52,7 +52,7 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
   ): Puri<
     TSchema,
     Record<TAlias, PuriTable<TSubResult>>,
-    OmitMetadataColumns<PuriTable<TSubResult>>
+    OmitInternalTypeKeys<PuriTable<TSubResult>>
   >;
   from(spec: any): any {
     return new Puri(this.knex, spec);
@@ -64,7 +64,7 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
   ): Puri<
     TSchema,
     Record<TTable, PuriTable<TSchema[TTable]>>,
-    OmitMetadataColumns<PuriTable<TSchema[TTable]>>
+    OmitInternalTypeKeys<PuriTable<TSchema[TTable]>>
   >;
   // 테이블명 + Alias로 시작
   table<TTable extends keyof TSchema, TAlias extends string>(
@@ -74,7 +74,7 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
   ): Puri<
     TSchema,
     Record<TAlias, PuriTable<TSchema[TTable]>>,
-    OmitMetadataColumns<PuriTable<TSchema[TTable]>>
+    OmitInternalTypeKeys<PuriTable<TSchema[TTable]>>
   >;
   // 서브쿼리로 시작
   table<TAlias extends string, TSubResult>(
@@ -84,7 +84,7 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
   ): Puri<
     TSchema,
     Record<TAlias, PuriTable<TSubResult>>,
-    OmitMetadataColumns<PuriTable<TSubResult>>
+    OmitInternalTypeKeys<PuriTable<TSubResult>>
   >;
   table(spec: any): any {
     return new Puri(this.knex, spec);
@@ -147,20 +147,26 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
     return this.upsertBuilder.register(tableName, row);
   }
 
-  ubUpsert(tableName: TableName<TSchema>, chunkSize?: number): Promise<number[]> {
-    return this.upsertBuilder.upsert(this.knex, tableName, { chunkSize });
+  ubUpsert<TTable extends TableName<TSchema> & keyof DatabaseSchemaExtend>(
+    tableName: TTable,
+    options?: UpsertOptions<TTable>,
+  ): Promise<number[]> {
+    return this.upsertBuilder.upsert(this.knex, tableName, options);
   }
 
-  ubInsertOnly(tableName: TableName<TSchema>, chunkSize?: number): Promise<number[]> {
-    return this.upsertBuilder.insertOnly(this.knex, tableName, chunkSize);
+  ubInsertOnly<TTable extends TableName<TSchema> & keyof DatabaseSchemaExtend>(
+    tableName: TTable,
+    options?: InsertOnlyOptions,
+  ): Promise<number[]> {
+    return this.upsertBuilder.insertOnly(this.knex, tableName, options);
   }
 
-  ubUpsertOrInsert(
-    tableName: TableName<TSchema>,
+  ubUpsertOrInsert<TTable extends TableName<TSchema> & keyof DatabaseSchemaExtend>(
+    tableName: TTable,
     mode: "upsert" | "insert",
-    chunkSize?: number,
+    options?: UpsertOptions<TTable>,
   ): Promise<number[]> {
-    return this.upsertBuilder.upsertOrInsert(this.knex, tableName, mode, { chunkSize });
+    return this.upsertBuilder.upsertOrInsert(this.knex, tableName, mode, options);
   }
 
   ubUpdateBatch(