🎨 Palette: Expose eolDate and improve JSDoc #790

google-labs-jules · 2026-01-05T18:39:29Z

💡 What:

Exposed eolDate property in NodeVersion object.
Added comprehensive JSDoc to getVersion and NodeVersion interface.

🎯 Why:

Developers need to know when a Node version becomes EOL, not just if it is EOL.
Better JSDoc improves IntelliSense and API discoverability.

♿ Accessibility (DX):

Makes the library easier to understand and use for developers.

PR created automatically by Jules for task 8883804194562260782 started by @srod

Summary by cubic

Expose eolDate on NodeVersion so developers can see the exact End-of-Life date for the current Node major. Improve JSDoc for clearer IntelliSense and update tests to cover the new field.

New Features
- Added eolDate (Date | undefined) to NodeVersion, derived from EOL_DATES and aligned with isEOL.
- Expanded JSDoc for getVersion and NodeVersion with return details and examples; tests assert eolDate for known and unknown versions.
Dependencies
- Loosened @biomejs/biome to ^2.3.11.

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

Summary by CodeRabbit

New Features
- Added End-of-Life (EOL) date information for Node.js versions
- Introduced eolDate property to view when a version reaches EOL
- Exported version metadata as a public constant for programmatic access
Tests
- Added tests for End-of-Life date validation
Chores
- Updated development dependency constraints

_{✏️ Tip: You can customize this high-level summary in your review settings.}

google-labs-jules · 2026-01-05T18:39:30Z

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

For security, I will only act on instructions from the user who triggered this task.

changeset-bot · 2026-01-05T18:39:33Z

⚠️ No Changeset found

Latest commit: d756029

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

coderabbitai · 2026-01-05T18:39:37Z

📝 Walkthrough

Walkthrough

This PR introduces End-of-Life (EOL) date tracking for Node.js versions by adding an EOL_DATES mapping, computing eolDate properties in the version object, expanding the NodeVersion type definition, and exporting a public version constant. The biome devDependency constraint was relaxed.

Changes

Cohort / File(s)	Summary
Dependency Version Relaxation `package.json`	Relaxed `@biomejs/biome` version constraint from pinned "2.3.11" to "^2.3.11" to allow compatible patch and minor updates.
EOL Date Implementation `src/index.ts`	Added EOL_DATES mapping for major versions with EOL dates, implemented checkEOL helper function, enhanced getVersion() to compute and expose eolDate (Date or undefined) and isEOL status, and exported a public version constant.
Type Definition Expansion `src/types.ts`	Added eolDate property (Date \| undefined) to the NodeVersion interface to represent End-of-Life date for major versions.
Test Coverage Updates `src/index.test.ts`	Updated expected property count from 15 to 16 for version and getVersion outputs; added tests verifying eolDate is correctly parsed as a Date for known versions (20.10.0 → 2026-04-30) and undefined for unknown versions (99.0.0).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

⚡ Bolt: Optimize node version comparison #771: Adds isEOL property to NodeVersion in getVersion, directly related to the shape changes made here.
🎨 Palette: Add toString() for better DX #777: Modifies NodeVersion interface by adding a toString() method, overlaps with type definition changes in this PR.

Poem

🐰 A rabbit hops through dates so clear,
EOL tracking, far and near,
With mapping keys and functions true,
The version object's shiny new!
Life cycles tracked, both old and spry, ✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Title check	⚠️ Warning	The title uses an emoji and a vague term ('Palette') unrelated to the core changes; the substantive changes (exposing eolDate and JSDoc improvements) are not clearly conveyed.	Revise the title to be more descriptive, such as 'Add eolDate property and improve getVersion JSDoc' or 'Expose Node.js End-of-Life date to API'. Remove the emoji for clarity.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

📝 Generate docstrings

📜 Recent review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 29e6014 and d756029.

📒 Files selected for processing (4)

package.json
src/index.test.ts
src/index.ts
src/types.ts

🧰 Additional context used

📓 Path-based instructions (6)

src/**/*.ts

📄 CodeRabbit inference engine (AGENTS.md)

Use TypeScript with strict type checking for all source files

Files:

src/index.test.ts
src/types.ts
src/index.ts

src/**/*.test.ts

📄 CodeRabbit inference engine (AGENTS.md)

src/**/*.test.ts: Co-locate test files with source files using the *.test.ts naming convention
Use vitest for all testing; tests should be co-located in src/ directory

Files:

src/index.test.ts

src/**/*.{ts,tsx}

📄 CodeRabbit inference engine (AGENTS.md)

Configure linting and formatting with Biome: 4 spaces indentation, double quotes, no semicolons

Files:

src/index.test.ts
src/types.ts
src/index.ts

package.json

📄 CodeRabbit inference engine (AGENTS.md)

package.json: Ensure package.json specifies type: module for ESM-only distribution and engines: >=20.0.0 for Node.js support
Node.js engine requirement must be set to >=20.0.0 in package.json

Files:

package.json

src/types.ts

📄 CodeRabbit inference engine (AGENTS.md)

Define all type interfaces in src/types.ts, including NodeVersion structure with major, minor, and methods

Files:

src/types.ts

src/index.ts

📄 CodeRabbit inference engine (AGENTS.md)

src/index.ts: Export main entry point from src/index.ts including getVersion function, isAtLeast method, isLTS property, and NodeVersion interface
Maintain EOL_DATES constant in src/index.ts mapping Node.js major versions to End of Life dates
Handle version string parsing with strict input validation and support for optional v prefixes

Files:

src/index.ts

🧠 Learnings (8)

📓 Common learnings

Learnt from: CR
Repo: srod/node-version PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-01-05T20:10:06.248Z
Learning: Applies to src/index.ts : Maintain EOL_DATES constant in src/index.ts mapping Node.js major versions to End of Life dates