FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

Plugin loader: dotted prefixes (/.foo) silently break the WebSocket upgrade — validate or document · Issue #597 · JavaScriptSolidServer/JavaScriptSolidServer · GitHub

Repository navigation

Plugin loader: dotted prefixes (/.foo) silently break the WebSocket upgrade — validate or document #597

Open

Description

What happens

A plugin mounted at a dotted prefix (e.g. /.terminal) cannot accept WebSocket connections — the upgrade fails immediately — while the same plugin at /terminal works. Plain HTTP on a dotted prefix (e.g. /.notifications) happens to work, so the failure is upgrade-specific and surprising.

Core reserves specific dotted paths (/.terminal, /.webrtc) for its own built-ins in the WAC-skip/upgrade handling, and a plugin claiming a dotted prefix collides with that host-level dotfile handling in a way plain prefixes don't.

Evidence

Found while porting the bundled terminal feature out-of-tree: https://github.com/JavaScriptSolidServer/plugins (NOTES.md, "Bugs the composition surfaced"). The composition there uses /terminal as the workaround.

Suggested fix

Either validate at load time (refuse or warn on a dotted prefix for plugins that register WS routes), or document the reservation so plugin authors don't discover it via a dead socket.

Activity

  1. added
    bugSomething isn't working
    pluginCould be implemented as a plugin (#206); core/plugin line defined in #564
    on Jul 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingpluginCould be implemented as a plugin (#206); core/plugin line defined in #564

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions


      Back | FazBrowse Home | New Git URL