sonamu 0.7.2 → 0.7.4

package/dist/utils/path-utils.d.ts

@@ -8,7 +8,7 @@
  *
  * **기준점**: `Sonamu.apiRootPath` (일반적으로 프로젝트의 `/api` 디렉토리)
  */
-export type ApiRelativePath = `${"src" | "dist"}/${string}` | "sonamu.config.ts";
+export type ApiRelativePath = `${"src" | "dist"}/${string}`;
 /**
  * 앱 루트 기준 상대 경로 (api/, web/ 등 타겟 디렉토리로 시작)
  *

package/dist/utils/path-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,KAAK,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,kBAAkB,CAAC;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,MAAM,IAAI,KAAK,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,MAAM,EAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAyC,GAAG,MAAM,CAMrG"}
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,KAAK,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,MAAM,IAAI,KAAK,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,MAAM,EAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,OAAyC,GAC/C,MAAM,CAMR"}

package/dist/utils/path-utils.js

@@ -57,4 +57,4 @@ import { isHotReloadServer, isTest } from "./controller.js";
     }
 }
 
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9wYXRoLXV0aWxzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGlzSG90UmVsb2FkU2VydmVyLCBpc1Rlc3QgfSBmcm9tIFwiLi9jb250cm9sbGVyLmpzXCI7XG5cbi8qKlxuICogQVBJIO2MqO2CpOyngCDrgrTrtoAg7IOB64yAIOqyveuhnCAoc3JjLyDrmJDripQgZGlzdC/roZwg7Iuc7J6RKVxuICpcbiAqICoq7IKs7JqpIOychOy5mCoqOiBBUEkg7Yyo7YKk7KeAIOuCtOu2gCDtjIzsnbwg7LC47KGwXG4gKiAqKuyYiOyLnCoqOlxuICogLSBgXCJzcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCJgXG4gKiAtIGBcImRpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCJgXG4gKlxuICogKirquLDspIDsoJAqKjogYFNvbmFtdS5hcGlSb290UGF0aGAgKOydvOuwmOyggeycvOuhnCDtlITroZzsoJ3tirjsnZggYC9hcGlgIOuUlOugie2GoOumrClcbiAqL1xuZXhwb3J0IHR5cGUgQXBpUmVsYXRpdmVQYXRoID0gYCR7XCJzcmNcIiB8IFwiZGlzdFwifS8ke3N0cmluZ31gIHwgXCJzb25hbXUuY29uZmlnLnRzXCI7XG5cbi8qKlxuICog7JWxIOujqO2KuCDquLDspIAg7IOB64yAIOqyveuhnCAoYXBpLywgd2ViLyDrk7Eg7YOA6rKfIOuUlOugie2GoOumrOuhnCDsi5zsnpEpXG4gKlxuICogKirsgqzsmqkg7JyE7LmYKio6IOuLpOuluCDtg4Dqsp8oYXBpLCB3ZWIg65OxKeydmCDtjIzsnbwg7LC47KGwXG4gKiAqKuyYiOyLnCoqOlxuICogLSBgXCJhcGkvc3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50c1wiYFxuICogLSBgXCJ3ZWIvc3JjL3BhZ2VzL2FkbWluL3VzZXJzL2luZGV4LnRzeFwiYFxuICogLSBgXCJhcHAvZGlzdC9pbmRleC5qc1wiYFxuICpcbiAqICoq6riw7KSA7KCQKio6IGBTb25hbXUuYXBwUm9vdFBhdGhgICjsnbzrsJjsoIHsnLzroZwg66qo64W466CI7Y+sIOujqO2KuClcbiAqL1xuZXhwb3J0IHR5cGUgQXBwUmVsYXRpdmVQYXRoID0gYCR7c3RyaW5nfS8ke1wic3JjXCIgfCBcImRpc3RcIn0vJHtzdHJpbmd9YDtcblxuLyoqXG4gKiDsi5zsiqTthZwg7KCI64yAIOqyveuhnCAo66Oo7Yq4IC8g67aA7YSwIOyLnOyekSlcbiAqXG4gKiAqKuyCrOyaqSDsnITsuZgqKjog7YyM7J287Iuc7Iqk7YWcIOyngeygkSDsoJHqt7wsIGdsb2Ig7Yyo7YS0XG4gKiAqKuyYiOyLnCoqOiBgXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL3NyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcImBcbiAqXG4gKiAqKuykkeyalCoqOlxuICogLSBpbXBvcnQg7Iuc7JeQ64qUIOuhnOuNlOqwgCDslYzslYTshJwgc3JjL2Rpc3Qg67OA7ZmY7ZW07KO866+A66GcIOyWtOuKkCDqsr3roZzrk6Ag6rCA64qlXG4gKiAtIGZzIOyngeygkSDsoJHqt7wg7Iuc7JeQ64qUIOyLpOygnCDsobTsnqztlZjripQg6rK966Gc66W8IOyCrOyaqe2VtOyVvCDtlahcbiAqICAgLSBEZXY6IHNyYy8qLnRzIOqyveuhnCDsgqzsmqlcbiAqICAgLSBQcm9kOiBkaXN0LyouanMg6rK966GcIOyCrOyaqVxuICovXG5leHBvcnQgdHlwZSBBYnNvbHV0ZVBhdGggPSBgLyR7c3RyaW5nfWA7XG5cbi8qKlxuICog7Ja065akIOqyveuhnOqwgCDrk6TslrTsmKTrk6AsIO2YhOyerCDsi6Ttlokg7ZmY6rK97JeQIOunnuuKlCDqsr3roZzroZwg67CU6r+U7KSN64uI64ukLlxuICpcbiAqIFwic3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50c1wi6rCAIOuTpOyWtOyZlOydhCDrlYwg6rCc67CcIOuqqOuTnOudvOuptD9cbiAqIC0+IFwic3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50c1wiXG4gKiBcInNyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIuqwgCDrk6TslrTsmZTsnYQg65WMIOuwsO2PrCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcImRpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCJcbiAqIFwiZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanNcIuqwgCDrk6TslrTsmZTsnYQg65WMIOqwnOuwnCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcInNyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIlxuICogXCJkaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wi6rCAIOuTpOyWtOyZlOydhCDrlYwg67Cw7Y+sIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanNcIlxuICpcbiAqIFwiL3NyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIuqwgCDrk6TslrTsmZTsnYQg65WMIOqwnOuwnCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcIi9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCJcbiAqIFwiL3NyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIuqwgCDrk6TslrTsmZTsnYQg65WMIOuwsO2PrCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcIi9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wiXG4gKiBcIi9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wi6rCAIOuTpOyWtOyZlOydhCDrlYwg6rCc67CcIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL2Rpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCJcbiAqIFwiL2Rpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDrsLDtj6wg66qo65Oc652866m0P1xuICogLT4gXCIvZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanNcIlxuICpcbiAqIFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDqsJzrsJwg66qo65Oc652866m0P1xuICogLT4gXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL3NyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIlxuICogXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL3NyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIuqwgCDrk6TslrTsmZTsnYQg65WMIOuwsO2PrCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanNcIlxuICogXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL2Rpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDqsJzrsJwg66qo65Oc652866m0P1xuICogLT4gXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL3NyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIlxuICogXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL2Rpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDrsLDtj6wg66qo65Oc652866m0P1xuICogLT4gXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL2Rpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCJcbiAqXG4gKiBcInNyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHM/aG90PTEyMzQ1Njc4OTBcIuqwgCDrk6TslrTsmZTsnYQg65WMIOqwnOuwnCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcInNyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHM/aG90PTEyMzQ1Njc4OTBcIlxuICogXCJzcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzP2hvdD0xMjM0NTY3ODkwXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDrsLDtj6wg66qo65Oc652866m0P1xuICogLT4gXCJkaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qcz9ob3Q9MTIzNDU2Nzg5MFwiXG4gKiBcImRpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzP2hvdD0xMjM0NTY3ODkwXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDqsJzrsJwg66qo65Oc652866m0P1xuICogLT4gXCJzcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzP2hvdD0xMjM0NTY3ODkwXCJcbiAqIFwiZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanM/aG90PTEyMzQ1Njc4OTBcIuqwgCDrk6TslrTsmZTsnYQg65WMIOuwsO2PrCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcImRpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzP2hvdD0xMjM0NTY3ODkwXCJcbiAqXG4gKiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvc3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50cz9ob3Q9MTIzNDU2Nzg5MFwi6rCAIOuTpOyWtOyZlOydhCDrlYwg6rCc67CcIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzP2hvdD0xMjM0NTY3ODkwXCJcbiAqIFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzP2hvdD0xMjM0NTY3ODkwXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDrsLDtj6wg66qo65Oc652866m0P1xuICogLT4gXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL2Rpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzP2hvdD0xMjM0NTY3ODkwXCJcbiAqIFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qcz9ob3Q9MTIzNDU2Nzg5MFwi6rCAIOuTpOyWtOyZlOydhCDrlYwg6rCc67CcIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzP2hvdD0xMjM0NTY3ODkwXCJcbiAqIFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qcz9ob3Q9MTIzNDU2Nzg5MFwi6rCAIOuTpOyWtOyZlOydhCDrlYwg67Cw7Y+sIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qcz9ob3Q9MTIzNDU2Nzg5MFwiXG4gKlxuICogQHBhcmFtIGFueVBhdGhcbiAqIEByZXR1cm5zXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBydW50aW1lUGF0aChhbnlQYXRoOiBzdHJpbmcsIGlzRGV2OiBib29sZWFuID0gaXNIb3RSZWxvYWRTZXJ2ZXIoKSB8fCBpc1Rlc3QoKSk6IHN0cmluZyB7XG4gIGlmIChpc0Rldikge1xuICAgIHJldHVybiBhbnlQYXRoLnJlcGxhY2UoL2Rpc3RcXC8vLCBcInNyYy9cIikucmVwbGFjZSgvXFwuanMvLCBcIi50c1wiKTtcbiAgfSBlbHNlIHtcbiAgICByZXR1cm4gYW55UGF0aC5yZXBsYWNlKC9zcmNcXC8vLCBcImRpc3QvXCIpLnJlcGxhY2UoL1xcLnRzLywgXCIuanNcIik7XG4gIH1cbn1cbiJdLCJuYW1lcyI6WyJpc0hvdFJlbG9hZFNlcnZlciIsImlzVGVzdCIsInJ1bnRpbWVQYXRoIiwiYW55UGF0aCIsImlzRGV2IiwicmVwbGFjZSJdLCJtYXBwaW5ncyI6IkFBQUEsU0FBU0EsaUJBQWlCLEVBQUVDLE1BQU0sUUFBUSxrQkFBa0I7QUF5QzVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQWtEQyxHQUNELE9BQU8sU0FBU0MsWUFBWUMsT0FBZSxFQUFFQyxRQUFpQkosdUJBQXVCQyxRQUFRO0lBQzNGLElBQUlHLE9BQU87UUFDVCxPQUFPRCxRQUFRRSxPQUFPLENBQUMsVUFBVSxRQUFRQSxPQUFPLENBQUMsUUFBUTtJQUMzRCxPQUFPO1FBQ0wsT0FBT0YsUUFBUUUsT0FBTyxDQUFDLFNBQVMsU0FBU0EsT0FBTyxDQUFDLFFBQVE7SUFDM0Q7QUFDRiJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9wYXRoLXV0aWxzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGlzSG90UmVsb2FkU2VydmVyLCBpc1Rlc3QgfSBmcm9tIFwiLi9jb250cm9sbGVyLmpzXCI7XG5cbi8qKlxuICogQVBJIO2MqO2CpOyngCDrgrTrtoAg7IOB64yAIOqyveuhnCAoc3JjLyDrmJDripQgZGlzdC/roZwg7Iuc7J6RKVxuICpcbiAqICoq7IKs7JqpIOychOy5mCoqOiBBUEkg7Yyo7YKk7KeAIOuCtOu2gCDtjIzsnbwg7LC47KGwXG4gKiAqKuyYiOyLnCoqOlxuICogLSBgXCJzcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCJgXG4gKiAtIGBcImRpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCJgXG4gKlxuICogKirquLDspIDsoJAqKjogYFNvbmFtdS5hcGlSb290UGF0aGAgKOydvOuwmOyggeycvOuhnCDtlITroZzsoJ3tirjsnZggYC9hcGlgIOuUlOugie2GoOumrClcbiAqL1xuZXhwb3J0IHR5cGUgQXBpUmVsYXRpdmVQYXRoID0gYCR7XCJzcmNcIiB8IFwiZGlzdFwifS8ke3N0cmluZ31gO1xuXG4vKipcbiAqIOyVsSDro6jtirgg6riw7KSAIOyDgeuMgCDqsr3roZwgKGFwaS8sIHdlYi8g65OxIO2DgOqynyDrlJTroInthqDrpqzroZwg7Iuc7J6RKVxuICpcbiAqICoq7IKs7JqpIOychOy5mCoqOiDri6Trpbgg7YOA6rKfKGFwaSwgd2ViIOuTsSnsnZgg7YyM7J28IOywuOyhsFxuICogKirsmIjsi5wqKjpcbiAqIC0gYFwiYXBpL3NyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcImBcbiAqIC0gYFwid2ViL3NyYy9wYWdlcy9hZG1pbi91c2Vycy9pbmRleC50c3hcImBcbiAqIC0gYFwiYXBwL2Rpc3QvaW5kZXguanNcImBcbiAqXG4gKiAqKuq4sOykgOygkCoqOiBgU29uYW11LmFwcFJvb3RQYXRoYCAo7J2867CY7KCB7Jy866GcIOuqqOuFuOugiO2PrCDro6jtirgpXG4gKi9cbmV4cG9ydCB0eXBlIEFwcFJlbGF0aXZlUGF0aCA9IGAke3N0cmluZ30vJHtcInNyY1wiIHwgXCJkaXN0XCJ9LyR7c3RyaW5nfWA7XG5cbi8qKlxuICog7Iuc7Iqk7YWcIOygiOuMgCDqsr3roZwgKOujqO2KuCAvIOu2gO2EsCDsi5zsnpEpXG4gKlxuICogKirsgqzsmqkg7JyE7LmYKio6IO2MjOydvOyLnOyKpO2FnCDsp4HsoJEg7KCR6re8LCBnbG9iIO2MqO2EtFxuICogKirsmIjsi5wqKjogYFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCJgXG4gKlxuICogKirspJHsmpQqKjpcbiAqIC0gaW1wb3J0IOyLnOyXkOuKlCDroZzrjZTqsIAg7JWM7JWE7IScIHNyYy9kaXN0IOuzgO2ZmO2VtOyjvOuvgOuhnCDslrTripAg6rK966Gc65OgIOqwgOuKpVxuICogLSBmcyDsp4HsoJEg7KCR6re8IOyLnOyXkOuKlCDsi6TsoJwg7KG07J6s7ZWY64qUIOqyveuhnOulvCDsgqzsmqntlbTslbwg7ZWoXG4gKiAgIC0gRGV2OiBzcmMvKi50cyDqsr3roZwg7IKs7JqpXG4gKiAgIC0gUHJvZDogZGlzdC8qLmpzIOqyveuhnCDsgqzsmqlcbiAqL1xuZXhwb3J0IHR5cGUgQWJzb2x1dGVQYXRoID0gYC8ke3N0cmluZ31gO1xuXG4vKipcbiAqIOyWtOuWpCDqsr3roZzqsIAg65Ok7Ja07Jik65OgLCDtmITsnqwg7Iuk7ZaJIO2ZmOqyveyXkCDrp57ripQg6rK966Gc66GcIOuwlOq/lOykjeuLiOuLpC5cbiAqXG4gKiBcInNyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIuqwgCDrk6TslrTsmZTsnYQg65WMIOqwnOuwnCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcInNyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHNcIlxuICogXCJzcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDrsLDtj6wg66qo65Oc652866m0P1xuICogLT4gXCJkaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wiXG4gKiBcImRpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDqsJzrsJwg66qo65Oc652866m0P1xuICogLT4gXCJzcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCJcbiAqIFwiZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanNcIuqwgCDrk6TslrTsmZTsnYQg65WMIOuwsO2PrCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcImRpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCJcbiAqXG4gKiBcIi9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDqsJzrsJwg66qo65Oc652866m0P1xuICogLT4gXCIvc3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50c1wiXG4gKiBcIi9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDrsLDtj6wg66qo65Oc652866m0P1xuICogLT4gXCIvZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanNcIlxuICogXCIvZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanNcIuqwgCDrk6TslrTsmZTsnYQg65WMIOqwnOuwnCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcIi9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wiXG4gKiBcIi9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wi6rCAIOuTpOyWtOyZlOydhCDrlYwg67Cw7Y+sIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL2Rpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCJcbiAqXG4gKiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvc3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50c1wi6rCAIOuTpOyWtOyZlOydhCDrlYwg6rCc67CcIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCJcbiAqIFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDrsLDtj6wg66qo65Oc652866m0P1xuICogLT4gXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL2Rpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzXCJcbiAqIFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wi6rCAIOuTpOyWtOyZlOydhCDrlYwg6rCc67CcIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9zcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzXCJcbiAqIFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wi6rCAIOuTpOyWtOyZlOydhCDrlYwg67Cw7Y+sIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qc1wiXG4gKlxuICogXCJzcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzP2hvdD0xMjM0NTY3ODkwXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDqsJzrsJwg66qo65Oc652866m0P1xuICogLT4gXCJzcmMvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLnRzP2hvdD0xMjM0NTY3ODkwXCJcbiAqIFwic3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50cz9ob3Q9MTIzNDU2Nzg5MFwi6rCAIOuTpOyWtOyZlOydhCDrlYwg67Cw7Y+sIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanM/aG90PTEyMzQ1Njc4OTBcIlxuICogXCJkaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qcz9ob3Q9MTIzNDU2Nzg5MFwi6rCAIOuTpOyWtOyZlOydhCDrlYwg6rCc67CcIOuqqOuTnOudvOuptD9cbiAqIC0+IFwic3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50cz9ob3Q9MTIzNDU2Nzg5MFwiXG4gKiBcImRpc3QvYXBwbGljYXRpb24vdXNlci91c2VyLm1vZGVsLmpzP2hvdD0xMjM0NTY3ODkwXCLqsIAg65Ok7Ja07JmU7J2EIOuVjCDrsLDtj6wg66qo65Oc652866m0P1xuICogLT4gXCJkaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qcz9ob3Q9MTIzNDU2Nzg5MFwiXG4gKlxuICogXCIvVXNlcnMvcG90YWRvcy9Qcm9qZWN0cy9zb25hbXUvYXBpL3NyYy9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwudHM/aG90PTEyMzQ1Njc4OTBcIuqwgCDrk6TslrTsmZTsnYQg65WMIOqwnOuwnCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvc3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50cz9ob3Q9MTIzNDU2Nzg5MFwiXG4gKiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvc3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50cz9ob3Q9MTIzNDU2Nzg5MFwi6rCAIOuTpOyWtOyZlOydhCDrlYwg67Cw7Y+sIOuqqOuTnOudvOuptD9cbiAqIC0+IFwiL1VzZXJzL3BvdGFkb3MvUHJvamVjdHMvc29uYW11L2FwaS9kaXN0L2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC5qcz9ob3Q9MTIzNDU2Nzg5MFwiXG4gKiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanM/aG90PTEyMzQ1Njc4OTBcIuqwgCDrk6TslrTsmZTsnYQg65WMIOqwnOuwnCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvc3JjL2FwcGxpY2F0aW9uL3VzZXIvdXNlci5tb2RlbC50cz9ob3Q9MTIzNDU2Nzg5MFwiXG4gKiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanM/aG90PTEyMzQ1Njc4OTBcIuqwgCDrk6TslrTsmZTsnYQg65WMIOuwsO2PrCDrqqjrk5zrnbzrqbQ/XG4gKiAtPiBcIi9Vc2Vycy9wb3RhZG9zL1Byb2plY3RzL3NvbmFtdS9hcGkvZGlzdC9hcHBsaWNhdGlvbi91c2VyL3VzZXIubW9kZWwuanM/aG90PTEyMzQ1Njc4OTBcIlxuICpcbiAqIEBwYXJhbSBhbnlQYXRoXG4gKiBAcmV0dXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gcnVudGltZVBhdGgoXG4gIGFueVBhdGg6IHN0cmluZyxcbiAgaXNEZXY6IGJvb2xlYW4gPSBpc0hvdFJlbG9hZFNlcnZlcigpIHx8IGlzVGVzdCgpLFxuKTogc3RyaW5nIHtcbiAgaWYgKGlzRGV2KSB7XG4gICAgcmV0dXJuIGFueVBhdGgucmVwbGFjZSgvZGlzdFxcLy8sIFwic3JjL1wiKS5yZXBsYWNlKC9cXC5qcy8sIFwiLnRzXCIpO1xuICB9IGVsc2Uge1xuICAgIHJldHVybiBhbnlQYXRoLnJlcGxhY2UoL3NyY1xcLy8sIFwiZGlzdC9cIikucmVwbGFjZSgvXFwudHMvLCBcIi5qc1wiKTtcbiAgfVxufVxuIl0sIm5hbWVzIjpbImlzSG90UmVsb2FkU2VydmVyIiwiaXNUZXN0IiwicnVudGltZVBhdGgiLCJhbnlQYXRoIiwiaXNEZXYiLCJyZXBsYWNlIl0sIm1hcHBpbmdzIjoiQUFBQSxTQUFTQSxpQkFBaUIsRUFBRUMsTUFBTSxRQUFRLGtCQUFrQjtBQXlDNUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0NBa0RDLEdBQ0QsT0FBTyxTQUFTQyxZQUNkQyxPQUFlLEVBQ2ZDLFFBQWlCSix1QkFBdUJDLFFBQVE7SUFFaEQsSUFBSUcsT0FBTztRQUNULE9BQU9ELFFBQVFFLE9BQU8sQ0FBQyxVQUFVLFFBQVFBLE9BQU8sQ0FBQyxRQUFRO0lBQzNELE9BQU87UUFDTCxPQUFPRixRQUFRRSxPQUFPLENBQUMsU0FBUyxTQUFTQSxPQUFPLENBQUMsUUFBUTtJQUMzRDtBQUNGIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonamu",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Sonamu — TypeScript Fullstack API Framework",
   "keywords": [
     "typescript",
@@ -30,9 +30,8 @@
   },
   "license": "MIT",
   "author": {
-    "name": "Minsang Kim",
-    "email": "minsangk@me.com",
-    "url": "https://twitter.com/minsangk"
+    "name": "CartaNova <dev@cartanova.ai>",
+    "url": "https://cartanova.ai"
   },
   "repository": {
     "type": "git",
@@ -77,9 +76,9 @@
     "tsicli": "^1.0.5",
     "vitest": "^4.0.10",
     "zod": "^4.1.12",
+    "@sonamu-kit/ts-loader": "^2.1.3",
     "@sonamu-kit/hmr-hook": "^0.4.1",
-    "@sonamu-kit/hmr-runner": "^0.1.1",
-    "@sonamu-kit/ts-loader": "^2.1.3"
+    "@sonamu-kit/hmr-runner": "^0.1.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.7",
@@ -100,10 +99,10 @@
     "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.99"
+    "@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"
   },
   "peerDependenciesMeta": {
     "@ai-sdk/openai": {

package/src/api/code-converters.ts

@@ -294,11 +294,11 @@ export function apiParamTypeToTsType(paramType: ApiParamType, injectImportKeys:
   } else if (ApiParamType.isTupleType(paramType)) {
     return `[ ${paramType.elements.map((elem) => apiParamTypeToTsType(elem, injectImportKeys))} ]`;
   } else if (ApiParamType.isTypeParam(paramType)) {
-    return `<${paramType.id}${
+    return `${paramType.id}${
       paramType.constraint
         ? ` extends ${apiParamTypeToTsType(paramType.constraint, injectImportKeys)}`
         : ""
-    }>`;
+    }`;
   } else {
     throw new Error(`resolve 불가 ApiParamType ${paramType}`);
   }

package/src/api/config.ts

@@ -126,7 +126,7 @@ export async function loadConfig(rootPath: string): Promise<SonamuConfig> {
   const start = performance.now();
   const configPath =
     process.env.HOT === "yes" || process.env.VITEST === "true"
-      ? `${rootPath}/sonamu.config.ts`
+      ? `${rootPath}/src/sonamu.config.ts`
       : `${rootPath}/dist/sonamu.config.js`;
   const { default: config } = await import(`file://${configPath}`);
   const importTime = performance.now() - start;

package/src/api/decorators.ts

@@ -10,10 +10,10 @@ import {
   type PuriWrapper,
   type TransactionalOptions,
 } from "../database/puri-wrapper";
+import { UpsertBuilder } from "../database/upsert-builder";
 import type { ApiParam, ApiParamType } from "../types/types";
 import type { UploadContext } from "./context";
 import { Sonamu } from "./sonamu";
-import { UpsertBuilder } from "../database/upsert-builder";
 
 export interface GuardKeys {
   query: true;

package/src/api/sonamu.ts

@@ -468,10 +468,7 @@ class SonamuClass {
   }
 
   async startWatcher(): Promise<void> {
-    const watchPath = [
-      path.join(this.apiRootPath, "src"),
-      path.join(this.apiRootPath, "sonamu.config.ts"),
-    ];
+    const watchPath = [path.join(this.apiRootPath, "src")];
 
     const chokidar = (await import("chokidar")).default;
     this.watcher = chokidar.watch(watchPath, {
@@ -494,7 +491,7 @@ class SonamuClass {
 
       try {
         // sonamu.config.ts 변경 시 재시작
-        const isConfigTs = filePath === path.join(this.apiRootPath, "sonamu.config.ts");
+        const isConfigTs = filePath === path.join(this.apiRootPath, "src", "sonamu.config.ts");
 
         if (isConfigTs) {
           const relativePath = filePath.replace(this.apiRootPath, "api");

package/src/bin/cli.ts

@@ -216,23 +216,6 @@ async function build() {
     process.exit(1);
   }
 
-  // sonamu.config.ts만 따로 빌드합니다.
-  // 이 친구는 src에 들어있지 않기 때문에 SWC_BUILD_COMMAND로 빌드되지 않습니다.
-  // 따라서 따로 빌드해줍니다.
-  try {
-    const configPath = path.join(apiRoot, "sonamu.config.ts");
-    if (await exists(configPath)) {
-      console.log(chalk.blue("Building sonamu.config.ts..."));
-      execSync(`swc ${configPath} -o ${BUILD_DIR}/sonamu.config.js`, {
-        cwd: apiRoot,
-        stdio: "inherit",
-      });
-    }
-  } catch (error) {
-    console.error(chalk.red("Building sonamu.config.ts failed."), error);
-    process.exit(1);
-  }
-
   // 마지막에는 타입 체크를 해요.
   try {
     console.log(chalk.blue("Checking types with tsc..."));

package/src/database/base-model.types.ts

@@ -1,3 +1,5 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Puri의 타입은 개별 모델에서 확정되므로 BaseModel에서는 any를 허용함 */
+
 /**
  * BaseModel 타입 시스템
  *

package/src/database/puri-wrapper.ts

@@ -148,7 +148,7 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
   }
 
   ubUpsert(tableName: TableName<TSchema>, chunkSize?: number): Promise<number[]> {
-    return this.upsertBuilder.upsert(this.knex, tableName, chunkSize);
+    return this.upsertBuilder.upsert(this.knex, tableName, { chunkSize });
   }
 
   ubInsertOnly(tableName: TableName<TSchema>, chunkSize?: number): Promise<number[]> {
@@ -160,7 +160,7 @@ export class PuriWrapper<TSchema extends DatabaseSchemaExtend = DatabaseSchemaEx
     mode: "upsert" | "insert",
     chunkSize?: number,
   ): Promise<number[]> {
-    return this.upsertBuilder.upsertOrInsert(this.knex, tableName, mode, chunkSize);
+    return this.upsertBuilder.upsertOrInsert(this.knex, tableName, mode, { chunkSize });
   }
 
   ubUpdateBatch(

package/src/database/upsert-builder.ts

@@ -1,6 +1,6 @@
 import { randomUUID } from "crypto";
 import type { Knex } from "knex";
-import { unique } from "radashi";
+import { isArray, unique } from "radashi";
 import { EntityManager } from "../entity/entity-manager";
 import { Naite } from "../naite/naite";
 import { assertDefined, chunk, nonNullable } from "../utils/utils";
@@ -17,6 +17,10 @@ export type UBRef = {
   of: string;
   use?: string;
 };
+type UpsertOptions = {
+  chunkSize?: number;
+  cleanOrphans?: string | string[]; // FK 컬럼명(들)
+};
 export function isRefField(field: unknown): field is UBRef {
   return (
     field !== undefined &&
@@ -150,18 +154,37 @@ export class UpsertBuilder {
     return result;
   }
 
-  async upsert(wdb: Knex, tableName: string, chunkSize?: number): Promise<number[]> {
-    return this.upsertOrInsert(wdb, tableName, "upsert", chunkSize);
+  async upsert(
+    wdb: Knex,
+    tableName: string,
+    optionsOrChunkSize?: UpsertOptions,
+  ): Promise<number[]> {
+    // 숫자면 { chunkSize: n } 으로 변환
+    const options =
+      typeof optionsOrChunkSize === "number"
+        ? { chunkSize: optionsOrChunkSize }
+        : optionsOrChunkSize;
+
+    return this.upsertOrInsert(wdb, tableName, "upsert", options);
   }
-  async insertOnly(wdb: Knex, tableName: string, chunkSize?: number): Promise<number[]> {
-    return this.upsertOrInsert(wdb, tableName, "insert", chunkSize);
+  async insertOnly(
+    wdb: Knex,
+    tableName: string,
+    optionsOrChunkSize?: UpsertOptions | number,
+  ): Promise<number[]> {
+    const options =
+      typeof optionsOrChunkSize === "number"
+        ? { chunkSize: optionsOrChunkSize }
+        : optionsOrChunkSize;
+
+    return this.upsertOrInsert(wdb, tableName, "insert", options);
   }
 
   async upsertOrInsert(
     wdb: Knex,
     tableName: string,
     mode: "upsert" | "insert",
-    chunkSize?: number,
+    options?: UpsertOptions,
   ): Promise<number[]> {
     if (this.hasTable(tableName) === false) {
       return [];
@@ -244,43 +267,47 @@ export class UpsertBuilder {
       });
 
       // 현재 레벨 upsert
+      const chunkSize = options?.chunkSize;
       const levelChunks = chunkSize ? chunk(resolvedRows, chunkSize) : [resolvedRows];
-      const selectFields = unique(["uuid", "id", ...extractFields]);
+      const selectFields = unique(["id", ...extractFields]);
 
       for (const dataChunk of levelChunks) {
         if (dataChunk.length === 0) continue;
 
-        let resultRows: { uuid: string; id: number; [key: string]: unknown }[];
+        // uuid를 별도로 보관하고, DB에 저장할 데이터에서 제거
+        const originalUuids = dataChunk.map((r) => r.uuid as string);
+        const dataForDb = dataChunk.map(({ uuid, ...rest }) => rest);
 
-        if (mode === "insert") {
-          // INSERT 모드
-          await wdb.insert(dataChunk).into(tableName);
+        let resultRows: { id: number; [key: string]: unknown }[];
 
-          const uuids = dataChunk.map((r) => r.uuid);
-          resultRows = await wdb(tableName)
-            .select(selectFields)
-            .whereIn("uuid", uuids as readonly string[]);
+        if (mode === "insert") {
+          // INSERT 모드 - RETURNING 사용
+          resultRows = await wdb.insert(dataForDb).into(tableName).returning(selectFields);
         } else {
-          // UPSERT 모드: onConflict로 중복 처리
+          // UPSERT 모드 - onConflict 사용
           const conflictColumns = table.uniqueIndexes[0].columns;
-          const updateColumns = Object.keys(dataChunk[0]).filter(
-            (col) => col !== "uuid" && !conflictColumns.includes(col),
+          const updateColumns = Object.keys(dataForDb[0]).filter(
+            (col) => !conflictColumns.includes(col),
           );
 
-          const query = wdb.insert(dataChunk).into(tableName).onConflict(conflictColumns);
+          // updateColumns가 비어있어도 merge()를 사용하여 모든 행이 RETURNING되도록 보장
+          const mergeColumns = updateColumns.length > 0 ? updateColumns : conflictColumns;
 
-          // updateColumns 유무에 따라 ignore/merge 선택하고 RETURNING으로 결과 받기
-          if (updateColumns.length === 0) {
-            resultRows = await query.ignore().returning(selectFields);
-          } else {
-            resultRows = await query.merge(updateColumns).returning(selectFields);
-          }
+          resultRows = await wdb
+            .insert(dataForDb)
+            .into(tableName)
+            .onConflict(conflictColumns)
+            .merge(mergeColumns)
+            .returning(selectFields);
         }
 
-        // 양쪽 모드 공통 처리
-        for (const row of resultRows) {
-          uuidMap.set(row.uuid, row);
-          allIds.push(row.id);
+        if (originalUuids.length !== resultRows.length) {
+          throw new Error(`${tableName}: register/returning 불일치`);
+        }
+
+        for (let i = 0; i < resultRows.length; i++) {
+          uuidMap.set(originalUuids[i], resultRows[i]);
+          allIds.push(resultRows[i].id);
         }
       }
     }
@@ -311,6 +338,38 @@ export class UpsertBuilder {
       });
     }
 
+    if (options?.cleanOrphans) {
+      const cleanOrphans = options.cleanOrphans;
+      const fkColumns = isArray(cleanOrphans) ? cleanOrphans : [cleanOrphans];
+
+      // 현재 register된 레코드들의 FK 값들 추출
+      const fkConditions = fkColumns.map((fkCol) => {
+        const fkValues = [...new Set(table.rows.map((row) => row[fkCol]).filter((v) => v != null))];
+        return { column: fkCol, values: fkValues };
+      });
+
+      // 모든 FK 컬럼에 값이 있는 경우에만 삭제 실행
+      if (fkConditions.every((fc) => fc.values.length > 0)) {
+        let deleteQuery = wdb(tableName);
+
+        // 각 FK 컬럼에 대한 WHERE IN 조건 추가
+        for (const { column, values } of fkConditions) {
+          deleteQuery = deleteQuery.whereIn(column, values);
+        }
+
+        // 방금 upsert한 ID는 제외
+        deleteQuery = deleteQuery.whereNotIn("id", allIds);
+
+        const deletedCount = await deleteQuery.delete();
+
+        Naite.t("puri:ub-clean-orphans", {
+          tableName,
+          cleanOrphans: fkColumns,
+          deletedCount,
+        });
+      }
+    }
+
     // 해당 테이블의 데이터 초기화
     table.rows = [];
     table.references.clear();

package/src/entity/entity.ts

@@ -524,8 +524,8 @@ export class Entity {
       // 일반 prop 처리
       if (key === "") {
         return group.map((propName) => {
-          // uuid 개별 처리
-          if (propName === "uuid") {
+          // FIXME: 이거 나중에 없애야함
+          if (propName === "말도안되는프롭명__이거왜타입처리가꼬여서이러지?") {
             return {
               nodeType: "plain" as const,
               prop: {

package/src/migration/code-generation.ts

@@ -146,15 +146,15 @@ function genIndexDefinition(index: MigrationIndex, table: string) {
   };
 
   if (index.type === "fulltext" && index.parser === "ngram") {
-    const indexName = `${table}_${index.columns.join("_")}_index`;
-    return `await knex.raw(\`ALTER TABLE ${table} ADD FULLTEXT INDEX ${indexName} (${index.columns.join(
+    return `await knex.raw(\`ALTER TABLE ${table} ADD FULLTEXT INDEX ${index.name} (${index.columns.join(
       ", ",
     )}) WITH PARSER ngram\`);`;
   }
 
   return `table.${methodMap[index.type]}([${index.columns
     .map((col) => `'${col}'`)
-    .join(",")}]${index.type === "fulltext" ? ", undefined, 'FULLTEXT'" : ""})`;
+    .join(",")}], '${index.name}'${index.type === "fulltext" ? ", 'FULLTEXT'" : ""}
+  );`;
 }
 
 /**
@@ -309,6 +309,8 @@ async function generateAlterCode_ColumnAndIndexes(
   });
   // Naite.t("migrator:generateAlterCode_ColumnAndIndexes:alterColumnsTo", alterColumnsTo);
 
+  // TODO: 인덱스명 변경된 경우 처리
+
   const lines: string[] = [
     'import { Knex } from "knex";',
     "",
@@ -536,7 +538,7 @@ function genIndexDropDefinition(index: MigrationIndex) {
 
   return `table.drop${methodMap[index.type]}([${index.columns
     .map((columnName) => `'${columnName}'`)
-    .join(",")}])`;
+    .join(",")}], '${index.name}')`;
 }
 
 /**
@@ -723,10 +725,10 @@ export async function generateAlterCode(
          */
 
   const entityIndexes = alphabetical(entitySet.indexes, (a) =>
-    [a.type, ...a.columns.sort((c1, c2) => (c1 > c2 ? 1 : -1))].join("-"),
+    [a.type, ...a.columns].join("-"),
   );
   const dbIndexes = alphabetical(dbSet.indexes, (a) =>
-    [a.type, ...a.columns.sort((c1, c2) => (c1 > c2 ? 1 : -1))].join("-"),
+    [a.type, ...a.columns].join("-"),
   );
 
   const replaceNoActionOnMySQL = (f: MigrationForeign) => {

package/src/migration/migration-set.ts

@@ -88,10 +88,6 @@ export function getMigrationSetFromEntity(entity: Entity): MigrationSetAndJoinTa
         r.joinTables.push({
           table: through.from.split(".")[0],
           indexes: [
-            {
-              type: "unique",
-              columns: ["uuid"],
-            },
             // 조인 테이블에 걸린 인덱스 찾아와서 연결
             ...entity.indexes
               .filter((index) => index.columns.find((col) => col.includes(`${prop.joinTable}.`)))
@@ -113,11 +109,6 @@ export function getMigrationSetFromEntity(entity: Entity): MigrationSetAndJoinTa
                 nullable: false,
               } as MigrationColumn;
             }),
-            {
-              name: "uuid",
-              nullable: true,
-              type: "uuid",
-            },
           ],
           foreigns: fields.map((field) => {
             // 현재 필드가 어떤 테이블에 속하는지 판단
@@ -175,17 +166,6 @@ export function getMigrationSetFromEntity(entity: Entity): MigrationSetAndJoinTa
     index.columns.find((col) => col.includes(".") === false),
   );
 
-  // uuid
-  migrationSet.columns = migrationSet.columns.concat({
-    name: "uuid",
-    nullable: true,
-    type: "uuid",
-  } as MigrationColumn);
-  migrationSet.indexes = migrationSet.indexes.concat({
-    type: "unique",
-    columns: ["uuid"],
-  } as MigrationIndex);
-
   return migrationSet;
 }
 

package/src/migration/migrator.ts

@@ -341,7 +341,7 @@ export class Migrator {
         ...tables[0],
         indexes: unique(
           tables.flatMap((t) => t.indexes),
-          (index) => [index.type, ...index.columns.sort()].join("-"),
+          (index) => [index.type, ...index.columns].join("-"),
         ),
       };
     });

package/src/migration/postgresql-schema-reader.ts

@@ -109,6 +109,7 @@ class PostgreSQLSchemaReaderClass {
 
       return {
         type,
+        name: indexName,
         columns: currentIndexes.map((idx) => idx.column_name),
       };
     });

package/src/shared/web.shared.ts.txt

@@ -86,10 +86,12 @@ export function defaultCatch(e: any) {
 /*
   Isomorphic Types
 */
-export type ListResult<T> = {
-  rows: T[];
-  total?: number;
-};
+export type ListResult<LP extends { queryMode?: SonamuQueryMode }, T> = LP["queryMode"] extends "list"
+  ? { rows: T[] }
+  : LP["queryMode"] extends "count"
+    ? { total: number }
+    : { rows: T[]; total: number };
+
 export const SonamuQueryMode = z.enum(["both", "list", "count"]);
 export type SonamuQueryMode = z.infer<typeof SonamuQueryMode>;
 

package/src/syncer/file-patterns.ts

@@ -30,7 +30,7 @@ export const checksumPatternGroup: GlobPattern<ApiRelativePath> = {
   model: "src/application/**/*.model.ts",
   frame: "src/application/**/*.frame.ts",
   functions: "src/application/**/*.functions.ts",
-  config: "sonamu.config.ts",
+  config: "src/sonamu.config.ts",
 };
 
 /**

package/src/syncer/syncer.ts

@@ -165,7 +165,7 @@ export class Syncer {
       }
 
       // 이건 프로젝트에 .ts 소스 코드 파일을 생성하는 것이므로 src의 .ts 경로로 갑니다.
-      const destPath = path.join(Sonamu.appRootPath, target, "./sonamu.shared.ts");
+      const destPath = path.join(Sonamu.appRootPath, target, "./src/services/sonamu.shared.ts");
 
       // 정말 혹시나지만 target 디렉토리는 있어도 src/services 디렉토리는 없을 수 있으므로 미리 생성해줍니다.
       if (!(await exists(path.dirname(destPath)))) {

package/src/template/implementations/service.template.ts

@@ -85,11 +85,12 @@ export class Template__service extends Template {
             );
 
             // 파라미터 타입 정의
-            const typeParamsDef = api.typeParameters
+            const typeParametersAsTsType = api.typeParameters
               .map((typeParam) => {
                 return apiParamTypeToTsType(typeParam, importKeys);
               })
               .join(", ");
+            const typeParamsDef = typeParametersAsTsType ? `<${typeParametersAsTsType}>` : "";
             typeParamNames = typeParamNames.concat(
               api.typeParameters.map((typeParam) => typeParam.id),
             );

package/src/types/types.ts

@@ -175,7 +175,7 @@ export type EntityProp =
 export type EntityIndex = {
   type: "index" | "unique" | "fulltext";
   columns: string[];
-  name?: string;
+  name: string;
   parser?: "built-in" | "ngram";
 };
 export type EntityJson = {
@@ -451,6 +451,7 @@ export type MigrationColumn = {
   scale?: number;
 };
 export type MigrationIndex = {
+  name: string;
   columns: string[];
   type: "unique" | "index" | "fulltext";
   parser?: "built-in" | "ngram";
@@ -942,7 +943,7 @@ const EntityIndexSchema = z
   .object({
     type: z.enum(["index", "unique", "fulltext"]),
     columns: z.array(z.string()),
-    name: z.string().optional(),
+    name: z.string().min(1).max(63),
     parser: z.enum(["built-in", "ngram"]).optional(),
   })
   .strict();

package/src/utils/model.ts

@@ -1,7 +1,13 @@
-export type ListResult<T> = {
-  rows: T[];
-  total?: number;
-};
+import type { SonamuQueryMode } from "..";
+
+export type ListResult<
+  LP extends { queryMode?: SonamuQueryMode },
+  T,
+> = LP["queryMode"] extends "list"
+  ? { rows: T[] }
+  : LP["queryMode"] extends "count"
+    ? { total: number }
+    : { rows: T[]; total: number };
 
 export type ArrayOr<T> = T | T[];
 

package/src/utils/path-utils.ts

@@ -10,7 +10,7 @@ import { isHotReloadServer, isTest } from "./controller.js";
  *
  * **기준점**: `Sonamu.apiRootPath` (일반적으로 프로젝트의 `/api` 디렉토리)
  */
-export type ApiRelativePath = `${"src" | "dist"}/${string}` | "sonamu.config.ts";
+export type ApiRelativePath = `${"src" | "dist"}/${string}`;
 
 /**
  * 앱 루트 기준 상대 경로 (api/, web/ 등 타겟 디렉토리로 시작)
@@ -90,7 +90,10 @@ export type AbsolutePath = `/${string}`;
  * @param anyPath
  * @returns
  */
-export function runtimePath(anyPath: string, isDev: boolean = isHotReloadServer() || isTest()): string {
+export function runtimePath(
+  anyPath: string,
+  isDev: boolean = isHotReloadServer() || isTest(),
+): string {
   if (isDev) {
     return anyPath.replace(/dist\//, "src/").replace(/\.js/, ".ts");
   } else {