Skip to content

docs: clarify %2f encoding requirement for scoped package paths#37

Open
jonasagx wants to merge 1 commit intonpm:mainfrom
jonasagx:doc-package-name
Open

docs: clarify %2f encoding requirement for scoped package paths#37
jonasagx wants to merge 1 commit intonpm:mainfrom
jonasagx:doc-package-name

Conversation

@jonasagx
Copy link
Copy Markdown

@jonasagx jonasagx commented Mar 27, 2026

Scoped packages must encode the scope separator as %2f in the URL path. A literal slash is treated as two path segments and will not resolve. Registry implementations must preserve %2f without decoding it to / before routing.

I'm not advocating for that solution, my goal is to document it for API compatibility.

References

Similar concerns were brought up on #9 but not documented for registry API.

Scoped packages must encode the scope separator as %2f in the URL path.
A literal slash is treated as two path segments and will not resolve.
Registry implementations must preserve %2f without decoding it to /
before routing.

I'm not advocating for that solution, my goal is to document it for API
compatiblity.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant