@withwiz/toolkit 0.2.3 → 0.2.5

package/dist/error/friendly-messages.js

@@ -1,10 +1,118 @@
 import {
-  formatFriendlyError,
-  getErrorDisplayInfo,
-  getFriendlyMessage
-} from "../chunk-2DVWSDST.js";
-import "../chunk-Y3OTJH2S.js";
+  getErrorCategory
+} from "../chunk-SNVGJPPX.js";
 import "../chunk-ORMEWXMH.js";
+
+// src/error/friendly-messages.ts
+var koMessages = {
+  // 검증 (400xx)
+  40001: { title: "\uC785\uB825 \uC815\uBCF4\uB97C \uD655\uC778\uD574 \uC8FC\uC138\uC694", description: "\uC785\uB825\uD558\uC2E0 \uC815\uBCF4 \uC911 \uC77C\uBD80\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uC785\uB825 \uB0B4\uC6A9\uC744 \uB2E4\uC2DC \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
+  40002: { title: "\uC694\uCCAD\uC744 \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC5B4\uC694", description: "\uC694\uCCAD \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uD398\uC774\uC9C0\uB97C \uC0C8\uB85C\uACE0\uCE68\uD574 \uC8FC\uC138\uC694." },
+  40003: { title: "\uC785\uB825\uAC12\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC544\uC694", description: "\uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294 \uD615\uC2DD\uC785\uB2C8\uB2E4.", action: "\uC62C\uBC14\uB978 \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD574 \uC8FC\uC138\uC694." },
+  40004: { title: "\uD544\uC218 \uC815\uBCF4\uAC00 \uBE60\uC84C\uC5B4\uC694", description: "\uD544\uC218 \uD56D\uBAA9\uC774 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.", action: "\uBAA8\uB4E0 \uD544\uC218 \uD56D\uBAA9\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694." },
+  40005: { title: "URL \uD615\uC2DD\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694", description: "https://\uB85C \uC2DC\uC791\uD558\uB294 URL\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694.", action: "\uC608: https://example.com" },
+  40006: { title: "\uC774\uBA54\uC77C \uD615\uC2DD\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694", description: "\uC62C\uBC14\uB978 \uC774\uBA54\uC77C \uC8FC\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4.", action: "\uC608: user@example.com" },
+  40007: { title: "\uB354 \uC548\uC804\uD55C \uBE44\uBC00\uBC88\uD638\uAC00 \uD544\uC694\uD574\uC694", description: "8\uC790 \uC774\uC0C1, \uC601\uBB38/\uC22B\uC790/\uD2B9\uC218\uBB38\uC790 \uD3EC\uD568", action: "\uB354 \uBCF5\uC7A1\uD55C \uBE44\uBC00\uBC88\uD638\uB97C \uC124\uC815\uD574 \uC8FC\uC138\uC694." },
+  40008: { title: "\uBCC4\uCE6D \uD615\uC2DD\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694", description: "\uC601\uBB38, \uC22B\uC790, \uD558\uC774\uD508(-)\uB9CC \uC0AC\uC6A9 \uAC00\uB2A5", action: "\uC608: my-link-123" },
+  // 인증 (401xx)
+  40101: { title: "\uB85C\uADF8\uC778\uC774 \uD544\uC694\uD574\uC694", description: "\uC774 \uAE30\uB2A5\uC740 \uB85C\uADF8\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.", action: "\uB85C\uADF8\uC778 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  40102: { title: "\uC778\uC99D \uC815\uBCF4\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC544\uC694", description: "\uB85C\uADF8\uC778 \uC0C1\uD0DC\uAC00 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uB85C\uADF8\uC778\uD574 \uC8FC\uC138\uC694." },
+  40103: { title: "\uB85C\uADF8\uC778\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC5B4\uC694", description: "\uBCF4\uC548\uC744 \uC704\uD574 \uC138\uC158\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uB85C\uADF8\uC778\uD574 \uC8FC\uC138\uC694." },
+  40106: { title: "\uB85C\uADF8\uC778\uC5D0 \uC2E4\uD328\uD588\uC5B4\uC694", description: "\uC774\uBA54\uC77C \uB610\uB294 \uBE44\uBC00\uBC88\uD638\uAC00 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  40107: { title: "\uC138\uC158\uC774 \uC885\uB8CC\uB418\uC5C8\uC5B4\uC694", description: "\uC790\uB3D9 \uB85C\uADF8\uC544\uC6C3\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uB85C\uADF8\uC778\uD574 \uC8FC\uC138\uC694." },
+  // 권한 (403xx)
+  40304: { title: "\uC811\uADFC \uAD8C\uD55C\uC774 \uC5C6\uC5B4\uC694", description: "\uC774 \uAE30\uB2A5\uC5D0 \uB300\uD55C \uAD8C\uD55C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.", action: "\uAD00\uB9AC\uC790\uC5D0\uAC8C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
+  40305: { title: "\uC774\uBA54\uC77C \uC778\uC99D\uC774 \uD544\uC694\uD574\uC694", description: "\uC774\uBA54\uC77C \uC778\uC99D\uC744 \uBA3C\uC800 \uC644\uB8CC\uD574 \uC8FC\uC138\uC694.", action: "\uBA54\uC77C\uD568\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
+  40308: { title: "\uACC4\uC815\uC774 \uBE44\uD65C\uC131\uD654\uB418\uC5C8\uC5B4\uC694", description: "\uC11C\uBE44\uC2A4\uB97C \uC774\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", action: "\uACE0\uAC1D\uC13C\uD130\uB85C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
+  40309: { title: "\uACC4\uC815\uC774 \uC7A0\uAE08\uB418\uC5C8\uC5B4\uC694", description: "\uB85C\uADF8\uC778 \uC2E4\uD328\uB85C \uACC4\uC815\uC774 \uC7A0\uACBC\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  // 리소스 (404xx)
+  40401: { title: "\uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uC694\uCCAD\uD558\uC2E0 \uD56D\uBAA9\uC774 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uC8FC\uC18C\uB97C \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
+  40402: { title: "\uC0AC\uC6A9\uC790\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uD574\uB2F9 \uC0AC\uC6A9\uC790\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." },
+  40403: { title: "\uB9C1\uD06C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uB2E8\uCD95 \uB9C1\uD06C\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uB9C1\uD06C \uC8FC\uC18C\uB97C \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
+  40408: { title: "\uD0DC\uADF8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uD0DC\uADF8\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." },
+  40409: { title: "\uC990\uACA8\uCC3E\uAE30\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uD56D\uBAA9\uC774 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." },
+  40410: { title: "\uADF8\uB8F9\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uADF8\uB8F9\uC774 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." },
+  // 충돌 (409xx)
+  40904: { title: "\uCDA9\uB3CC\uC774 \uBC1C\uC0DD\uD588\uC5B4\uC694", description: "\uAE30\uC874 \uB370\uC774\uD130\uC640 \uCDA9\uB3CC\uD569\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  40905: { title: "\uC774\uBBF8 \uC874\uC7AC\uD574\uC694", description: "\uB3D9\uC77C\uD55C \uD56D\uBAA9\uC774 \uC788\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uB978 \uAC12\uC744 \uC0AC\uC6A9\uD574 \uC8FC\uC138\uC694." },
+  40906: { title: "\uC774\uBBF8 \uB4F1\uB85D\uB41C \uC774\uBA54\uC77C\uC774\uC5D0\uC694", description: "\uB2E4\uB978 \uACC4\uC815\uC5D0\uC11C \uC0AC\uC6A9 \uC911\uC785\uB2C8\uB2E4.", action: "\uB2E4\uB978 \uC774\uBA54\uC77C\uC744 \uC0AC\uC6A9\uD574 \uC8FC\uC138\uC694." },
+  40907: { title: "\uC774\uBBF8 \uC0AC\uC6A9 \uC911\uC778 \uBCC4\uCE6D\uC774\uC5D0\uC694", description: "\uB2E4\uB978 \uB9C1\uD06C\uC5D0\uC11C \uC0AC\uC6A9 \uC911\uC785\uB2C8\uB2E4.", action: "\uB2E4\uB978 \uBCC4\uCE6D\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694." },
+  // 비즈니스 (422xx)
+  42201: { title: "\uCC98\uB9AC\uD560 \uC218 \uC5C6\uC5B4\uC694", description: "\uD604\uC7AC \uC0C1\uD0DC\uC5D0\uC11C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", action: "\uC870\uAC74\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
+  42202: { title: "\uC9C0\uAE08\uC740 \uD560 \uC218 \uC5C6\uB294 \uC791\uC5C5\uC774\uC5D0\uC694", description: "\uD604\uC7AC \uC0C1\uD0DC\uC5D0\uC11C \uBD88\uAC00\uB2A5\uD569\uB2C8\uB2E4." },
+  42203: { title: "\uC0AC\uC6A9\uB7C9\uC744 \uCD08\uACFC\uD588\uC5B4\uC694", description: "\uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.", action: "\uD50C\uB79C \uC5C5\uADF8\uB808\uC774\uB4DC\uB97C \uACE0\uB824\uD574 \uC8FC\uC138\uC694." },
+  42204: { title: "\uB9CC\uB8CC\uB41C \uB9C1\uD06C\uC608\uC694", description: "\uC720\uD6A8 \uAE30\uAC04\uC774 \uC9C0\uB0AC\uC2B5\uB2C8\uB2E4.", action: "\uC0C8 \uB9C1\uD06C\uB97C \uC0DD\uC131\uD574 \uC8FC\uC138\uC694." },
+  42205: { title: "\uBE44\uD65C\uC131\uD654\uB41C \uB9C1\uD06C\uC608\uC694", description: "\uC0AC\uC6A9\uC774 \uC911\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uC18C\uC720\uC790\uC5D0\uAC8C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
+  // 42206, 42207: 401xx로 이동 (40104, 40105)
+  40104: { title: "\uBE44\uBC00\uBC88\uD638\uAC00 \uD544\uC694\uD574\uC694", description: "\uBE44\uBC00\uBC88\uD638\uB97C \uC785\uB825\uD574\uC57C \uD569\uB2C8\uB2E4.", action: "\uBE44\uBC00\uBC88\uD638\uB97C \uC785\uB825\uD574 \uC8FC\uC138\uC694." },
+  40105: { title: "\uBE44\uBC00\uBC88\uD638\uAC00 \uD2C0\uB838\uC5B4\uC694", description: "\uBE44\uBC00\uBC88\uD638\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
+  42208: { title: "\uC0AC\uC6A9\uD560 \uC218 \uC5C6\uB294 \uBCC4\uCE6D\uC774\uC5D0\uC694", description: "\uC2DC\uC2A4\uD15C \uC608\uC57D\uC5B4\uC785\uB2C8\uB2E4.", action: "\uB2E4\uB978 \uBCC4\uCE6D\uC744 \uC120\uD0DD\uD574 \uC8FC\uC138\uC694." },
+  42209: { title: "\uC774\uBBF8 \uC990\uACA8\uCC3E\uAE30\uC5D0 \uC788\uC5B4\uC694", description: "\uC774\uBBF8 \uCD94\uAC00\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4." },
+  42210: { title: "\uC0AD\uC81C\uD560 \uC218 \uC5C6\uC5B4\uC694", description: "\uBCF8\uC778 \uAD00\uB9AC\uC790 \uACC4\uC815\uC740 \uC0AD\uC81C \uBD88\uAC00\uD569\uB2C8\uB2E4." },
+  42211: { title: "\uD30C\uC77C\uC774 \uB108\uBB34 \uCEE4\uC694", description: "\uCD5C\uB300 \uD06C\uAE30\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC791\uC740 \uD30C\uC77C\uC744 \uC120\uD0DD\uD574 \uC8FC\uC138\uC694." },
+  42212: { title: "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD30C\uC77C \uD615\uC2DD\uC774\uC5D0\uC694", description: "\uC5C5\uB85C\uB4DC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", action: "\uC9C0\uC6D0 \uD615\uC2DD\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
+  // Rate Limit (429xx)
+  42901: { title: "\uC7A0\uC2DC \uC26C\uC5B4\uAC00\uC138\uC694", description: "\uC694\uCCAD\uC774 \uB108\uBB34 \uB9CE\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  42902: { title: "\uC624\uB298 \uC0AC\uC6A9\uB7C9\uC744 \uBAA8\uB450 \uC0AC\uC6A9\uD588\uC5B4\uC694", description: "\uC77C\uC77C \uD55C\uB3C4\uC5D0 \uB3C4\uB2EC\uD588\uC2B5\uB2C8\uB2E4.", action: "\uB0B4\uC77C \uB2E4\uC2DC \uC774\uC6A9\uD574 \uC8FC\uC138\uC694." },
+  42903: { title: "API \uD560\uB2F9\uB7C9\uC744 \uCD08\uACFC\uD588\uC5B4\uC694", description: "API \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.", action: "\uD50C\uB79C \uC5C5\uADF8\uB808\uC774\uB4DC\uB97C \uACE0\uB824\uD574 \uC8FC\uC138\uC694." },
+  // 서버 (500xx)
+  50001: { title: "\uBB38\uC81C\uAC00 \uBC1C\uC0DD\uD588\uC5B4\uC694", description: "\uC11C\uBC84 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  50002: { title: "\uC77C\uC2DC\uC801\uC778 \uC624\uB958\uC608\uC694", description: "\uACE7 \uBCF5\uAD6C\uB429\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  50003: { title: "\uB370\uC774\uD130 \uCC98\uB9AC \uC624\uB958\uC608\uC694", description: "\uB370\uC774\uD130 \uCC98\uB9AC \uC911 \uBB38\uC81C\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  50006: { title: "\uC774\uBA54\uC77C\uC744 \uBCF4\uB0B4\uC9C0 \uBABB\uD588\uC5B4\uC694", description: "\uC774\uBA54\uC77C \uC804\uC1A1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  50007: { title: "\uC77C\uC2DC\uC801\uC778 \uC624\uB958\uC608\uC694", description: "\uCE90\uC2DC \uCC98\uB9AC \uC911 \uBB38\uC81C\uAC00 \uC788\uC2B5\uB2C8\uB2E4.", action: "\uD398\uC774\uC9C0\uB97C \uC0C8\uB85C\uACE0\uCE68\uD574 \uC8FC\uC138\uC694." },
+  50008: { title: "\uD30C\uC77C \uC5C5\uB85C\uB4DC\uC5D0 \uC2E4\uD328\uD588\uC5B4\uC694", description: "\uD30C\uC77C \uC800\uC7A5 \uC911 \uBB38\uC81C\uAC00 \uC788\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  // 서비스 불가 (503xx)
+  50304: { title: "\uC678\uBD80 \uC11C\uBE44\uC2A4 \uC5F0\uACB0 \uC2E4\uD328", description: "\uC678\uBD80 \uC11C\uBE44\uC2A4\uAC00 \uC751\uB2F5\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  50305: { title: "\uC11C\uBE44\uC2A4 \uC810\uAC80 \uC911\uC774\uC5D0\uC694", description: "\uC810\uAC80 \uC911\uC785\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uBC29\uBB38\uD574 \uC8FC\uC138\uC694." },
+  // 보안 (403xx - 71~79)
+  40371: { title: "\uC811\uADFC\uC774 \uCC28\uB2E8\uB418\uC5C8\uC5B4\uC694", description: "\uBCF4\uC548 \uC815\uCC45\uC73C\uB85C \uCC28\uB2E8\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uC815\uC0C1\uC801\uC778 \uBC29\uBC95\uC73C\uB85C \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  40372: { title: "\uBCF4\uC548 \uAC80\uC99D \uC2E4\uD328", description: "\uBCF4\uC548 \uD1A0\uD070\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uD398\uC774\uC9C0\uB97C \uC0C8\uB85C\uACE0\uCE68\uD574 \uC8FC\uC138\uC694." },
+  40373: { title: "\uC0AC\uC6A9\uD560 \uC218 \uC5C6\uB294 URL\uC774\uC5D0\uC694", description: "\uBCF4\uC548\uC0C1 \uCC28\uB2E8\uB41C URL\uC785\uB2C8\uB2E4.", action: "\uB2E4\uB978 URL\uC744 \uC0AC\uC6A9\uD574 \uC8FC\uC138\uC694." },
+  40374: { title: "\uBE44\uC815\uC0C1 \uD65C\uB3D9 \uAC10\uC9C0", description: "\uC77C\uC2DC\uC801\uC73C\uB85C \uC81C\uD55C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uACE0\uAC1D\uC13C\uD130\uB85C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
+  40375: { title: "IP\uAC00 \uCC28\uB2E8\uB418\uC5C8\uC5B4\uC694", description: "\uBCF4\uC548 \uC815\uCC45\uC5D0 \uC758\uD574 \uCC28\uB2E8\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uACE0\uAC1D\uC13C\uD130\uB85C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
+  40376: { title: "CORS \uC815\uCC45 \uC704\uBC18\uC774\uC5D0\uC694", description: "\uD5C8\uC6A9\uB418\uC9C0 \uC54A\uC740 \uCD9C\uCC98\uC5D0\uC11C\uC758 \uC694\uCCAD\uC785\uB2C8\uB2E4.", action: "\uC62C\uBC14\uB978 \uC8FC\uC18C\uB85C \uC811\uC18D\uD574 \uC8FC\uC138\uC694." }
+};
+var defaultMessages = {
+  ko: { title: "\uBB38\uC81C\uAC00 \uBC1C\uC0DD\uD588\uC5B4\uC694", description: "\uC608\uC0C1\uCE58 \uBABB\uD55C \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
+  en: { title: "Something went wrong", description: "An unexpected error occurred.", action: "Please try again later." }
+};
+var categoryIcons = {
+  validation: "\u26A0\uFE0F",
+  auth: "\u{1F510}",
+  permission: "\u{1F6AB}",
+  resource: "\u{1F50D}",
+  conflict: "\u26A1",
+  business: "\u{1F4CB}",
+  rateLimit: "\u23F1\uFE0F",
+  server: "\u{1F527}",
+  security: "\u{1F6E1}\uFE0F",
+  unknown: "\u274C"
+};
+var categorySeverity = {
+  validation: "warning",
+  auth: "warning",
+  permission: "warning",
+  resource: "info",
+  conflict: "warning",
+  business: "warning",
+  rateLimit: "warning",
+  server: "error",
+  security: "critical",
+  unknown: "error"
+};
+function getFriendlyMessage(code, locale = "ko") {
+  return koMessages[code] || defaultMessages[locale];
+}
+function getErrorDisplayInfo(code, locale = "ko") {
+  const message = getFriendlyMessage(code, locale);
+  const category = getErrorCategory(code);
+  return { code, title: message.title, description: message.description, action: message.action, icon: categoryIcons[category], severity: categorySeverity[category] };
+}
+function formatFriendlyError(code, locale = "ko") {
+  const { title, description } = getFriendlyMessage(code, locale);
+  return `${title} - ${description} [${code}]`;
+}
 export {
   formatFriendlyError,
   getErrorDisplayInfo,

package/dist/error/index.js

@@ -2,42 +2,41 @@ import {
   LocaleDetector
 } from "../chunk-XHZ5L4FO.js";
 import {
+  AUTH_ERROR_CODE_MAP,
   ErrorResponse,
   errorToResponse,
   processError,
   withErrorHandler
-} from "../chunk-GPBOMJSZ.js";
+} from "../chunk-JVDJKMEF.js";
+import {
+  extractErrorInfo,
+  formatInlineError,
+  getDefaultErrorCode,
+  getErrorIcon,
+  handleApiResponse,
+  showFriendlyError
+} from "../chunk-IJCVFLEY.js";
 import {
   formatFriendlyError,
-  getErrorDisplayInfo as getErrorDisplayInfo2,
+  getErrorDisplayInfo,
   getFriendlyMessage
-} from "../chunk-POKGHK3L.js";
+} from "../chunk-S54PFAEU.js";
 import {
   getAllMessages,
   getErrorMessage,
   hasMessage,
   isLocaleSupported,
   supportedLocales
-} from "../chunk-EEUBKZV4.js";
-import "../chunk-N4YGR5WH.js";
-import "../chunk-KXAWBFJN.js";
+} from "../chunk-Y2JYA2AR.js";
+import "../chunk-HCF3C3AQ.js";
+import "../chunk-IYXMGIEP.js";
 import {
   AppError
-} from "../chunk-MLGO3HLS.js";
-import {
-  extractErrorInfo,
-  formatInlineError,
-  getDefaultErrorCode,
-  getErrorIcon,
-  handleApiResponse,
-  showFriendlyError
-} from "../chunk-3DZA6AGS.js";
-import {
-  getErrorDisplayInfo
-} from "../chunk-2DVWSDST.js";
+} from "../chunk-KXXROUA5.js";
 import {
   ERROR_CODES,
   HTTP_STATUS,
+  classifyError,
   formatErrorMessage,
   getAllErrorCodes,
   getDefaultErrorMessage,
@@ -47,8 +46,9 @@ import {
   getErrorInfo,
   getHttpStatus,
   getLogLevel
-} from "../chunk-Y3OTJH2S.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-SNVGJPPX.js";
+import "../chunk-AIH3F7JV.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 
 // src/error/ErrorBoundary.tsx
@@ -184,6 +184,7 @@ function InlineError({
   ] });
 }
 export {
+  AUTH_ERROR_CODE_MAP,
   AppError,
   ERROR_CODES,
   ErrorBoundary,
@@ -192,6 +193,7 @@ export {
   HTTP_STATUS,
   InlineError,
   LocaleDetector,
+  classifyError,
   errorToResponse,
   extractErrorInfo,
   formatErrorMessage,
@@ -204,7 +206,7 @@ export {
   getErrorByCode,
   getErrorCategory,
   getErrorCodesByCategory,
-  getErrorDisplayInfo2 as getErrorDisplayInfo,
+  getErrorDisplayInfo,
   getErrorIcon,
   getErrorInfo,
   getErrorMessage,

package/dist/error/messages/en.js

@@ -1,6 +1,6 @@
 import {
   enMessages
-} from "../../chunk-N4YGR5WH.js";
+} from "../../chunk-HCF3C3AQ.js";
 import "../../chunk-ORMEWXMH.js";
 export {
   enMessages

package/dist/error/messages/index.js

@@ -4,9 +4,9 @@ import {
   hasMessage,
   isLocaleSupported,
   supportedLocales
-} from "../../chunk-EEUBKZV4.js";
-import "../../chunk-N4YGR5WH.js";
-import "../../chunk-KXAWBFJN.js";
+} from "../../chunk-Y2JYA2AR.js";
+import "../../chunk-HCF3C3AQ.js";
+import "../../chunk-IYXMGIEP.js";
 import "../../chunk-ORMEWXMH.js";
 export {
   getAllMessages,

package/dist/error/messages/ko.js

@@ -1,6 +1,6 @@
 import {
   koMessages
-} from "../../chunk-KXAWBFJN.js";
+} from "../../chunk-IYXMGIEP.js";
 import "../../chunk-ORMEWXMH.js";
 export {
   koMessages

package/dist/geolocation/batch-processor.js

@@ -1,8 +1,8 @@
 import {
   BatchProcessor,
   createBatchProcessor
-} from "../chunk-TZAP5T4N.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-T7J2OS63.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   BatchProcessor,

package/dist/geolocation/index.js

@@ -20,8 +20,8 @@ import {
 import {
   BatchProcessor,
   createBatchProcessor
-} from "../chunk-TZAP5T4N.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-T7J2OS63.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   BaseGeoIPProvider,

package/dist/logger/logger.js

@@ -5,7 +5,7 @@ import {
   logError,
   logInfo,
   logger
-} from "../chunk-EZR55KV2.js";
+} from "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   logApiRequest,

package/dist/middleware/auth.js

@@ -4,12 +4,12 @@ import {
   initializeAuthMiddleware,
   optionalAuthMiddleware,
   setAccessTokenBlacklistChecker
-} from "../chunk-UXQRU3EM.js";
-import "../chunk-MLGO3HLS.js";
-import "../chunk-Y3OTJH2S.js";
-import "../chunk-T3LJYAMO.js";
+} from "../chunk-MNORDAW2.js";
+import "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
+import "../chunk-2ATBAIRL.js";
 import "../chunk-AIH3F7JV.js";
-import "../chunk-EZR55KV2.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   adminMiddleware,

package/dist/middleware/cors.d.ts

@@ -5,11 +5,40 @@
  */
 import type { TApiMiddleware } from './types';
 /**
- * CORS 미들웨어
+ * CORS 미들웨어 설정
+ */
+export interface CorsMiddlewareConfig {
+    /** 허용할 Origin 목록 (예: ['https://example.com', 'https://app.example.com']) */
+    allowedOrigins: string[];
+    /** 크레덴셜 허용 여부 (기본값: true) */
+    allowCredentials?: boolean;
+    /** 허용할 HTTP 메서드 (기본값: GET, POST, PUT, DELETE, PATCH, OPTIONS) */
+    allowedMethods?: string;
+    /** 허용할 헤더 (기본값: Content-Type, Authorization, X-Requested-With, X-API-Key) */
+    allowedHeaders?: string;
+    /** preflight 캐시 시간(초) (기본값: 86400 = 24시간) */
+    maxAge?: number;
+}
+/**
+ * CORS 미들웨어 팩토리
+ *
+ * 설정 기반으로 CORS 미들웨어를 생성합니다.
+ *
+ * @example
+ * ```typescript
+ * const cors = createCorsMiddleware({
+ *   allowedOrigins: ['https://example.com', 'https://app.example.com'],
+ * });
+ * ```
+ */
+export declare function createCorsMiddleware(config: CorsMiddlewareConfig): TApiMiddleware;
+/**
+ * 기본 CORS 미들웨어 (환경변수 기반)
+ *
+ * ALLOWED_ORIGINS 환경변수에서 콤마 구분 Origin 목록을 읽습니다.
+ * 설정이 없으면 빈 배열(모든 Origin 차단)을 사용합니다.
  *
- * - Origin 검증 및 CORS 헤더 설정
- * - OPTIONS preflight 요청 처리
- * - 크레덴셜 허용 설정
+ * @deprecated createCorsMiddleware()를 사용하여 명시적으로 설정하세요.
  */
 export declare const corsMiddleware: TApiMiddleware;
 /**
@@ -17,14 +46,18 @@ export declare const corsMiddleware: TApiMiddleware;
  *
  * instrumentation.ts에서 서버 시작 시 호출하여 CORS 설정을 검증하고 로그를 출력합니다.
  *
+ * @param config - 검증할 CORS 설정 (생략 시 환경변수 기반)
+ *
  * @example
  * ```typescript
  * // instrumentation.ts
  * import { validateCorsConfiguration } from '@withwiz/middleware/cors';
  *
  * export async function register() {
- *   validateCorsConfiguration();
+ *   validateCorsConfiguration({
+ *     allowedOrigins: ['https://example.com'],
+ *   });
  * }
  * ```
  */
-export declare function validateCorsConfiguration(): void;
+export declare function validateCorsConfiguration(config?: Pick<CorsMiddlewareConfig, 'allowedOrigins'>): void;

package/dist/middleware/cors.js

@@ -1,10 +1,12 @@
 import {
   corsMiddleware,
+  createCorsMiddleware,
   validateCorsConfiguration
-} from "../chunk-FOKAATUQ.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-ELD6UH57.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   corsMiddleware,
+  createCorsMiddleware,
   validateCorsConfiguration
 };

package/dist/middleware/error-handler.js

@@ -1,12 +1,14 @@
 import {
   errorHandlerMiddleware
-} from "../chunk-TMVS4F7E.js";
-import "../chunk-EEUBKZV4.js";
-import "../chunk-N4YGR5WH.js";
-import "../chunk-KXAWBFJN.js";
-import "../chunk-MLGO3HLS.js";
-import "../chunk-Y3OTJH2S.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-7T6EAU4I.js";
+import "../chunk-JVDJKMEF.js";
+import "../chunk-Y2JYA2AR.js";
+import "../chunk-HCF3C3AQ.js";
+import "../chunk-IYXMGIEP.js";
+import "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
+import "../chunk-AIH3F7JV.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   errorHandlerMiddleware

package/dist/middleware/index.js

@@ -4,48 +4,49 @@ import {
   withCustomApi,
   withOptionalAuthApi,
   withPublicApi
-} from "../chunk-SLG26KHZ.js";
+} from "../chunk-PDQCJR4E.js";
+import {
+  initRequestMiddleware
+} from "../chunk-62Q7DN5G.js";
 import {
   MiddlewareChain
-} from "../chunk-4ODT3Q4A.js";
+} from "../chunk-YGZBEEW2.js";
 import {
   createRateLimitMiddleware,
   rateLimitMiddleware,
   setRateLimitAdapter
-} from "../chunk-H5I5GWAA.js";
+} from "../chunk-UZDNS7TE.js";
 import {
   responseLoggerMiddleware
-} from "../chunk-KAWVMIRJ.js";
+} from "../chunk-GJGLG2MN.js";
 import {
   securityMiddleware,
   validateSecurityConfiguration
-} from "../chunk-WSQMXMTL.js";
+} from "../chunk-SKCYXBDR.js";
 import {
   adminMiddleware,
   authMiddleware,
   initializeAuthMiddleware,
   optionalAuthMiddleware,
   setAccessTokenBlacklistChecker
-} from "../chunk-UXQRU3EM.js";
+} from "../chunk-MNORDAW2.js";
 import {
   corsMiddleware,
   validateCorsConfiguration
-} from "../chunk-FOKAATUQ.js";
+} from "../chunk-ELD6UH57.js";
 import {
   errorHandlerMiddleware
-} from "../chunk-TMVS4F7E.js";
-import {
-  initRequestMiddleware
-} from "../chunk-62Q7DN5G.js";
+} from "../chunk-7T6EAU4I.js";
 import "../chunk-XHZ5L4FO.js";
-import "../chunk-EEUBKZV4.js";
-import "../chunk-N4YGR5WH.js";
-import "../chunk-KXAWBFJN.js";
-import "../chunk-MLGO3HLS.js";
-import "../chunk-Y3OTJH2S.js";
-import "../chunk-T3LJYAMO.js";
+import "../chunk-JVDJKMEF.js";
+import "../chunk-Y2JYA2AR.js";
+import "../chunk-HCF3C3AQ.js";
+import "../chunk-IYXMGIEP.js";
+import "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
+import "../chunk-2ATBAIRL.js";
 import "../chunk-AIH3F7JV.js";
-import "../chunk-EZR55KV2.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   MiddlewareChain,

package/dist/middleware/middleware-chain.js

@@ -1,7 +1,7 @@
 import {
   MiddlewareChain
-} from "../chunk-4ODT3Q4A.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-YGZBEEW2.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   MiddlewareChain

package/dist/middleware/rate-limit.js

@@ -2,10 +2,10 @@ import {
   createRateLimitMiddleware,
   rateLimitMiddleware,
   setRateLimitAdapter
-} from "../chunk-H5I5GWAA.js";
-import "../chunk-MLGO3HLS.js";
-import "../chunk-Y3OTJH2S.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-UZDNS7TE.js";
+import "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   createRateLimitMiddleware,

package/dist/middleware/response-logger.js

@@ -1,7 +1,7 @@
 import {
   responseLoggerMiddleware
-} from "../chunk-KAWVMIRJ.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-GJGLG2MN.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   responseLoggerMiddleware

package/dist/middleware/security.js

@@ -1,7 +1,8 @@
 import {
   securityMiddleware,
   validateSecurityConfiguration
-} from "../chunk-WSQMXMTL.js";
+} from "../chunk-SKCYXBDR.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   securityMiddleware,

package/dist/middleware/wrappers.js

@@ -4,24 +4,25 @@ import {
   withCustomApi,
   withOptionalAuthApi,
   withPublicApi
-} from "../chunk-SLG26KHZ.js";
-import "../chunk-4ODT3Q4A.js";
-import "../chunk-H5I5GWAA.js";
-import "../chunk-KAWVMIRJ.js";
-import "../chunk-WSQMXMTL.js";
-import "../chunk-UXQRU3EM.js";
-import "../chunk-FOKAATUQ.js";
-import "../chunk-TMVS4F7E.js";
+} from "../chunk-PDQCJR4E.js";
 import "../chunk-62Q7DN5G.js";
+import "../chunk-YGZBEEW2.js";
+import "../chunk-UZDNS7TE.js";
+import "../chunk-GJGLG2MN.js";
+import "../chunk-SKCYXBDR.js";
+import "../chunk-MNORDAW2.js";
+import "../chunk-ELD6UH57.js";
+import "../chunk-7T6EAU4I.js";
 import "../chunk-XHZ5L4FO.js";
-import "../chunk-EEUBKZV4.js";
-import "../chunk-N4YGR5WH.js";
-import "../chunk-KXAWBFJN.js";
-import "../chunk-MLGO3HLS.js";
-import "../chunk-Y3OTJH2S.js";
-import "../chunk-T3LJYAMO.js";
+import "../chunk-JVDJKMEF.js";
+import "../chunk-Y2JYA2AR.js";
+import "../chunk-HCF3C3AQ.js";
+import "../chunk-IYXMGIEP.js";
+import "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
+import "../chunk-2ATBAIRL.js";
 import "../chunk-AIH3F7JV.js";
-import "../chunk-EZR55KV2.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   withAdminApi,

package/dist/storage/r2-storage.js

@@ -1,3 +1,7 @@
+import {
+  AppError
+} from "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
 import "../chunk-ORMEWXMH.js";
 
 // src/storage/r2-storage.ts
@@ -44,7 +48,7 @@ async function uploadToR2(key, body, contentType) {
   const client = getClient();
   const config = getConfig();
   if (!client || !config) {
-    throw new Error("R2 storage is not configured");
+    throw AppError.serviceUnavailable("R2 storage is not configured");
   }
   await client.send(
     new PutObjectCommand({
@@ -65,7 +69,7 @@ async function deleteFromR2(key) {
   const client = getClient();
   const config = getConfig();
   if (!client || !config) {
-    throw new Error("R2 storage is not configured");
+    throw AppError.serviceUnavailable("R2 storage is not configured");
   }
   await client.send(
     new DeleteObjectCommand({
@@ -78,7 +82,7 @@ async function getFromR2(key) {
   const client = getClient();
   const config = getConfig();
   if (!client || !config) {
-    throw new Error("R2 storage is not configured");
+    throw AppError.serviceUnavailable("R2 storage is not configured");
   }
   try {
     const response = await client.send(

package/dist/system/cpu.js

@@ -1,8 +1,8 @@
 import {
   getCpuInfo
-} from "../chunk-L76O3X3D.js";
-import "../chunk-KWTBD4CM.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-WVPCER6E.js";
+import "../chunk-P62T7AWY.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   getCpuInfo

package/dist/system/disk.js

@@ -1,8 +1,8 @@
 import {
   getDiskInfo
-} from "../chunk-4DPSCTX4.js";
-import "../chunk-KWTBD4CM.js";
-import "../chunk-EZR55KV2.js";
+} from "../chunk-HC7574TB.js";
+import "../chunk-P62T7AWY.js";
+import "../chunk-HJIKCR6I.js";
 import "../chunk-ORMEWXMH.js";
 export {
   getDiskInfo