@within-7/minto 0.4.1 → 0.4.3

package/dist/utils/userFriendlyError.js

@@ -1,346 +0,0 @@
-import { randomUUID } from "crypto";
-import * as fs from "fs";
-import * as path from "path";
-import { t, tSafe } from "../i18n/index.js";
-var ErrorCategory = /* @__PURE__ */ ((ErrorCategory2) => {
-  ErrorCategory2["NETWORK_CONNECTION"] = "network_connection";
-  ErrorCategory2["NETWORK_TIMEOUT"] = "network_timeout";
-  ErrorCategory2["NETWORK_DNS"] = "network_dns";
-  ErrorCategory2["API_RATE_LIMIT"] = "api_rate_limit";
-  ErrorCategory2["API_AUTH"] = "api_auth";
-  ErrorCategory2["API_QUOTA"] = "api_quota";
-  ErrorCategory2["API_SERVER_ERROR"] = "api_server_error";
-  ErrorCategory2["API_INVALID_RESPONSE"] = "api_invalid_response";
-  ErrorCategory2["FILE_NOT_FOUND"] = "file_not_found";
-  ErrorCategory2["FILE_PERMISSION"] = "file_permission";
-  ErrorCategory2["FILE_TOO_LARGE"] = "file_too_large";
-  ErrorCategory2["FILE_ENCODING"] = "file_encoding";
-  ErrorCategory2["CONFIG_MISSING"] = "config_missing";
-  ErrorCategory2["CONFIG_INVALID"] = "config_invalid";
-  ErrorCategory2["CONFIG_API_KEY"] = "config_api_key";
-  ErrorCategory2["MODEL_UNAVAILABLE"] = "model_unavailable";
-  ErrorCategory2["MODEL_CONTEXT_LENGTH"] = "model_context_length";
-  ErrorCategory2["MODEL_CONTENT_FILTER"] = "model_content_filter";
-  ErrorCategory2["SYSTEM_MEMORY"] = "system_memory";
-  ErrorCategory2["SYSTEM_PROCESS"] = "system_process";
-  ErrorCategory2["UNKNOWN"] = "unknown";
-  return ErrorCategory2;
-})(ErrorCategory || {});
-const CATEGORY_TO_I18N_PREFIX = {
-  ["network_connection" /* NETWORK_CONNECTION */]: "friendlyError.networkConnection",
-  ["network_timeout" /* NETWORK_TIMEOUT */]: "friendlyError.networkTimeout",
-  ["network_dns" /* NETWORK_DNS */]: "friendlyError.networkDns",
-  ["api_rate_limit" /* API_RATE_LIMIT */]: "friendlyError.apiRateLimit",
-  ["api_auth" /* API_AUTH */]: "friendlyError.apiAuth",
-  ["api_quota" /* API_QUOTA */]: "friendlyError.apiQuota",
-  ["api_server_error" /* API_SERVER_ERROR */]: "friendlyError.apiServerError",
-  ["api_invalid_response" /* API_INVALID_RESPONSE */]: "friendlyError.apiInvalidResponse",
-  ["file_not_found" /* FILE_NOT_FOUND */]: "friendlyError.fileNotFound",
-  ["file_permission" /* FILE_PERMISSION */]: "friendlyError.filePermission",
-  ["file_too_large" /* FILE_TOO_LARGE */]: "friendlyError.fileTooLarge",
-  ["file_encoding" /* FILE_ENCODING */]: "friendlyError.fileEncoding",
-  ["config_missing" /* CONFIG_MISSING */]: "friendlyError.configMissing",
-  ["config_invalid" /* CONFIG_INVALID */]: "friendlyError.configInvalid",
-  ["config_api_key" /* CONFIG_API_KEY */]: "friendlyError.configApiKey",
-  ["model_unavailable" /* MODEL_UNAVAILABLE */]: "friendlyError.modelUnavailable",
-  ["model_context_length" /* MODEL_CONTEXT_LENGTH */]: "friendlyError.modelContextLength",
-  ["model_content_filter" /* MODEL_CONTENT_FILTER */]: "friendlyError.modelContentFilter",
-  ["system_memory" /* SYSTEM_MEMORY */]: "friendlyError.systemMemory",
-  ["system_process" /* SYSTEM_PROCESS */]: "friendlyError.systemProcess",
-  ["unknown" /* UNKNOWN */]: "friendlyError.unknown"
-};
-function getFriendlyMessage(category) {
-  const prefix = CATEGORY_TO_I18N_PREFIX[category];
-  const suggestions = [];
-  for (let i = 1; i <= 3; i++) {
-    const suggestion = tSafe(`${prefix}.suggestion${i}`);
-    if (suggestion) {
-      suggestions.push(suggestion);
-    }
-  }
-  return {
-    title: tSafe(`${prefix}.title`) || category,
-    description: tSafe(`${prefix}.description`) || "",
-    suggestions
-  };
-}
-const FRIENDLY_MESSAGES = Object.fromEntries(
-  Object.values(ErrorCategory).map((category) => [
-    category,
-    getFriendlyMessage(category)
-  ])
-);
-const ERROR_PATTERNS = [
-  // Network errors
-  {
-    category: "network_connection" /* NETWORK_CONNECTION */,
-    patterns: [
-      "socket.*closed",
-      "ECONNREFUSED",
-      "ECONNRESET",
-      "ENOTFOUND",
-      "connection.*refused",
-      "connection.*closed",
-      "network.*error",
-      "fetch failed"
-    ]
-  },
-  {
-    category: "network_timeout" /* NETWORK_TIMEOUT */,
-    patterns: [
-      "timeout",
-      "ETIMEDOUT",
-      "timed out",
-      "deadline exceeded",
-      "request.*timeout"
-    ]
-  },
-  {
-    category: "network_dns" /* NETWORK_DNS */,
-    patterns: ["ENOTFOUND", "getaddrinfo", "DNS", "resolve.*failed"]
-  },
-  // API errors
-  {
-    category: "api_rate_limit" /* API_RATE_LIMIT */,
-    patterns: ["rate.*limit", "429", "too many requests", "quota.*exceeded"]
-  },
-  {
-    category: "api_auth" /* API_AUTH */,
-    patterns: [
-      "401",
-      "unauthorized",
-      "authentication.*failed",
-      "invalid.*key",
-      "api.*key.*invalid"
-    ]
-  },
-  {
-    category: "api_quota" /* API_QUOTA */,
-    patterns: [
-      "insufficient.*quota",
-      "billing",
-      "credit",
-      "exceeded.*quota",
-      "402"
-    ]
-  },
-  {
-    category: "api_server_error" /* API_SERVER_ERROR */,
-    patterns: ["500", "502", "503", "504", "internal.*error", "server.*error"]
-  },
-  // File errors
-  {
-    category: "file_not_found" /* FILE_NOT_FOUND */,
-    patterns: ["ENOENT", "no such file", "file.*not.*found", "does not exist"]
-  },
-  {
-    category: "file_permission" /* FILE_PERMISSION */,
-    patterns: ["EACCES", "EPERM", "permission.*denied", "access.*denied"]
-  },
-  {
-    category: "file_too_large" /* FILE_TOO_LARGE */,
-    patterns: ["file.*too.*large", "EFBIG", "size.*limit"]
-  },
-  // Model errors
-  {
-    category: "model_context_length" /* MODEL_CONTEXT_LENGTH */,
-    patterns: [
-      "context.*length",
-      "token.*limit",
-      "max.*tokens",
-      "too.*long",
-      "exceeds.*maximum"
-    ]
-  },
-  {
-    category: "model_content_filter" /* MODEL_CONTENT_FILTER */,
-    patterns: ["content.*filter", "safety", "blocked", "moderation"]
-  },
-  {
-    category: "model_unavailable" /* MODEL_UNAVAILABLE */,
-    patterns: ["model.*not.*found", "model.*unavailable", "does not exist"]
-  },
-  // Config errors
-  {
-    category: "config_api_key" /* CONFIG_API_KEY */,
-    patterns: [
-      "api.*key.*not.*set",
-      "missing.*api.*key",
-      "ANTHROPIC_API_KEY",
-      "OPENAI_API_KEY"
-    ]
-  },
-  // System errors
-  {
-    category: "system_memory" /* SYSTEM_MEMORY */,
-    patterns: ["ENOMEM", "out of memory", "heap", "memory.*limit"]
-  }
-];
-function classifyError(error) {
-  const errorString = getErrorString(error).toLowerCase();
-  for (const { category, patterns } of ERROR_PATTERNS) {
-    for (const pattern of patterns) {
-      if (typeof pattern === "string") {
-        if (errorString.includes(pattern.toLowerCase())) {
-          return category;
-        }
-      } else if (pattern.test(errorString)) {
-        return category;
-      }
-    }
-  }
-  return "unknown" /* UNKNOWN */;
-}
-function getErrorString(error) {
-  if (error instanceof Error) {
-    return `${error.name}: ${error.message} ${error.stack || ""}`;
-  }
-  return String(error);
-}
-class UserFriendlyError extends Error {
-  id;
-  category;
-  friendlyMessage;
-  originalError;
-  context;
-  timestamp;
-  constructor(originalError, context = {}, categoryOverride) {
-    const category = categoryOverride || classifyError(originalError);
-    const friendly = FRIENDLY_MESSAGES[category];
-    super(friendly.title);
-    this.name = "UserFriendlyError";
-    this.id = randomUUID().slice(0, 8);
-    this.category = category;
-    this.friendlyMessage = friendly;
-    this.originalError = originalError;
-    this.context = context;
-    this.timestamp = /* @__PURE__ */ new Date();
-    if (originalError instanceof Error && originalError.stack) {
-      this.stack = originalError.stack;
-    }
-  }
-  /**
-   * Get user-facing display message
-   */
-  getUserMessage() {
-    const message = getFriendlyMessage(this.category);
-    const suggestionLabel = t("friendlyError.suggestionLabel");
-    const errorIdLabel = t("friendlyError.errorIdLabel");
-    const lines = [
-      `\u26A0\uFE0F ${message.title}`,
-      "",
-      message.description,
-      "",
-      `\u{1F4A1} ${suggestionLabel}:`,
-      ...message.suggestions.map((s) => `  \u2022 ${s}`),
-      "",
-      `\u{1F4CB} ${errorIdLabel}: ${this.id}`
-    ];
-    return lines.join("\n");
-  }
-  /**
-   * Get technical message for developers
-   */
-  getTechnicalMessage() {
-    const original = this.originalError instanceof Error ? this.originalError.message : String(this.originalError);
-    return `[${this.category}] ${original}`;
-  }
-  /**
-   * Create structured log entry
-   */
-  toLogEntry() {
-    return {
-      id: this.id,
-      timestamp: this.timestamp.toISOString(),
-      category: this.category,
-      friendlyTitle: this.friendlyMessage.title,
-      technicalMessage: this.getTechnicalMessage(),
-      stack: this.stack,
-      context: this.context,
-      systemInfo: {
-        platform: process.platform,
-        nodeVersion: process.version,
-        mintoVersion: getMintoVersion()
-      }
-    };
-  }
-}
-let errorLogPath = null;
-function getErrorLogPath() {
-  if (!errorLogPath) {
-    const logDir = path.join(process.env.HOME || "", ".minto", "logs");
-    errorLogPath = path.join(logDir, "errors.jsonl");
-  }
-  return errorLogPath;
-}
-function logUserFriendlyError(error) {
-  try {
-    const logPath = getErrorLogPath();
-    const logDir = path.dirname(logPath);
-    if (!fs.existsSync(logDir)) {
-      fs.mkdirSync(logDir, { recursive: true });
-    }
-    const entry = error.toLogEntry();
-    fs.appendFileSync(logPath, JSON.stringify(entry) + "\n");
-  } catch {
-  }
-}
-function getRecentErrors(limit = 10) {
-  try {
-    const logPath = getErrorLogPath();
-    if (!fs.existsSync(logPath)) {
-      return [];
-    }
-    const content = fs.readFileSync(logPath, "utf-8");
-    const lines = content.trim().split("\n").filter(Boolean);
-    const entries = lines.slice(-limit).map((line) => {
-      try {
-        return JSON.parse(line);
-      } catch {
-        return null;
-      }
-    }).filter((e) => e !== null);
-    return entries.reverse();
-  } catch {
-    return [];
-  }
-}
-function getMintoVersion() {
-  try {
-    const packageJsonPath = path.join(__dirname, "../../package.json");
-    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
-    return packageJson.version || "unknown";
-  } catch {
-    return "unknown";
-  }
-}
-function toUserFriendlyError(error, context) {
-  if (error instanceof UserFriendlyError) {
-    return error;
-  }
-  return new UserFriendlyError(error, context);
-}
-function formatErrorForUser(error, options = {}) {
-  const friendly = toUserFriendlyError(error, options.context);
-  logUserFriendlyError(friendly);
-  let message = friendly.getUserMessage();
-  if (options.showTechnical) {
-    const technicalLabel = t("friendlyError.technicalDetailsLabel");
-    message += `
-
-\u{1F527} ${technicalLabel}: ${friendly.getTechnicalMessage()}`;
-  }
-  return message;
-}
-export {
-  ERROR_PATTERNS,
-  ErrorCategory,
-  FRIENDLY_MESSAGES,
-  UserFriendlyError,
-  classifyError,
-  formatErrorForUser,
-  getRecentErrors,
-  logUserFriendlyError,
-  toUserFriendlyError
-};
-//# sourceMappingURL=userFriendlyError.js.map

package/dist/utils/userFriendlyError.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/userFriendlyError.ts"],
-  "sourcesContent": ["/**\n * User-Friendly Error System\n *\n * Transforms technical errors into friendly messages for non-developer users.\n * Provides structured logging for debugging and optional cloud reporting.\n *\n * Design Philosophy:\n * - User layer: Simple, actionable messages in their language\n * - Developer layer: Full technical details for debugging\n * - Operations layer: Structured data for analysis and improvement\n */\n\nimport { randomUUID } from 'crypto'\nimport * as fs from 'fs'\nimport * as path from 'path'\nimport { t, tSafe } from '@i18n/index'\n\n// ============================================================================\n// Error Categories\n// ============================================================================\n\n/**\n * High-level error categories that map to user-understandable concepts\n */\nexport enum ErrorCategory {\n  // Network & Connectivity\n  NETWORK_CONNECTION = 'network_connection', // Can't reach the server\n  NETWORK_TIMEOUT = 'network_timeout', // Request took too long\n  NETWORK_DNS = 'network_dns', // Can't find the server\n\n  // API & Service\n  API_RATE_LIMIT = 'api_rate_limit', // Too many requests\n  API_AUTH = 'api_auth', // Authentication failed\n  API_QUOTA = 'api_quota', // Usage quota exceeded\n  API_SERVER_ERROR = 'api_server_error', // Server is having issues\n  API_INVALID_RESPONSE = 'api_invalid_response', // Unexpected response\n\n  // File & Storage\n  FILE_NOT_FOUND = 'file_not_found', // File doesn't exist\n  FILE_PERMISSION = 'file_permission', // Can't access file\n  FILE_TOO_LARGE = 'file_too_large', // File is too big\n  FILE_ENCODING = 'file_encoding', // Can't read file format\n\n  // Configuration\n  CONFIG_MISSING = 'config_missing', // Missing required setting\n  CONFIG_INVALID = 'config_invalid', // Invalid setting value\n  CONFIG_API_KEY = 'config_api_key', // API key issue\n\n  // Model & AI\n  MODEL_UNAVAILABLE = 'model_unavailable', // Model not accessible\n  MODEL_CONTEXT_LENGTH = 'model_context_length', // Input too long\n  MODEL_CONTENT_FILTER = 'model_content_filter', // Content blocked\n\n  // System\n  SYSTEM_MEMORY = 'system_memory', // Out of memory\n  SYSTEM_PROCESS = 'system_process', // Process error\n\n  // Unknown\n  UNKNOWN = 'unknown', // Unclassified error\n}\n\n// ============================================================================\n// User-Friendly Messages (Multi-language support via i18n)\n// ============================================================================\n\ninterface FriendlyMessage {\n  title: string\n  description: string\n  suggestions: string[]\n}\n\n/**\n * Maps error categories to i18n translation key prefixes\n */\nconst CATEGORY_TO_I18N_PREFIX: Record<ErrorCategory, string> = {\n  [ErrorCategory.NETWORK_CONNECTION]: 'friendlyError.networkConnection',\n  [ErrorCategory.NETWORK_TIMEOUT]: 'friendlyError.networkTimeout',\n  [ErrorCategory.NETWORK_DNS]: 'friendlyError.networkDns',\n  [ErrorCategory.API_RATE_LIMIT]: 'friendlyError.apiRateLimit',\n  [ErrorCategory.API_AUTH]: 'friendlyError.apiAuth',\n  [ErrorCategory.API_QUOTA]: 'friendlyError.apiQuota',\n  [ErrorCategory.API_SERVER_ERROR]: 'friendlyError.apiServerError',\n  [ErrorCategory.API_INVALID_RESPONSE]: 'friendlyError.apiInvalidResponse',\n  [ErrorCategory.FILE_NOT_FOUND]: 'friendlyError.fileNotFound',\n  [ErrorCategory.FILE_PERMISSION]: 'friendlyError.filePermission',\n  [ErrorCategory.FILE_TOO_LARGE]: 'friendlyError.fileTooLarge',\n  [ErrorCategory.FILE_ENCODING]: 'friendlyError.fileEncoding',\n  [ErrorCategory.CONFIG_MISSING]: 'friendlyError.configMissing',\n  [ErrorCategory.CONFIG_INVALID]: 'friendlyError.configInvalid',\n  [ErrorCategory.CONFIG_API_KEY]: 'friendlyError.configApiKey',\n  [ErrorCategory.MODEL_UNAVAILABLE]: 'friendlyError.modelUnavailable',\n  [ErrorCategory.MODEL_CONTEXT_LENGTH]: 'friendlyError.modelContextLength',\n  [ErrorCategory.MODEL_CONTENT_FILTER]: 'friendlyError.modelContentFilter',\n  [ErrorCategory.SYSTEM_MEMORY]: 'friendlyError.systemMemory',\n  [ErrorCategory.SYSTEM_PROCESS]: 'friendlyError.systemProcess',\n  [ErrorCategory.UNKNOWN]: 'friendlyError.unknown',\n}\n\n/**\n * Get friendly message using i18n\n * Designed for non-technical users (analysts, researchers, writers, etc.)\n */\nfunction getFriendlyMessage(category: ErrorCategory): FriendlyMessage {\n  const prefix = CATEGORY_TO_I18N_PREFIX[category]\n\n  // Build suggestions array dynamically (use tSafe to avoid warnings for missing keys)\n  const suggestions: string[] = []\n  for (let i = 1; i <= 3; i++) {\n    const suggestion = tSafe(`${prefix}.suggestion${i}`)\n    if (suggestion) {\n      suggestions.push(suggestion)\n    }\n  }\n\n  return {\n    title: tSafe(`${prefix}.title`) || category,\n    description: tSafe(`${prefix}.description`) || '',\n    suggestions,\n  }\n}\n\n/**\n * Legacy FRIENDLY_MESSAGES for backward compatibility\n * @deprecated Use getFriendlyMessage() for i18n support\n */\nconst FRIENDLY_MESSAGES: Record<ErrorCategory, FriendlyMessage> =\n  Object.fromEntries(\n    Object.values(ErrorCategory).map(category => [\n      category,\n      getFriendlyMessage(category),\n    ]),\n  ) as Record<ErrorCategory, FriendlyMessage>\n\n// ============================================================================\n// Error Classification Logic\n// ============================================================================\n\ninterface ErrorPattern {\n  category: ErrorCategory\n  patterns: (string | RegExp)[]\n}\n\n/**\n * Patterns to classify raw errors into categories\n * Order matters - more specific patterns should come first\n */\nconst ERROR_PATTERNS: ErrorPattern[] = [\n  // Network errors\n  {\n    category: ErrorCategory.NETWORK_CONNECTION,\n    patterns: [\n      'socket.*closed',\n      'ECONNREFUSED',\n      'ECONNRESET',\n      'ENOTFOUND',\n      'connection.*refused',\n      'connection.*closed',\n      'network.*error',\n      'fetch failed',\n    ],\n  },\n  {\n    category: ErrorCategory.NETWORK_TIMEOUT,\n    patterns: [\n      'timeout',\n      'ETIMEDOUT',\n      'timed out',\n      'deadline exceeded',\n      'request.*timeout',\n    ],\n  },\n  {\n    category: ErrorCategory.NETWORK_DNS,\n    patterns: ['ENOTFOUND', 'getaddrinfo', 'DNS', 'resolve.*failed'],\n  },\n\n  // API errors\n  {\n    category: ErrorCategory.API_RATE_LIMIT,\n    patterns: ['rate.*limit', '429', 'too many requests', 'quota.*exceeded'],\n  },\n  {\n    category: ErrorCategory.API_AUTH,\n    patterns: [\n      '401',\n      'unauthorized',\n      'authentication.*failed',\n      'invalid.*key',\n      'api.*key.*invalid',\n    ],\n  },\n  {\n    category: ErrorCategory.API_QUOTA,\n    patterns: [\n      'insufficient.*quota',\n      'billing',\n      'credit',\n      'exceeded.*quota',\n      '402',\n    ],\n  },\n  {\n    category: ErrorCategory.API_SERVER_ERROR,\n    patterns: ['500', '502', '503', '504', 'internal.*error', 'server.*error'],\n  },\n\n  // File errors\n  {\n    category: ErrorCategory.FILE_NOT_FOUND,\n    patterns: ['ENOENT', 'no such file', 'file.*not.*found', 'does not exist'],\n  },\n  {\n    category: ErrorCategory.FILE_PERMISSION,\n    patterns: ['EACCES', 'EPERM', 'permission.*denied', 'access.*denied'],\n  },\n  {\n    category: ErrorCategory.FILE_TOO_LARGE,\n    patterns: ['file.*too.*large', 'EFBIG', 'size.*limit'],\n  },\n\n  // Model errors\n  {\n    category: ErrorCategory.MODEL_CONTEXT_LENGTH,\n    patterns: [\n      'context.*length',\n      'token.*limit',\n      'max.*tokens',\n      'too.*long',\n      'exceeds.*maximum',\n    ],\n  },\n  {\n    category: ErrorCategory.MODEL_CONTENT_FILTER,\n    patterns: ['content.*filter', 'safety', 'blocked', 'moderation'],\n  },\n  {\n    category: ErrorCategory.MODEL_UNAVAILABLE,\n    patterns: ['model.*not.*found', 'model.*unavailable', 'does not exist'],\n  },\n\n  // Config errors\n  {\n    category: ErrorCategory.CONFIG_API_KEY,\n    patterns: [\n      'api.*key.*not.*set',\n      'missing.*api.*key',\n      'ANTHROPIC_API_KEY',\n      'OPENAI_API_KEY',\n    ],\n  },\n\n  // System errors\n  {\n    category: ErrorCategory.SYSTEM_MEMORY,\n    patterns: ['ENOMEM', 'out of memory', 'heap', 'memory.*limit'],\n  },\n]\n\n/**\n * Classifies a raw error into a category\n */\nexport function classifyError(error: unknown): ErrorCategory {\n  const errorString = getErrorString(error).toLowerCase()\n\n  for (const { category, patterns } of ERROR_PATTERNS) {\n    for (const pattern of patterns) {\n      if (typeof pattern === 'string') {\n        if (errorString.includes(pattern.toLowerCase())) {\n          return category\n        }\n      } else if (pattern.test(errorString)) {\n        return category\n      }\n    }\n  }\n\n  return ErrorCategory.UNKNOWN\n}\n\nfunction getErrorString(error: unknown): string {\n  if (error instanceof Error) {\n    return `${error.name}: ${error.message} ${error.stack || ''}`\n  }\n  return String(error)\n}\n\n// ============================================================================\n// User-Friendly Error Class\n// ============================================================================\n\nexport interface ErrorContext {\n  /** Operation being performed (e.g., \"reading file\", \"calling API\") */\n  operation?: string\n  /** Model being used */\n  model?: string\n  /** File path involved */\n  filePath?: string\n  /** API endpoint */\n  endpoint?: string\n  /** Additional context */\n  [key: string]: unknown\n}\n\nexport interface ErrorLogEntry {\n  id: string\n  timestamp: string\n  category: ErrorCategory\n  friendlyTitle: string\n  technicalMessage: string\n  stack?: string\n  context: ErrorContext\n  systemInfo: {\n    platform: string\n    nodeVersion: string\n    mintoVersion: string\n  }\n}\n\n/**\n * User-Friendly Error wrapper\n * Provides both user-facing messages and technical details\n */\nexport class UserFriendlyError extends Error {\n  readonly id: string\n  readonly category: ErrorCategory\n  readonly friendlyMessage: FriendlyMessage\n  readonly originalError: unknown\n  readonly context: ErrorContext\n  readonly timestamp: Date\n\n  constructor(\n    originalError: unknown,\n    context: ErrorContext = {},\n    categoryOverride?: ErrorCategory,\n  ) {\n    const category = categoryOverride || classifyError(originalError)\n    const friendly = FRIENDLY_MESSAGES[category]\n\n    super(friendly.title)\n    this.name = 'UserFriendlyError'\n    this.id = randomUUID().slice(0, 8)\n    this.category = category\n    this.friendlyMessage = friendly\n    this.originalError = originalError\n    this.context = context\n    this.timestamp = new Date()\n\n    // Preserve original stack\n    if (originalError instanceof Error && originalError.stack) {\n      this.stack = originalError.stack\n    }\n  }\n\n  /**\n   * Get user-facing display message\n   */\n  getUserMessage(): string {\n    // Get fresh translations (in case language changed)\n    const message = getFriendlyMessage(this.category)\n    const suggestionLabel = t('friendlyError.suggestionLabel')\n    const errorIdLabel = t('friendlyError.errorIdLabel')\n\n    const lines = [\n      `\u26A0\uFE0F ${message.title}`,\n      '',\n      message.description,\n      '',\n      `\uD83D\uDCA1 ${suggestionLabel}:`,\n      ...message.suggestions.map(s => `  \u2022 ${s}`),\n      '',\n      `\uD83D\uDCCB ${errorIdLabel}: ${this.id}`,\n    ]\n    return lines.join('\\n')\n  }\n\n  /**\n   * Get technical message for developers\n   */\n  getTechnicalMessage(): string {\n    const original =\n      this.originalError instanceof Error\n        ? this.originalError.message\n        : String(this.originalError)\n    return `[${this.category}] ${original}`\n  }\n\n  /**\n   * Create structured log entry\n   */\n  toLogEntry(): ErrorLogEntry {\n    return {\n      id: this.id,\n      timestamp: this.timestamp.toISOString(),\n      category: this.category,\n      friendlyTitle: this.friendlyMessage.title,\n      technicalMessage: this.getTechnicalMessage(),\n      stack: this.stack,\n      context: this.context,\n      systemInfo: {\n        platform: process.platform,\n        nodeVersion: process.version,\n        mintoVersion: getMintoVersion(),\n      },\n    }\n  }\n}\n\n// ============================================================================\n// Error Logging\n// ============================================================================\n\nlet errorLogPath: string | null = null\n\nfunction getErrorLogPath(): string {\n  if (!errorLogPath) {\n    const logDir = path.join(process.env.HOME || '', '.minto', 'logs')\n    errorLogPath = path.join(logDir, 'errors.jsonl')\n  }\n  return errorLogPath\n}\n\n/**\n * Log error to local file (JSONL format for easy analysis)\n */\nexport function logUserFriendlyError(error: UserFriendlyError): void {\n  try {\n    const logPath = getErrorLogPath()\n    const logDir = path.dirname(logPath)\n\n    // Ensure log directory exists\n    if (!fs.existsSync(logDir)) {\n      fs.mkdirSync(logDir, { recursive: true })\n    }\n\n    const entry = error.toLogEntry()\n    fs.appendFileSync(logPath, JSON.stringify(entry) + '\\n')\n  } catch {\n    // Silent fail - don't let logging errors break the app\n  }\n}\n\n/**\n * Get recent errors for debugging\n */\nexport function getRecentErrors(limit = 10): ErrorLogEntry[] {\n  try {\n    const logPath = getErrorLogPath()\n    if (!fs.existsSync(logPath)) {\n      return []\n    }\n\n    const content = fs.readFileSync(logPath, 'utf-8')\n    const lines = content.trim().split('\\n').filter(Boolean)\n    const entries = lines\n      .slice(-limit)\n      .map(line => {\n        try {\n          return JSON.parse(line) as ErrorLogEntry\n        } catch {\n          return null\n        }\n      })\n      .filter((e): e is ErrorLogEntry => e !== null)\n\n    return entries.reverse()\n  } catch {\n    return []\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nfunction getMintoVersion(): string {\n  try {\n    const packageJsonPath = path.join(__dirname, '../../package.json')\n    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'))\n    return packageJson.version || 'unknown'\n  } catch {\n    return 'unknown'\n  }\n}\n\n/**\n * Wrap any error into a UserFriendlyError\n */\nexport function toUserFriendlyError(\n  error: unknown,\n  context?: ErrorContext,\n): UserFriendlyError {\n  if (error instanceof UserFriendlyError) {\n    return error\n  }\n  return new UserFriendlyError(error, context)\n}\n\n/**\n * Format error for display to user\n * Returns the friendly message, optionally with technical details\n */\nexport function formatErrorForUser(\n  error: unknown,\n  options: { showTechnical?: boolean; context?: ErrorContext } = {},\n): string {\n  const friendly = toUserFriendlyError(error, options.context)\n\n  // Log the error\n  logUserFriendlyError(friendly)\n\n  let message = friendly.getUserMessage()\n\n  if (options.showTechnical) {\n    const technicalLabel = t('friendlyError.technicalDetailsLabel')\n    message += `\\n\\n\uD83D\uDD27 ${technicalLabel}: ${friendly.getTechnicalMessage()}`\n  }\n\n  return message\n}\n\n// ============================================================================\n// Exports for Integration\n// ============================================================================\n\nexport { FRIENDLY_MESSAGES, ERROR_PATTERNS }\n"],
-  "mappings": "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",
-  "names": ["ErrorCategory"]
-}

package/dist/utils/validate.js

@@ -1,132 +0,0 @@
-function validateField(field, value) {
-  const trimmed = value.trim();
-  if (!trimmed && field === "address2") {
-    return null;
-  }
-  if (!trimmed) {
-    return { message: "This field is required" };
-  }
-  switch (field) {
-    case "email": {
-      const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
-      if (!emailRegex.test(trimmed)) {
-        return { message: "Please enter a valid email address" };
-      }
-      break;
-    }
-    case "name":
-      if (trimmed.length < 2) {
-        return { message: "Name must be at least 2 characters long" };
-      }
-      break;
-    case "address1": {
-      if (trimmed.length < 3) {
-        return { message: "Please enter a valid address" };
-      }
-      const isPOBox = /^P\.?O\.?\s*Box\s+\d+$/i.test(trimmed);
-      const hasNumber = /\d+/.test(trimmed);
-      if (!isPOBox && !hasNumber) {
-        return { message: "Please include a number in the street address" };
-      }
-      break;
-    }
-    case "address2":
-      break;
-    case "city":
-      if (trimmed.length < 2) {
-        return { message: "City name must be at least 2 characters long" };
-      }
-      if (!/^[a-zA-Z\s.-]+$/.test(trimmed)) {
-        return {
-          message: "City can only contain letters, spaces, periods, and hyphens"
-        };
-      }
-      break;
-    case "state": {
-      const states = /* @__PURE__ */ new Set([
-        "AL",
-        "AK",
-        "AZ",
-        "AR",
-        "CA",
-        "CO",
-        "CT",
-        "DE",
-        "FL",
-        "GA",
-        "HI",
-        "ID",
-        "IL",
-        "IN",
-        "IA",
-        "KS",
-        "KY",
-        "LA",
-        "ME",
-        "MD",
-        "MA",
-        "MI",
-        "MN",
-        "MS",
-        "MO",
-        "MT",
-        "NE",
-        "NV",
-        "NH",
-        "NJ",
-        "NM",
-        "NY",
-        "NC",
-        "ND",
-        "OH",
-        "OK",
-        "OR",
-        "PA",
-        "RI",
-        "SC",
-        "SD",
-        "TN",
-        "TX",
-        "UT",
-        "VT",
-        "VA",
-        "WA",
-        "WV",
-        "WI",
-        "WY",
-        "DC"
-      ]);
-      const stateCode = trimmed.toUpperCase();
-      if (!states.has(stateCode)) {
-        return { message: "Please enter a valid US state code (e.g. CA)" };
-      }
-      break;
-    }
-    case "usLocation": {
-      const normalized = trimmed.toLowerCase();
-      if (!["y", "yes", "n", "no"].includes(normalized)) {
-        return { message: "Please enter y/yes or n/no" };
-      }
-      break;
-    }
-    case "zip":
-      if (!/^\d{5}(-\d{4})?$/.test(trimmed)) {
-        return {
-          message: "Please enter a valid ZIP code (e.g. 12345 or 12345-6789)"
-        };
-      }
-      break;
-    case "phone":
-      if (!/^(\+1\s?)?(\d{3}[-.\s]??)?\d{3}[-.\s]??\d{4}$/.test(trimmed)) {
-        return {
-          message: "Please enter a valid US phone number"
-        };
-      }
-      break;
-  }
-  return null;
-}
-export {
-  validateField
-};
-//# sourceMappingURL=validate.js.map

package/dist/utils/validate.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/validate.ts"],
-  "sourcesContent": ["export type FormData = {\n  name: string\n  email: string\n  address1: string\n  address2: string\n  city: string\n  state: string\n  zip: string\n  phone: string\n  usLocation: boolean\n}\n\nexport type ValidationError = {\n  message: string\n}\n\nexport function validateField(\n  field: keyof FormData,\n  value: string,\n): ValidationError | null {\n  // Trim whitespace for validation\n  const trimmed = value.trim()\n\n  if (!trimmed && field === 'address2') {\n    return null // address2 is optional\n  }\n\n  // Basic required field check\n  if (!trimmed) {\n    return { message: 'This field is required' }\n  }\n\n  switch (field) {\n    case 'email': {\n      const emailRegex =\n        /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/\n      if (!emailRegex.test(trimmed)) {\n        return { message: 'Please enter a valid email address' }\n      }\n      break\n    }\n\n    case 'name':\n      if (trimmed.length < 2) {\n        return { message: 'Name must be at least 2 characters long' }\n      }\n      break\n\n    case 'address1': {\n      if (trimmed.length < 3) {\n        return { message: 'Please enter a valid address' }\n      }\n      // Accept PO Box format or regular street address\n      const isPOBox = /^P\\.?O\\.?\\s*Box\\s+\\d+$/i.test(trimmed)\n      const hasNumber = /\\d+/.test(trimmed)\n      if (!isPOBox && !hasNumber) {\n        return { message: 'Please include a number in the street address' }\n      }\n      break\n    }\n    case 'address2':\n      break\n\n    case 'city':\n      if (trimmed.length < 2) {\n        return { message: 'City name must be at least 2 characters long' }\n      }\n      if (!/^[a-zA-Z\\s.-]+$/.test(trimmed)) {\n        return {\n          message:\n            'City can only contain letters, spaces, periods, and hyphens',\n        }\n      }\n      break\n\n    case 'state': {\n      const states = new Set([\n        'AL',\n        'AK',\n        'AZ',\n        'AR',\n        'CA',\n        'CO',\n        'CT',\n        'DE',\n        'FL',\n        'GA',\n        'HI',\n        'ID',\n        'IL',\n        'IN',\n        'IA',\n        'KS',\n        'KY',\n        'LA',\n        'ME',\n        'MD',\n        'MA',\n        'MI',\n        'MN',\n        'MS',\n        'MO',\n        'MT',\n        'NE',\n        'NV',\n        'NH',\n        'NJ',\n        'NM',\n        'NY',\n        'NC',\n        'ND',\n        'OH',\n        'OK',\n        'OR',\n        'PA',\n        'RI',\n        'SC',\n        'SD',\n        'TN',\n        'TX',\n        'UT',\n        'VT',\n        'VA',\n        'WA',\n        'WV',\n        'WI',\n        'WY',\n        'DC',\n      ])\n      const stateCode = trimmed.toUpperCase()\n      if (!states.has(stateCode)) {\n        return { message: 'Please enter a valid US state code (e.g. CA)' }\n      }\n      break\n    }\n\n    case 'usLocation': {\n      const normalized = trimmed.toLowerCase()\n      if (!['y', 'yes', 'n', 'no'].includes(normalized)) {\n        return { message: 'Please enter y/yes or n/no' }\n      }\n      break\n    }\n\n    case 'zip':\n      // ZIP code validation for US\n      if (!/^\\d{5}(-\\d{4})?$/.test(trimmed)) {\n        return {\n          message: 'Please enter a valid ZIP code (e.g. 12345 or 12345-6789)',\n        }\n      }\n      break\n\n    case 'phone':\n      // Phone validation for US (allow various formats)\n      if (!/^(\\+1\\s?)?(\\d{3}[-.\\s]??)?\\d{3}[-.\\s]??\\d{4}$/.test(trimmed)) {\n        return {\n          message: 'Please enter a valid US phone number',\n        }\n      }\n      break\n  }\n\n  return null\n}\n"],
-  "mappings": "AAgBO,SAAS,cACd,OACA,OACwB;AAExB,QAAM,UAAU,MAAM,KAAK;AAE3B,MAAI,CAAC,WAAW,UAAU,YAAY;AACpC,WAAO;AAAA,EACT;AAGA,MAAI,CAAC,SAAS;AACZ,WAAO,EAAE,SAAS,yBAAyB;AAAA,EAC7C;AAEA,UAAQ,OAAO;AAAA,IACb,KAAK,SAAS;AACZ,YAAM,aACJ;AACF,UAAI,CAAC,WAAW,KAAK,OAAO,GAAG;AAC7B,eAAO,EAAE,SAAS,qCAAqC;AAAA,MACzD;AACA;AAAA,IACF;AAAA,IAEA,KAAK;AACH,UAAI,QAAQ,SAAS,GAAG;AACtB,eAAO,EAAE,SAAS,0CAA0C;AAAA,MAC9D;AACA;AAAA,IAEF,KAAK,YAAY;AACf,UAAI,QAAQ,SAAS,GAAG;AACtB,eAAO,EAAE,SAAS,+BAA+B;AAAA,MACnD;AAEA,YAAM,UAAU,0BAA0B,KAAK,OAAO;AACtD,YAAM,YAAY,MAAM,KAAK,OAAO;AACpC,UAAI,CAAC,WAAW,CAAC,WAAW;AAC1B,eAAO,EAAE,SAAS,gDAAgD;AAAA,MACpE;AACA;AAAA,IACF;AAAA,IACA,KAAK;AACH;AAAA,IAEF,KAAK;AACH,UAAI,QAAQ,SAAS,GAAG;AACtB,eAAO,EAAE,SAAS,+CAA+C;AAAA,MACnE;AACA,UAAI,CAAC,kBAAkB,KAAK,OAAO,GAAG;AACpC,eAAO;AAAA,UACL,SACE;AAAA,QACJ;AAAA,MACF;AACA;AAAA,IAEF,KAAK,SAAS;AACZ,YAAM,SAAS,oBAAI,IAAI;AAAA,QACrB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AACD,YAAM,YAAY,QAAQ,YAAY;AACtC,UAAI,CAAC,OAAO,IAAI,SAAS,GAAG;AAC1B,eAAO,EAAE,SAAS,+CAA+C;AAAA,MACnE;AACA;AAAA,IACF;AAAA,IAEA,KAAK,cAAc;AACjB,YAAM,aAAa,QAAQ,YAAY;AACvC,UAAI,CAAC,CAAC,KAAK,OAAO,KAAK,IAAI,EAAE,SAAS,UAAU,GAAG;AACjD,eAAO,EAAE,SAAS,6BAA6B;AAAA,MACjD;AACA;AAAA,IACF;AAAA,IAEA,KAAK;AAEH,UAAI,CAAC,mBAAmB,KAAK,OAAO,GAAG;AACrC,eAAO;AAAA,UACL,SAAS;AAAA,QACX;AAAA,MACF;AACA;AAAA,IAEF,KAAK;AAEH,UAAI,CAAC,gDAAgD,KAAK,OAAO,GAAG;AAClE,eAAO;AAAA,UACL,SAAS;AAAA,QACX;AAAA,MACF;AACA;AAAA,EACJ;AAEA,SAAO;AACT;",
-  "names": []
-}

package/dist/version.js

@@ -1,7 +0,0 @@
-const VERSION = "0.4.1";
-const BUILD_DATE = "2026-02-23T23:12:52.791Z";
-export {
-  BUILD_DATE,
-  VERSION
-};
-//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/version.ts"],
-  "sourcesContent": ["/**\n * Application version\n * This file is auto-generated during build process\n */\n\nexport const VERSION = '0.4.1'\nexport const BUILD_DATE = '2026-02-23T23:12:52.791Z'\n"],
-  "mappings": "AAKO,MAAM,UAAU;AAChB,MAAM,aAAa;",
-  "names": []
-}