AtlatestRepositorysigil-http3

sigil-http3 / tree / testtest-webtransport-session.sgl

1(import (sigil test)
2 (sigil http3 error)
3 (sigil http3 fields)
4 (sigil http3 webtransport wire)
5 (sigil http3 webtransport session))
6
7(define wt-session-fields
8 (map (lambda (entry) (cons (h3-ascii-bytes (car entry)) (h3-ascii-bytes (cdr entry))))
9 '((":method" . "CONNECT") (":protocol" . "webtransport") (":scheme" . "https")
10 (":authority" . "unit.test") (":path" . "/echo") ("origin" . "https://unit.test"))))
12(define (wt-session-code thunk)
13 (guard (exn ((h3-error? exn) (h3-error-code exn)) (else (raise exn)))
14 (thunk)
15 #f))
17(test-group "WebTransport session lifecycle"
18 (test "negotiation and application authorization are explicit gates"
19 (let ((calls 0))
20 (define (authorize fields)
21 (set! calls (+ calls 1))
22 (h3-ascii=? (h3-field-ref fields "origin") "https://unit.test"))
23 (assert-equal 503 (webtransport-request-status wt-session-fields authorize))
24 (assert-equal 0 calls)
25 (assert-equal 200 (webtransport-request-status wt-session-fields authorize negotiated?: #t))
26 (assert-equal 1 calls)
27 (assert-equal 403
28 (webtransport-request-status wt-session-fields (lambda (fields) #f) negotiated?: #t))))
30 (test "origin duplication and content fields are rejected before authorization"
31 (let ((calls 0))
32 (define (authorize fields) (set! calls (+ calls 1)) #t)
33 (for-each
34 (lambda (fields)
35 (assert-equal 400 (webtransport-request-status fields authorize negotiated?: #t)))
36 (list
37 (filter (lambda (entry) (not (h3-ascii=? (car entry) "origin"))) wt-session-fields)
38 (append wt-session-fields (list (cons (h3-ascii-bytes "origin") (h3-ascii-bytes "https://other.test"))))
39 (append wt-session-fields (list (cons (h3-ascii-bytes "content-length") (h3-ascii-bytes "0"))))
40 (append wt-session-fields (list (cons (h3-ascii-bytes "content-type") (h3-ascii-bytes "text/plain"))))))
41 (assert-equal 0 calls)))
43 (test "other protocols do not become accepted WebTransport requests"
44 (assert-equal 404
45 (webtransport-request-status wt-session-fields (lambda (fields) #t)
46 protocol: "webtransport-h3" negotiated?: #t)))
48 (test "associated bidi and uni payloads preserve bytes and FIN independently"
49 (let ((session (make-webtransport-session 0)))
50 (assert-equal '#(stream 4 #u8(1 2) #f) (webtransport-session-stream! session 4 #u8(1 2) #f))
51 (assert-equal '#(stream 14 #u8(3) #t) (webtransport-session-stream! session 14 #u8(3) #t))
52 (assert-equal '#(stream 4 #u8(4 5) #t) (webtransport-session-stream! session 4 #u8(4 5) #t))
53 (assert-equal '(4 14) (webtransport-session-stream-ids session))
54 (assert-equal #x105
55 (wt-session-code (lambda () (webtransport-session-stream! session 4 #u8(9) #f))))
56 (assert-error (webtransport-session-stream! session 0 #u8(1) #f))
57 (assert-error (webtransport-session-stream! session 7 #u8(1) #f))))
59 (test "drain permits existing session traffic and close retires every associated stream"
60 (let ((session (make-webtransport-session 0)))
61 (webtransport-session-stream! session 4 #u8(1) #f)
62 (webtransport-session-stream! session 14 #u8(2) #f)
63 (assert-equal (list (vector 'drain))
64 (webtransport-session-control! session (encode-webtransport-drain) #f))
65 (assert-equal 'draining (webtransport-session-phase session))
66 (assert-equal '#(datagram #u8(3)) (webtransport-session-datagram! session #u8(3)))
67 (assert-equal (list (vector 'close 7 #u8(65) '(14 4)))
68 (webtransport-session-control! session (encode-webtransport-close 7 #u8(65)) #f))
69 (assert-equal 'closed (webtransport-session-phase session))
70 (assert-equal '() (webtransport-session-stream-ids session))
71 (assert-false (webtransport-session-datagram! session #u8(1)))
72 (assert-false (webtransport-session-stream! session 4 #u8(1) #f))
73 (assert-equal (list (vector 'end)) (webtransport-session-control! session #u8() #t))))
75 (test "local close returns the capsule and stream retirement once"
76 (let ((session (make-webtransport-session 0)))
77 (webtransport-session-stream! session 4 #u8() #f)
78 (assert-equal (vector 'send-close (encode-webtransport-close 0 #u8()) '(4))
79 (webtransport-session-close! session 0 #u8()))
80 (assert-false (webtransport-session-close! session 0 #u8()))
81 (assert-equal (list (vector 'end)) (webtransport-session-control! session #u8() #t))))
83 (test "stream resets retain their lifetime slot and CONNECT reset retires the session"
84 (let ((session (make-webtransport-session 0 max-streams: 1)))
85 (webtransport-session-stream! session 4 #u8(1) #f)
86 (assert-equal '#(reset 4 0) (webtransport-session-reset! session 4 0))
87 (assert-false (webtransport-session-reset! session 4 0))
88 (assert-false (webtransport-session-reset! session 8 0))
89 (assert-equal #x107
90 (wt-session-code (lambda () (webtransport-session-stream! session 8 #u8(1) #f))))
91 (assert-equal '#(aborted 12 (4)) (webtransport-session-reset! session 0 12))
92 (assert-false (webtransport-session-reset! session 0 12))
93 (assert-equal 'closed (webtransport-session-phase session))))
95 (test "stream and datagram bytes consume the same finite session budget"
96 (let ((session (make-webtransport-session 0 byte-budget: 4)))
97 (webtransport-session-stream! session 4 #u8(1 2) #f)
98 (webtransport-session-datagram! session #u8(3))
99 (assert-equal '#(datagram #u8(4)) (webtransport-session-datagram! session #u8(4)))
100 (assert-equal #x107
101 (wt-session-code (lambda () (webtransport-session-stream! session 4 #u8(5) #f))))
102 (assert-equal #x107
103 (wt-session-code (lambda () (webtransport-session-datagram! session #u8(5)))))))
105 (test "capsule datagrams are delivered before a following close"
106 (let ((session (make-webtransport-session 0)))
107 (assert-equal (list (vector 'datagram #u8(1)) (vector 'close 0 #u8() '()) (vector 'end))
108 (webtransport-session-control! session
109 #u8(0 1 1 104 67 4 0 0 0 0) #t))))
111 (test "per-call and constructor bounds are checked"
112 (assert-error (make-webtransport-session 2))
113 (assert-error (make-webtransport-session 0 max-streams: 25))
114 (assert-error (make-webtransport-session 0 byte-budget: 0))
115 (let ((session (make-webtransport-session 0)))
116 (assert-error (webtransport-session-stream! session 4 (make-bytevector 4097 0) #f))
117 (assert-error (webtransport-session-datagram! session (make-bytevector 1025 0))))))