npm - sonamu - Versions diffs - 0.8.24 → 0.8.26 - Mend

sonamu 0.8.24 → 0.8.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (88) hide show

package/dist/api/__tests__/config.test.js +189 -0
package/dist/api/config.d.ts.map +1 -1
package/dist/api/config.js +7 -2
package/dist/api/sonamu.d.ts.map +1 -1
package/dist/api/sonamu.js +14 -10
package/dist/auth/index.d.ts +1 -0
package/dist/auth/index.d.ts.map +1 -1
package/dist/auth/index.js +2 -1
package/dist/auth/knex-adapter.d.ts +23 -0
package/dist/auth/knex-adapter.d.ts.map +1 -0
package/dist/auth/knex-adapter.js +163 -0
package/dist/auth/plugins/wrappers/admin.d.ts +2 -2
package/dist/bin/__tests__/ts-loader-register.test.js +45 -0
package/dist/bin/cli.js +47 -9
package/dist/bin/ts-loader-register.js +3 -29
package/dist/bin/ts-loader-registration.d.ts +2 -0
package/dist/bin/ts-loader-registration.d.ts.map +1 -0
package/dist/bin/ts-loader-registration.js +42 -0
package/dist/cone/cone-generator.js +3 -3
package/dist/database/puri-subset.test-d.js +9 -1
package/dist/database/puri-subset.types.d.ts +1 -1
package/dist/database/puri-subset.types.d.ts.map +1 -1
package/dist/database/puri-subset.types.js +1 -1
package/dist/testing/fixture-generator.js +5 -5
package/dist/ui/ai-client.js +2 -2
package/dist/ui/api.d.ts.map +1 -1
package/dist/ui/api.js +14 -14
package/dist/ui/cdd-service.d.ts +15 -18
package/dist/ui/cdd-service.d.ts.map +1 -1
package/dist/ui/cdd-service.js +246 -222
package/dist/ui/cdd-types.d.ts +41 -68
package/dist/ui/cdd-types.d.ts.map +1 -1
package/dist/ui/cdd-types.js +2 -2
package/dist/ui-web/assets/index-CKo0Z2Iu.css +1 -0
package/dist/ui-web/assets/{index-CxiydzeC.js → index-DK-2aacv.js} +83 -83
package/dist/ui-web/index.html +2 -2
package/package.json +6 -2
package/src/api/__tests__/config.test.ts +225 -0
package/src/api/config.ts +10 -4
package/src/api/sonamu.ts +16 -13
package/src/auth/index.ts +1 -0
package/src/auth/knex-adapter.ts +208 -0
package/src/bin/__tests__/ts-loader-register.test.ts +62 -0
package/src/bin/cli.ts +52 -9
package/src/bin/ts-loader-register.ts +2 -32
package/src/bin/ts-loader-registration.ts +55 -0
package/src/cone/cone-generator.ts +2 -2
package/src/database/puri-subset.test-d.ts +102 -0
package/src/database/puri-subset.types.ts +1 -1
package/src/skills/commands/sonamu-skills.md +20 -0
package/src/skills/sonamu/SKILL.md +179 -137
package/src/skills/sonamu/ai-agents.md +69 -69
package/src/skills/sonamu/api.md +147 -147
package/src/skills/sonamu/auth-migration.md +220 -220
package/src/skills/sonamu/auth-plugins.md +83 -83
package/src/skills/sonamu/auth.md +106 -106
package/src/skills/sonamu/cdd.md +65 -200
package/src/skills/sonamu/cone.md +138 -138
package/src/skills/sonamu/config.md +191 -191
package/src/skills/sonamu/create-sonamu.md +66 -66
package/src/skills/sonamu/database.md +158 -158
package/src/skills/sonamu/entity-basic.md +292 -293
package/src/skills/sonamu/entity-relations.md +246 -246
package/src/skills/sonamu/entity-validation-checklist.md +124 -124
package/src/skills/sonamu/fixture-cli.md +231 -231
package/src/skills/sonamu/framework-change.md +37 -37
package/src/skills/sonamu/frontend.md +223 -223
package/src/skills/sonamu/i18n.md +82 -82
package/src/skills/sonamu/migration.md +77 -77
package/src/skills/sonamu/model.md +222 -222
package/src/skills/sonamu/naite.md +86 -86
package/src/skills/sonamu/project-init.md +228 -228
package/src/skills/sonamu/puri.md +122 -122
package/src/skills/sonamu/scaffolding.md +154 -154
package/src/skills/sonamu/skill-contribution.md +124 -124
package/src/skills/sonamu/subset.md +46 -46
package/src/skills/sonamu/tasks.md +82 -82
package/src/skills/sonamu/testing-devrunner.md +147 -147
package/src/skills/sonamu/testing.md +673 -673
package/src/skills/sonamu/upsert.md +79 -79
package/src/skills/sonamu/vector.md +67 -67
package/src/testing/fixture-generator.ts +4 -4
package/src/ui/ai-client.ts +1 -1
package/src/ui/api.ts +18 -17
package/src/ui/cdd-service.ts +264 -254
package/src/ui/cdd-types.ts +40 -75
package/dist/ui-web/assets/index-BrQKU3j9.css +0 -1
package/src/skills/sonamu/workflow.md +0 -317

package/dist/ui-web/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/svg+xml" href="/sonamu-ui/setting.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>{{projectName}}: Sonamu UI</title>
-    <script type="module" crossorigin src="/sonamu-ui/assets/index-CxiydzeC.js"></script>
-    <link rel="stylesheet" crossorigin href="/sonamu-ui/assets/index-BrQKU3j9.css">
+    <script type="module" crossorigin src="/sonamu-ui/assets/index-DK-2aacv.js"></script>
+    <link rel="stylesheet" crossorigin href="/sonamu-ui/assets/index-CKo0Z2Iu.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "sonamu",
-  "version": "0.8.24",
+  "version": "0.8.26",
   "description": "Sonamu — TypeScript Fullstack API Framework",
   "keywords": [
     "typescript",
@@ -55,6 +55,10 @@
       "import": "./dist/filter/index.js",
       "types": "./dist/filter/index.d.ts"
     },
+    "./auth/plugins": {
+      "import": "./dist/auth/plugins/index.js",
+      "types": "./dist/auth/plugins/index.d.ts"
+    },
     "./cdd-types": {
       "import": "./dist/ui/cdd-types.js",
       "types": "./dist/ui/cdd-types.d.ts"
@@ -123,8 +127,8 @@
     "tsicli": "^1.0.5",
     "vite": "7.3.0",
     "vitest": "^4.0.10",
-    "@sonamu-kit/hmr-runner": "^0.1.1",
     "@sonamu-kit/hmr-hook": "^0.4.1",
+    "@sonamu-kit/hmr-runner": "^0.1.1",
     "@sonamu-kit/ts-loader": "^2.1.3",
     "@sonamu-kit/tasks": "^0.2.0"
   },

package/src/api/__tests__/config.test.ts ADDED Viewed

@@ -0,0 +1,225 @@
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+const tsLoaderRegisterStateKey = Symbol.for("sonamu.ts-loader-register.state");
+type TsLoaderRegisterState = {
+  registered: boolean;
+};
+type GlobalWithTsLoaderRegisterState = typeof globalThis & {
+  [tsLoaderRegisterStateKey]?: TsLoaderRegisterState;
+};
+function resetRegisterState() {
+  const globalState = globalThis as GlobalWithTsLoaderRegisterState;
+  delete globalState[tsLoaderRegisterStateKey];
+  delete process.env.SWCRC_PATH;
+}
+async function createTempRoot(): Promise<string> {
+  return mkdtemp(path.join(os.tmpdir(), "sonamu-config-test-"));
+}
+async function writeSourceFixture(rootPath: string): Promise<void> {
+  await mkdir(path.join(rootPath, "src"), { recursive: true });
+  await writeFile(
+    path.join(rootPath, "src", "support.ts"),
+    `
+export const fastifyOptions = { keepAliveTimeout: 4321 };
+export function customPlugin() {
+  return "plugin";
+}
+export function contextProvider(defaultContext) {
+  return defaultContext;
+}
+export function guardHandler() {}
+`,
+  );
+  await writeFile(
+    path.join(rootPath, "src", "sonamu.config.ts"),
+    `
+import { customPlugin, contextProvider, fastifyOptions, guardHandler } from "./support";
+export default {
+  api: {
+    dir: "./src",
+    route: {
+      prefix: "/api",
+    },
+  },
+  i18n: {
+    defaultLocale: "ko",
+    supportedLocales: ["ko"],
+  },
+  sync: {
+    targets: ["web"],
+  },
+  server: {
+    fastify: fastifyOptions,
+    plugins: {
+      custom: customPlugin,
+    },
+    apiConfig: {
+      contextProvider,
+      guardHandler,
+    },
+  },
+  test: {
+    parallel: true,
+    maxWorkers: 3,
+    devRunner: {
+      enabled: true,
+      routePrefix: "/__test__",
+    },
+  },
+};
+`,
+  );
+}
+async function writeDistFixture(rootPath: string): Promise<void> {
+  await mkdir(path.join(rootPath, "dist"), { recursive: true });
+  await writeFile(
+    path.join(rootPath, "dist", "sonamu.config.js"),
+    `
+export default {
+  api: {
+    dir: "./dist",
+    route: {
+      prefix: "/api",
+    },
+  },
+  i18n: {
+    defaultLocale: "en",
+    supportedLocales: ["en"],
+  },
+  sync: {
+    targets: ["web"],
+  },
+  server: {
+    apiConfig: {
+      contextProvider(defaultContext) {
+        return defaultContext;
+      },
+      guardHandler() {},
+    },
+  },
+  test: {
+    devRunner: {
+      enabled: false,
+    },
+  },
+};
+`,
+  );
+}
+describe("loadConfig", () => {
+  const tempRoots: string[] = [];
+  const originalHot = process.env.HOT;
+  const originalVitest = process.env.VITEST;
+  const originalSwcrcPath = process.env.SWCRC_PATH;
+  beforeEach(() => {
+    vi.resetModules();
+    vi.restoreAllMocks();
+    vi.unmock("../../bin/ts-loader-registration");
+    resetRegisterState();
+  });
+  afterEach(async () => {
+    vi.resetModules();
+    vi.restoreAllMocks();
+    vi.unmock("../../bin/ts-loader-registration");
+    resetRegisterState();
+    if (originalHot === undefined) {
+      delete process.env.HOT;
+    } else {
+      process.env.HOT = originalHot;
+    }
+    if (originalVitest === undefined) {
+      delete process.env.VITEST;
+    } else {
+      process.env.VITEST = originalVitest;
+    }
+    if (originalSwcrcPath === undefined) {
+      delete process.env.SWCRC_PATH;
+    } else {
+      process.env.SWCRC_PATH = originalSwcrcPath;
+    }
+    await Promise.all(
+      tempRoots.splice(0).map((rootPath) => rm(rootPath, { recursive: true, force: true })),
+    );
+  });
+  it("source config 로드 전에 ts-loader 등록을 보장한다", async () => {
+    const rootPath = await createTempRoot();
+    tempRoots.push(rootPath);
+    await writeSourceFixture(rootPath);
+    process.env.VITEST = "true";
+    const ensureTsLoaderRegistered = vi.fn(async () => {});
+    vi.doMock("../../bin/ts-loader-registration", () => ({
+      ensureTsLoaderRegistered,
+    }));
+    const { loadConfig } = await import("../config");
+    const config = await loadConfig(rootPath);
+    expect(ensureTsLoaderRegistered).toHaveBeenCalledTimes(1);
+    expect(ensureTsLoaderRegistered).toHaveBeenCalledWith(rootPath);
+    expect(config.test?.devRunner?.enabled).toBe(true);
+  });
+  it("dist config 로딩 경로는 기존과 동일하게 유지한다", async () => {
+    const rootPath = await createTempRoot();
+    tempRoots.push(rootPath);
+    await writeDistFixture(rootPath);
+    delete process.env.HOT;
+    delete process.env.VITEST;
+    const ensureTsLoaderRegistered = vi.fn(async () => {});
+    vi.doMock("../../bin/ts-loader-registration", () => ({
+      ensureTsLoaderRegistered,
+    }));
+    const { loadConfig } = await import("../config");
+    const config = await loadConfig(rootPath);
+    expect(ensureTsLoaderRegistered).not.toHaveBeenCalled();
+    expect(config.api.dir).toBe("./dist");
+    expect(config.test?.devRunner?.enabled).toBe(false);
+  });
+  it("source config가 확장자 없는 상대 import와 런타임 객체를 유지하며 반복 로드된다", async () => {
+    const rootPath = await createTempRoot();
+    tempRoots.push(rootPath);
+    await writeSourceFixture(rootPath);
+    process.env.VITEST = "true";
+    vi.unmock("../../bin/ts-loader-registration");
+    const { loadConfig } = await import("../config");
+    const supportModule = await import(
+      pathToFileURL(path.join(rootPath, "src", "support.ts")).href
+    );
+    const firstConfig = await loadConfig(rootPath);
+    const secondConfig = await loadConfig(rootPath);
+    expect(firstConfig.server.fastify).toBe(supportModule.fastifyOptions);
+    expect(firstConfig.server.plugins?.custom).toBe(supportModule.customPlugin);
+    expect(firstConfig.test?.parallel).toBe(true);
+    expect(firstConfig.test?.maxWorkers).toBe(3);
+    expect(firstConfig.test?.devRunner?.enabled).toBe(true);
+    expect(secondConfig.server.plugins?.custom).toBe(supportModule.customPlugin);
+    expect(secondConfig.server.fastify).toBe(supportModule.fastifyOptions);
+  });
+});

package/src/api/config.ts CHANGED Viewed

@@ -289,10 +289,16 @@ export function defineConfig(config: Executable<SonamuConfig>): Promise<SonamuCo
  */
 export async function loadConfig(rootPath: string): Promise<SonamuConfig> {
   const start = performance.now();
-  const configPath =
-    process.env.HOT === "yes" || process.env.VITEST === "true"
-      ? `${rootPath}/src/sonamu.config.ts`
-      : `${rootPath}/dist/sonamu.config.js`;
+  const shouldLoadSourceConfig = process.env.HOT === "yes" || process.env.VITEST === "true";
+  const configPath = shouldLoadSourceConfig
+    ? `${rootPath}/src/sonamu.config.ts`
+    : `${rootPath}/dist/sonamu.config.js`;
+  if (shouldLoadSourceConfig) {
+    const { ensureTsLoaderRegistered } = await import("../bin/ts-loader-registration");
+    await ensureTsLoaderRegistered(rootPath);
+  }
   const { default: config } = await import(`file://${configPath}`);
   const importTime = performance.now() - start;
   process.env.NODE_ENV !== "test" &&

package/src/api/sonamu.ts CHANGED Viewed

@@ -9,7 +9,6 @@ import type { IncomingMessage, Server, ServerResponse } from "http";
 import mime, { lookup as mimeLookup } from "mime-types";
 import os from "os";
 import path from "path";
-import type { PoolConfig } from "pg";
 import type { ZodObject } from "zod";
 import {
   BASE_FIELD_MAPPINGS,
@@ -232,6 +231,22 @@ class SonamuClass {
     // Cache 초기화
     await this.initializeCache(this.config.server.cache, forTesting);
+    // BetterAuth 초기화
+    const authConfig = this.config.server.auth;
+    if (authConfig) {
+      // 사용자 설정과 기본값을 merge
+      const mergedFieldMappings = merge(BASE_FIELD_MAPPINGS, authConfig);
+      // better-auth 인스턴스 생성
+      const { betterAuth } = await import("better-auth");
+      const { sonamuKnexAdapter } = await import("../auth/knex-adapter");
+      this._auth = betterAuth({
+        database: sonamuKnexAdapter(),
+        ...mergedFieldMappings,
+      });
+    }
     // 테스팅인 경우 싱크 없이 중단
     if (forTesting) {
       this.isInitialized = true;
@@ -1243,18 +1258,6 @@ class SonamuClass {
     const basePath = options.basePath ?? "/api/auth";
-    // 사용자 설정과 기본값을 merge
-    const mergedFieldMappings = merge(BASE_FIELD_MAPPINGS, options);
-    // better-auth 인스턴스 생성
-    const { betterAuth } = await import("better-auth");
-    const { Pool } = await import("pg");
-    this._auth = betterAuth({
-      database: new Pool(DB.getDBConfig("w").connection as PoolConfig),
-      ...mergedFieldMappings,
-    });
     // better-auth 라우트 등록
     server.route({
       method: ["GET", "POST"],

package/src/auth/index.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 export type { GenerateBetterAuthEntitiesOptions } from "./auth-generator";
 export { generateBetterAuthEntities } from "./auth-generator";
 export { BASE_FIELD_MAPPINGS, betterAuthV1 } from "./better-auth-entities";
+export { sonamuKnexAdapter } from "./knex-adapter";
 // 외부로는 wrappers만 export (admin, twoFactor 등 래퍼 함수와 SCHEMA)
 export * from "./plugins";

package/src/auth/knex-adapter.ts ADDED Viewed

@@ -0,0 +1,208 @@
+import type { BetterAuthOptions } from "better-auth";
+import type {
+  AdapterFactoryCustomizeAdapterCreator,
+  DBTransactionAdapter,
+} from "better-auth/adapters";
+import { createAdapterFactory } from "better-auth/adapters";
+import type { Knex } from "knex";
+import { DB } from "../database/db";
+interface CleanedWhere {
+  field: string;
+  value: string | number | boolean | string[] | number[] | Date | null;
+  operator: string;
+  connector: string;
+}
+/**
+ * better-auth용 Sonamu knex 어댑터
+ *
+ * better-auth의 모든 쿼리를 DB.getDB()를 통해 실행하여
+ * Sonamu 테스트 트랜잭션과 동일한 커넥션을 공유합니다.
+ */
+export const sonamuKnexAdapter = () => {
+  let lazyOptions: BetterAuthOptions | null = null;
+  const createCustomAdapter = (
+    getDb: () => Knex | Knex.Transaction,
+  ): AdapterFactoryCustomizeAdapterCreator => {
+    return ({ getFieldName }) => ({
+      create: async ({ model, data }) => {
+        const [row] = await getDb()(model).insert(data).returning("*");
+        return row;
+      },
+      findOne: async ({ model, where }) => {
+        let query = getDb()(model);
+        query = applyWhere(query, where);
+        const row = await query.first();
+        return row ?? null;
+      },
+      findMany: async ({ model, where, limit, offset, sortBy }) => {
+        let query = getDb()(model);
+        if (where) {
+          query = applyWhere(query, where);
+        }
+        if (sortBy) {
+          const dbField = getFieldName({ model, field: sortBy.field });
+          query = query.orderBy(dbField, sortBy.direction);
+        }
+        if (limit) {
+          query = query.limit(limit);
+        }
+        if (offset) {
+          query = query.offset(offset);
+        }
+        return await query;
+      },
+      update: async ({ model, where, update }) => {
+        let query = getDb()(model);
+        query = applyWhere(query, where);
+        const [row] = await query.update(update).returning("*");
+        return row ?? null;
+      },
+      updateMany: async ({ model, where, update }) => {
+        let query = getDb()(model);
+        query = applyWhere(query, where);
+        const count = await query.update(update);
+        return count;
+      },
+      delete: async ({ model, where }) => {
+        let query = getDb()(model);
+        query = applyWhere(query, where);
+        await query.del();
+      },
+      deleteMany: async ({ model, where }) => {
+        let query = getDb()(model);
+        query = applyWhere(query, where);
+        const count = await query.del();
+        return count;
+      },
+      count: async ({ model, where }) => {
+        let query = getDb()(model);
+        if (where) {
+          query = applyWhere(query, where);
+        }
+        const [{ count }] = await query.count("* as count");
+        return Number(count);
+      },
+    });
+  };
+  const adapterConfig = {
+    adapterId: "sonamu-knex",
+    adapterName: "Sonamu Knex Adapter",
+    usePlural: false,
+    supportsJSON: true,
+    supportsDates: true,
+    supportsBooleans: true,
+    supportsNumericIds: false,
+    transaction: async <R>(cb: (trx: DBTransactionAdapter) => Promise<R>): Promise<R> => {
+      const db = DB.getDB("w");
+      return db.transaction(async (trx) => {
+        const options = lazyOptions;
+        if (!options) {
+          throw new Error("sonamuKnexAdapter: options not initialized");
+        }
+        return cb(
+          createAdapterFactory({
+            config: adapterConfig,
+            adapter: createCustomAdapter(() => trx),
+          })(options),
+        );
+      });
+    },
+  };
+  const adapterCreator = createAdapterFactory({
+    config: adapterConfig,
+    adapter: createCustomAdapter(() => DB.getDB("w")),
+  });
+  return (options: BetterAuthOptions) => {
+    lazyOptions = options;
+    return adapterCreator(options);
+  };
+};
+/**
+ * Better Auth의 공식 어댑터(Kysely, Drizzle, Prisma, MongoDB) 패턴에 맞춰
+ * AND 그룹과 OR 그룹을 분리한 뒤 top-level AND로 결합합니다.
+ * 결과: (A AND B AND ...) AND (C OR D OR ...)
+ */
+export function applyWhere(
+  query: Knex.QueryBuilder,
+  conditions: CleanedWhere[],
+): Knex.QueryBuilder {
+  const andGroup = conditions.filter((c) => c.connector !== "OR");
+  const orGroup = conditions.filter((c) => c.connector === "OR");
+  if (andGroup.length > 0) {
+    for (const condition of andGroup) {
+      query = applyCondition(query, condition, "where");
+    }
+  }
+  if (orGroup.length > 0) {
+    query = query.where(function (this: Knex.QueryBuilder) {
+      for (let i = 0; i < orGroup.length; i++) {
+        applyCondition(this, orGroup[i], i === 0 ? "where" : "orWhere");
+      }
+    });
+  }
+  return query;
+}
+function applyCondition(
+  query: Knex.QueryBuilder,
+  condition: CleanedWhere,
+  method: "where" | "orWhere",
+): Knex.QueryBuilder {
+  const { field, value, operator } = condition;
+  switch (operator) {
+    case "eq":
+      if (value === null) {
+        return query[method === "orWhere" ? "orWhereNull" : "whereNull"](field);
+      }
+      return query[method](field, "=", value);
+    case "ne":
+      if (value === null) {
+        return query[method === "orWhere" ? "orWhereNotNull" : "whereNotNull"](field);
+      }
+      return query[method](field, "!=", value);
+    case "lt":
+      return query[method](field, "<", value);
+    case "lte":
+      return query[method](field, "<=", value);
+    case "gt":
+      return query[method](field, ">", value);
+    case "gte":
+      return query[method](field, ">=", value);
+    case "in":
+      return query[method === "orWhere" ? "orWhereIn" : "whereIn"](
+        field,
+        value as (string | number)[],
+      );
+    case "not_in":
+      return query[method === "orWhere" ? "orWhereNotIn" : "whereNotIn"](
+        field,
+        value as (string | number)[],
+      );
+    case "contains":
+      return query[method](field, "like", `%${value}%`);
+    case "starts_with":
+      return query[method](field, "like", `${value}%`);
+    case "ends_with":
+      return query[method](field, "like", `%${value}`);
+    default:
+      return query;
+  }
+}

package/src/bin/__tests__/ts-loader-register.test.ts ADDED Viewed

@@ -0,0 +1,62 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+const tsLoaderRegisterStateKey = Symbol.for("sonamu.ts-loader-register.state");
+type TsLoaderRegisterState = {
+  registered: boolean;
+};
+type GlobalWithTsLoaderRegisterState = typeof globalThis & {
+  [tsLoaderRegisterStateKey]?: TsLoaderRegisterState;
+};
+function resetRegisterState() {
+  const globalState = globalThis as GlobalWithTsLoaderRegisterState;
+  delete globalState[tsLoaderRegisterStateKey];
+  delete process.env.SWCRC_PATH;
+}
+describe("ensureTsLoaderRegistered", () => {
+  beforeEach(() => {
+    vi.resetModules();
+    vi.restoreAllMocks();
+    vi.unmock("node:module");
+    vi.unmock("../../utils/fs-utils.js");
+    resetRegisterState();
+  });
+  afterEach(() => {
+    vi.resetModules();
+    vi.restoreAllMocks();
+    vi.unmock("node:module");
+    vi.unmock("../../utils/fs-utils.js");
+    resetRegisterState();
+  });
+  it("프로젝트 .swcrc를 우선 사용하고 중복 등록하지 않는다", async () => {
+    const registerMock = vi.fn();
+    vi.doMock("node:module", () => ({
+      register: registerMock,
+    }));
+    vi.doMock("../../utils/fs-utils.js", () => ({
+      exists: vi.fn(async (candidate: string) => candidate === "/tmp/fixture-api/.swcrc"),
+    }));
+    const module = await import("../ts-loader-registration");
+    expect(registerMock).not.toHaveBeenCalled();
+    await module.ensureTsLoaderRegistered("/tmp/fixture-api");
+    expect(registerMock).toHaveBeenCalledTimes(1);
+    expect(registerMock).toHaveBeenCalledWith("@sonamu-kit/ts-loader/loader", {
+      parentURL: expect.stringContaining("/src/bin/ts-loader-registration"),
+    });
+    expect(process.env.SWCRC_PATH).toBe("/tmp/fixture-api/.swcrc");
+    await module.ensureTsLoaderRegistered("/tmp/another-api");
+    expect(registerMock).toHaveBeenCalledTimes(1);
+    expect(process.env.SWCRC_PATH).toBe("/tmp/fixture-api/.swcrc");
+  });
+});