@aashari/mcp-server-atlassian-bitbucket/dist/utils/error-handler.util.d.ts

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MC

/**
 * Standard error codes for consistent handling
 */
export declare enum ErrorCode {
    NOT_FOUND = "NOT_FOUND",
    INVALID_CURSOR = "INVALID_CURSOR",
    ACCESS_DENIED = "ACCESS_DENIED",
    VALIDATION_ERROR = "VALIDATION_ERROR",
    UNEXPECTED_ERROR = "UNEXPECTED_ERROR"
}
/**
 * Context information for error handling
 */
export interface ErrorContext {
    /**
     * Source of the error (e.g., file path and function)
     */
    source?: string;
    /**
     * Type of entity being processed (e.g., 'Repository', 'PullRequest')
     */
    entityType?: string;
    /**
     * Identifier of the entity being processed
     */
    entityId?: string | Record<string, string>;
    /**
     * Operation being performed (e.g., 'listing', 'creating')
     */
    operation?: string;
    /**
     * Additional information for debugging
     */
    additionalInfo?: Record<string, unknown>;
}
/**
 * Detect specific error types from raw errors
 * @param error The error to analyze
 * @param context Context information for better error detection
 * @returns Object containing the error code and status code
 */
export declare function detectErrorType(error: unknown, context?: ErrorContext): {
    code: ErrorCode;
    statusCode: number;
};
/**
 * Create user-friendly error messages based on error type and context
 * @param code The error code
 * @param context Context information for better error messages
 * @param originalMessage The original error message
 * @returns User-friendly error message
 */
export declare function createUserFriendlyErrorMessage(code: ErrorCode, context?: ErrorContext, originalMessage?: string): string;
/**
 * Handle controller errors consistently
 * @param error The error to handle
 * @param context Context information for better error messages
 * @returns Never returns, always throws an error
 */
export declare function handleControllerError(error: unknown, context?: ErrorContext): never;