feat: Add support for MongoDB driver options serverSelectionTimeoutMS, maxIdleTimeMS, heartbeatFrequencyMS

[mtrezza]

Pull Request

• Report security issues confidentially.
• Any contribution is under this license.
• Link this pull request to an issue.

Issue

MongoDB driver options serverSelectionTimeoutMS, maxIdleTimeMS, heartbeatFrequencyMS not recognized.

Approach

Add support for MongoDB driver options serverSelectionTimeoutMS, maxIdleTimeMS, heartbeatFrequencyMS.

Tasks

• Add tests
• Add changes to documentation (guides, repository pages, code comments)

Summary by CodeRabbit

• New Features
  • Added serverSelectionTimeoutMS option to configure the server selection timeout duration in milliseconds.
  • Added maxIdleTimeMS option to specify the maximum idle time for connections in the connection pool before removal.
  • Added heartbeatFrequencyMS option to control how frequently the driver checks MongoDB deployment state.

[parse-github-assistant]

🚀 Thanks for opening this pull request!

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds three MongoDB driver options—serverSelectionTimeoutMS, maxIdleTimeMS, and heartbeatFrequencyMS—across tests, option definitions, documentation, Flow and TypeScript type declarations, and environment variable parsing.

Changes

Cohort / File(s)	Summary
Test Updates spec/ParseConfigKey.spec.js	Added serverSelectionTimeoutMS, maxIdleTimeMS, and heartbeatFrequencyMS as valid MongoDB database configuration options in the databaseOptions test path; test asserts no invalidKey errors.
Option Definitions src/Options/Definitions.js	Inserted three new DatabaseOptions properties with env names (PARSE_SERVER_DATABASE_SERVER_SELECTION_TIMEOUT_MS, PARSE_SERVER_DATABASE_MAX_IDLE_TIME_MS, PARSE_SERVER_DATABASE_HEARTBEAT_FREQUENCY_MS) and parsers.numberParser(...) for each, plus help text.
JSDoc Documentation src/Options/docs.js	Added JSDoc entries documenting serverSelectionTimeoutMS, maxIdleTimeMS, and heartbeatFrequencyMS (Number, ms) on DatabaseOptions.
Flow Type Definitions src/Options/index.js	Added optional numeric fields serverSelectionTimeoutMS, maxIdleTimeMS, and heartbeatFrequencyMS to the DatabaseOptions Flow type.
TypeScript Type Definitions types/Options/index.d.ts	Added optional numeric properties serverSelectionTimeoutMS?: number, maxIdleTimeMS?: number, and heartbeatFrequencyMS?: number to the DatabaseOptions interface.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

• Verify environment variable names and help text match across files.
• Confirm numeric parsers are used consistently and handle edge cases.
• Ensure Flow and TypeScript declarations align with the runtime option keys.
• Validate the updated test correctly covers the new keys.

Suggested reviewers

• Moumouls

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The PR description identifies the problem and approach but lacks specific issue link and does not indicate whether tests have been added despite the unchecked test task.	Add the GitHub issue number/link in the 'Closes' field and provide clarity on test coverage status, as the 'Add tests' checkbox remains unchecked.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically describes the main change: adding support for three MongoDB driver options with their exact names.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

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.}

[parseplatformorg]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scanner	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.06%. Comparing base (460a65c) to head (a265932).
⚠️ Report is 3 commits behind head on alpha.

Additional details and impacted files

@@           Coverage Diff           @@
##            alpha    #9910   +/-   ##
=======================================
  Coverage   93.06%   93.06%           
=======================================
  Files         187      187           
  Lines       15187    15187           
  Branches      177      177           
=======================================
  Hits        14134    14134           
  Misses       1041     1041           
  Partials       12       12           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[parseplatformorg]

🎉 This change has been released in version 8.5.0-alpha.2