feat: add raw url to types returned from inbound individual GET API

[lucasfcosta]

This PR adds the new types necessary for the feature-flagged option to download raw emails.

We don't need any change in functionality as these will work mostly like the download URLs for attachments, at least for now.

Please do not merge until the FF is enabled for all users.

---

Summary by cubic

Adds raw email download metadata to the inbound individual GET API types to enable raw email downloads behind a feature flag. Updates list types and tests; no runtime behavior change.

• New Features
  • Added raw: { download_url: string; expires_at: string } | null to GetReceivingEmailResponseSuccess.
  • Omitted raw from ListReceivingEmail to keep list payloads small.
  • Extended tests to cover raw present and null cases.

^{Written for commit 56d6fe4. Summary will update on new commits.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/resend/resend-node/resend@774

commit: 56d6fe4

[cubic-dev-ai]

1 issue found across 3 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="src/emails/receiving/receiving.spec.ts">

<violation number="1" location="src/emails/receiving/receiving.spec.ts:73">
P2: Invalid ISO 8601 timestamp: hour `24` with non-zero minutes/seconds (`24:13:52`) is not valid. If the intent is 1 hour after `created_at` (23:13), this should be `2023-04-08T00:13:52.669661+00:00` (midnight + 13 minutes on the next day).</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P2: Invalid ISO 8601 timestamp: hour 24 with non-zero minutes/seconds (24:13:52) is not valid. If the intent is 1 hour after created_at (23:13), this should be 2023-04-08T00:13:52.669661+00:00 (midnight + 13 minutes on the next day).

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At src/emails/receiving/receiving.spec.ts, line 73:

<comment>Invalid ISO 8601 timestamp: hour `24` with non-zero minutes/seconds (`24:13:52`) is not valid. If the intent is 1 hour after `created_at` (23:13), this should be `2023-04-08T00:13:52.669661+00:00` (midnight + 13 minutes on the next day).</comment>

<file context>
@@ -67,6 +67,11 @@ describe(&#39;Receiving&#39;, () =&gt; {
+          raw: {
+            download_url:
+              &#39;https://example.com/emails/raw/abc123?signature=xyz789&#39;,
+            expires_at: &#39;2023-04-07T24:13:52.669661+00:00&#39;,
+          },
           attachments: [
</file context>

✅ Addressed in 3aef7be