sonamu 0.10.12 → 0.10.13

package/src/utils/utils.ts

@@ -4,9 +4,11 @@ import path from "path";
 import { type FastifyRequest } from "fastify";
 
 import { type AbsolutePath } from "./path-utils";
+import { isObjectValue } from "./runtime-value";
 
 export function findAppRootPath(): AbsolutePath {
   const apiRootPath = findApiRootPath();
+  // SAFETY: 선행 분기와 함수 계약이 이 타입을 보장합니다.
   return path.dirname(apiRootPath) as AbsolutePath;
 }
 
@@ -15,15 +17,18 @@ export function findApiRootPath(): AbsolutePath {
   // 하지만 workspace 쓰면 process.cwd() 하면 되는데... 이건 나중에 협의 후 수정하는걸로
   const workspacePath = process.env.PNPM_SCRIPT_SRC_DIR ?? process.env.INIT_CWD;
   if (nonNullable(workspacePath)) {
+    // SAFETY: 선행 분기와 함수 계약이 이 타입을 보장합니다.
     return workspacePath as AbsolutePath;
   }
 
   if (nonNullable(process.env.PNPM_PACKAGE_NAME)) {
+    // SAFETY: 선행 분기와 함수 계약이 이 타입을 보장합니다.
     return process.cwd().split(path.sep).join(path.sep) as AbsolutePath;
   }
 
   const cwdPackagePath = path.join(process.cwd(), "package.json");
   if (fs.existsSync(cwdPackagePath)) {
+    // SAFETY: 선행 분기와 함수 계약이 이 타입을 보장합니다.
     return process.cwd().split(path.sep).join(path.sep) as AbsolutePath;
   }
 
@@ -35,6 +40,7 @@ export function findApiRootPath(): AbsolutePath {
 
   do {
     if (fs.existsSync(path.join(dir, "/package.json"))) {
+      // SAFETY: 선행 분기와 함수 계약이 이 타입을 보장합니다.
       return dir.split(path.sep).join(path.sep) as AbsolutePath;
     }
     dir = dir.split(path.sep).slice(0, -1).join(path.sep);
@@ -91,26 +97,18 @@ export function differenceWith<T>(
   return arr1.filter((itemA) => !arr2.some((itemB) => comparator(itemA, itemB)));
 }
 
-// biome-ignore lint/suspicious/noExplicitAny: dynamic property access
-export function merge<T extends Record<string, any>>(defaultObj: T, userObj: T): T {
-  // 원본 보존을 위해 defaultObj 복사
+export function merge<T extends object>(defaultObj: T, userObj: T): T {
+  // 원본을 보존하면서 사용자 설정의 own enumerable 속성만 병합합니다.
   const result = { ...defaultObj };
-
-  // userObj의 각 속성을 순회
-  for (const key in userObj) {
-    // userObj의 own property만 처리 (프로토타입 체인 제외)
-    if (Object.hasOwn(userObj, key)) {
-      const userValue = userObj[key];
-      const defaultValue = result[key];
-
-      // 두 값이 모두 객체이고, 배열이 아닌 경우 재귀적으로 병합
-      if (isPlainObject(userValue) && isPlainObject(defaultValue)) {
-        result[key] = merge(defaultValue, userValue);
-      } else {
-        // 그 외의 경우 userObj의 값으로 덮어쓰기
-        result[key] = userValue;
-      }
-    }
+  const defaultEntries = new Map(Object.entries(defaultObj));
+
+  for (const [key, userValue] of Object.entries(userObj)) {
+    const defaultValue = defaultEntries.get(key);
+    const mergedValue =
+      isPlainObject(userValue) && isPlainObject(defaultValue)
+        ? merge(defaultValue, userValue)
+        : userValue;
+    Object.assign(result, { [key]: mergedValue });
   }
 
   return result;
@@ -118,10 +116,10 @@ export function merge<T extends Record<string, any>>(defaultObj: T, userObj: T):
 
 // plain object 판별 헬퍼 함수
 // (배열, null, Date 등을 제외한 순수 객체만 true)
-export function isPlainObject(value: unknown): value is Record<string, unknown> {
+export function isPlainObject<Value>(value: Value): value is Value & object {
   return (
     value !== null &&
-    typeof value === "object" &&
+    isObjectValue(value) &&
     !Array.isArray(value) &&
     Object.prototype.toString.call(value) === "[object Object]"
   );

package/src/utils/zod-error.ts

@@ -1,5 +1,7 @@
 import { type z } from "zod";
 
+import { isNumberValue, isSymbolValue } from "./runtime-value";
+
 type ValidationError = {
   path: string[];
   message: string;
@@ -8,11 +10,11 @@ type ValidationError = {
 export function humanizeZodError(error: z.ZodError): ValidationError[] {
   return error.issues.map(({ path: originPath, message }) => {
     const path = originPath.map((item) => {
-      if (typeof item === "symbol") {
+      if (isSymbolValue(item)) {
         return item.description ?? item.toString();
       }
 
-      if (typeof item === "number") {
+      if (isNumberValue(item)) {
         return `[${item}]`;
       }
 

package/src/vector/chunking.ts

@@ -1,6 +1,11 @@
 import { DEFAULT_VECTOR_CONFIG } from "./config";
 import { type Chunk, type ChunkingConfig } from "./types";
 
+interface ExtractedChunk {
+  chunk: string;
+  length: number;
+}
+
 /**
  * 텍스트 청킹
  * - 현재 가이드에서는 400토큰 이하만 저장하므로 기본적으로 사용하지 않음
@@ -69,7 +74,7 @@ export class Chunking {
     return Math.ceil(text.length / effectiveChunkSize);
   }
 
-  private extractChunk(text: string): { chunk: string; length: number } {
+  private extractChunk(text: string): ExtractedChunk {
     if (text.length <= this.config.chunkSize) {
       return { chunk: text, length: text.length };
     }

package/src/vector/embedding.ts

@@ -139,7 +139,8 @@ class EmbeddingClass {
     const model = openai.embeddingModel(openaiConfig.model);
 
     const { embeddings, usage } = await embedMany({
-      model: model as EmbeddingModel,
+      model:
+        /* SAFETY: 호출 경계의 선행 검증과 소유 타입 계약이 이 값의 타입을 보장한다. */ model as EmbeddingModel,
       values: texts,
     });
 

package/src/vector/types.ts

@@ -2,6 +2,8 @@
  * pgvector 통합을 위한 타입 정의
  */
 
+import { type JsonValue } from "../types/types";
+
 /** 임베딩 제공자 */
 export type EmbeddingProvider = "voyage" | "openai";
 
@@ -24,14 +26,14 @@ export interface Chunk {
 }
 
 /** 벡터 검색 결과 */
-export interface VectorSearchResult<T = Record<string, unknown>> {
+export interface VectorSearchResult<T = Record<string, JsonValue>> {
   id: number | string;
   similarity: number;
   data: T;
 }
 
 /** 하이브리드 검색 결과 (Vector + FTS) */
-export interface HybridSearchResult<T = Record<string, unknown>> extends VectorSearchResult<T> {
+export interface HybridSearchResult<T = Record<string, JsonValue>> extends VectorSearchResult<T> {
   vectorScore?: number;
   ftsScore?: number;
 }

package/tsdown.api.config.ts

@@ -6,9 +6,12 @@ import { defineConfig } from "tsdown";
 const srcRoot = path.resolve(process.cwd(), "src");
 const ignoredSuffixes = [".test.ts", ".test-hold.ts", ".ignore.ts", ".d.ts"];
 const ignoredDirectories = new Set(["__mocks__", "_templates", "wasted_src"]);
+interface BuildEntries {
+  [entryName: string]: string;
+}
 
-function collectEntries(directory: string): Record<string, string> {
-  const entries: Record<string, string> = {};
+function collectEntries(directory: string): BuildEntries {
+  const entries: BuildEntries = {};
 
   for (const entry of readdirSync(directory)) {
     if (ignoredDirectories.has(entry)) {