feat: add method to help with forwarding inbound emails

[lucasfcosta]

This PR adds a helper method for forwarding inbound emails that works as shown below.

IMO the most important thing to notice here is that we need to make a call of whether we want to add mailparser as a dependency because that's necessary for the passthrough forwarding to work.

The rest of the code is mostly simple.

// Passthrough (default) - content sent directly, doesn't look like it was forwarded
await resend.emails.receiving.forward({
  emailId: payload.data.email_id,
  to: payload.data.from,
  from: 'passthrough@example.com',
});

// Wrapped - content wrapped in a `forwarded` part
await resend.emails.receiving.forward({
  emailId: payload.data.email_id,
  to: payload.data.from,
  from: 'wrapped@example.com',
  passthrough: false,
  text: 'See the attached email.',
});

This is an SDK-only change.

---

Summary by cubic

Adds resend.emails.receiving.forward to forward inbound emails, either as-is (passthrough) or as a wrapped forward with the original message attached. Preserves subject, body, and attachments to support simple routing flows.

• New Features

  • New forwarding method:
    • Passthrough (default): sends parsed original text/html and attachments without a “forwarded” look.
    • Wrapped: prefixes subject with “Fwd:” and attaches the original .eml; requires text or html.
  • Receiving email response now includes raw.download_url and raw.expires_at; list response omits raw.
  • Preserves inline attachments (content_id with brackets stripped), sets “(no subject)” when missing, and returns clear errors for missing/undownloadable raw content.

• Dependencies

  • Added mailparser@3.7.2 and @types/mailparser for parsing raw messages in passthrough mode.

^{Written for commit 18d57b1. Summary will update on new commits.}

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@​types/​mailparser@​3.4.5
	mailparser@​3.7.2

View full report

[pkg-pr-new]

Open in StackBlitz

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

commit: 18d57b1

[cubic-dev-ai]

No issues found across 8 files