@vasperacapital/vaspera-shared 0.1.0

package/dist/errors/index.js

@@ -0,0 +1,341 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/errors/index.ts
+var errors_exports = {};
+__export(errors_exports, {
+  ErrorCodes: () => ErrorCodes,
+  Errors: () => Errors,
+  VasperaApiError: () => VasperaApiError,
+  createError: () => createError,
+  createErrorResponse: () => createErrorResponse
+});
+module.exports = __toCommonJS(errors_exports);
+
+// src/errors/codes.ts
+var ErrorCodes = {
+  // Authentication Errors (VPM-AUTH-XXX)
+  AUTH: {
+    REQUIRED: {
+      code: "VPM-AUTH-001",
+      message: "Authentication required",
+      httpStatus: 401
+    },
+    INVALID_TOKEN: {
+      code: "VPM-AUTH-002",
+      message: "Invalid or expired authentication token",
+      httpStatus: 401
+    },
+    INSUFFICIENT_PERMISSIONS: {
+      code: "VPM-AUTH-003",
+      message: "Insufficient permissions for this action",
+      httpStatus: 403
+    },
+    SESSION_EXPIRED: {
+      code: "VPM-AUTH-004",
+      message: "Session has expired, please login again",
+      httpStatus: 401
+    },
+    MFA_REQUIRED: {
+      code: "VPM-AUTH-005",
+      message: "Multi-factor authentication required",
+      httpStatus: 403
+    }
+  },
+  // API Key Errors (VPM-API-KEY-XXX)
+  API_KEY: {
+    REQUIRED: {
+      code: "VPM-API-KEY-001",
+      message: "API key is required",
+      httpStatus: 401
+    },
+    INVALID: {
+      code: "VPM-API-KEY-002",
+      message: "Invalid API key",
+      httpStatus: 401
+    },
+    REVOKED: {
+      code: "VPM-API-KEY-003",
+      message: "API key has been revoked",
+      httpStatus: 401
+    },
+    EXPIRED: {
+      code: "VPM-API-KEY-004",
+      message: "API key has expired",
+      httpStatus: 401
+    },
+    RATE_LIMITED: {
+      code: "VPM-API-KEY-005",
+      message: "API key rate limit exceeded",
+      httpStatus: 429
+    },
+    QUOTA_EXCEEDED: {
+      code: "VPM-API-KEY-006",
+      message: "Monthly usage quota exceeded",
+      httpStatus: 429
+    }
+  },
+  // MCP Tool Errors (VPM-MCP-XXX)
+  MCP: {
+    TOOL_NOT_FOUND: {
+      code: "VPM-MCP-001",
+      message: "Requested tool not found",
+      httpStatus: 404
+    },
+    INVALID_ARGUMENTS: {
+      code: "VPM-MCP-002",
+      message: "Invalid tool arguments provided",
+      httpStatus: 400
+    },
+    EXECUTION_FAILED: {
+      code: "VPM-MCP-003",
+      message: "Tool execution failed",
+      httpStatus: 500
+    },
+    TIMEOUT: {
+      code: "VPM-MCP-004",
+      message: "Tool execution timed out",
+      httpStatus: 504
+    },
+    LLM_ERROR: {
+      code: "VPM-MCP-005",
+      message: "AI model returned an error",
+      httpStatus: 502
+    },
+    CONTEXT_TOO_LARGE: {
+      code: "VPM-MCP-006",
+      message: "Input context exceeds maximum size",
+      httpStatus: 413
+    }
+  },
+  // Billing Errors (VPM-BILLING-XXX)
+  BILLING: {
+    NO_SUBSCRIPTION: {
+      code: "VPM-BILLING-001",
+      message: "No active subscription found",
+      httpStatus: 402
+    },
+    SUBSCRIPTION_EXPIRED: {
+      code: "VPM-BILLING-002",
+      message: "Subscription has expired",
+      httpStatus: 402
+    },
+    PAYMENT_FAILED: {
+      code: "VPM-BILLING-003",
+      message: "Payment processing failed",
+      httpStatus: 402
+    },
+    FEATURE_NOT_INCLUDED: {
+      code: "VPM-BILLING-004",
+      message: "Feature not included in current plan",
+      httpStatus: 403
+    },
+    UPGRADE_REQUIRED: {
+      code: "VPM-BILLING-005",
+      message: "Plan upgrade required for this action",
+      httpStatus: 403
+    }
+  },
+  // Integration Errors (VPM-INT-XXX)
+  INTEGRATION: {
+    NOT_CONNECTED: {
+      code: "VPM-INT-001",
+      message: "Integration not connected",
+      httpStatus: 400
+    },
+    TOKEN_EXPIRED: {
+      code: "VPM-INT-002",
+      message: "Integration token expired, reconnection required",
+      httpStatus: 401
+    },
+    REFRESH_FAILED: {
+      code: "VPM-INT-003",
+      message: "Failed to refresh integration token",
+      httpStatus: 502
+    },
+    API_ERROR: {
+      code: "VPM-INT-004",
+      message: "External integration API error",
+      httpStatus: 502
+    },
+    RATE_LIMITED: {
+      code: "VPM-INT-005",
+      message: "Integration rate limit exceeded",
+      httpStatus: 429
+    }
+  },
+  // Validation Errors (VPM-VAL-XXX)
+  VALIDATION: {
+    REQUIRED_FIELD: {
+      code: "VPM-VAL-001",
+      message: "Required field missing",
+      httpStatus: 400
+    },
+    INVALID_FORMAT: {
+      code: "VPM-VAL-002",
+      message: "Invalid field format",
+      httpStatus: 400
+    },
+    OUT_OF_RANGE: {
+      code: "VPM-VAL-003",
+      message: "Value out of allowed range",
+      httpStatus: 400
+    },
+    INVALID_JSON: {
+      code: "VPM-VAL-004",
+      message: "Invalid JSON in request body",
+      httpStatus: 400
+    }
+  },
+  // System Errors (VPM-SYS-XXX)
+  SYSTEM: {
+    INTERNAL_ERROR: {
+      code: "VPM-SYS-001",
+      message: "Internal server error",
+      httpStatus: 500
+    },
+    DATABASE_ERROR: {
+      code: "VPM-SYS-002",
+      message: "Database operation failed",
+      httpStatus: 500
+    },
+    SERVICE_UNAVAILABLE: {
+      code: "VPM-SYS-003",
+      message: "Service temporarily unavailable",
+      httpStatus: 503
+    },
+    MAINTENANCE_MODE: {
+      code: "VPM-SYS-004",
+      message: "System is under maintenance",
+      httpStatus: 503
+    }
+  }
+};
+
+// src/errors/factory.ts
+function generateRequestId() {
+  return `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;
+}
+function createError(errorDef, details, requestId) {
+  return {
+    code: errorDef.code,
+    message: errorDef.message,
+    details,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    requestId: requestId || generateRequestId(),
+    docUrl: `https://docs.vaspera.pm/errors/${errorDef.code}`
+  };
+}
+function createErrorResponse(errorDef, details, requestId) {
+  return {
+    response: {
+      success: false,
+      error: createError(errorDef, details, requestId)
+    },
+    status: errorDef.httpStatus
+  };
+}
+function getNextResetDate() {
+  const now = /* @__PURE__ */ new Date();
+  const nextMonth = new Date(now.getFullYear(), now.getMonth() + 1, 1);
+  return nextMonth.toISOString();
+}
+var Errors = {
+  authRequired: (requestId) => createErrorResponse(ErrorCodes.AUTH.REQUIRED, void 0, requestId),
+  invalidApiKey: (requestId) => createErrorResponse(ErrorCodes.API_KEY.INVALID, void 0, requestId),
+  apiKeyRevoked: (requestId) => createErrorResponse(ErrorCodes.API_KEY.REVOKED, void 0, requestId),
+  apiKeyExpired: (requestId) => createErrorResponse(ErrorCodes.API_KEY.EXPIRED, void 0, requestId),
+  rateLimited: (retryAfter, requestId) => createErrorResponse(
+    ErrorCodes.API_KEY.RATE_LIMITED,
+    { retryAfterSeconds: retryAfter },
+    requestId
+  ),
+  quotaExceeded: (currentUsage, limit, requestId) => createErrorResponse(
+    ErrorCodes.API_KEY.QUOTA_EXCEEDED,
+    { currentUsage, limit, resetDate: getNextResetDate() },
+    requestId
+  ),
+  toolNotFound: (toolName, requestId) => createErrorResponse(
+    ErrorCodes.MCP.TOOL_NOT_FOUND,
+    { tool: toolName },
+    requestId
+  ),
+  toolExecutionFailed: (toolName, reason, requestId) => createErrorResponse(
+    ErrorCodes.MCP.EXECUTION_FAILED,
+    { tool: toolName, reason },
+    requestId
+  ),
+  toolTimeout: (toolName, timeoutMs, requestId) => createErrorResponse(
+    ErrorCodes.MCP.TIMEOUT,
+    { tool: toolName, timeoutMs },
+    requestId
+  ),
+  validationFailed: (field, reason, requestId) => createErrorResponse(
+    ErrorCodes.VALIDATION.REQUIRED_FIELD,
+    { field, reason },
+    requestId
+  ),
+  invalidFormat: (field, expected, requestId) => createErrorResponse(
+    ErrorCodes.VALIDATION.INVALID_FORMAT,
+    { field, expected },
+    requestId
+  ),
+  internalError: (message, requestId) => createErrorResponse(
+    ErrorCodes.SYSTEM.INTERNAL_ERROR,
+    message ? { message } : void 0,
+    requestId
+  ),
+  databaseError: (operation, requestId) => createErrorResponse(
+    ErrorCodes.SYSTEM.DATABASE_ERROR,
+    { operation },
+    requestId
+  ),
+  integrationNotConnected: (provider, requestId) => createErrorResponse(
+    ErrorCodes.INTEGRATION.NOT_CONNECTED,
+    { provider },
+    requestId
+  ),
+  subscriptionRequired: (feature, requiredTier, requestId) => createErrorResponse(
+    ErrorCodes.BILLING.FEATURE_NOT_INCLUDED,
+    { feature, requiredTier },
+    requestId
+  )
+};
+var VasperaApiError = class extends Error {
+  errorDef;
+  details;
+  constructor(errorDef, details) {
+    super(errorDef.message);
+    this.name = "VasperaApiError";
+    this.errorDef = errorDef;
+    this.details = details;
+  }
+  toResponse(requestId) {
+    return createErrorResponse(this.errorDef, this.details, requestId);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ErrorCodes,
+  Errors,
+  VasperaApiError,
+  createError,
+  createErrorResponse
+});
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/index.ts","../../src/errors/codes.ts","../../src/errors/factory.ts"],"sourcesContent":["export { ErrorCodes } from './codes.js';\nexport type { ErrorDefinition, ErrorCodeType } from './codes.js';\n\nexport {\n  createError,\n  createErrorResponse,\n  Errors,\n  VasperaApiError,\n} from './factory.js';\nexport type { VasperaError, ErrorResponse } from './factory.js';\n","export interface ErrorDefinition {\n  code: string;\n  message: string;\n  httpStatus: number;\n}\n\nexport const ErrorCodes = {\n  // Authentication Errors (VPM-AUTH-XXX)\n  AUTH: {\n    REQUIRED: {\n      code: 'VPM-AUTH-001',\n      message: 'Authentication required',\n      httpStatus: 401,\n    },\n    INVALID_TOKEN: {\n      code: 'VPM-AUTH-002',\n      message: 'Invalid or expired authentication token',\n      httpStatus: 401,\n    },\n    INSUFFICIENT_PERMISSIONS: {\n      code: 'VPM-AUTH-003',\n      message: 'Insufficient permissions for this action',\n      httpStatus: 403,\n    },\n    SESSION_EXPIRED: {\n      code: 'VPM-AUTH-004',\n      message: 'Session has expired, please login again',\n      httpStatus: 401,\n    },\n    MFA_REQUIRED: {\n      code: 'VPM-AUTH-005',\n      message: 'Multi-factor authentication required',\n      httpStatus: 403,\n    },\n  },\n\n  // API Key Errors (VPM-API-KEY-XXX)\n  API_KEY: {\n    REQUIRED: {\n      code: 'VPM-API-KEY-001',\n      message: 'API key is required',\n      httpStatus: 401,\n    },\n    INVALID: {\n      code: 'VPM-API-KEY-002',\n      message: 'Invalid API key',\n      httpStatus: 401,\n    },\n    REVOKED: {\n      code: 'VPM-API-KEY-003',\n      message: 'API key has been revoked',\n      httpStatus: 401,\n    },\n    EXPIRED: {\n      code: 'VPM-API-KEY-004',\n      message: 'API key has expired',\n      httpStatus: 401,\n    },\n    RATE_LIMITED: {\n      code: 'VPM-API-KEY-005',\n      message: 'API key rate limit exceeded',\n      httpStatus: 429,\n    },\n    QUOTA_EXCEEDED: {\n      code: 'VPM-API-KEY-006',\n      message: 'Monthly usage quota exceeded',\n      httpStatus: 429,\n    },\n  },\n\n  // MCP Tool Errors (VPM-MCP-XXX)\n  MCP: {\n    TOOL_NOT_FOUND: {\n      code: 'VPM-MCP-001',\n      message: 'Requested tool not found',\n      httpStatus: 404,\n    },\n    INVALID_ARGUMENTS: {\n      code: 'VPM-MCP-002',\n      message: 'Invalid tool arguments provided',\n      httpStatus: 400,\n    },\n    EXECUTION_FAILED: {\n      code: 'VPM-MCP-003',\n      message: 'Tool execution failed',\n      httpStatus: 500,\n    },\n    TIMEOUT: {\n      code: 'VPM-MCP-004',\n      message: 'Tool execution timed out',\n      httpStatus: 504,\n    },\n    LLM_ERROR: {\n      code: 'VPM-MCP-005',\n      message: 'AI model returned an error',\n      httpStatus: 502,\n    },\n    CONTEXT_TOO_LARGE: {\n      code: 'VPM-MCP-006',\n      message: 'Input context exceeds maximum size',\n      httpStatus: 413,\n    },\n  },\n\n  // Billing Errors (VPM-BILLING-XXX)\n  BILLING: {\n    NO_SUBSCRIPTION: {\n      code: 'VPM-BILLING-001',\n      message: 'No active subscription found',\n      httpStatus: 402,\n    },\n    SUBSCRIPTION_EXPIRED: {\n      code: 'VPM-BILLING-002',\n      message: 'Subscription has expired',\n      httpStatus: 402,\n    },\n    PAYMENT_FAILED: {\n      code: 'VPM-BILLING-003',\n      message: 'Payment processing failed',\n      httpStatus: 402,\n    },\n    FEATURE_NOT_INCLUDED: {\n      code: 'VPM-BILLING-004',\n      message: 'Feature not included in current plan',\n      httpStatus: 403,\n    },\n    UPGRADE_REQUIRED: {\n      code: 'VPM-BILLING-005',\n      message: 'Plan upgrade required for this action',\n      httpStatus: 403,\n    },\n  },\n\n  // Integration Errors (VPM-INT-XXX)\n  INTEGRATION: {\n    NOT_CONNECTED: {\n      code: 'VPM-INT-001',\n      message: 'Integration not connected',\n      httpStatus: 400,\n    },\n    TOKEN_EXPIRED: {\n      code: 'VPM-INT-002',\n      message: 'Integration token expired, reconnection required',\n      httpStatus: 401,\n    },\n    REFRESH_FAILED: {\n      code: 'VPM-INT-003',\n      message: 'Failed to refresh integration token',\n      httpStatus: 502,\n    },\n    API_ERROR: {\n      code: 'VPM-INT-004',\n      message: 'External integration API error',\n      httpStatus: 502,\n    },\n    RATE_LIMITED: {\n      code: 'VPM-INT-005',\n      message: 'Integration rate limit exceeded',\n      httpStatus: 429,\n    },\n  },\n\n  // Validation Errors (VPM-VAL-XXX)\n  VALIDATION: {\n    REQUIRED_FIELD: {\n      code: 'VPM-VAL-001',\n      message: 'Required field missing',\n      httpStatus: 400,\n    },\n    INVALID_FORMAT: {\n      code: 'VPM-VAL-002',\n      message: 'Invalid field format',\n      httpStatus: 400,\n    },\n    OUT_OF_RANGE: {\n      code: 'VPM-VAL-003',\n      message: 'Value out of allowed range',\n      httpStatus: 400,\n    },\n    INVALID_JSON: {\n      code: 'VPM-VAL-004',\n      message: 'Invalid JSON in request body',\n      httpStatus: 400,\n    },\n  },\n\n  // System Errors (VPM-SYS-XXX)\n  SYSTEM: {\n    INTERNAL_ERROR: {\n      code: 'VPM-SYS-001',\n      message: 'Internal server error',\n      httpStatus: 500,\n    },\n    DATABASE_ERROR: {\n      code: 'VPM-SYS-002',\n      message: 'Database operation failed',\n      httpStatus: 500,\n    },\n    SERVICE_UNAVAILABLE: {\n      code: 'VPM-SYS-003',\n      message: 'Service temporarily unavailable',\n      httpStatus: 503,\n    },\n    MAINTENANCE_MODE: {\n      code: 'VPM-SYS-004',\n      message: 'System is under maintenance',\n      httpStatus: 503,\n    },\n  },\n} as const;\n\nexport type ErrorCodeType =\n  (typeof ErrorCodes)[keyof typeof ErrorCodes][keyof (typeof ErrorCodes)[keyof typeof ErrorCodes]];\n","import type { ErrorDefinition } from './codes.js';\nimport { ErrorCodes } from './codes.js';\n\nexport interface VasperaError {\n  code: string;\n  message: string;\n  details?: Record<string, unknown>;\n  timestamp: string;\n  requestId: string;\n  docUrl?: string;\n}\n\nexport interface ErrorResponse {\n  success: false;\n  error: VasperaError;\n}\n\nfunction generateRequestId(): string {\n  return `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;\n}\n\nexport function createError(\n  errorDef: ErrorDefinition,\n  details?: Record<string, unknown>,\n  requestId?: string\n): VasperaError {\n  return {\n    code: errorDef.code,\n    message: errorDef.message,\n    details,\n    timestamp: new Date().toISOString(),\n    requestId: requestId || generateRequestId(),\n    docUrl: `https://docs.vaspera.pm/errors/${errorDef.code}`,\n  };\n}\n\nexport function createErrorResponse(\n  errorDef: ErrorDefinition,\n  details?: Record<string, unknown>,\n  requestId?: string\n): { response: ErrorResponse; status: number } {\n  return {\n    response: {\n      success: false,\n      error: createError(errorDef, details, requestId),\n    },\n    status: errorDef.httpStatus,\n  };\n}\n\nfunction getNextResetDate(): string {\n  const now = new Date();\n  const nextMonth = new Date(now.getFullYear(), now.getMonth() + 1, 1);\n  return nextMonth.toISOString();\n}\n\n// Pre-built error creators for common cases\nexport const Errors = {\n  authRequired: (requestId?: string) =>\n    createErrorResponse(ErrorCodes.AUTH.REQUIRED, undefined, requestId),\n\n  invalidApiKey: (requestId?: string) =>\n    createErrorResponse(ErrorCodes.API_KEY.INVALID, undefined, requestId),\n\n  apiKeyRevoked: (requestId?: string) =>\n    createErrorResponse(ErrorCodes.API_KEY.REVOKED, undefined, requestId),\n\n  apiKeyExpired: (requestId?: string) =>\n    createErrorResponse(ErrorCodes.API_KEY.EXPIRED, undefined, requestId),\n\n  rateLimited: (retryAfter: number, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.API_KEY.RATE_LIMITED,\n      { retryAfterSeconds: retryAfter },\n      requestId\n    ),\n\n  quotaExceeded: (currentUsage: number, limit: number, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.API_KEY.QUOTA_EXCEEDED,\n      { currentUsage, limit, resetDate: getNextResetDate() },\n      requestId\n    ),\n\n  toolNotFound: (toolName: string, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.MCP.TOOL_NOT_FOUND,\n      { tool: toolName },\n      requestId\n    ),\n\n  toolExecutionFailed: (toolName: string, reason: string, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.MCP.EXECUTION_FAILED,\n      { tool: toolName, reason },\n      requestId\n    ),\n\n  toolTimeout: (toolName: string, timeoutMs: number, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.MCP.TIMEOUT,\n      { tool: toolName, timeoutMs },\n      requestId\n    ),\n\n  validationFailed: (field: string, reason: string, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.VALIDATION.REQUIRED_FIELD,\n      { field, reason },\n      requestId\n    ),\n\n  invalidFormat: (field: string, expected: string, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.VALIDATION.INVALID_FORMAT,\n      { field, expected },\n      requestId\n    ),\n\n  internalError: (message?: string, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.SYSTEM.INTERNAL_ERROR,\n      message ? { message } : undefined,\n      requestId\n    ),\n\n  databaseError: (operation: string, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.SYSTEM.DATABASE_ERROR,\n      { operation },\n      requestId\n    ),\n\n  integrationNotConnected: (provider: string, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.INTEGRATION.NOT_CONNECTED,\n      { provider },\n      requestId\n    ),\n\n  subscriptionRequired: (feature: string, requiredTier: string, requestId?: string) =>\n    createErrorResponse(\n      ErrorCodes.BILLING.FEATURE_NOT_INCLUDED,\n      { feature, requiredTier },\n      requestId\n    ),\n};\n\n// Custom error class for throwing in API routes\nexport class VasperaApiError extends Error {\n  public readonly errorDef: ErrorDefinition;\n  public readonly details?: Record<string, unknown>;\n\n  constructor(errorDef: ErrorDefinition, details?: Record<string, unknown>) {\n    super(errorDef.message);\n    this.name = 'VasperaApiError';\n    this.errorDef = errorDef;\n    this.details = details;\n  }\n\n  toResponse(requestId?: string): { response: ErrorResponse; status: number } {\n    return createErrorResponse(this.errorDef, this.details, requestId);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/errors/index.mjs

@@ -0,0 +1,310 @@
+// src/errors/codes.ts
+var ErrorCodes = {
+  // Authentication Errors (VPM-AUTH-XXX)
+  AUTH: {
+    REQUIRED: {
+      code: "VPM-AUTH-001",
+      message: "Authentication required",
+      httpStatus: 401
+    },
+    INVALID_TOKEN: {
+      code: "VPM-AUTH-002",
+      message: "Invalid or expired authentication token",
+      httpStatus: 401
+    },
+    INSUFFICIENT_PERMISSIONS: {
+      code: "VPM-AUTH-003",
+      message: "Insufficient permissions for this action",
+      httpStatus: 403
+    },
+    SESSION_EXPIRED: {
+      code: "VPM-AUTH-004",
+      message: "Session has expired, please login again",
+      httpStatus: 401
+    },
+    MFA_REQUIRED: {
+      code: "VPM-AUTH-005",
+      message: "Multi-factor authentication required",
+      httpStatus: 403
+    }
+  },
+  // API Key Errors (VPM-API-KEY-XXX)
+  API_KEY: {
+    REQUIRED: {
+      code: "VPM-API-KEY-001",
+      message: "API key is required",
+      httpStatus: 401
+    },
+    INVALID: {
+      code: "VPM-API-KEY-002",
+      message: "Invalid API key",
+      httpStatus: 401
+    },
+    REVOKED: {
+      code: "VPM-API-KEY-003",
+      message: "API key has been revoked",
+      httpStatus: 401
+    },
+    EXPIRED: {
+      code: "VPM-API-KEY-004",
+      message: "API key has expired",
+      httpStatus: 401
+    },
+    RATE_LIMITED: {
+      code: "VPM-API-KEY-005",
+      message: "API key rate limit exceeded",
+      httpStatus: 429
+    },
+    QUOTA_EXCEEDED: {
+      code: "VPM-API-KEY-006",
+      message: "Monthly usage quota exceeded",
+      httpStatus: 429
+    }
+  },
+  // MCP Tool Errors (VPM-MCP-XXX)
+  MCP: {
+    TOOL_NOT_FOUND: {
+      code: "VPM-MCP-001",
+      message: "Requested tool not found",
+      httpStatus: 404
+    },
+    INVALID_ARGUMENTS: {
+      code: "VPM-MCP-002",
+      message: "Invalid tool arguments provided",
+      httpStatus: 400
+    },
+    EXECUTION_FAILED: {
+      code: "VPM-MCP-003",
+      message: "Tool execution failed",
+      httpStatus: 500
+    },
+    TIMEOUT: {
+      code: "VPM-MCP-004",
+      message: "Tool execution timed out",
+      httpStatus: 504
+    },
+    LLM_ERROR: {
+      code: "VPM-MCP-005",
+      message: "AI model returned an error",
+      httpStatus: 502
+    },
+    CONTEXT_TOO_LARGE: {
+      code: "VPM-MCP-006",
+      message: "Input context exceeds maximum size",
+      httpStatus: 413
+    }
+  },
+  // Billing Errors (VPM-BILLING-XXX)
+  BILLING: {
+    NO_SUBSCRIPTION: {
+      code: "VPM-BILLING-001",
+      message: "No active subscription found",
+      httpStatus: 402
+    },
+    SUBSCRIPTION_EXPIRED: {
+      code: "VPM-BILLING-002",
+      message: "Subscription has expired",
+      httpStatus: 402
+    },
+    PAYMENT_FAILED: {
+      code: "VPM-BILLING-003",
+      message: "Payment processing failed",
+      httpStatus: 402
+    },
+    FEATURE_NOT_INCLUDED: {
+      code: "VPM-BILLING-004",
+      message: "Feature not included in current plan",
+      httpStatus: 403
+    },
+    UPGRADE_REQUIRED: {
+      code: "VPM-BILLING-005",
+      message: "Plan upgrade required for this action",
+      httpStatus: 403
+    }
+  },
+  // Integration Errors (VPM-INT-XXX)
+  INTEGRATION: {
+    NOT_CONNECTED: {
+      code: "VPM-INT-001",
+      message: "Integration not connected",
+      httpStatus: 400
+    },
+    TOKEN_EXPIRED: {
+      code: "VPM-INT-002",
+      message: "Integration token expired, reconnection required",
+      httpStatus: 401
+    },
+    REFRESH_FAILED: {
+      code: "VPM-INT-003",
+      message: "Failed to refresh integration token",
+      httpStatus: 502
+    },
+    API_ERROR: {
+      code: "VPM-INT-004",
+      message: "External integration API error",
+      httpStatus: 502
+    },
+    RATE_LIMITED: {
+      code: "VPM-INT-005",
+      message: "Integration rate limit exceeded",
+      httpStatus: 429
+    }
+  },
+  // Validation Errors (VPM-VAL-XXX)
+  VALIDATION: {
+    REQUIRED_FIELD: {
+      code: "VPM-VAL-001",
+      message: "Required field missing",
+      httpStatus: 400
+    },
+    INVALID_FORMAT: {
+      code: "VPM-VAL-002",
+      message: "Invalid field format",
+      httpStatus: 400
+    },
+    OUT_OF_RANGE: {
+      code: "VPM-VAL-003",
+      message: "Value out of allowed range",
+      httpStatus: 400
+    },
+    INVALID_JSON: {
+      code: "VPM-VAL-004",
+      message: "Invalid JSON in request body",
+      httpStatus: 400
+    }
+  },
+  // System Errors (VPM-SYS-XXX)
+  SYSTEM: {
+    INTERNAL_ERROR: {
+      code: "VPM-SYS-001",
+      message: "Internal server error",
+      httpStatus: 500
+    },
+    DATABASE_ERROR: {
+      code: "VPM-SYS-002",
+      message: "Database operation failed",
+      httpStatus: 500
+    },
+    SERVICE_UNAVAILABLE: {
+      code: "VPM-SYS-003",
+      message: "Service temporarily unavailable",
+      httpStatus: 503
+    },
+    MAINTENANCE_MODE: {
+      code: "VPM-SYS-004",
+      message: "System is under maintenance",
+      httpStatus: 503
+    }
+  }
+};
+
+// src/errors/factory.ts
+function generateRequestId() {
+  return `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;
+}
+function createError(errorDef, details, requestId) {
+  return {
+    code: errorDef.code,
+    message: errorDef.message,
+    details,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    requestId: requestId || generateRequestId(),
+    docUrl: `https://docs.vaspera.pm/errors/${errorDef.code}`
+  };
+}
+function createErrorResponse(errorDef, details, requestId) {
+  return {
+    response: {
+      success: false,
+      error: createError(errorDef, details, requestId)
+    },
+    status: errorDef.httpStatus
+  };
+}
+function getNextResetDate() {
+  const now = /* @__PURE__ */ new Date();
+  const nextMonth = new Date(now.getFullYear(), now.getMonth() + 1, 1);
+  return nextMonth.toISOString();
+}
+var Errors = {
+  authRequired: (requestId) => createErrorResponse(ErrorCodes.AUTH.REQUIRED, void 0, requestId),
+  invalidApiKey: (requestId) => createErrorResponse(ErrorCodes.API_KEY.INVALID, void 0, requestId),
+  apiKeyRevoked: (requestId) => createErrorResponse(ErrorCodes.API_KEY.REVOKED, void 0, requestId),
+  apiKeyExpired: (requestId) => createErrorResponse(ErrorCodes.API_KEY.EXPIRED, void 0, requestId),
+  rateLimited: (retryAfter, requestId) => createErrorResponse(
+    ErrorCodes.API_KEY.RATE_LIMITED,
+    { retryAfterSeconds: retryAfter },
+    requestId
+  ),
+  quotaExceeded: (currentUsage, limit, requestId) => createErrorResponse(
+    ErrorCodes.API_KEY.QUOTA_EXCEEDED,
+    { currentUsage, limit, resetDate: getNextResetDate() },
+    requestId
+  ),
+  toolNotFound: (toolName, requestId) => createErrorResponse(
+    ErrorCodes.MCP.TOOL_NOT_FOUND,
+    { tool: toolName },
+    requestId
+  ),
+  toolExecutionFailed: (toolName, reason, requestId) => createErrorResponse(
+    ErrorCodes.MCP.EXECUTION_FAILED,
+    { tool: toolName, reason },
+    requestId
+  ),
+  toolTimeout: (toolName, timeoutMs, requestId) => createErrorResponse(
+    ErrorCodes.MCP.TIMEOUT,
+    { tool: toolName, timeoutMs },
+    requestId
+  ),
+  validationFailed: (field, reason, requestId) => createErrorResponse(
+    ErrorCodes.VALIDATION.REQUIRED_FIELD,
+    { field, reason },
+    requestId
+  ),
+  invalidFormat: (field, expected, requestId) => createErrorResponse(
+    ErrorCodes.VALIDATION.INVALID_FORMAT,
+    { field, expected },
+    requestId
+  ),
+  internalError: (message, requestId) => createErrorResponse(
+    ErrorCodes.SYSTEM.INTERNAL_ERROR,
+    message ? { message } : void 0,
+    requestId
+  ),
+  databaseError: (operation, requestId) => createErrorResponse(
+    ErrorCodes.SYSTEM.DATABASE_ERROR,
+    { operation },
+    requestId
+  ),
+  integrationNotConnected: (provider, requestId) => createErrorResponse(
+    ErrorCodes.INTEGRATION.NOT_CONNECTED,
+    { provider },
+    requestId
+  ),
+  subscriptionRequired: (feature, requiredTier, requestId) => createErrorResponse(
+    ErrorCodes.BILLING.FEATURE_NOT_INCLUDED,
+    { feature, requiredTier },
+    requestId
+  )
+};
+var VasperaApiError = class extends Error {
+  errorDef;
+  details;
+  constructor(errorDef, details) {
+    super(errorDef.message);
+    this.name = "VasperaApiError";
+    this.errorDef = errorDef;
+    this.details = details;
+  }
+  toResponse(requestId) {
+    return createErrorResponse(this.errorDef, this.details, requestId);
+  }
+};
+export {
+  ErrorCodes,
+  Errors,
+  VasperaApiError,
+  createError,
+  createErrorResponse
+};
+//# sourceMappingURL=index.mjs.map