feat: rename ALPN prefix from alknet/ to alk/ (v0.1.1)
- CHANNELS_ALPN: b"alknet/channels" → b"alk/channels" - CallAdapter::alpn(): b"alknet/call" → b"alk/call" - derive_alpn_from_op_name: alknet/ prefix → alk/ prefix - All ALPN string literals in src/ and docs/ updated - ADR-004 amended with prefix rename rationale - AGENTS.md, README.md updated - Version bumped to 0.1.1 Review: docs/reviews/003-alpn-prefix-rename.md Verification: - cargo test: 542 passed, 0 failed - cargo clippy --all-targets -- -D warnings: clean - cargo fmt --check: clean - cargo doc --no-deps: clean
This commit is contained in:
1 parent
3cce1410c4
commit
08e7df2aa0
60 files changed
+837
-328
No files matched your search
@@ -32,9 +32,9 @@ The endpoint advertises the union of all registered handlers' ALPN strings. When
|
||||
- WASM story is clean: handlers receive byte streams, protocol parsers that operate on bytes compile to WASM
|
||||
|
||||
**Negative:**
|
||||
- ALPN is negotiated per-connection, not per-stream — a client that wants to use multiple ALPNs (e.g., SSH and call protocol) opens separate QUIC connections for each. QUIC connections are cheap (multiplexed over the same UDP flow), so this is acceptable, but it means `alknet/call` cannot serve as a multiplexer for other ALPNs within a single connection unless explicitly designed to do so (see ADR-004).
|
||||
- ALPN is negotiated per-connection, not per-stream — a client that wants to use multiple ALPNs (e.g., SSH and call protocol) opens separate QUIC connections for each. QUIC connections are cheap (multiplexed over the same UDP flow), so this is acceptable, but it means `alk/call` cannot serve as a multiplexer for other ALPNs within a single connection unless explicitly designed to do so (see ADR-004).
|
||||
- All protocols must be registered at endpoint creation time (or use hot-reload via ArcSwap for dynamic addition)
|
||||
- Custom protocols require reserving ALPN strings — we own the `alknet/` namespace
|
||||
- Custom protocols require reserving ALPN strings — we own the `alk/` namespace
|
||||
- Debugging requires knowing which ALPN was negotiated (mitigated by logging at the endpoint level)
|
||||
|
||||
## References
|
||||
|
||||
Reference in new issue
Block a user