@withwiz/toolkit 0.2.3 → 0.2.4

package/dist/constants/error-codes.d.ts

@@ -105,6 +105,18 @@ export declare const ERROR_CODES: {
         readonly status: 401;
         readonly message: "Invalid email or password.";
     };
+    readonly LINK_PASSWORD_REQUIRED: {
+        readonly code: 40104;
+        readonly key: "LINK_PASSWORD_REQUIRED";
+        readonly status: 401;
+        readonly message: "Link password is required.";
+    };
+    readonly LINK_PASSWORD_INCORRECT: {
+        readonly code: 40105;
+        readonly key: "LINK_PASSWORD_INCORRECT";
+        readonly status: 401;
+        readonly message: "Incorrect link password.";
+    };
     readonly SESSION_EXPIRED: {
         readonly code: 40107;
         readonly key: "SESSION_EXPIRED";
@@ -225,18 +237,6 @@ export declare const ERROR_CODES: {
         readonly status: 422;
         readonly message: "Link is inactive.";
     };
-    readonly LINK_PASSWORD_REQUIRED: {
-        readonly code: 42206;
-        readonly key: "LINK_PASSWORD_REQUIRED";
-        readonly status: 422;
-        readonly message: "Link password is required.";
-    };
-    readonly LINK_PASSWORD_INCORRECT: {
-        readonly code: 42207;
-        readonly key: "LINK_PASSWORD_INCORRECT";
-        readonly status: 422;
-        readonly message: "Incorrect link password.";
-    };
     readonly RESERVED_WORD_USED: {
         readonly code: 42208;
         readonly key: "RESERVED_WORD_USED";
@@ -387,3 +387,10 @@ export declare function getLogLevel(status: number): "debug" | "info" | "warn" |
 export declare function getAllErrorCodes(): IErrorCodeInfo[];
 export declare function getErrorCodesByCategory(category: "validation" | "auth" | "permission" | "resource" | "conflict" | "business" | "rateLimit" | "server" | "security"): IErrorCodeInfo[];
 export declare function formatErrorMessage(code: number, customMessage?: string): string;
+/**
+ * 알 수 없는 Error 인스턴스에서 에러 메시지/코드 패턴을 분석하여
+ * 가장 적합한 에러코드를 반환하는 공통 함수.
+ *
+ * AppError.from(), processError(), resolveErrorCode() 등에서 공유.
+ */
+export declare function classifyError(error: Error): IErrorCodeInfo;

package/dist/constants/error-codes.js

@@ -1,6 +1,7 @@
 import {
   ERROR_CODES,
   HTTP_STATUS,
+  classifyError,
   formatErrorMessage,
   getAllErrorCodes,
   getDefaultErrorMessage,
@@ -10,11 +11,12 @@ import {
   getErrorInfo,
   getHttpStatus,
   getLogLevel
-} from "../chunk-Y3OTJH2S.js";
+} from "../chunk-SNVGJPPX.js";
 import "../chunk-ORMEWXMH.js";
 export {
   ERROR_CODES,
   HTTP_STATUS,
+  classifyError,
   formatErrorMessage,
   getAllErrorCodes,
   getDefaultErrorMessage,

package/dist/constants/index.js

@@ -34,6 +34,7 @@ import {
 import {
   ERROR_CODES,
   HTTP_STATUS,
+  classifyError,
   formatErrorMessage,
   getAllErrorCodes,
   getDefaultErrorMessage,
@@ -43,7 +44,7 @@ import {
   getErrorInfo,
   getHttpStatus,
   getLogLevel
-} from "../chunk-Y3OTJH2S.js";
+} from "../chunk-SNVGJPPX.js";
 import "../chunk-ORMEWXMH.js";
 export {
   API_KEY,
@@ -73,6 +74,7 @@ export {
   TEXT,
   URL,
   USER_INPUT,
+  classifyError,
   formatErrorMessage,
   getAllErrorCodes,
   getDefaultErrorMessage,

package/dist/error/app-error.d.ts

@@ -140,5 +140,6 @@ export declare class AppError extends Error {
     static blockedUrl(url?: string): AppError;
     static suspiciousActivity(): AppError;
     static ipBlocked(ip?: string): AppError;
+    static corsViolation(origin?: string): AppError;
 }
 export default AppError;

package/dist/error/app-error.js

@@ -1,8 +1,8 @@
 import {
   AppError,
   app_error_default
-} from "../chunk-MLGO3HLS.js";
-import "../chunk-Y3OTJH2S.js";
+} from "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
 import "../chunk-ORMEWXMH.js";
 export {
   AppError,

package/dist/error/error-display.d.ts

@@ -2,7 +2,7 @@
  * 프론트엔드 에러 표시 유틸리티
  * Toast 알림, 에러 UI 표시 등
  */
-export { getFriendlyMessage, getErrorDisplayInfo, type IErrorDisplay } from './friendly-messages';
+export { getFriendlyMessage, getErrorDisplayInfo, type IErrorDisplay } from './friendly-messages-v2';
 type TLocale = 'ko' | 'en';
 /**
  * API 에러 응답 인터페이스

package/dist/error/error-display.js

@@ -5,12 +5,16 @@ import {
   getErrorIcon,
   handleApiResponse,
   showFriendlyError
-} from "../chunk-3DZA6AGS.js";
+} from "../chunk-IJCVFLEY.js";
 import {
   getErrorDisplayInfo,
   getFriendlyMessage
-} from "../chunk-2DVWSDST.js";
-import "../chunk-Y3OTJH2S.js";
+} from "../chunk-S54PFAEU.js";
+import "../chunk-Y2JYA2AR.js";
+import "../chunk-HCF3C3AQ.js";
+import "../chunk-IYXMGIEP.js";
+import "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
 import "../chunk-ORMEWXMH.js";
 export {
   extractErrorInfo,

package/dist/error/error-handler.d.ts

@@ -3,6 +3,7 @@
  * API 라우트 및 미들웨어에서 발생하는 모든 에러를 처리
  */
 import { NextRequest, NextResponse } from 'next/server';
+export declare const AUTH_ERROR_CODE_MAP: Record<string, number>;
 /**
  * 에러 응답 형식
  */
@@ -37,12 +38,17 @@ export declare function withErrorHandler<T extends unknown[]>(handler: (request:
 export declare const ErrorResponse: {
     validation: (message?: string, details?: unknown) => NextResponse<IErrorResponse>;
     badRequest: (message?: string) => NextResponse<IErrorResponse>;
+    invalidInput: (message?: string) => NextResponse<IErrorResponse>;
+    missingField: (fieldName: string) => NextResponse<IErrorResponse>;
     invalidUrl: () => NextResponse<IErrorResponse>;
     invalidEmail: () => NextResponse<IErrorResponse>;
+    weakPassword: () => NextResponse<IErrorResponse>;
     invalidAlias: () => NextResponse<IErrorResponse>;
     unauthorized: (message?: string) => NextResponse<IErrorResponse>;
     invalidToken: () => NextResponse<IErrorResponse>;
     tokenExpired: () => NextResponse<IErrorResponse>;
+    linkPasswordRequired: () => NextResponse<IErrorResponse>;
+    linkPasswordIncorrect: () => NextResponse<IErrorResponse>;
     invalidCredentials: () => NextResponse<IErrorResponse>;
     sessionExpired: () => NextResponse<IErrorResponse>;
     forbidden: (message?: string) => NextResponse<IErrorResponse>;
@@ -52,25 +58,39 @@ export declare const ErrorResponse: {
     notFound: (message?: string) => NextResponse<IErrorResponse>;
     userNotFound: () => NextResponse<IErrorResponse>;
     linkNotFound: () => NextResponse<IErrorResponse>;
+    tagNotFound: () => NextResponse<IErrorResponse>;
+    favoriteNotFound: () => NextResponse<IErrorResponse>;
+    groupNotFound: () => NextResponse<IErrorResponse>;
     conflict: (message?: string) => NextResponse<IErrorResponse>;
     duplicate: (resource?: string) => NextResponse<IErrorResponse>;
     emailExists: () => NextResponse<IErrorResponse>;
     aliasExists: () => NextResponse<IErrorResponse>;
     businessRule: (message?: string) => NextResponse<IErrorResponse>;
+    invalidOperation: (message?: string) => NextResponse<IErrorResponse>;
     linkExpired: () => NextResponse<IErrorResponse>;
     linkInactive: () => NextResponse<IErrorResponse>;
-    linkPasswordRequired: () => NextResponse<IErrorResponse>;
-    linkPasswordIncorrect: () => NextResponse<IErrorResponse>;
     reservedWord: () => NextResponse<IErrorResponse>;
     quotaExceeded: () => NextResponse<IErrorResponse>;
+    alreadyFavorited: () => NextResponse<IErrorResponse>;
+    fileTooLarge: (maxSize?: string) => NextResponse<IErrorResponse>;
+    unsupportedFileType: (fileType?: string) => NextResponse<IErrorResponse>;
     rateLimit: () => NextResponse<IErrorResponse>;
     dailyLimit: () => NextResponse<IErrorResponse>;
+    apiQuotaExceeded: () => NextResponse<IErrorResponse>;
     serverError: (message?: string) => NextResponse<IErrorResponse>;
-    databaseError: () => NextResponse<IErrorResponse>;
-    serviceUnavailable: () => NextResponse<IErrorResponse>;
+    internalError: (message?: string) => NextResponse<IErrorResponse>;
+    databaseError: (message?: string) => NextResponse<IErrorResponse>;
+    emailSendFailed: () => NextResponse<IErrorResponse>;
+    cacheError: () => NextResponse<IErrorResponse>;
+    fileUploadFailed: () => NextResponse<IErrorResponse>;
+    serviceUnavailable: (message?: string) => NextResponse<IErrorResponse>;
     externalServiceError: (service?: string) => NextResponse<IErrorResponse>;
-    accessBlocked: () => NextResponse<IErrorResponse>;
-    ipBlocked: () => NextResponse<IErrorResponse>;
+    accessBlocked: (reason?: string) => NextResponse<IErrorResponse>;
+    securityValidationFailed: () => NextResponse<IErrorResponse>;
+    blockedUrl: (url?: string) => NextResponse<IErrorResponse>;
+    suspiciousActivity: () => NextResponse<IErrorResponse>;
+    ipBlocked: (ip?: string) => NextResponse<IErrorResponse>;
+    corsViolation: (origin?: string) => NextResponse<IErrorResponse>;
 };
 declare const _default: {
     errorToResponse: typeof errorToResponse;
@@ -79,12 +99,17 @@ declare const _default: {
     ErrorResponse: {
         validation: (message?: string, details?: unknown) => NextResponse<IErrorResponse>;
         badRequest: (message?: string) => NextResponse<IErrorResponse>;
+        invalidInput: (message?: string) => NextResponse<IErrorResponse>;
+        missingField: (fieldName: string) => NextResponse<IErrorResponse>;
         invalidUrl: () => NextResponse<IErrorResponse>;
         invalidEmail: () => NextResponse<IErrorResponse>;
+        weakPassword: () => NextResponse<IErrorResponse>;
         invalidAlias: () => NextResponse<IErrorResponse>;
         unauthorized: (message?: string) => NextResponse<IErrorResponse>;
         invalidToken: () => NextResponse<IErrorResponse>;
         tokenExpired: () => NextResponse<IErrorResponse>;
+        linkPasswordRequired: () => NextResponse<IErrorResponse>;
+        linkPasswordIncorrect: () => NextResponse<IErrorResponse>;
         invalidCredentials: () => NextResponse<IErrorResponse>;
         sessionExpired: () => NextResponse<IErrorResponse>;
         forbidden: (message?: string) => NextResponse<IErrorResponse>;
@@ -94,25 +119,39 @@ declare const _default: {
         notFound: (message?: string) => NextResponse<IErrorResponse>;
         userNotFound: () => NextResponse<IErrorResponse>;
         linkNotFound: () => NextResponse<IErrorResponse>;
+        tagNotFound: () => NextResponse<IErrorResponse>;
+        favoriteNotFound: () => NextResponse<IErrorResponse>;
+        groupNotFound: () => NextResponse<IErrorResponse>;
         conflict: (message?: string) => NextResponse<IErrorResponse>;
         duplicate: (resource?: string) => NextResponse<IErrorResponse>;
         emailExists: () => NextResponse<IErrorResponse>;
         aliasExists: () => NextResponse<IErrorResponse>;
         businessRule: (message?: string) => NextResponse<IErrorResponse>;
+        invalidOperation: (message?: string) => NextResponse<IErrorResponse>;
         linkExpired: () => NextResponse<IErrorResponse>;
         linkInactive: () => NextResponse<IErrorResponse>;
-        linkPasswordRequired: () => NextResponse<IErrorResponse>;
-        linkPasswordIncorrect: () => NextResponse<IErrorResponse>;
         reservedWord: () => NextResponse<IErrorResponse>;
         quotaExceeded: () => NextResponse<IErrorResponse>;
+        alreadyFavorited: () => NextResponse<IErrorResponse>;
+        fileTooLarge: (maxSize?: string) => NextResponse<IErrorResponse>;
+        unsupportedFileType: (fileType?: string) => NextResponse<IErrorResponse>;
         rateLimit: () => NextResponse<IErrorResponse>;
         dailyLimit: () => NextResponse<IErrorResponse>;
+        apiQuotaExceeded: () => NextResponse<IErrorResponse>;
         serverError: (message?: string) => NextResponse<IErrorResponse>;
-        databaseError: () => NextResponse<IErrorResponse>;
-        serviceUnavailable: () => NextResponse<IErrorResponse>;
+        internalError: (message?: string) => NextResponse<IErrorResponse>;
+        databaseError: (message?: string) => NextResponse<IErrorResponse>;
+        emailSendFailed: () => NextResponse<IErrorResponse>;
+        cacheError: () => NextResponse<IErrorResponse>;
+        fileUploadFailed: () => NextResponse<IErrorResponse>;
+        serviceUnavailable: (message?: string) => NextResponse<IErrorResponse>;
         externalServiceError: (service?: string) => NextResponse<IErrorResponse>;
-        accessBlocked: () => NextResponse<IErrorResponse>;
-        ipBlocked: () => NextResponse<IErrorResponse>;
+        accessBlocked: (reason?: string) => NextResponse<IErrorResponse>;
+        securityValidationFailed: () => NextResponse<IErrorResponse>;
+        blockedUrl: (url?: string) => NextResponse<IErrorResponse>;
+        suspiciousActivity: () => NextResponse<IErrorResponse>;
+        ipBlocked: (ip?: string) => NextResponse<IErrorResponse>;
+        corsViolation: (origin?: string) => NextResponse<IErrorResponse>;
     };
 };
 export default _default;

package/dist/error/error-handler.js

@@ -1,15 +1,18 @@
 import {
+  AUTH_ERROR_CODE_MAP,
   ErrorResponse,
   errorToResponse,
   error_handler_default,
   processError,
   withErrorHandler
-} from "../chunk-GPBOMJSZ.js";
-import "../chunk-MLGO3HLS.js";
-import "../chunk-Y3OTJH2S.js";
+} from "../chunk-WDRDGFHO.js";
+import "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
+import "../chunk-AIH3F7JV.js";
 import "../chunk-EZR55KV2.js";
 import "../chunk-ORMEWXMH.js";
 export {
+  AUTH_ERROR_CODE_MAP,
   ErrorResponse,
   error_handler_default as default,
   errorToResponse,

package/dist/error/friendly-messages-v2.js

@@ -2,11 +2,11 @@ import {
   formatFriendlyError,
   getErrorDisplayInfo,
   getFriendlyMessage
-} from "../chunk-POKGHK3L.js";
-import "../chunk-EEUBKZV4.js";
-import "../chunk-N4YGR5WH.js";
-import "../chunk-KXAWBFJN.js";
-import "../chunk-Y3OTJH2S.js";
+} from "../chunk-S54PFAEU.js";
+import "../chunk-Y2JYA2AR.js";
+import "../chunk-HCF3C3AQ.js";
+import "../chunk-IYXMGIEP.js";
+import "../chunk-SNVGJPPX.js";
 import "../chunk-ORMEWXMH.js";
 export {
   formatFriendlyError,

package/dist/error/friendly-messages.d.ts

@@ -1,4 +1,7 @@
 /**
+ * @deprecated friendly-messages-v2.ts를 사용하세요.
+ * 이 파일은 하위 호환용으로만 유지됩니다. 신규 코드에서 import하지 마세요.
+ *
  * 사용자 친화적 에러 메시지 정의
  * 5자리 HTTP 확장 에러 코드별 프렌들리 메시지
  */

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-WDRDGFHO.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,7 +46,8 @@ import {
   getErrorInfo,
   getHttpStatus,
   getLogLevel
-} from "../chunk-Y3OTJH2S.js";
+} from "../chunk-SNVGJPPX.js";
+import "../chunk-AIH3F7JV.js";
 import "../chunk-EZR55KV2.js";
 import "../chunk-ORMEWXMH.js";
 
@@ -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/middleware/auth.js

@@ -4,10 +4,10 @@ import {
   initializeAuthMiddleware,
   optionalAuthMiddleware,
   setAccessTokenBlacklistChecker
-} from "../chunk-UXQRU3EM.js";
-import "../chunk-MLGO3HLS.js";
-import "../chunk-Y3OTJH2S.js";
-import "../chunk-T3LJYAMO.js";
+} from "../chunk-V4KAPU2S.js";
+import "../chunk-KXXROUA5.js";
+import "../chunk-SNVGJPPX.js";
+import "../chunk-UT4J7NPS.js";
 import "../chunk-AIH3F7JV.js";
 import "../chunk-EZR55KV2.js";
 import "../chunk-ORMEWXMH.js";

package/dist/middleware/error-handler.js

@@ -1,11 +1,13 @@
 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";
+} from "../chunk-QYIUGQ5Q.js";
+import "../chunk-WDRDGFHO.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-EZR55KV2.js";
 import "../chunk-ORMEWXMH.js";
 export {