feat: add experimental http2 support

Closes #4

Author: mafredri

.github/workflows/ci.yml

@@ -17,7 +17,10 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-go@v5
         with:
-          go-version-file: ./go.mod
+          # HACK(mafredri): The exampels and thirdparty library require Go 1.24
+          # due to `golang.org/x/crypto` import, so lint tools must be built by
+          # the highest version of Go used.
+          go-version-file: ./internal/thirdparty/go.mod
       - run: make fmt
 
   lint:
@@ -27,7 +30,10 @@ jobs:
       - run: go version
       - uses: actions/setup-go@v5
         with:
-          go-version-file: ./go.mod
+          # HACK(mafredri): The exampels and thirdparty library require Go 1.24
+          # due to `golang.org/x/crypto` import, so lint tools must be built by
+          # the highest version of Go used.
+          go-version-file: ./internal/thirdparty/go.mod
       - run: make lint
 
   test:

.github/workflows/daily.yml

@@ -34,33 +34,3 @@ jobs:
         with:
           name: coverage.html
           path: ./ci/out/coverage.html
-  bench-dev:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: dev
-      - uses: actions/setup-go@v5
-        with:
-          go-version-file: ./go.mod
-      - run: AUTOBAHN=1 make bench
-  test-dev:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Disable AppArmor
-        if: runner.os == 'Linux'
-        run: |
-          # Disable AppArmor for Ubuntu 23.10+.
-          # https://chromium.googlesource.com/chromium/src/+/main/docs/security/apparmor-userns-restrictions.md
-          echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns
-      - uses: actions/checkout@v4
-        with:
-          ref: dev
-      - uses: actions/setup-go@v5
-        with:
-          go-version-file: ./go.mod
-      - run: AUTOBAHN=1 make test
-      - uses: actions/upload-artifact@v4
-        with:
-          name: coverage-dev.html
-          path: ./ci/out/coverage.html

.github/workflows/static.yml

@@ -38,11 +38,7 @@ jobs:
           go-version-file: ./go.mod
       - name: Generate coverage and badge
         run: |
-          make test
-          mkdir -p ./ci/out/static
-          cp ./ci/out/coverage.html ./ci/out/static/coverage.html
-          percent=$(go tool cover -func ./ci/out/coverage.prof | tail -n1 | awk '{print $3}' | tr -d '%')
-          wget -O ./ci/out/static/coverage.svg "https://img.shields.io/badge/coverage-${percent}%25-success"
+          make static
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:

Makefile

@@ -13,6 +13,11 @@ lint:
 test:
 	./ci/test.sh
 
+.PHONY: static
+static:
+	make test
+	./ci/static.sh
+
 .PHONY: bench
 bench:
-	./ci/bench.sh
+	./ci/bench.sh

README.md

@@ -31,6 +31,11 @@ go get github.com/coder/websocket
 - [RFC 7692](https://tools.ietf.org/html/rfc7692) permessage-deflate compression
 - [CloseRead](https://pkg.go.dev/github.com/coder/websocket#Conn.CloseRead) helper for write only connections
 - Compile to [Wasm](https://pkg.go.dev/github.com/coder/websocket#hdr-Wasm)
+- Experimental support for HTTP/2 extended CONNECT (RFC 8441)
+  - Requires opt-in via the [AcceptOptions](https://pkg.go.dev/github.com/coder/websocket#AcceptOptions) and [DialOptions](https://pkg.go.dev/github.com/coder/websocket#DialOptions) Protocol option
+    - Clients must provide a `http2.Transport`
+    - Servers must be started with `GODEBUG=http2xconnect=1`, see https://github.com/golang/go/issues/53208
+  - See the [http2 example](./internal/examples/http2)
 
 ## Roadmap
 
@@ -43,7 +48,7 @@ See GitHub issues for minor issues but the major future enhancements are:
 - [ ] Graceful shutdown helpers [#209](https://github.com/nhooyr/websocket/issues/209)
 - [ ] Assembly for WebSocket masking [#16](https://github.com/nhooyr/websocket/issues/16)
   - WIP at [#326](https://github.com/nhooyr/websocket/pull/326), about 3x faster
-- [ ] HTTP/2 [#4](https://github.com/nhooyr/websocket/issues/4)
+- [x] HTTP/2 extended CONNECT (RFC 8441) [#4](https://github.com/coder/websocket/issues/4)
 - [ ] The holy grail [#402](https://github.com/nhooyr/websocket/issues/402)
 
 ## Examples
@@ -53,6 +58,8 @@ For a production quality example that demonstrates the complete API, see the
 
 For a full stack example, see the [chat example](./internal/examples/chat).
 
+For a HTTP/2 WebSocket example, see the [http2 example](./internal/examples/http2).
+
 ### Server
 
 ```go