deepsource-mcp-server/dist/utils/errors/factory.js

Model Context Protocol server for DeepSource

/**
 * @fileoverview Error factory for creating classified errors
 * This module provides utilities for creating standardized error objects.
 */
import { ErrorCategory } from './categories.js';
/**
 * Create a new classified error with additional metadata
 * @param message The error message
 * @param category The error category
 * @param originalError The original error that caused this error, useful for debugging and error tracing
 * @param metadata Additional contextual information about the error as key-value pairs
 * @returns A new classified error with the specified properties
 * @example
 * const error = createClassifiedError(
 *   'Failed to fetch project data',
 *   ErrorCategory.NETWORK,
 *   originalError,
 *   { projectId: '123', endpoint: '/api/projects' }
 * );
 * @public
 */
export function createClassifiedError(message, category, originalError, metadata) {
    const error = new Error(message);
    error.category = category;
    error.originalError = originalError;
    if (metadata !== undefined) {
        error.metadata = metadata;
    }
    return error;
}
/**
 * Create an authentication error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with AUTH category
 * @public
 */
export function createAuthError(message, originalError, metadata) {
    return createClassifiedError(message || 'Authentication failed', ErrorCategory.AUTH, originalError, metadata);
}
/**
 * Create a network error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with NETWORK category
 * @public
 */
export function createNetworkError(message, originalError, metadata) {
    return createClassifiedError(message || 'Network error occurred', ErrorCategory.NETWORK, originalError, metadata);
}
/**
 * Create a server error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with SERVER category
 * @public
 */
export function createServerError(message, originalError, metadata) {
    return createClassifiedError(message || 'Server error occurred', ErrorCategory.SERVER, originalError, metadata);
}
/**
 * Create a client error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with CLIENT category
 * @public
 */
export function createClientError(message, originalError, metadata) {
    return createClassifiedError(message || 'Client error occurred', ErrorCategory.CLIENT, originalError, metadata);
}
/**
 * Create a timeout error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with TIMEOUT category
 * @public
 */
export function createTimeoutError(message, originalError, metadata) {
    return createClassifiedError(message || 'Request timed out', ErrorCategory.TIMEOUT, originalError, metadata);
}
/**
 * Create a rate limit error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with RATE_LIMIT category
 * @public
 */
export function createRateLimitError(message, originalError, metadata) {
    return createClassifiedError(message || 'Rate limit exceeded', ErrorCategory.RATE_LIMIT, originalError, metadata);
}
/**
 * Create a schema error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with SCHEMA category
 * @public
 */
export function createSchemaError(message, originalError, metadata) {
    return createClassifiedError(message || 'GraphQL schema error', ErrorCategory.SCHEMA, originalError, metadata);
}
/**
 * Create a not found error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with NOT_FOUND category
 * @public
 */
export function createNotFoundError(message, originalError, metadata) {
    return createClassifiedError(message || 'Resource not found', ErrorCategory.NOT_FOUND, originalError, metadata);
}
/**
 * Create a format error
 * @param message The error message
 * @param originalError The original error that caused this error
 * @param metadata Additional contextual information about the error
 * @returns A classified error with FORMAT category
 * @public
 */
export function createFormatError(message, originalError, metadata) {
    return createClassifiedError(message || 'Data format error', ErrorCategory.FORMAT, originalError, metadata);
}
//# sourceMappingURL=factory.js.map