feat: add received_for to received email type

[lucasfcosta]

Adds the received_for field to the received email response type, matching the API.

---

Summary by cubic

Add received_for to the received email response to match the API and expose forwarding recipients. Updated fixtures and service tests to include and assert received_for.

^{Written for commit 14c361a. Summary will update on new commits.}

[cubic-dev-ai]

1 issue found across 3 files

Confidence score: 4/5

• In tests/Fixtures/Emails/Receiving.php, inboundEmails() is missing received_for while inboundEmail() includes it, so list-vs-single fixtures no longer model the same resource and tests can silently miss response-shape regressions—add received_for to inboundEmails() before merging.

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="tests/Fixtures/Emails/Receiving.php">

<violation number="1" location="tests/Fixtures/Emails/Receiving.php:17">
P2: inboundEmails() fixture is missing the 'received_for' field that was just added to inboundEmail(). These fixtures represent the same email resource; omitting it creates an inconsistency that can mask bugs in list-response handling.</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

P2: inboundEmails() fixture is missing the 'received_for' field that was just added to inboundEmail(). These fixtures represent the same email resource; omitting it creates an inconsistency that can mask bugs in list-response handling.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At tests/Fixtures/Emails/Receiving.php, line 17:

<comment>inboundEmails() fixture is missing the 'received_for' field that was just added to inboundEmail(). These fixtures represent the same email resource; omitting it creates an inconsistency that can mask bugs in list-response handling.</comment>

<file context>
@@ -14,6 +14,7 @@ function inboundEmail(): array
         'bcc' => [],
         'cc' => [],
         'reply_to' => [],
+        'received_for' => ['forwarded@example.com'],
         'message_id' => '<example+123>',
         'attachments' => [
</file context>