feat: add pagination for inbound email attachments

[lucasfcosta]

This PR is the SDK complement to https://github.com/resend/resend-api/pull/2192. It adds pagination to the inbound email attachments.

I also used this opportunity to:

• Update the object to list for the method that lists attachment (I did that on the API PR too)
• Use the new /emails/receiving/:emailId/attachments alias from the API instead of the old /emails/inbound/:emailId/attachments

---

Summary by cubic

Added pagination for inbound email attachments in the SDK and switched to the new /emails/receiving endpoints. Aligns with PRODUCT-710 to enable cursor-based navigation and reduce large payloads.

• New Features

  • attachments.receiving.list now supports limit, before, and after.
  • Uses /emails/receiving/:emailId and /emails/receiving/:emailId/attachments/:id.
  • Builds query params only when pagination options are provided.

• Migration

  • List responses now return object: 'list' and has_more. Update any checks relying on the previous object value.

[pkg-pr-new]

Open in StackBlitz

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

commit: fb5096e

[cubic-dev-ai]

1 issue found across 4 files

Prompt for AI agents (all 1 issues)

Understand the root cause of the following 1 issues and fix them.


<file name="src/attachments/receiving/receiving.ts">

<violation number="1" location="src/attachments/receiving/receiving.ts:34">
The list call now targets `/emails/receiving/:emailId`, but it needs the `/attachments` suffix; otherwise it fetches the email resource instead of its attachments, breaking the response shape.</violation>
</file>

_{React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.}

[bukinoshita]

Why is it calling an API and not the DB here?

[lucasfcosta]

Not sure I understand this comment. This is the get method that we call on resend.emails.receiving.get so it can't connect to a DB? Maybe I'm missing something? 🤔

[lucasfcosta]

For reference, the existing get method for the outbound emails does the same call but to the outbound route:

  async get(id: string): Promise<GetEmailResponse> {
    const data = await this.resend.get<GetEmailResponseSuccess>(
      `/emails/${id}`,
    );

    return data;
  }