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, webhook event APIs, and broadcasts.cancel(id) to support the headless dashboard preview. Bumps to 6.19.0-preview-headless-dashboard.5.

• New Features

  • broadcasts.metrics(id): status/timestamps; counters/rates; clicked_links.
  • broadcasts.recipients(id, { type, ... }): list recipients by event with filters (email, bounceType) and cursor pagination.
  • emails.metrics(options?): metrics with metrics, dimensions (period|domain|email), date range, 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.
  • Webhook events: webhooks.events.list({ webhookId, limit?, after? }), webhooks.events.get({ webhookId, eventId }), webhooks.events.attempts.list({ webhookId, eventId, limit?, after? }).
  • broadcasts.cancel(id): cancel queued or scheduled broadcasts.

• Bug Fixes

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

^{Written for commit 0e2d30f. Summary will update on new commits.}

[pkg-pr-new]

Open in StackBlitz

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

commit: 0e2d30f

[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>

[cubic-dev-ai]

0 issues found across 4 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 explicitly marked 'DO NOT MERGE' (draft) and adds many new public API methods (broadcast metrics/recipients/cancel, email/segment metrics, usage, webhook events) plus a preview version bump; requires human review of the API contract and rollout.

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: This is a draft PR adding numerous new public API endpoints (metrics, usage, webhook events, cancel) and a preview version bump; each new contract and release decision warrants human sign-off.

Re-trigger cubic</sub>