GitHub Projects MCP Server

src
common
export class GitHubError extends Error {
	constructor(
		message: string,
		public readonly status: number,
		public readonly response: unknown,
	) {
		super(message);
		this.name = "GitHubError";
	}
}

export class GitHubValidationError extends GitHubError {
	constructor(message: string, status: number, response: unknown) {
		super(message, status, response);
		this.name = "GitHubValidationError";
	}
}

export class GitHubResourceNotFoundError extends GitHubError {
	constructor(resource: string) {
		super(`Resource not found: ${resource}`, 404, {
			message: `${resource} not found`,
		});
		this.name = "GitHubResourceNotFoundError";
	}
}

export class GitHubAuthenticationError extends GitHubError {
	constructor(message = "Authentication failed") {
		super(message, 401, { message });
		this.name = "GitHubAuthenticationError";
	}
}

export class GitHubPermissionError extends GitHubError {
	constructor(message = "Insufficient permissions") {
		super(message, 403, { message });
		this.name = "GitHubPermissionError";
	}
}

export class GitHubRateLimitError extends GitHubError {
	constructor(
		public readonly resetAt: Date,
		message = "Rate limit exceeded",
	) {
		super(message, 429, { message, reset_at: resetAt.toISOString() });
		this.name = "GitHubRateLimitError";
	}
}

export class GitHubConflictError extends GitHubError {
	constructor(message: string) {
		super(message, 409, { message });
		this.name = "GitHubConflictError";
	}
}

export function isGitHubError(error: unknown): error is GitHubError {
	return error instanceof GitHubError;
}

export function createGitHubError(status: number, response: any): GitHubError {
	switch (status) {
		case 401:
			return new GitHubAuthenticationError(
				response?.message || "Authentication Failed",
			);
		case 403:
			return new GitHubPermissionError(
				response?.message || "Permission Denied",
			);
		case 404:
			return new GitHubResourceNotFoundError(response?.message || "Resource");
		case 409:
			return new GitHubConflictError(response?.message || "Conflict occurred");
		case 422: {
			const validationMessage = response?.message || "Validation failed";
			const detailedMessage = response
				? `${validationMessage}\nDetails: ${JSON.stringify(response)}`
				: validationMessage;
			return new GitHubValidationError(detailedMessage, status, response);
		}
		case 429: {
			const resetTime = new Date(response?.reset_at || Date.now() + 60000);
			return new GitHubRateLimitError(
				resetTime,
				response?.message
					? `${response.message}\nResets at: ${resetTime.toISOString()}`
					: `Rate Limit Exceeded\nResets at: ${resetTime.toISOString()}`,
			);
		}
		default:
			return new GitHubError(
				response?.message || `GitHub API Error (Status: ${status})`,
				status,
				response,
			);
	}
}