feat: Add Revoke Achievmenet

[cjmellor]

Description

This pull request introduces a new feature allowing achievements to be revoked from users. It includes updates to the documentation, the addition of a new event, and corresponding tests to ensure the functionality works as expected.

New Feature: Achievement Revocation

• Documentation Update:

  • Added a new section in README.md explaining how to revoke achievements using the revokeAchievement method.
  • Documented the AchievementRevoked event in README.md.

• Code Changes:

  • Added the AchievementRevoked event to src/Concerns/HasAchievements.php.
  • Implemented the revokeAchievement method in src/Concerns/HasAchievements.php, which detaches the achievement from the user and dispatches the AchievementRevoked event.

• Event Addition:

  • Created a new AchievementRevoked event class in src/Events/AchievementRevoked.php.

• Testing:

  • Updated tests in tests/Concerns/HasAchievementsTest.php to cover scenarios such as revoking an achievement, ensuring the event is dispatched, and handling errors when revoking unearned achievements. [1] [2]

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Related Issues and Pull Requests

• Closes revokeAchievement method #81

Testing

Please provide a passing test where possible. This package uses PestPHP

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• I have made corresponding changes to the documentation [OPTIONAL]