@withwiz/toolkit 0.1.0

package/dist/chunk-MLGO3HLS.js

@@ -0,0 +1,329 @@
+import {
+  ERROR_CODES,
+  formatErrorMessage,
+  getErrorCategory,
+  getHttpStatus
+} from "./chunk-Y3OTJH2S.js";
+
+// src/error/app-error.ts
+var AppError = class _AppError extends Error {
+  constructor(code, message, details, requestId) {
+    const formattedMessage = formatErrorMessage(code, message);
+    super(formattedMessage);
+    this.name = "AppError";
+    this.code = code;
+    this.status = getHttpStatus(code);
+    this.key = this.findErrorKey(code);
+    this.category = getErrorCategory(code);
+    this.details = details;
+    this.timestamp = /* @__PURE__ */ new Date();
+    this.requestId = requestId;
+    Object.setPrototypeOf(this, _AppError.prototype);
+  }
+  /**
+   * 에러 코드로 에러 키 찾기
+   */
+  findErrorKey(code) {
+    const entry = Object.entries(ERROR_CODES).find(([, v]) => v.code === code);
+    return entry ? entry[0] : "UNKNOWN";
+  }
+  /**
+   * JSON 직렬화
+   */
+  toJSON() {
+    return {
+      code: this.code,
+      message: this.message,
+      status: this.status,
+      key: this.key,
+      category: this.category,
+      details: this.details,
+      timestamp: this.timestamp.toISOString(),
+      requestId: this.requestId
+    };
+  }
+  /**
+   * 사용자 친화적 메시지 반환
+   */
+  toFriendlyMessage() {
+    return this.message;
+  }
+  /**
+   * 에러가 특정 카테고리인지 확인
+   */
+  isCategory(category) {
+    return this.category === category;
+  }
+  /**
+   * 로깅용 문자열 반환
+   */
+  toLogString() {
+    return `[${this.code}] ${this.message} | ${this.category} | ${this.requestId || "no-request-id"}`;
+  }
+  // ============================================
+  // 정적 팩토리 메서드
+  // ============================================
+  /**
+   * 에러 코드 키로 에러 생성
+   */
+  static fromKey(key, customMessage, details) {
+    const errorInfo = ERROR_CODES[key];
+    return new _AppError(
+      errorInfo.code,
+      customMessage || errorInfo.message,
+      details
+    );
+  }
+  /**
+   * 에러 정보로 에러 생성
+   */
+  static fromErrorInfo(errorInfo, customMessage, details) {
+    return new _AppError(
+      errorInfo.code,
+      customMessage || errorInfo.message,
+      details
+    );
+  }
+  /**
+   * 알 수 없는 에러를 AppError로 변환
+   */
+  static from(error, fallbackMessage) {
+    if (error instanceof _AppError) {
+      return error;
+    }
+    if (error instanceof Error) {
+      const codeMatch = error.message.match(/\[(\d{5})\]/);
+      if (codeMatch) {
+        const code = parseInt(codeMatch[1], 10);
+        return new _AppError(code, error.message.replace(/\s*\[\d{5}\]$/, ""));
+      }
+      return new _AppError(
+        ERROR_CODES.SERVER_ERROR.code,
+        fallbackMessage || ERROR_CODES.SERVER_ERROR.message
+      );
+    }
+    return new _AppError(
+      ERROR_CODES.INTERNAL_SERVER_ERROR.code,
+      fallbackMessage || ERROR_CODES.INTERNAL_SERVER_ERROR.message
+    );
+  }
+  // ============================================
+  // 검증 에러 (400xx)
+  // ============================================
+  static validation(message, details) {
+    return _AppError.fromKey("VALIDATION_ERROR", message, details);
+  }
+  static badRequest(message, details) {
+    return _AppError.fromKey("BAD_REQUEST", message, details);
+  }
+  static invalidInput(message, details) {
+    return _AppError.fromKey("INVALID_INPUT", message, details);
+  }
+  static missingField(fieldName) {
+    return _AppError.fromKey(
+      "MISSING_REQUIRED_FIELD",
+      `\uD544\uC218 \uD56D\uBAA9 '${fieldName}'\uC774(\uAC00) \uB204\uB77D\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`,
+      { field: fieldName }
+    );
+  }
+  static invalidUrl(url) {
+    return _AppError.fromKey("INVALID_URL_FORMAT", void 0, { value: url });
+  }
+  static invalidEmail(email) {
+    return _AppError.fromKey("INVALID_EMAIL_FORMAT", void 0, {
+      value: email
+    });
+  }
+  static weakPassword() {
+    return _AppError.fromKey("PASSWORD_TOO_WEAK");
+  }
+  static invalidAlias(alias) {
+    return _AppError.fromKey("INVALID_ALIAS_FORMAT", void 0, {
+      value: alias
+    });
+  }
+  // ============================================
+  // 인증 에러 (401xx)
+  // ============================================
+  static unauthorized(message) {
+    return _AppError.fromKey("UNAUTHORIZED", message);
+  }
+  static invalidToken() {
+    return _AppError.fromKey("INVALID_TOKEN");
+  }
+  static tokenExpired() {
+    return _AppError.fromKey("TOKEN_EXPIRED");
+  }
+  static invalidCredentials() {
+    return _AppError.fromKey("INVALID_CREDENTIALS");
+  }
+  static sessionExpired() {
+    return _AppError.fromKey("SESSION_EXPIRED");
+  }
+  // ============================================
+  // 권한 에러 (403xx)
+  // ============================================
+  static forbidden(message) {
+    return _AppError.fromKey("FORBIDDEN", message);
+  }
+  static emailNotVerified() {
+    return _AppError.fromKey("EMAIL_NOT_VERIFIED");
+  }
+  static accountDisabled() {
+    return _AppError.fromKey("ACCOUNT_DISABLED");
+  }
+  static accountLocked() {
+    return _AppError.fromKey("ACCOUNT_LOCKED");
+  }
+  // ============================================
+  // 리소스 에러 (404xx)
+  // ============================================
+  static notFound(message) {
+    return _AppError.fromKey("NOT_FOUND", message);
+  }
+  static userNotFound() {
+    return _AppError.fromKey("USER_NOT_FOUND");
+  }
+  static linkNotFound() {
+    return _AppError.fromKey("LINK_NOT_FOUND");
+  }
+  static tagNotFound() {
+    return _AppError.fromKey("TAG_NOT_FOUND");
+  }
+  static favoriteNotFound() {
+    return _AppError.fromKey("FAVORITE_NOT_FOUND");
+  }
+  static groupNotFound() {
+    return _AppError.fromKey("GROUP_NOT_FOUND");
+  }
+  // ============================================
+  // 충돌 에러 (409xx)
+  // ============================================
+  static conflict(message) {
+    return _AppError.fromKey("CONFLICT", message);
+  }
+  static duplicate(resourceName) {
+    const message = resourceName ? `'${resourceName}'\uC740(\uB294) \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4.` : void 0;
+    return _AppError.fromKey("DUPLICATE_RESOURCE", message);
+  }
+  static emailExists(email) {
+    return _AppError.fromKey("EMAIL_ALREADY_EXISTS", void 0, {
+      value: email
+    });
+  }
+  static aliasExists(alias) {
+    return _AppError.fromKey("ALIAS_ALREADY_EXISTS", void 0, {
+      value: alias
+    });
+  }
+  // ============================================
+  // 비즈니스 로직 에러 (422xx)
+  // ============================================
+  static businessRule(message, details) {
+    return _AppError.fromKey("BUSINESS_RULE_VIOLATION", message, details);
+  }
+  static invalidOperation(message) {
+    return _AppError.fromKey("INVALID_OPERATION", message);
+  }
+  static quotaExceeded(quotaType) {
+    const message = quotaType ? `${quotaType} \uC0AC\uC6A9\uB7C9\uC744 \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.` : void 0;
+    return _AppError.fromKey("QUOTA_EXCEEDED", message);
+  }
+  static linkExpired() {
+    return _AppError.fromKey("LINK_EXPIRED");
+  }
+  static linkInactive() {
+    return _AppError.fromKey("LINK_INACTIVE");
+  }
+  static linkPasswordRequired() {
+    return _AppError.fromKey("LINK_PASSWORD_REQUIRED");
+  }
+  static linkPasswordIncorrect() {
+    return _AppError.fromKey("LINK_PASSWORD_INCORRECT");
+  }
+  static reservedWord(word) {
+    return _AppError.fromKey("RESERVED_WORD_USED", void 0, { value: word });
+  }
+  static alreadyFavorited() {
+    return _AppError.fromKey("ALREADY_FAVORITED");
+  }
+  static cannotDeleteOwnAccount() {
+    return _AppError.fromKey("CANNOT_DELETE_OWN_ACCOUNT");
+  }
+  static fileTooLarge(maxSize) {
+    const message = maxSize ? `\uD30C\uC77C \uD06C\uAE30\uAC00 ${maxSize}\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.` : void 0;
+    return _AppError.fromKey("FILE_TOO_LARGE", message);
+  }
+  static unsupportedFileType(fileType) {
+    const message = fileType ? `'${fileType}' \uD615\uC2DD\uC740 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.` : void 0;
+    return _AppError.fromKey("UNSUPPORTED_FILE_TYPE", message);
+  }
+  // ============================================
+  // Rate Limiting (429xx)
+  // ============================================
+  static rateLimit(retryAfter) {
+    const details = retryAfter ? { retryAfter } : void 0;
+    return _AppError.fromKey("RATE_LIMIT_EXCEEDED", void 0, details);
+  }
+  static dailyLimit() {
+    return _AppError.fromKey("DAILY_LIMIT_EXCEEDED");
+  }
+  static apiQuotaExceeded() {
+    return _AppError.fromKey("API_QUOTA_EXCEEDED");
+  }
+  // ============================================
+  // 서버 에러 (500xx)
+  // ============================================
+  static serverError(message) {
+    return _AppError.fromKey("SERVER_ERROR", message);
+  }
+  static internalError(message) {
+    return _AppError.fromKey("INTERNAL_SERVER_ERROR", message);
+  }
+  static databaseError(message) {
+    return _AppError.fromKey("DATABASE_ERROR", message);
+  }
+  static emailSendFailed() {
+    return _AppError.fromKey("EMAIL_SEND_FAILED");
+  }
+  static cacheError() {
+    return _AppError.fromKey("CACHE_ERROR");
+  }
+  static fileUploadFailed() {
+    return _AppError.fromKey("FILE_UPLOAD_FAILED");
+  }
+  // ============================================
+  // 서비스 불가 (503xx)
+  // ============================================
+  static externalServiceError(serviceName) {
+    const message = serviceName ? `'${serviceName}' \uC11C\uBE44\uC2A4\uC5D0 \uC5F0\uACB0\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.` : void 0;
+    return _AppError.fromKey("EXTERNAL_SERVICE_ERROR", message);
+  }
+  static serviceUnavailable(message) {
+    return _AppError.fromKey("SERVICE_UNAVAILABLE", message);
+  }
+  // ============================================
+  // 보안 에러 (403xx - 71~79)
+  // ============================================
+  static accessBlocked(reason) {
+    return _AppError.fromKey("ACCESS_BLOCKED", reason);
+  }
+  static securityValidationFailed() {
+    return _AppError.fromKey("SECURITY_VALIDATION_FAILED");
+  }
+  static blockedUrl(url) {
+    return _AppError.fromKey("BLOCKED_URL", void 0, { value: url });
+  }
+  static suspiciousActivity() {
+    return _AppError.fromKey("SUSPICIOUS_ACTIVITY");
+  }
+  static ipBlocked(ip) {
+    return _AppError.fromKey("IP_BLOCKED", void 0, { value: ip });
+  }
+};
+var app_error_default = AppError;
+
+export {
+  AppError,
+  app_error_default
+};

package/dist/chunk-MRJE6OX5.js

@@ -0,0 +1,22 @@
+import {
+  cn
+} from "./chunk-62FLBG6B.js";
+
+// src/components/ui/Skeleton.tsx
+import { jsx } from "react/jsx-runtime";
+function Skeleton({ className, children }) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn(
+        "animate-pulse rounded-md bg-muted",
+        className
+      ),
+      children
+    }
+  );
+}
+
+export {
+  Skeleton
+};

package/dist/chunk-MYLGYX4K.js

@@ -0,0 +1,57 @@
+// src/error/recovery/fallback.ts
+async function withFallback(fn, fallbackValue, options = {}) {
+  const { onError, logError = true } = options;
+  try {
+    return await fn();
+  } catch (error) {
+    if (logError) {
+      console.error("[withFallback] Error occurred, using fallback:", error);
+    }
+    onError == null ? void 0 : onError(error);
+    return fallbackValue;
+  }
+}
+async function withFallbackFn(primaryFn, fallbackFn, options = {}) {
+  const { onError, logError = true } = options;
+  try {
+    return await primaryFn();
+  } catch (error) {
+    if (logError) {
+      console.error("[withFallbackFn] Primary failed, trying fallback:", error);
+    }
+    onError == null ? void 0 : onError(error);
+    try {
+      return await fallbackFn();
+    } catch (fallbackError) {
+      console.error("[withFallbackFn] Fallback also failed:", fallbackError);
+      throw fallbackError;
+    }
+  }
+}
+async function withFallbackChain(fns, options = {}) {
+  const { onError, logError = true } = options;
+  const errors = [];
+  for (let i = 0; i < fns.length; i++) {
+    try {
+      return await fns[i]();
+    } catch (error) {
+      errors.push(error);
+      if (logError) {
+        console.error(`[withFallbackChain] Attempt ${i + 1} failed:`, error);
+      }
+      onError == null ? void 0 : onError(error);
+      if (i === fns.length - 1) {
+        throw new Error(
+          `All ${fns.length} attempts failed. Last error: ${error}`
+        );
+      }
+    }
+  }
+  throw new Error("No functions provided");
+}
+
+export {
+  withFallback,
+  withFallbackFn,
+  withFallbackChain
+};