@withwiz/toolkit 0.1.0

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

@@ -0,0 +1,55 @@
+/**
+ * 프론트엔드 에러 표시 유틸리티
+ * Toast 알림, 에러 UI 표시 등
+ */
+export { getFriendlyMessage, getErrorDisplayInfo, type IErrorDisplay } from './friendly-messages';
+type TLocale = 'ko' | 'en';
+/**
+ * API 에러 응답 인터페이스
+ */
+export interface IApiErrorResponse {
+    success: false;
+    error: {
+        code: number;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * 에러 코드로 친화적 토스트 표시
+ */
+export declare function showFriendlyError(errorOrCode: number | IApiErrorResponse | Error, options?: {
+    locale?: TLocale;
+    duration?: number;
+    showCode?: boolean;
+    onAuthError?: () => void;
+    onRateLimitError?: () => void;
+}): void;
+/**
+ * API 응답에서 에러 처리
+ */
+export declare function handleApiResponse<T>(response: Response, options?: {
+    showToast?: boolean;
+    locale?: TLocale;
+    onAuthError?: () => void;
+}): Promise<T>;
+/**
+ * 에러 메시지 포맷 (인라인 표시용)
+ */
+export declare function formatInlineError(code: number, locale?: TLocale): string;
+/**
+ * 에러 아이콘 가져오기
+ */
+export declare function getErrorIcon(code: number): string;
+/**
+ * HTTP 상태 코드에서 기본 에러 코드 가져오기
+ */
+export declare function getDefaultErrorCode(status: number): number;
+/**
+ * 에러 바운더리용 에러 정보 추출
+ */
+export declare function extractErrorInfo(error: Error | unknown): {
+    code: number;
+    message: string;
+    stack?: string;
+};

package/dist/error/error-display.js

@@ -0,0 +1,24 @@
+import {
+  extractErrorInfo,
+  formatInlineError,
+  getDefaultErrorCode,
+  getErrorIcon,
+  handleApiResponse,
+  showFriendlyError
+} from "../chunk-3DZA6AGS.js";
+import {
+  getErrorDisplayInfo,
+  getFriendlyMessage
+} from "../chunk-2DVWSDST.js";
+import "../chunk-Y3OTJH2S.js";
+import "../chunk-ORMEWXMH.js";
+export {
+  extractErrorInfo,
+  formatInlineError,
+  getDefaultErrorCode,
+  getErrorDisplayInfo,
+  getErrorIcon,
+  getFriendlyMessage,
+  handleApiResponse,
+  showFriendlyError
+};

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

@@ -0,0 +1,118 @@
+/**
+ * 통합 에러 핸들러
+ * API 라우트 및 미들웨어에서 발생하는 모든 에러를 처리
+ */
+import { NextRequest, NextResponse } from 'next/server';
+/**
+ * 에러 응답 형식
+ */
+export interface IErrorResponse {
+    success: false;
+    error: {
+        code: number;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * 에러를 NextResponse로 변환
+ */
+export declare function errorToResponse(error: unknown, requestPath?: string): NextResponse<IErrorResponse>;
+/**
+ * 에러 처리 및 표준화
+ */
+export declare function processError(error: unknown): {
+    code: number;
+    message: string;
+    status: number;
+    details?: unknown;
+};
+/**
+ * 에러 핸들링 미들웨어 래퍼
+ */
+export declare function withErrorHandler<T extends unknown[]>(handler: (request: NextRequest, ...args: T) => Promise<NextResponse>): (request: NextRequest, ...args: T) => Promise<NextResponse>;
+/**
+ * 에러 응답 생성 유틸리티
+ */
+export declare const ErrorResponse: {
+    validation: (message?: string, details?: unknown) => NextResponse<IErrorResponse>;
+    badRequest: (message?: string) => NextResponse<IErrorResponse>;
+    invalidUrl: () => NextResponse<IErrorResponse>;
+    invalidEmail: () => NextResponse<IErrorResponse>;
+    invalidAlias: () => NextResponse<IErrorResponse>;
+    unauthorized: (message?: string) => NextResponse<IErrorResponse>;
+    invalidToken: () => NextResponse<IErrorResponse>;
+    tokenExpired: () => NextResponse<IErrorResponse>;
+    invalidCredentials: () => NextResponse<IErrorResponse>;
+    sessionExpired: () => NextResponse<IErrorResponse>;
+    forbidden: (message?: string) => NextResponse<IErrorResponse>;
+    emailNotVerified: () => NextResponse<IErrorResponse>;
+    accountDisabled: () => NextResponse<IErrorResponse>;
+    accountLocked: () => NextResponse<IErrorResponse>;
+    notFound: (message?: string) => NextResponse<IErrorResponse>;
+    userNotFound: () => NextResponse<IErrorResponse>;
+    linkNotFound: () => NextResponse<IErrorResponse>;
+    conflict: (message?: string) => NextResponse<IErrorResponse>;
+    duplicate: (resource?: string) => NextResponse<IErrorResponse>;
+    emailExists: () => NextResponse<IErrorResponse>;
+    aliasExists: () => NextResponse<IErrorResponse>;
+    businessRule: (message?: string) => NextResponse<IErrorResponse>;
+    linkExpired: () => NextResponse<IErrorResponse>;
+    linkInactive: () => NextResponse<IErrorResponse>;
+    linkPasswordRequired: () => NextResponse<IErrorResponse>;
+    linkPasswordIncorrect: () => NextResponse<IErrorResponse>;
+    reservedWord: () => NextResponse<IErrorResponse>;
+    quotaExceeded: () => NextResponse<IErrorResponse>;
+    rateLimit: () => NextResponse<IErrorResponse>;
+    dailyLimit: () => NextResponse<IErrorResponse>;
+    serverError: (message?: string) => NextResponse<IErrorResponse>;
+    databaseError: () => NextResponse<IErrorResponse>;
+    serviceUnavailable: () => NextResponse<IErrorResponse>;
+    externalServiceError: (service?: string) => NextResponse<IErrorResponse>;
+    accessBlocked: () => NextResponse<IErrorResponse>;
+    ipBlocked: () => NextResponse<IErrorResponse>;
+};
+declare const _default: {
+    errorToResponse: typeof errorToResponse;
+    processError: typeof processError;
+    withErrorHandler: typeof withErrorHandler;
+    ErrorResponse: {
+        validation: (message?: string, details?: unknown) => NextResponse<IErrorResponse>;
+        badRequest: (message?: string) => NextResponse<IErrorResponse>;
+        invalidUrl: () => NextResponse<IErrorResponse>;
+        invalidEmail: () => NextResponse<IErrorResponse>;
+        invalidAlias: () => NextResponse<IErrorResponse>;
+        unauthorized: (message?: string) => NextResponse<IErrorResponse>;
+        invalidToken: () => NextResponse<IErrorResponse>;
+        tokenExpired: () => NextResponse<IErrorResponse>;
+        invalidCredentials: () => NextResponse<IErrorResponse>;
+        sessionExpired: () => NextResponse<IErrorResponse>;
+        forbidden: (message?: string) => NextResponse<IErrorResponse>;
+        emailNotVerified: () => NextResponse<IErrorResponse>;
+        accountDisabled: () => NextResponse<IErrorResponse>;
+        accountLocked: () => NextResponse<IErrorResponse>;
+        notFound: (message?: string) => NextResponse<IErrorResponse>;
+        userNotFound: () => NextResponse<IErrorResponse>;
+        linkNotFound: () => NextResponse<IErrorResponse>;
+        conflict: (message?: string) => NextResponse<IErrorResponse>;
+        duplicate: (resource?: string) => NextResponse<IErrorResponse>;
+        emailExists: () => NextResponse<IErrorResponse>;
+        aliasExists: () => NextResponse<IErrorResponse>;
+        businessRule: (message?: string) => NextResponse<IErrorResponse>;
+        linkExpired: () => NextResponse<IErrorResponse>;
+        linkInactive: () => NextResponse<IErrorResponse>;
+        linkPasswordRequired: () => NextResponse<IErrorResponse>;
+        linkPasswordIncorrect: () => NextResponse<IErrorResponse>;
+        reservedWord: () => NextResponse<IErrorResponse>;
+        quotaExceeded: () => NextResponse<IErrorResponse>;
+        rateLimit: () => NextResponse<IErrorResponse>;
+        dailyLimit: () => NextResponse<IErrorResponse>;
+        serverError: (message?: string) => NextResponse<IErrorResponse>;
+        databaseError: () => NextResponse<IErrorResponse>;
+        serviceUnavailable: () => NextResponse<IErrorResponse>;
+        externalServiceError: (service?: string) => NextResponse<IErrorResponse>;
+        accessBlocked: () => NextResponse<IErrorResponse>;
+        ipBlocked: () => NextResponse<IErrorResponse>;
+    };
+};
+export default _default;

package/dist/error/error-handler.js

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

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

@@ -0,0 +1,46 @@
+/**
+ * 사용자 친화적 에러 메시지 (v2)
+ * 새로운 다중 언어 메시지 시스템 사용
+ *
+ * 이 파일은 기존 friendly-messages.ts를 대체하며,
+ * messages/ 폴더의 다중 언어 시스템을 활용합니다.
+ */
+import { type IErrorMessage, type TLocale } from './messages';
+/**
+ * @deprecated Use IErrorMessage from './messages' instead
+ */
+export interface IFriendlyMessage extends IErrorMessage {
+}
+export interface IErrorDisplay {
+    code: number;
+    title: string;
+    description: string;
+    action?: string;
+    icon: string;
+    severity: 'info' | 'warning' | 'error' | 'critical';
+}
+/**
+ * 에러 코드에 해당하는 친화적 메시지 가져오기
+ *
+ * @param code - 에러 코드
+ * @param locale - 언어 (기본값: 'ko')
+ * @returns 친화적 메시지
+ */
+export declare function getFriendlyMessage(code: number, locale?: TLocale): IErrorMessage;
+/**
+ * 에러 표시 정보 가져오기 (아이콘, 심각도 포함)
+ *
+ * @param code - 에러 코드
+ * @param locale - 언어 (기본값: 'ko')
+ * @returns 에러 표시 정보
+ */
+export declare function getErrorDisplayInfo(code: number, locale?: TLocale): IErrorDisplay;
+/**
+ * 친화적 에러 메시지 포맷팅 (한 줄)
+ *
+ * @param code - 에러 코드
+ * @param locale - 언어 (기본값: 'ko')
+ * @returns 포맷된 에러 메시지
+ */
+export declare function formatFriendlyError(code: number, locale?: TLocale): string;
+export type { IErrorMessage, TLocale } from './messages';

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

@@ -0,0 +1,15 @@
+import {
+  formatFriendlyError,
+  getErrorDisplayInfo,
+  getFriendlyMessage
+} from "../chunk-POKGHK3L.js";
+import "../chunk-EEUBKZV4.js";
+import "../chunk-N4YGR5WH.js";
+import "../chunk-KXAWBFJN.js";
+import "../chunk-Y3OTJH2S.js";
+import "../chunk-ORMEWXMH.js";
+export {
+  formatFriendlyError,
+  getErrorDisplayInfo,
+  getFriendlyMessage
+};

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

@@ -0,0 +1,22 @@
+/**
+ * 사용자 친화적 에러 메시지 정의
+ * 5자리 HTTP 확장 에러 코드별 프렌들리 메시지
+ */
+export interface IFriendlyMessage {
+    title: string;
+    description: string;
+    action?: string;
+}
+export interface IErrorDisplay {
+    code: number;
+    title: string;
+    description: string;
+    action?: string;
+    icon: string;
+    severity: 'info' | 'warning' | 'error' | 'critical';
+}
+type TLocale = 'ko' | 'en';
+export declare function getFriendlyMessage(code: number, locale?: TLocale): IFriendlyMessage;
+export declare function getErrorDisplayInfo(code: number, locale?: TLocale): IErrorDisplay;
+export declare function formatFriendlyError(code: number, locale?: TLocale): string;
+export {};

package/dist/error/friendly-messages.js

@@ -0,0 +1,12 @@
+import {
+  formatFriendlyError,
+  getErrorDisplayInfo,
+  getFriendlyMessage
+} from "../chunk-2DVWSDST.js";
+import "../chunk-Y3OTJH2S.js";
+import "../chunk-ORMEWXMH.js";
+export {
+  formatFriendlyError,
+  getErrorDisplayInfo,
+  getFriendlyMessage
+};

package/dist/error/hooks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * React Hooks
+ *
+ * 통합 에러 처리 시스템의 React Hooks
+ */
+export { useErrorHandler } from './useErrorHandler';
+export type { IErrorState, IUseErrorHandler } from './useErrorHandler';

package/dist/error/hooks/index.js

@@ -0,0 +1,14 @@
+import "../../chunk-Y2TUZFCP.js";
+import {
+  useErrorHandler
+} from "../../chunk-IAJNC34M.js";
+import "../../chunk-POKGHK3L.js";
+import "../../chunk-EEUBKZV4.js";
+import "../../chunk-N4YGR5WH.js";
+import "../../chunk-KXAWBFJN.js";
+import "../../chunk-MLGO3HLS.js";
+import "../../chunk-Y3OTJH2S.js";
+import "../../chunk-ORMEWXMH.js";
+export {
+  useErrorHandler
+};

package/dist/error/hooks/useErrorHandler.d.ts

@@ -0,0 +1,67 @@
+/**
+ * useErrorHandler Hook
+ *
+ * 에러 상태 관리 및 처리
+ */
+import type { TLocale } from '@withwiz/error/messages';
+import type { IErrorDisplay } from '@withwiz/error/friendly-messages-v2';
+/**
+ * 에러 상태
+ */
+export interface IErrorState {
+    /** 에러 발생 여부 */
+    hasError: boolean;
+    /** 에러 코드 */
+    code?: number;
+    /** 에러 메시지 */
+    message?: string;
+    /** 에러 표시 정보 */
+    displayInfo?: IErrorDisplay;
+    /** 에러 발생 시간 */
+    timestamp?: number;
+}
+/**
+ * useErrorHandler Hook 반환 타입
+ */
+export interface IUseErrorHandler {
+    /** 에러 상태 */
+    errorState: IErrorState;
+    /** 에러 처리 */
+    handleError: (error: unknown) => void;
+    /** 에러 초기화 */
+    clearError: () => void;
+    /** 인증 에러 처리 (자동 리다이렉트) */
+    handleAuthError: (error: unknown, redirectUrl?: string) => void;
+    /** 에러 여부 확인 */
+    hasError: boolean;
+}
+/**
+ * useErrorHandler Hook
+ *
+ * @param locale - 로케일 (기본값: 'ko')
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { errorState, handleError, clearError } = useErrorHandler('ko');
+ *
+ *   const fetchData = async () => {
+ *     try {
+ *       const res = await fetch('/api/data');
+ *       if (!res.ok) {
+ *         throw new AppError(40401);
+ *       }
+ *     } catch (error) {
+ *       handleError(error);
+ *     }
+ *   };
+ *
+ *   if (errorState.hasError) {
+ *     return <ErrorAlert code={errorState.code!} />;
+ *   }
+ *
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function useErrorHandler(locale?: TLocale): IUseErrorHandler;

package/dist/error/hooks/useErrorHandler.js

@@ -0,0 +1,14 @@
+"use client";
+import {
+  useErrorHandler
+} from "../../chunk-IAJNC34M.js";
+import "../../chunk-POKGHK3L.js";
+import "../../chunk-EEUBKZV4.js";
+import "../../chunk-N4YGR5WH.js";
+import "../../chunk-KXAWBFJN.js";
+import "../../chunk-MLGO3HLS.js";
+import "../../chunk-Y3OTJH2S.js";
+import "../../chunk-ORMEWXMH.js";
+export {
+  useErrorHandler
+};

package/dist/error/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 통합 에러 처리 시스템
+ *
+ * 모든 에러, 예외 상황을 통합 처리하는 중앙 집중식 시스템
+ * 에러코드는 HTTP status를 확장한 5자리 형식 (XXXYY)
+ * 사용자 UI에 표시할 문구는 프렌들리하게 제공 (다중 언어 지원)
+ *
+ * @example
+ * // API 라우트에서 에러 발생
+ * throw AppError.notFound('링크를 찾을 수 없습니다');
+ *
+ * // 프론트엔드에서 에러 표시
+ * showFriendlyError(error, { locale: 'ko' });
+ */
+export * from "@withwiz/constants/error-codes";
+export * from "./messages";
+export { LocaleDetector } from "./core/locale-detector";
+export * from "./app-error";
+export * from "./error-handler";
+export { getFriendlyMessage, getErrorDisplayInfo, formatFriendlyError, type IFriendlyMessage, type IErrorDisplay, } from "./friendly-messages-v2";
+export * from "./error-display";
+export * from "./ErrorBoundary";
+export * from "./components";
+export * from "./hooks";
+export * from "./logging";
+export * from "./recovery";