@withwiz/toolkit 0.1.0

package/dist/error/index.js

@@ -0,0 +1,289 @@
+import "../chunk-ULF5RDDX.js";
+import {
+  withFallback,
+  withFallbackChain,
+  withFallbackFn
+} from "../chunk-MYLGYX4K.js";
+import {
+  withRetry
+} from "../chunk-A6EAAWMK.js";
+import "../chunk-Y2TUZFCP.js";
+import {
+  useErrorHandler
+} from "../chunk-IAJNC34M.js";
+import {
+  EmptyState,
+  ErrorAlert,
+  ErrorPage,
+  LoadingState
+} from "../chunk-ZHVUK5OY.js";
+import "../chunk-7XFHGAJP.js";
+import "../chunk-COK4ZXNG.js";
+import {
+  ConsoleTransport
+} from "../chunk-FW3IEJ7H.js";
+import {
+  FileTransport
+} from "../chunk-YJ3TLEW3.js";
+import {
+  SentryTransport
+} from "../chunk-ZZIKRBJU.js";
+import {
+  SlackTransport
+} from "../chunk-EQYTE7WD.js";
+import {
+  BaseTransport
+} from "../chunk-HGC4CCKB.js";
+import {
+  ErrorLogger
+} from "../chunk-JS5VI3OW.js";
+import {
+  ELogLevel
+} from "../chunk-6C7HQIX4.js";
+import {
+  CircuitBreaker,
+  ECircuitState
+} from "../chunk-7VJNLGAS.js";
+import {
+  FeatureDegradation
+} from "../chunk-TEIYA7U4.js";
+import {
+  LocaleDetector
+} from "../chunk-XHZ5L4FO.js";
+import {
+  ErrorResponse,
+  errorToResponse,
+  processError,
+  withErrorHandler
+} from "../chunk-GPBOMJSZ.js";
+import {
+  formatFriendlyError,
+  getErrorDisplayInfo as getErrorDisplayInfo2,
+  getFriendlyMessage
+} from "../chunk-POKGHK3L.js";
+import {
+  getAllMessages,
+  getErrorMessage,
+  hasMessage,
+  isLocaleSupported,
+  supportedLocales
+} from "../chunk-EEUBKZV4.js";
+import "../chunk-N4YGR5WH.js";
+import "../chunk-KXAWBFJN.js";
+import {
+  AppError
+} from "../chunk-MLGO3HLS.js";
+import {
+  extractErrorInfo,
+  formatInlineError,
+  getDefaultErrorCode,
+  getErrorIcon,
+  handleApiResponse,
+  showFriendlyError
+} from "../chunk-3DZA6AGS.js";
+import {
+  getErrorDisplayInfo
+} from "../chunk-2DVWSDST.js";
+import {
+  ERROR_CODES,
+  HTTP_STATUS,
+  formatErrorMessage,
+  getAllErrorCodes,
+  getDefaultErrorMessage,
+  getErrorByCode,
+  getErrorCategory,
+  getErrorCodesByCategory,
+  getErrorInfo,
+  getHttpStatus,
+  getLogLevel
+} from "../chunk-Y3OTJH2S.js";
+import "../chunk-EZR55KV2.js";
+import "../chunk-ORMEWXMH.js";
+
+// src/error/ErrorBoundary.tsx
+import { Component } from "react";
+import { AlertCircle, RefreshCw, Home, HelpCircle } from "lucide-react";
+import Link from "next/link";
+import { jsx, jsxs } from "react/jsx-runtime";
+var ErrorBoundary = class extends Component {
+  constructor(props) {
+    super(props);
+    this.handleReset = () => {
+      this.setState({ hasError: false, error: null, errorCode: 50001 });
+    };
+    this.handleRefresh = () => {
+      window.location.reload();
+    };
+    this.state = { hasError: false, error: null, errorCode: 50001 };
+  }
+  static getDerivedStateFromError(error) {
+    const { code } = extractErrorInfo(error);
+    return { hasError: true, error, errorCode: code };
+  }
+  componentDidCatch(error, errorInfo) {
+    var _a, _b;
+    console.error("ErrorBoundary caught an error:", error, errorInfo);
+    (_b = (_a = this.props).onError) == null ? void 0 : _b.call(_a, error, errorInfo);
+  }
+  render() {
+    if (this.state.hasError) {
+      if (this.props.fallback) {
+        return this.props.fallback;
+      }
+      const locale = this.props.locale || "ko";
+      const displayInfo = getErrorDisplayInfo(this.state.errorCode, locale);
+      const isKo = locale === "ko";
+      return /* @__PURE__ */ jsx("div", { className: "min-h-[400px] flex items-center justify-center p-6", children: /* @__PURE__ */ jsxs("div", { className: "max-w-md w-full bg-white dark:bg-gray-900 rounded-2xl shadow-xl p-8 text-center", children: [
+        /* @__PURE__ */ jsx("div", { className: "w-16 h-16 mx-auto mb-6 rounded-full bg-red-100 dark:bg-red-900/30 flex items-center justify-center", children: /* @__PURE__ */ jsx(AlertCircle, { className: "w-8 h-8 text-red-500" }) }),
+        /* @__PURE__ */ jsx("h2", { className: "text-xl font-bold text-gray-900 dark:text-white mb-2", children: displayInfo.title }),
+        /* @__PURE__ */ jsx("p", { className: "text-gray-600 dark:text-gray-400 mb-4", children: displayInfo.description }),
+        /* @__PURE__ */ jsxs("p", { className: "text-sm text-gray-500 dark:text-gray-500 mb-6", children: [
+          isKo ? "\uC5D0\uB7EC \uCF54\uB4DC" : "Error Code",
+          ": ",
+          /* @__PURE__ */ jsx("code", { className: "bg-gray-100 dark:bg-gray-800 px-2 py-1 rounded", children: this.state.errorCode })
+        ] }),
+        this.props.showDetails && this.state.error && /* @__PURE__ */ jsxs("details", { className: "text-left mb-6 p-4 bg-gray-50 dark:bg-gray-800 rounded-lg", children: [
+          /* @__PURE__ */ jsx("summary", { className: "cursor-pointer text-sm font-medium text-gray-700 dark:text-gray-300", children: isKo ? "\uC0C1\uC138 \uC815\uBCF4" : "Details" }),
+          /* @__PURE__ */ jsx("pre", { className: "mt-2 text-xs text-gray-600 dark:text-gray-400 overflow-auto max-h-40", children: this.state.error.stack })
+        ] }),
+        /* @__PURE__ */ jsxs("div", { className: "flex flex-col sm:flex-row gap-3 justify-center", children: [
+          /* @__PURE__ */ jsxs(
+            "button",
+            {
+              onClick: this.handleRefresh,
+              className: "inline-flex items-center justify-center px-4 py-2.5 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg transition-colors",
+              children: [
+                /* @__PURE__ */ jsx(RefreshCw, { className: "w-4 h-4 mr-2" }),
+                isKo ? "\uC0C8\uB85C\uACE0\uCE68" : "Refresh"
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsxs(
+            Link,
+            {
+              href: "/",
+              className: "inline-flex items-center justify-center px-4 py-2.5 bg-gray-100 hover:bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-700 text-gray-700 dark:text-gray-300 font-medium rounded-lg transition-colors",
+              children: [
+                /* @__PURE__ */ jsx(Home, { className: "w-4 h-4 mr-2" }),
+                isKo ? "\uD648\uC73C\uB85C" : "Go Home"
+              ]
+            }
+          )
+        ] }),
+        displayInfo.action && /* @__PURE__ */ jsxs("p", { className: "mt-6 text-sm text-gray-500 dark:text-gray-500 flex items-center justify-center gap-1", children: [
+          /* @__PURE__ */ jsx(HelpCircle, { className: "w-4 h-4" }),
+          displayInfo.action
+        ] })
+      ] }) });
+    }
+    return this.props.children;
+  }
+};
+function ErrorCard({
+  code,
+  message,
+  locale = "ko",
+  onRetry,
+  className
+}) {
+  const errorCode = code || 50002;
+  const displayInfo = getErrorDisplayInfo(errorCode, locale);
+  const isKo = locale === "ko";
+  return /* @__PURE__ */ jsx("div", { className: `bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded-lg p-4 ${className || ""}`, children: /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-3", children: [
+    /* @__PURE__ */ jsx(AlertCircle, { className: "w-5 h-5 text-red-500 flex-shrink-0 mt-0.5" }),
+    /* @__PURE__ */ jsxs("div", { className: "flex-1", children: [
+      /* @__PURE__ */ jsx("h4", { className: "font-medium text-red-800 dark:text-red-200", children: message || displayInfo.title }),
+      /* @__PURE__ */ jsxs("p", { className: "text-sm text-red-600 dark:text-red-300 mt-1", children: [
+        displayInfo.description,
+        " [",
+        errorCode,
+        "]"
+      ] }),
+      onRetry && /* @__PURE__ */ jsxs(
+        "button",
+        {
+          onClick: onRetry,
+          className: "mt-3 text-sm text-red-600 dark:text-red-400 hover:underline flex items-center gap-1",
+          children: [
+            /* @__PURE__ */ jsx(RefreshCw, { className: "w-3 h-3" }),
+            isKo ? "\uB2E4\uC2DC \uC2DC\uB3C4" : "Try again"
+          ]
+        }
+      )
+    ] })
+  ] }) });
+}
+function InlineError({
+  code,
+  message,
+  locale = "ko"
+}) {
+  if (!code && !message) return null;
+  const displayInfo = code ? getErrorDisplayInfo(code, locale) : null;
+  const displayMessage = message || (displayInfo == null ? void 0 : displayInfo.description) || "";
+  return /* @__PURE__ */ jsxs("p", { className: "text-sm text-red-600 dark:text-red-400 mt-1 flex items-center gap-1", children: [
+    /* @__PURE__ */ jsx(AlertCircle, { className: "w-3 h-3" }),
+    displayMessage,
+    " ",
+    code && /* @__PURE__ */ jsxs("span", { className: "text-red-400", children: [
+      "[",
+      code,
+      "]"
+    ] })
+  ] });
+}
+export {
+  AppError,
+  BaseTransport,
+  CircuitBreaker,
+  ConsoleTransport,
+  ECircuitState,
+  ELogLevel,
+  ERROR_CODES,
+  EmptyState,
+  ErrorAlert,
+  ErrorBoundary,
+  ErrorCard,
+  ErrorLogger,
+  ErrorPage,
+  ErrorResponse,
+  FeatureDegradation,
+  FileTransport,
+  HTTP_STATUS,
+  InlineError,
+  LoadingState,
+  LocaleDetector,
+  SentryTransport,
+  SlackTransport,
+  errorToResponse,
+  extractErrorInfo,
+  formatErrorMessage,
+  formatFriendlyError,
+  formatInlineError,
+  getAllErrorCodes,
+  getAllMessages,
+  getDefaultErrorCode,
+  getDefaultErrorMessage,
+  getErrorByCode,
+  getErrorCategory,
+  getErrorCodesByCategory,
+  getErrorDisplayInfo2 as getErrorDisplayInfo,
+  getErrorIcon,
+  getErrorInfo,
+  getErrorMessage,
+  getFriendlyMessage,
+  getHttpStatus,
+  getLogLevel,
+  handleApiResponse,
+  hasMessage,
+  isLocaleSupported,
+  processError,
+  showFriendlyError,
+  supportedLocales,
+  useErrorHandler,
+  withErrorHandler,
+  withFallback,
+  withFallbackChain,
+  withFallbackFn,
+  withRetry
+};

package/dist/error/logging/error-logger.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ErrorLogger 클래스
+ *
+ * 구조화된 에러 로깅
+ */
+import { AppError } from '@withwiz/error/app-error';
+import type { IErrorLogContext, ITransport, IErrorLoggerOptions } from './types';
+/**
+ * ErrorLogger 클래스
+ *
+ * @example
+ * ```typescript
+ * const logger = new ErrorLogger({
+ *   minLevel: ELogLevel.INFO,
+ *   environment: 'production',
+ *   transports: [consoleTransport, sentryTransport],
+ * });
+ *
+ * logger.error('API Error', {
+ *   requestId: 'abc-123',
+ *   errorCode: 50001,
+ * });
+ * ```
+ */
+export declare class ErrorLogger {
+    private options;
+    private transports;
+    constructor(options?: IErrorLoggerOptions);
+    /**
+     * Transport 추가
+     */
+    addTransport(transport: ITransport): void;
+    /**
+     * Transport 제거
+     */
+    removeTransport(transportName: string): void;
+    /**
+     * Debug 로그
+     */
+    debug(message: string, context?: IErrorLogContext): void;
+    /**
+     * Info 로그
+     */
+    info(message: string, context?: IErrorLogContext): void;
+    /**
+     * Warning 로그
+     */
+    warn(message: string, context?: IErrorLogContext): void;
+    /**
+     * Error 로그
+     */
+    error(message: string, context?: IErrorLogContext, error?: AppError | Error): void;
+    /**
+     * Critical 로그
+     */
+    critical(message: string, context?: IErrorLogContext, error?: AppError | Error): void;
+    /**
+     * 로그 기록
+     */
+    private log;
+    /**
+     * 로그 레벨 체크
+     */
+    private shouldLog;
+    /**
+     * 컨텍스트 보강
+     */
+    private enrichContext;
+    /**
+     * Transport로 전송
+     */
+    private sendToTransports;
+    /**
+     * AppError 로깅 헬퍼
+     */
+    logAppError(error: AppError, context?: IErrorLogContext): void;
+}

package/dist/error/logging/error-logger.js

@@ -0,0 +1,10 @@
+import {
+  ErrorLogger
+} from "../../chunk-JS5VI3OW.js";
+import "../../chunk-6C7HQIX4.js";
+import "../../chunk-MLGO3HLS.js";
+import "../../chunk-Y3OTJH2S.js";
+import "../../chunk-ORMEWXMH.js";
+export {
+  ErrorLogger
+};

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

@@ -0,0 +1,9 @@
+/**
+ * 로깅 시스템
+ *
+ * 통합 에러 처리 시스템의 로깅 레이어
+ */
+export type { IErrorLogContext, ILogEntry, ITransport, IErrorLoggerOptions, } from './types';
+export { ELogLevel } from './types';
+export { ErrorLogger } from './error-logger';
+export * from './transports';

package/dist/error/logging/index.js

@@ -0,0 +1,35 @@
+import "../../chunk-7XFHGAJP.js";
+import "../../chunk-COK4ZXNG.js";
+import {
+  ConsoleTransport
+} from "../../chunk-FW3IEJ7H.js";
+import {
+  FileTransport
+} from "../../chunk-YJ3TLEW3.js";
+import {
+  SentryTransport
+} from "../../chunk-ZZIKRBJU.js";
+import {
+  SlackTransport
+} from "../../chunk-EQYTE7WD.js";
+import {
+  BaseTransport
+} from "../../chunk-HGC4CCKB.js";
+import {
+  ErrorLogger
+} from "../../chunk-JS5VI3OW.js";
+import {
+  ELogLevel
+} from "../../chunk-6C7HQIX4.js";
+import "../../chunk-MLGO3HLS.js";
+import "../../chunk-Y3OTJH2S.js";
+import "../../chunk-ORMEWXMH.js";
+export {
+  BaseTransport,
+  ConsoleTransport,
+  ELogLevel,
+  ErrorLogger,
+  FileTransport,
+  SentryTransport,
+  SlackTransport
+};

package/dist/error/logging/transports/base.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Base Transport
+ *
+ * 모든 Transport의 기본 클래스
+ */
+import type { ITransport, ILogEntry } from '@withwiz/error/logging/types';
+/**
+ * BaseTransport 추상 클래스
+ */
+export declare abstract class BaseTransport implements ITransport {
+    readonly name: string;
+    protected enabled: boolean;
+    constructor(name: string, enabled?: boolean);
+    /**
+     * 로그 전송 (구현 필요)
+     */
+    abstract log(entry: ILogEntry): Promise<void>;
+    /**
+     * Transport 활성화 여부
+     */
+    isEnabled(): boolean;
+    /**
+     * Transport 활성화
+     */
+    enable(): void;
+    /**
+     * Transport 비활성화
+     */
+    disable(): void;
+}

package/dist/error/logging/transports/base.js

@@ -0,0 +1,7 @@
+import {
+  BaseTransport
+} from "../../../chunk-HGC4CCKB.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  BaseTransport
+};

package/dist/error/logging/transports/console.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Console Transport
+ *
+ * 콘솔에 로그 출력
+ */
+import { BaseTransport } from './base';
+import type { ILogEntry } from '@withwiz/error/logging/types';
+/**
+ * ConsoleTransport 옵션
+ */
+export interface IConsoleTransportOptions {
+    enabled?: boolean;
+    colorize?: boolean;
+    includeTimestamp?: boolean;
+}
+/**
+ * ConsoleTransport 클래스
+ *
+ * @example
+ * ```typescript
+ * const transport = new ConsoleTransport({
+ *   colorize: true,
+ *   includeTimestamp: true,
+ * });
+ * ```
+ */
+export declare class ConsoleTransport extends BaseTransport {
+    private colorize;
+    private includeTimestamp;
+    constructor(options?: IConsoleTransportOptions);
+    log(entry: ILogEntry): Promise<void>;
+    /**
+     * 로그 포맷팅
+     */
+    private format;
+    /**
+     * 콘솔 출력
+     */
+    private output;
+}

package/dist/error/logging/transports/console.js

@@ -0,0 +1,9 @@
+import {
+  ConsoleTransport
+} from "../../../chunk-FW3IEJ7H.js";
+import "../../../chunk-HGC4CCKB.js";
+import "../../../chunk-6C7HQIX4.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  ConsoleTransport
+};

package/dist/error/logging/transports/file.d.ts

@@ -0,0 +1,49 @@
+/**
+ * File Transport
+ *
+ * 파일에 로그 기록 (서버 전용)
+ */
+import { BaseTransport } from './base';
+import type { ILogEntry } from '@withwiz/error/logging/types';
+/**
+ * FileTransport 옵션
+ */
+export interface IFileTransportOptions {
+    enabled?: boolean;
+    filePath?: string;
+    maxSize?: number;
+    maxFiles?: number;
+}
+/**
+ * FileTransport 클래스
+ *
+ * @example
+ * ```typescript
+ * const transport = new FileTransport({
+ *   filePath: './logs/error.log',
+ *   maxSize: 10 * 1024 * 1024, // 10MB
+ *   maxFiles: 5,
+ * });
+ * ```
+ */
+export declare class FileTransport extends BaseTransport {
+    private filePath;
+    private maxSize;
+    private maxFiles;
+    private fs;
+    private path;
+    constructor(options?: IFileTransportOptions);
+    /**
+     * 모듈 로드 (동적 import)
+     */
+    private loadModules;
+    log(entry: ILogEntry): Promise<void>;
+    /**
+     * 로그 포맷팅 (JSON Lines)
+     */
+    private format;
+    /**
+     * 파일 rotation
+     */
+    private rotateIfNeeded;
+}

package/dist/error/logging/transports/file.js

@@ -0,0 +1,8 @@
+import {
+  FileTransport
+} from "../../../chunk-YJ3TLEW3.js";
+import "../../../chunk-HGC4CCKB.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  FileTransport
+};

package/dist/error/logging/transports/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Transport 모듈
+ */
+export { BaseTransport } from './base';
+export { ConsoleTransport } from './console';
+export type { IConsoleTransportOptions } from './console';
+export { FileTransport } from './file';
+export type { IFileTransportOptions } from './file';
+export { SentryTransport } from './sentry';
+export type { ISentryTransportOptions } from './sentry';
+export { SlackTransport } from './slack';
+export type { ISlackTransportOptions } from './slack';

package/dist/error/logging/transports/index.js

@@ -0,0 +1,25 @@
+import "../../../chunk-COK4ZXNG.js";
+import {
+  ConsoleTransport
+} from "../../../chunk-FW3IEJ7H.js";
+import {
+  FileTransport
+} from "../../../chunk-YJ3TLEW3.js";
+import {
+  SentryTransport
+} from "../../../chunk-ZZIKRBJU.js";
+import {
+  SlackTransport
+} from "../../../chunk-EQYTE7WD.js";
+import {
+  BaseTransport
+} from "../../../chunk-HGC4CCKB.js";
+import "../../../chunk-6C7HQIX4.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  BaseTransport,
+  ConsoleTransport,
+  FileTransport,
+  SentryTransport,
+  SlackTransport
+};

package/dist/error/logging/transports/sentry.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Sentry Transport
+ *
+ * Sentry로 에러 전송
+ */
+import { BaseTransport } from './base';
+import type { ILogEntry, ELogLevel } from '@withwiz/error/logging/types';
+/**
+ * SentryTransport 옵션
+ */
+export interface ISentryTransportOptions {
+    enabled?: boolean;
+    dsn?: string;
+    environment?: string;
+    minLevel?: ELogLevel;
+}
+/**
+ * SentryTransport 클래스
+ *
+ * @example
+ * ```typescript
+ * const transport = new SentryTransport({
+ *   dsn: process.env.SENTRY_DSN,
+ *   environment: 'production',
+ *   minLevel: ELogLevel.ERROR,
+ * });
+ * ```
+ */
+export declare class SentryTransport extends BaseTransport {
+    private dsn;
+    private environment;
+    private minLevel;
+    private Sentry;
+    constructor(options?: ISentryTransportOptions);
+    /**
+     * Sentry 초기화
+     */
+    private initSentry;
+    log(entry: ILogEntry): Promise<void>;
+    /**
+     * 로그 레벨 체크
+     */
+    private shouldLog;
+}

package/dist/error/logging/transports/sentry.js

@@ -0,0 +1,9 @@
+import {
+  SentryTransport
+} from "../../../chunk-ZZIKRBJU.js";
+import "../../../chunk-HGC4CCKB.js";
+import "../../../chunk-6C7HQIX4.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  SentryTransport
+};