@withwiz/toolkit 0.1.0

package/dist/chunk-N4YGR5WH.js

@@ -0,0 +1,310 @@
+// src/error/messages/en.ts
+var enMessages = {
+  // ============================================
+  // Validation Errors (400xx)
+  // ============================================
+  40001: {
+    title: "Please check your input",
+    description: "Some information you entered is incorrect.",
+    action: "Please review your input."
+  },
+  40002: {
+    title: "Cannot process request",
+    description: "The request format is invalid.",
+    action: "Please refresh the page."
+  },
+  40003: {
+    title: "Invalid input",
+    description: "The format is not allowed.",
+    action: "Please enter in the correct format."
+  },
+  40004: {
+    title: "Required information is missing",
+    description: "Required fields are empty.",
+    action: "Please fill in all required fields."
+  },
+  40005: {
+    title: "Please check URL format",
+    description: "Please enter a URL starting with https://.",
+    action: "Example: https://example.com"
+  },
+  40006: {
+    title: "Please check email format",
+    description: "This is not a valid email address.",
+    action: "Example: user@example.com"
+  },
+  40007: {
+    title: "Stronger password required",
+    description: "8+ characters with letters, numbers, and symbols",
+    action: "Please set a more complex password."
+  },
+  40008: {
+    title: "Please check alias format",
+    description: "Only letters, numbers, and hyphens (-) allowed",
+    action: "Example: my-link-123"
+  },
+  // ============================================
+  // Authentication Errors (401xx)
+  // ============================================
+  40101: {
+    title: "Login required",
+    description: "This feature requires authentication.",
+    action: "Please login and try again."
+  },
+  40102: {
+    title: "Invalid authentication",
+    description: "Your login session is not valid.",
+    action: "Please login again."
+  },
+  40103: {
+    title: "Session expired",
+    description: "Your session has expired for security.",
+    action: "Please login again."
+  },
+  40106: {
+    title: "Login failed",
+    description: "Email or password is incorrect.",
+    action: "Please try again."
+  },
+  40107: {
+    title: "Session ended",
+    description: "You have been automatically logged out.",
+    action: "Please login again."
+  },
+  // ============================================
+  // Permission Errors (403xx)
+  // ============================================
+  40304: {
+    title: "Access denied",
+    description: "You do not have permission for this feature.",
+    action: "Please contact the administrator."
+  },
+  40305: {
+    title: "Email verification required",
+    description: "Please verify your email first.",
+    action: "Please check your mailbox."
+  },
+  40308: {
+    title: "Account disabled",
+    description: "This account cannot use the service.",
+    action: "Please contact customer support."
+  },
+  40309: {
+    title: "Account locked",
+    description: "Account locked due to failed login attempts.",
+    action: "Please try again later."
+  },
+  // ============================================
+  // Resource Not Found (404xx)
+  // ============================================
+  40401: {
+    title: "Not found",
+    description: "The requested item does not exist.",
+    action: "Please check the address."
+  },
+  40402: {
+    title: "User not found",
+    description: "The user does not exist."
+  },
+  40403: {
+    title: "Link not found",
+    description: "The shortened link does not exist.",
+    action: "Please check the link address."
+  },
+  40408: {
+    title: "Tag not found",
+    description: "The tag does not exist."
+  },
+  40409: {
+    title: "Favorite not found",
+    description: "The item does not exist."
+  },
+  40410: {
+    title: "Group not found",
+    description: "The group does not exist."
+  },
+  // ============================================
+  // Conflict Errors (409xx)
+  // ============================================
+  40904: {
+    title: "Conflict occurred",
+    description: "Conflicts with existing data.",
+    action: "Please try again later."
+  },
+  40905: {
+    title: "Already exists",
+    description: "An identical item already exists.",
+    action: "Please use a different value."
+  },
+  40906: {
+    title: "Email already registered",
+    description: "This email is already in use by another account.",
+    action: "Please use a different email."
+  },
+  40907: {
+    title: "Alias already in use",
+    description: "This alias is being used by another link.",
+    action: "Please enter a different alias."
+  },
+  // ============================================
+  // Business Logic Errors (422xx)
+  // ============================================
+  42201: {
+    title: "Cannot process",
+    description: "Cannot be processed in the current state.",
+    action: "Please check the conditions."
+  },
+  42202: {
+    title: "Operation not allowed",
+    description: "This operation is not possible in the current state."
+  },
+  42203: {
+    title: "Usage limit exceeded",
+    description: "You have exceeded the limit.",
+    action: "Please consider upgrading your plan."
+  },
+  42204: {
+    title: "Link expired",
+    description: "The validity period has passed.",
+    action: "Please create a new link."
+  },
+  42205: {
+    title: "Link disabled",
+    description: "Usage has been stopped.",
+    action: "Please contact the owner."
+  },
+  42206: {
+    title: "Password required",
+    description: "You must enter a password.",
+    action: "Please enter the password."
+  },
+  42207: {
+    title: "Incorrect password",
+    description: "The password is incorrect.",
+    action: "Please check again."
+  },
+  42208: {
+    title: "Alias not allowed",
+    description: "This is a system reserved word.",
+    action: "Please choose a different alias."
+  },
+  42209: {
+    title: "Already in favorites",
+    description: "Already added."
+  },
+  42210: {
+    title: "Cannot delete",
+    description: "Cannot delete your own admin account."
+  },
+  42211: {
+    title: "File too large",
+    description: "The maximum size has been exceeded.",
+    action: "Please select a smaller file."
+  },
+  42212: {
+    title: "Unsupported file format",
+    description: "Cannot upload.",
+    action: "Please check supported formats."
+  },
+  // ============================================
+  // Rate Limiting (429xx)
+  // ============================================
+  42901: {
+    title: "Please slow down",
+    description: "Too many requests.",
+    action: "Please try again in a moment."
+  },
+  42902: {
+    title: "Daily limit reached",
+    description: "You have reached the daily limit.",
+    action: "Please try again tomorrow."
+  },
+  42903: {
+    title: "API quota exceeded",
+    description: "API limit exceeded.",
+    action: "Please consider upgrading your plan."
+  },
+  // ============================================
+  // Server Errors (500xx)
+  // ============================================
+  50001: {
+    title: "Internal server error",
+    description: "An internal server problem has occurred.",
+    action: "Please try again later."
+  },
+  50002: {
+    title: "Temporary error",
+    description: "Will be restored soon.",
+    action: "Please try again later."
+  },
+  50003: {
+    title: "Data processing error",
+    description: "A problem occurred while processing data.",
+    action: "Please try again later."
+  },
+  50006: {
+    title: "Failed to send email",
+    description: "Email sending failed.",
+    action: "Please try again later."
+  },
+  50007: {
+    title: "Temporary error",
+    description: "There is a problem with cache processing.",
+    action: "Please refresh the page."
+  },
+  50008: {
+    title: "File upload failed",
+    description: "There was a problem saving the file.",
+    action: "Please try again."
+  },
+  // ============================================
+  // Service Unavailable (503xx)
+  // ============================================
+  50304: {
+    title: "External service connection failed",
+    description: "The external service is not responding.",
+    action: "Please try again later."
+  },
+  50305: {
+    title: "Service under maintenance",
+    description: "Maintenance in progress.",
+    action: "Please visit again later."
+  },
+  // ============================================
+  // Security Errors (403xx - 71~79)
+  // ============================================
+  40371: {
+    title: "Access blocked",
+    description: "Blocked by security policy.",
+    action: "Please try again using the normal method."
+  },
+  40372: {
+    title: "Security validation failed",
+    description: "Security token has expired.",
+    action: "Please refresh the page."
+  },
+  40373: {
+    title: "URL not allowed",
+    description: "This URL is blocked for security reasons.",
+    action: "Please use a different URL."
+  },
+  40374: {
+    title: "Suspicious activity detected",
+    description: "Temporarily restricted.",
+    action: "Please contact customer support."
+  },
+  40375: {
+    title: "IP blocked",
+    description: "Blocked by security policy.",
+    action: "Please contact customer support."
+  },
+  40376: {
+    title: "CORS policy violation",
+    description: "Request from an unauthorized origin.",
+    action: "Please access from the correct address."
+  }
+};
+
+export {
+  enMessages
+};

package/dist/chunk-OIVXOT2X.js

@@ -0,0 +1,80 @@
+// src/utils/error-message-formatter.ts
+function formatRedisError(errorMessage) {
+  if (!errorMessage) {
+    return "Unknown Redis error";
+  }
+  let cleanMessage = errorMessage;
+  if (cleanMessage.startsWith("Command failed:")) {
+    cleanMessage = cleanMessage.replace(/^Command failed:\s*/, "").trim();
+  }
+  if (cleanMessage.startsWith("ERR ")) {
+    cleanMessage = cleanMessage.replace(/^ERR\s+/, "").trim();
+  }
+  cleanMessage = cleanMessage.replace(/\s*See https:\/\/upstash\.com\/[^\s]+\s*for details.*$/i, "").trim();
+  if (cleanMessage.includes("max requests limit exceeded")) {
+    const limitMatch = cleanMessage.match(/Limit:\s*(\d+)/);
+    const usageMatch = cleanMessage.match(/Usage:\s*(\d+)/);
+    if (limitMatch && usageMatch) {
+      const limit = parseInt(limitMatch[1]);
+      const usage = parseInt(usageMatch[1]);
+      const limitInK = Math.floor(limit / 1e3);
+      return `Redis request limit exceeded (${limitInK}K requests used). Please upgrade your plan or wait for the quota to reset.`;
+    }
+    return "Redis request limit exceeded. Please check your Upstash plan.";
+  }
+  if (cleanMessage.includes("timeout") || cleanMessage.includes("ETIMEDOUT")) {
+    return "Redis connection timeout. Please check network connectivity.";
+  }
+  if (cleanMessage.includes("NOAUTH") || cleanMessage.includes("authentication") || cleanMessage.includes("invalid password")) {
+    return "Redis authentication failed. Please check your credentials.";
+  }
+  if (cleanMessage.includes("ECONNREFUSED") || cleanMessage.includes("connection refused")) {
+    return "Redis connection refused. Please check Redis server status.";
+  }
+  if (cleanMessage.includes("ENOTFOUND") || cleanMessage.includes("getaddrinfo")) {
+    return "Redis server not found. Please check the Redis URL.";
+  }
+  if (cleanMessage.includes("network") || cleanMessage.includes("ENETUNREACH")) {
+    return "Network error connecting to Redis.";
+  }
+  if (cleanMessage.length > 100) {
+    return cleanMessage.substring(0, 100) + "...";
+  }
+  return cleanMessage;
+}
+function formatDatabaseError(errorMessage) {
+  if (!errorMessage) {
+    return "Unknown database error";
+  }
+  if (errorMessage.includes("timeout") || errorMessage.includes("ETIMEDOUT")) {
+    return "Database connection timeout. Please check network connectivity.";
+  }
+  if (errorMessage.includes("ECONNREFUSED") || errorMessage.includes("connection refused")) {
+    return "Database connection refused. Please check database server status.";
+  }
+  if (errorMessage.includes("authentication") || errorMessage.includes("password")) {
+    return "Database authentication failed. Please check your credentials.";
+  }
+  if (errorMessage.includes("too many connections") || errorMessage.includes("connection limit")) {
+    return "Database connection limit reached. Please try again later.";
+  }
+  if (errorMessage.includes("database") && errorMessage.includes("does not exist")) {
+    return "Database not found. Please check your configuration.";
+  }
+  return errorMessage.length > 100 ? errorMessage.substring(0, 100) + "..." : errorMessage;
+}
+function formatGenericError(errorMessage) {
+  if (!errorMessage) {
+    return "Unknown error occurred";
+  }
+  if (errorMessage.length > 150) {
+    return errorMessage.substring(0, 150) + "...";
+  }
+  return errorMessage;
+}
+
+export {
+  formatRedisError,
+  formatDatabaseError,
+  formatGenericError
+};

package/dist/chunk-ORMEWXMH.js

@@ -0,0 +1,37 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+
+export {
+  __spreadValues,
+  __spreadProps,
+  __objRest
+};

package/dist/chunk-POKGHK3L.js

@@ -0,0 +1,57 @@
+import {
+  getErrorMessage
+} from "./chunk-EEUBKZV4.js";
+import {
+  getErrorCategory
+} from "./chunk-Y3OTJH2S.js";
+
+// src/error/friendly-messages-v2.ts
+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 getErrorMessage(code, locale);
+}
+function getErrorDisplayInfo(code, locale = "ko") {
+  const message = getErrorMessage(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 {
+  getFriendlyMessage,
+  getErrorDisplayInfo,
+  formatFriendlyError
+};

package/dist/chunk-Q7IP4JMW.js

@@ -0,0 +1,69 @@
+import {
+  getCacheConfig
+} from "./chunk-TXGNSECL.js";
+import {
+  getENV
+} from "./chunk-I47QEDTX.js";
+
+// src/cache/noop-cache-manager.ts
+var NoopCacheManager = class {
+  constructor(prefix) {
+    this.prefix = prefix;
+  }
+  async get(_key) {
+    return null;
+  }
+  async set(_key, _value, _ttl) {
+  }
+  async delete(_key) {
+  }
+  async deletePattern(_pattern) {
+  }
+  async exists(_key) {
+    return false;
+  }
+  async increment() {
+    return 0;
+  }
+  async expire() {
+  }
+  getMetrics() {
+    return {
+      hits: 0,
+      misses: 0,
+      errors: 0,
+      totalRequests: 0,
+      hitRate: 0,
+      averageResponseTime: 0
+    };
+  }
+  getConnectionStatus() {
+    return {
+      isConnected: false,
+      connectionErrors: 0
+    };
+  }
+  async checkConnection() {
+    return false;
+  }
+  getConfig() {
+    const cacheConfig = getCacheConfig[this.prefix];
+    const envVarName = `CACHE_${this.prefix.toUpperCase()}_ENABLED`;
+    const ENV = getENV();
+    return {
+      prefix: this.prefix,
+      enabled: false,
+      reason: cacheConfig && !cacheConfig.enabled() ? "\uD658\uACBD \uBCC0\uC218\uB85C \uBE44\uD65C\uC131\uD654\uB428" : "\uC804\uC5ED \uCE90\uC2DC \uBE44\uD65C\uC131\uD654\uB428",
+      envVars: {
+        CACHE_ENABLED: ENV.CACHE.ENABLED ? "true" : "false",
+        [envVarName]: "disabled",
+        UPSTASH_REDIS_REST_URL: ENV.REDIS.URL ? "\uC124\uC815\uB428" : "\uBBF8\uC124\uC815",
+        UPSTASH_REDIS_REST_TOKEN: ENV.REDIS.TOKEN ? "\uC124\uC815\uB428" : "\uBBF8\uC124\uC815"
+      }
+    };
+  }
+};
+
+export {
+  NoopCacheManager
+};

package/dist/chunk-RJUVBBZG.js

@@ -0,0 +1,27 @@
+import {
+  cn
+} from "./chunk-62FLBG6B.js";
+import {
+  __objRest,
+  __spreadValues
+} from "./chunk-ORMEWXMH.js";
+
+// src/components/ui/Input.tsx
+import { jsx } from "react/jsx-runtime";
+function Input(_a) {
+  var _b = _a, { className, type } = _b, props = __objRest(_b, ["className", "type"]);
+  return /* @__PURE__ */ jsx(
+    "input",
+    __spreadValues({
+      type,
+      className: cn(
+        "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50",
+        className
+      )
+    }, props)
+  );
+}
+
+export {
+  Input
+};

package/dist/chunk-S73334QY.js

@@ -0,0 +1,89 @@
+import {
+  IPApiProvider
+} from "./chunk-DEEJBDJE.js";
+import {
+  IPApiCoProvider
+} from "./chunk-VSGKVZB4.js";
+import {
+  IPGeolocationProvider
+} from "./chunk-DH2ZHGW2.js";
+import {
+  MaxMindProvider
+} from "./chunk-4NWJ3WCZ.js";
+
+// src/geolocation/providers/index.ts
+var GeoIPProviderFactory = class {
+  /**
+   * 사용 가능한 제공자 목록 반환
+   */
+  static getAvailableProviders() {
+    return this.providers.filter((provider) => provider.isAvailable());
+  }
+  /**
+   * 이름으로 제공자 찾기
+   */
+  static getProvider(name) {
+    return this.providers.find((provider) => provider.name === name) || null;
+  }
+  /**
+   * 모든 제공자 목록 반환
+   */
+  static getAllProviders() {
+    return [...this.providers];
+  }
+  /**
+   * 제공자별 성능 통계
+   */
+  static getProviderStats() {
+    return this.providers.map((provider) => ({
+      name: provider.name,
+      available: provider.isAvailable(),
+      rateLimit: provider.getRateLimit(),
+      timeout: provider.getTimeout()
+    }));
+  }
+  /**
+   * 최적의 제공자 선택 (성능 기준)
+   */
+  static getOptimalProvider() {
+    const availableProviders = this.getAvailableProviders();
+    if (availableProviders.length === 0) return null;
+    return availableProviders.sort((a, b) => {
+      const scoreA = a.getRateLimit() / a.getTimeout();
+      const scoreB = b.getRateLimit() / b.getTimeout();
+      return scoreB - scoreA;
+    })[0];
+  }
+  /**
+   * 제공자 등록
+   */
+  static registerProvider(provider) {
+    const existingIndex = this.providers.findIndex((p) => p.name === provider.name);
+    if (existingIndex >= 0) {
+      this.providers[existingIndex] = provider;
+    } else {
+      this.providers.push(provider);
+    }
+  }
+  /**
+   * 제공자 제거
+   */
+  static unregisterProvider(name) {
+    const index = this.providers.findIndex((p) => p.name === name);
+    if (index >= 0) {
+      this.providers.splice(index, 1);
+      return true;
+    }
+    return false;
+  }
+};
+GeoIPProviderFactory.providers = [
+  new IPApiProvider(),
+  new IPApiCoProvider(),
+  new IPGeolocationProvider(),
+  new MaxMindProvider()
+];
+
+export {
+  GeoIPProviderFactory
+};