feat: preview-headless-dashboard

[dielduarte]

DO NOT MERGE

draft PR just so we can follow the preview features being merged here and control preview bumps.

---

Summary by cubic

Adds account-level email, broadcast, and segment metrics, a usage endpoint, and webhook event APIs to support the headless dashboard preview. Bumps to 6.19.0-preview-headless-dashboard.4.

• New Features

  • broadcasts.metrics(id): status/timestamps; counters and rates for delivered/opened/clicked/unsubscribed/bounced/complained/suppressed; clicked_links.
  • broadcasts.recipients(id, { type, ... }): recipients by event (sent|delivered|opened|clicked|bounced|complained|unsubscribed|suppressed); filters email, bounceType (when bounced); cursor pagination.
  • emails.metrics(options?): metrics with metrics, dimensions (period|domain|email), startDate/endDate, timezone, granularity (hourly|daily|weekly|monthly), filter.domainId|emailId, sortBy, sortOrder; returns totals and optional data.
  • segments.metrics(options?): metrics with metrics, dimensions, filter.segmentId, sortBy, sortOrder; returns totals and optional data.
  • resend.usage.get(): returns generated time and usage for emails (daily/monthly), contacts, segments, broadcasts, ai_credits, automation_runs, domains, and rate limit.
  • Webhooks events: webhooks.events.list({ webhookId, limit?, after? }), webhooks.events.get({ webhookId, eventId }), webhooks.events.attempts.list({ webhookId, eventId, limit?, after? }).

• Bug Fixes

  • Flattened emails.metrics() and segments.metrics() filter query params to top-level domain_id, email_id, and segment_id in requests.

^{Written for commit 3e683d5. Summary will update on new commits.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/resend@1043

commit: 3e683d5

[cubic-dev-ai]

No issues found across 5 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Requires human review: Adds new public API methods and types for broadcast metrics and recipients. New features expanding the SDK's contract require human review of design, typing, and behavior.

Re-trigger cubic</sub>

[cubic-dev-ai]

0 issues found across 1 file (changes from recent commits).

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Requires human review: Draft PR marked 'DO NOT MERGE' for tracking preview features; adds new public API methods (broadcasts.metrics, broadcasts.recipients, usage.get) that require human review for correctness and design alignment.

Re-trigger cubic</sub>

[cubic-dev-ai]

0 issues found across 1 file (changes from recent commits).

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Requires human review: The PR is explicitly marked as a draft with "DO NOT MERGE" and introduces new public API methods (metrics, recipients, usage) as preview features, requiring human review before approval.

Re-trigger cubic</sub>

[cubic-dev-ai]

0 issues found across 3 files (changes from recent commits).

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Requires human review: PR is marked as draft and says 'DO NOT MERGE'; it adds multiple new public API endpoints (metrics, recipients, usage) that require human review for design and correctness before approval.

Re-trigger cubic</sub>

[cubic-dev-ai]

0 issues found across 1 file (changes from recent commits).

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Requires human review: PR is explicitly marked draft/DO NOT MERGE and adds new public API methods (metrics, usage, webhook events) plus a preview version bump. New API surface and release decisions need human sign-off.

Re-trigger cubic</sub>