Implement DELETE endpoint for heroes API

[Copilot]

Implemented DELETE functionality for heroes

This PR adds the ability to delete heroes from the database through a REST API endpoint. The implementation follows the existing code patterns and includes proper error handling.

Changes made:

1. Added deleteHeroById method to HeroService that:

   • Takes a hero ID as parameter
   • Attempts to find and delete the hero using findOneAndDelete
   • Returns success/failure result with appropriate error messages

2. Added deleteHero method to HeroController that:

   • Validates that the ID is a valid number
   • Calls the service method
   • Returns appropriate HTTP status codes (200 for success, 404 for not found)

3. Added DELETE route to hero.routes.ts:

   router.delete('/:id', (req, res, next) => heroController.deleteHero(req, res, next));

4. Updated documentation:

   • Added DELETE endpoint details to API reference
   • Added usage examples with cURL
   • Added example DELETE request to heroes.http file

Testing:

The endpoint can be tested with:

curl -X DELETE http://localhost:3000/api/heroes/1

Response formats:

Success (200):

{
  "message": "Hero deleted successfully"
}

Not Found (404):

{
  "error": "Hero not found"
}

Invalid ID (400):

{
  "error": "Invalid hero ID. ID must be a number."
}

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.