heyibad/quickbook-mcp

Improve error messages across handlers

开放

#2 创建于 2025年10月26日

 (1 条评论) (0 个反应) (0 位负责人)TypeScript (0 个派生)auto 404
enhancementgood first issuehacktoberfest

仓库指标

星标
 (1 个星标)
PR 合并指标
 (PR 指标待抓取)

描述

Description

Many handlers currently return generic error messages like 'Failed to create customer' without providing specific details about what went wrong. This makes debugging difficult for users.

Current Problem

Example from handlers: \\ ypescript error: response.error || 'Failed to create customer' \`n

Proposed Solution

Enhance error messages to include:

  • Specific error details from QuickBooks API
  • Field-level validation errors
  • HTTP status codes
  • Suggested actions for common errors

Requirements

  • Review error handling in at least 3 handler files
  • Extract detailed error information from API responses
  • Create helper function for consistent error formatting
  • Add specific error messages for common scenarios
  • Document error response format

Example Implementation

\\ ypescript function formatDetailedError(error: any, operation: string): string { const baseMessage = \Failed to \; if (error.response?.data) { const qbError = error.response.data.Fault?.Error?.[0]; if (qbError) { return \: \ (Code: ); } } return baseMessage; } \`n

Benefits

  • Better developer experience
  • Easier debugging
  • Clearer API documentation
  • Reduced support requests

贡献者指南