fix: enable path parsing to account for root level paths

[LukasParke]

What/Why/How?

Fixes #1634

Reference

Testing

Screenshots (optional)

Check yourself

• Code changed? - Tested with redoc/reference-docs/workflows (internal)
• All new/updated code is covered with tests
• New package installed? - Tested in different environments (browser/node)

Security

• Security impact of change has been considered
• Code follows company security practices and guidelines

[changeset-bot]

🦋 Changeset detected

Latest commit: aa943dc

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@redocly/cli	Patch
@redocly/openapi-core	Patch

Not sure what this means? Click here to learn what changesets are.

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

[lornajane]

Thanks for the pull request @LukeHagar , we'll take a look.

[tatomyr]

@LukeHagar do you mind adding a simple e2e test for the case?
(The corresponding folder is __tests__/split).

[LukasParke]

I'd be happy too, I realize this solution would also collide with any API endpoints that are actually /root so I'll solve for that as well.

[LukasParke]

@lornajane @tatomyr I think this is right. I couldn't get any of the tests to run locally due to a warning about an outdated dep messing with the snapshot output

[tatomyr]

I couldn't get any of the tests to run locally due to a warning about an outdated dep messing with the snapshot output

It's most likely because you're using Node version 21 or higher. If you try version 20 or earlier, it should work locally.

[LukasParke]

Yup I'm on v22.8.0

[tatomyr]

Does this mean that it will create a file named ~root for the root path?

[tatomyr]

I believe the best solution here would be simply returning the pathSeparator.
@LukeHagar, let me know if are still interested in the PR, or I'll redo this myself.

[LukasParke]

Swapped it over, but I do think there could be a better solution here, as a root level endpoint is somewhat common.

[tatomyr]

You might be right, but I haven't come up with a better solution yet. Let's start small and will see how it goes.

[tatomyr]

Could you rebase your branch as I believe smoke tests are failing due to the outdated code?

[LukasParke]

I'll rebase when I get on this morning

[tatomyr]

@LukeHagar it looks like it's too much to rebase. As for me, it'd be simpler to reapply your changes from scratch.

[tatomyr]

Any updates @LukeHagar 🙂?

[tatomyr]

Closing this since I've moved the logic manually to #2485.
Thanks again @LukeHagar for the original issue and the contribution!
The fix will be available in the next release.