Release v4.5.0

[piobeny]

Motivation

• Bump version to 4.5.0

Changes

• Bump version to 4.5.0
• Release Stats API
• Release Email Logs API

How to test

N/A

Examples

Summary by CodeRabbit

• New Features

  • Added Statistics API endpoints to retrieve aggregated data by domain, category, provider, and date.
  • Added support for Email Logs API.

• Documentation

  • Clarified the API key generation link in the README.

• Chores

  • Released version 4.5.0 (changelog updated 2026-03-13) and updated dependency versions.

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0a314bdb-1cdd-4fab-af86-c8f545eae172

📥 Commits

Reviewing files that changed from the base of the PR and between e89fbb8 and dbc284e.

📒 Files selected for processing (1)

• CHANGELOG.md

🚧 Files skipped from review as they are similar to previous changes (1)

• CHANGELOG.md

---

📝 Walkthrough

Walkthrough

Replaced "Unreleased" with a new 4.5.0 release entry dated 2026-03-13 in CHANGELOG.md, adjusted bullets under 4.5.0, and bumped package.json version from 4.4.0 → 4.5.0. No other code or public API signature changes.

Changes

Cohort / File(s)	Summary
Release metadata CHANGELOG.md, package.json	Added 4.5.0 (2026-03-13) release entry and updated bullets; bumped version in package.json from 4.4.0 → 4.5.0.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

• mailtrap/mailtrap-nodejs#113: Another release metadata bump touching CHANGELOG and package.json.
• mailtrap/mailtrap-nodejs#110: Related release/version bump and changelog update.
• mailtrap/mailtrap-nodejs#88: Prior release bump that also included an axios dependency entry referenced in changelogs.

Suggested reviewers

• mklocek

Poem

🐰 A hop, a tweak, a stamped release,
Notes trimmed neat — the changelog's peace.
Version nudged up, the numbers climb,
Carrots for docs, a tiny rhyme.
Hop on, new tag — it's release time.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Release v4.5.0' directly aligns with the main change: updating version numbers and releasing new APIs in a version bump.
Description check	✅ Passed	The description includes Motivation, Changes, and How to test sections following the template, though 'How to test' is marked as N/A and 'Images and GIFs' section is missing.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch release-v4.5.0

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Tip

You can make CodeRabbit's review stricter and more nitpicky using the `assertive` profile, if that's what you prefer.

Change the reviews.profile setting to assertive to make CodeRabbit's nitpick more issues in your PRs.

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CHANGELOG.md`:
- Around line 1-2: Update the release header "## [4.5.0] - 2025-03-06" in
CHANGELOG.md to the correct 2026 release date (replace "2025-03-06" with the
actual 2026 date for the 4.5.0 release) so the chronology with "## [4.4.0] -
2025-12-08" is correct.

In `@src/lib/api/resources/Stats.ts`:
- Around line 100-121: The buildQueryParams method is manually appending "[]" to
array parameter keys (e.g., "sending_domain_ids[]") which causes
double-bracketed query strings when Axios serializes arrays; update
Stats.buildQueryParams (accepting StatsFilterParams) to use plain keys
("sending_domain_ids", "sending_streams", "categories",
"email_service_providers") without the "[]" suffix so axios.get(..., { params:
buildQueryParams(...) }) will serialize arrays correctly.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: d342a8a2-ed69-490b-9da4-f213fcbf0fa8

📥 Commits

Reviewing files that changed from the base of the PR and between 484d833 and 9b6f082.

📒 Files selected for processing (8)

• CHANGELOG.md
• examples/general/stats.ts
• package.json
• src/__tests__/lib/api/resources/Stats.test.ts
• src/index.ts
• src/lib/api/General.ts
• src/lib/api/resources/Stats.ts
• src/types/api/stats.ts