feat: add Comment Reactions functionality (#8)

[jordanpartridge]

Implements GitHub Issue Comment Reactions API support:

• List reactions on a comment
• Create reaction on a comment
• Delete a reaction from a comment

Includes:

• Reaction DTO with type identification methods
• Request classes for all reaction API endpoints
• ManagesCommentReactions trait
• ManagesCommentReactionsInterface contract
• Full test coverage (42 new tests)

Closes #8 (Comment Reactions section)

Summary by CodeRabbit

• New Features

  • Added comment reaction management capabilities to issues, enabling users to list, create, and delete emoji reactions on issue comments
  • Support for eight reaction types: thumbs up, thumbs down, laugh, confused, heart, hooray, rocket, and eyes

• Tests

  • Added comprehensive unit tests for comment reaction functionality, including validation and API integration scenarios

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

This PR introduces comment reaction management to the issues service by adding a new interface, trait, data class, and request classes to handle listing, creating, and deleting reactions on issue comments via the GitHub API.

Changes

Cohort / File(s)	Summary
Interface Contracts src/Contracts/IssuesServiceInterface.php, src/Contracts/ManagesCommentReactionsInterface.php	IssuesServiceInterface updated to extend ManagesCommentReactionsInterface; new ManagesCommentReactionsInterface introduced with three methods: listCommentReactions, createCommentReaction, deleteCommentReaction
Data Model src/Data/Reaction.php	New readonly Reaction class with properties id, content, user, createdAt; includes fromArray/toArray serialization, validation helpers (validTypes, isValidType), and type-check predicates (isThumbsUp, isThumbsDown, isLaugh, isConfused, isHeart, isHooray, isRocket, isEyes)
API Request Classes src/Requests/Reactions/ListCommentReactionsRequest.php, src/Requests/Reactions/CreateCommentReactionRequest.php, src/Requests/Reactions/DeleteCommentReactionRequest.php	Three request classes for GET/POST/DELETE operations; ListCommentReactionsRequest accepts optional filters, CreateCommentReactionRequest includes JSON body with content, DeleteCommentReactionRequest targets specific reaction by ID
Service Implementation src/Services/IssuesService.php, src/Traits/ManagesCommentReactions.php	IssuesService now uses ManagesCommentReactions trait; trait provides implementations of interface methods with input validation (validateReactionContent, validateReactionId), API response handling, and Reaction object instantiation
Unit Tests tests/Unit/Data/ReactionTest.php, tests/Unit/Requests/Reactions/*Test.php, tests/Unit/Traits/ManagesCommentReactionsTest.php	Comprehensive test coverage for Reaction data model serialization/deserialization, request endpoint resolution and HTTP methods, and trait methods with validation and response handling

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

• Reaction data class: Verify all type predicates are correct and exhaustive; confirm serialization/deserialization logic handles all fields properly
• ManagesCommentReactions trait: Review validation logic for content and ID; ensure API response handling aligns with existing patterns in the service
• Request classes: Confirm endpoint resolution and body/query parameter construction match GitHub API specification

Possibly related issues

• Add Issue Comments functionality #8: Add Issue Comments functionality — This PR implements three of the planned comment-reactions features (add reactions, remove reactions, list reactions on comments), directly fulfilling part of the linked issue's requirements for comprehensive comment management.

Poem

🐰 A hop, skip, and reaction away!
Comments now glow with emoji display,
Thumbs up, hearts down, and rockets that soar,
Our service reacts like never before! 🚀💬✨

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch claude/implement-with-tdd-u23o6

---

📜 Recent review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b478c71 and 509f4e7.

📒 Files selected for processing (13)

• src/Contracts/IssuesServiceInterface.php (1 hunks)
• src/Contracts/ManagesCommentReactionsInterface.php (1 hunks)
• src/Data/Reaction.php (1 hunks)
• src/Requests/Reactions/CreateCommentReactionRequest.php (1 hunks)
• src/Requests/Reactions/DeleteCommentReactionRequest.php (1 hunks)
• src/Requests/Reactions/ListCommentReactionsRequest.php (1 hunks)
• src/Services/IssuesService.php (2 hunks)
• src/Traits/ManagesCommentReactions.php (1 hunks)
• tests/Unit/Data/ReactionTest.php (1 hunks)
• tests/Unit/Requests/Reactions/CreateCommentReactionRequestTest.php (1 hunks)
• tests/Unit/Requests/Reactions/DeleteCommentReactionRequestTest.php (1 hunks)
• tests/Unit/Requests/Reactions/ListCommentReactionsRequestTest.php (1 hunks)
• tests/Unit/Traits/ManagesCommentReactionsTest.php (1 hunks)

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 PHPStan (2.1.33)

Invalid configuration:
Unexpected item 'parameters › checkOctaneCompatibility'.
Invalid configuration:
Unexpected item 'parameters › checkModelProperties'.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}