rwebtransport 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. package/Cargo.lock +666 -666
  2. package/Cargo.toml +31 -31
  3. package/LICENSE +202 -202
  4. package/NOTICE +41 -41
  5. package/README.md +550 -550
  6. package/crates/echo-server/Cargo.toml +20 -20
  7. package/crates/echo-server/src/main.rs +666 -666
  8. package/crates/native/Cargo.toml +23 -23
  9. package/crates/native/src/config.rs +129 -129
  10. package/crates/native/src/driver.rs +463 -463
  11. package/crates/native/src/lib.rs +821 -821
  12. package/crates/native/src/server.rs +718 -718
  13. package/crates/native/src/session.rs +1191 -1191
  14. package/crates/native/src/tls.rs +96 -96
  15. package/crates/wtcore/Cargo.toml +15 -15
  16. package/crates/wtcore/src/h3.rs +226 -226
  17. package/crates/wtcore/src/lib.rs +9 -9
  18. package/dist/index.js.map +1 -1
  19. package/dist/index.mjs.map +1 -1
  20. package/package.json +80 -79
  21. package/prebuilds/darwin-arm64/rwebtransport.node +0 -0
  22. package/prebuilds/linux-arm64/rwebtransport.node +0 -0
  23. package/prebuilds/linux-x64/rwebtransport.node +0 -0
  24. package/prebuilds/win32-x64/rwebtransport.node +0 -0
  25. package/scripts/bench.mjs +180 -180
  26. package/scripts/build.js +67 -67
  27. package/scripts/postinstall.js +67 -67
  28. package/scripts/setup-unix.sh +129 -129
  29. package/scripts/setup-windows.ps1 +229 -229
  30. package/vendor/quiche/AGENTS.md +75 -75
  31. package/vendor/quiche/COPYING +23 -23
  32. package/vendor/quiche/Cargo.lock +1212 -1212
  33. package/vendor/quiche/Cargo.toml +215 -215
  34. package/vendor/quiche/README.md +466 -466
  35. package/vendor/quiche/examples/Makefile +46 -46
  36. package/vendor/quiche/examples/README.md +20 -20
  37. package/vendor/quiche/examples/cert-big.crt +90 -90
  38. package/vendor/quiche/examples/cert.crt +18 -18
  39. package/vendor/quiche/examples/cert.key +28 -28
  40. package/vendor/quiche/examples/client.c +343 -343
  41. package/vendor/quiche/examples/client.rs +281 -281
  42. package/vendor/quiche/examples/gen-certs.sh +15 -15
  43. package/vendor/quiche/examples/http3-client.c +473 -473
  44. package/vendor/quiche/examples/http3-client.rs +349 -349
  45. package/vendor/quiche/examples/http3-server.c +614 -614
  46. package/vendor/quiche/examples/http3-server.rs +680 -680
  47. package/vendor/quiche/examples/qpack-decode.rs +87 -87
  48. package/vendor/quiche/examples/qpack-encode.rs +88 -88
  49. package/vendor/quiche/examples/rootca.crt +21 -21
  50. package/vendor/quiche/examples/server.c +529 -529
  51. package/vendor/quiche/examples/server.rs +529 -529
  52. package/vendor/quiche/include/quiche.h +1282 -1282
  53. package/vendor/quiche/src/buffers.rs +105 -105
  54. package/vendor/quiche/src/build.rs +66 -66
  55. package/vendor/quiche/src/cid.rs +1079 -1079
  56. package/vendor/quiche/src/crypto/boringssl.rs +373 -373
  57. package/vendor/quiche/src/crypto/mod.rs +671 -671
  58. package/vendor/quiche/src/dgram.rs +118 -118
  59. package/vendor/quiche/src/error.rs +263 -263
  60. package/vendor/quiche/src/ffi.rs +2290 -2290
  61. package/vendor/quiche/src/flowcontrol.rs +246 -246
  62. package/vendor/quiche/src/frame.rs +2172 -2172
  63. package/vendor/quiche/src/h3/AGENTS.md +54 -54
  64. package/vendor/quiche/src/h3/ffi.rs +442 -442
  65. package/vendor/quiche/src/h3/frame.rs +1404 -1404
  66. package/vendor/quiche/src/h3/mod.rs +8223 -8223
  67. package/vendor/quiche/src/h3/qpack/decoder.rs +288 -288
  68. package/vendor/quiche/src/h3/qpack/encoder.rs +235 -235
  69. package/vendor/quiche/src/h3/qpack/mod.rs +202 -202
  70. package/vendor/quiche/src/h3/qpack/static_table.rs +323 -323
  71. package/vendor/quiche/src/h3/stream.rs +1595 -1595
  72. package/vendor/quiche/src/lib.rs +9556 -9556
  73. package/vendor/quiche/src/minmax.rs +446 -446
  74. package/vendor/quiche/src/packet.rs +2334 -2334
  75. package/vendor/quiche/src/path.rs +1374 -1374
  76. package/vendor/quiche/src/pmtud.rs +652 -652
  77. package/vendor/quiche/src/rand.rs +64 -64
  78. package/vendor/quiche/src/range_buf.rs +186 -186
  79. package/vendor/quiche/src/ranges.rs +755 -755
  80. package/vendor/quiche/src/recovery/AGENTS.md +80 -80
  81. package/vendor/quiche/src/recovery/bandwidth.rs +565 -565
  82. package/vendor/quiche/src/recovery/bytes_in_flight.rs +179 -179
  83. package/vendor/quiche/src/recovery/congestion/cubic.rs +1038 -1038
  84. package/vendor/quiche/src/recovery/congestion/delivery_rate.rs +514 -514
  85. package/vendor/quiche/src/recovery/congestion/hystart.rs +241 -241
  86. package/vendor/quiche/src/recovery/congestion/mod.rs +361 -361
  87. package/vendor/quiche/src/recovery/congestion/prr.rs +238 -238
  88. package/vendor/quiche/src/recovery/congestion/recovery.rs +1170 -1170
  89. package/vendor/quiche/src/recovery/congestion/reno.rs +291 -291
  90. package/vendor/quiche/src/recovery/congestion/test_sender.rs +201 -201
  91. package/vendor/quiche/src/recovery/gcongestion/bbr/bandwidth_sampler.rs +1947 -1947
  92. package/vendor/quiche/src/recovery/gcongestion/bbr/windowed_filter.rs +158 -158
  93. package/vendor/quiche/src/recovery/gcongestion/bbr.rs +37 -37
  94. package/vendor/quiche/src/recovery/gcongestion/bbr2/drain.rs +120 -120
  95. package/vendor/quiche/src/recovery/gcongestion/bbr2/mode.rs +318 -318
  96. package/vendor/quiche/src/recovery/gcongestion/bbr2/network_model.rs +784 -784
  97. package/vendor/quiche/src/recovery/gcongestion/bbr2/probe_bw.rs +729 -729
  98. package/vendor/quiche/src/recovery/gcongestion/bbr2/probe_rtt.rs +175 -175
  99. package/vendor/quiche/src/recovery/gcongestion/bbr2/startup.rs +190 -190
  100. package/vendor/quiche/src/recovery/gcongestion/bbr2.rs +855 -855
  101. package/vendor/quiche/src/recovery/gcongestion/mod.rs +275 -275
  102. package/vendor/quiche/src/recovery/gcongestion/pacer.rs +294 -294
  103. package/vendor/quiche/src/recovery/gcongestion/recovery.rs +1384 -1384
  104. package/vendor/quiche/src/recovery/mod.rs +3086 -3086
  105. package/vendor/quiche/src/recovery/rtt.rs +152 -152
  106. package/vendor/quiche/src/stream/mod.rs +2210 -2210
  107. package/vendor/quiche/src/stream/recv_buf.rs +1236 -1236
  108. package/vendor/quiche/src/stream/send_buf.rs +849 -849
  109. package/vendor/quiche/src/test_utils.rs +681 -681
  110. package/vendor/quiche/src/tests.rs +12922 -12922
  111. package/vendor/quiche/src/tls/boringssl.rs +375 -375
  112. package/vendor/quiche/src/tls/mod.rs +1245 -1245
  113. package/vendor/quiche/src/transport_params.rs +628 -628
@@ -1,821 +1,821 @@
1
- // SPDX-License-Identifier: Apache-2.0
2
- //! rwebtransport native addon: a WebTransport **client** for Node.js.
3
- //!
4
- //! This crate binds a native QUIC/HTTP-3/WebTransport client (Cloudflare quiche
5
- //! with BoringSSL) to Node through neon (N-API). The public surface is
6
- //! intentionally low-level and event-driven; the WHATWG `WebTransport` API is
7
- //! layered on top in TypeScript. See the JS↔native contract below.
8
- //!
9
- //! ## JS-visible functions
10
- //! * `connect(url, hashes[], insecure, origin|null, hdrNames[], hdrVals[], onEvent) -> handle`
11
- //! * `openStream(handle, bidi, requestId)`
12
- //! * `writeStream(handle, streamId, bytes, requestId)`
13
- //! * `finStream(handle, streamId)`
14
- //! * `resetStream(handle, streamId, code)`
15
- //! * `stopSending(handle, streamId, code)`
16
- //! * `setPaused(handle, streamId, paused)`
17
- //! * `sendDatagram(handle, bytes, requestId)`
18
- //! * `maxDatagramSize(handle) -> number`
19
- //! * `isReady(handle) -> boolean` / `isClosed(handle) -> boolean`
20
- //! * `closeSession(handle, code, reasonBytes)`
21
- //! * `shutdown(handle)`
22
- //!
23
- //! Events delivered to `onEvent(ev)` are plain objects `{ type, ... }`. See
24
- //! `ev_to_js`.
25
-
26
- mod config;
27
- mod driver;
28
- mod server;
29
- mod session;
30
- mod tls;
31
-
32
- use std::net::IpAddr;
33
- use std::sync::atomic::Ordering;
34
- use std::sync::mpsc::Sender;
35
- use std::sync::{Arc, Mutex};
36
-
37
- use neon::prelude::*;
38
- use neon::types::buffer::TypedArray;
39
-
40
- use config::ClientConfigParams;
41
- use driver::{Command, DriverShared, EventSink};
42
- use session::Ev;
43
- use tls::CertVerification;
44
-
45
- /// JS-facing session handle (a `JsBox`).
46
- struct SessionHandle {
47
- tx: Mutex<Option<Sender<Command>>>,
48
- waker: Arc<mio::Waker>,
49
- shared: Arc<DriverShared>,
50
- thread: Mutex<Option<std::thread::JoinHandle<()>>>,
51
- }
52
-
53
- impl SessionHandle {
54
- fn send(&self, cmd: Command) {
55
- if let Ok(guard) = self.tx.lock() {
56
- if let Some(tx) = guard.as_ref() {
57
- let _ = tx.send(cmd);
58
- let _ = self.waker.wake();
59
- }
60
- }
61
- }
62
- }
63
-
64
- impl Finalize for SessionHandle {
65
- fn finalize<'a, C: Context<'a>>(self, _cx: &mut C) {
66
- // Tell the driver thread to stop, then JOIN it before returning. Finalize
67
- // runs while the Node environment is still valid, so the thread drops its
68
- // neon `Channel` and `Root` here rather than racing the environment's
69
- // teardown from a detached thread (which crashes the process on Windows).
70
- self.send(Command::Shutdown);
71
- if let Ok(mut guard) = self.thread.lock() {
72
- if let Some(handle) = guard.take() {
73
- let _ = handle.join();
74
- }
75
- }
76
- }
77
- }
78
-
79
- /// Bridges driver events onto the JS event loop.
80
- struct NeonSink {
81
- channel: Channel,
82
- callback: Arc<Root<JsFunction>>,
83
- shared: Arc<DriverShared>,
84
- }
85
-
86
- impl EventSink for NeonSink {
87
- fn emit(&self, events: Vec<Ev>) {
88
- let cb = self.callback.clone();
89
- let shared = self.shared.clone();
90
- // Count this batch as in flight to the JS loop; the driver reads this to
91
- // back off from pulling more data out of quiche when JS falls behind.
92
- self.shared.inflight.fetch_add(1, Ordering::Relaxed);
93
- // `try_send`, not `send`: `send` panics if the callback cannot be
94
- // scheduled (for example while the Node environment is shutting down),
95
- // and that panic would unwind across the N-API C frame (undefined
96
- // behaviour that aborts the process on some platforms). Failing the emit
97
- // silently is the correct behaviour during teardown.
98
- let result = self.channel.try_send(move |mut cx| {
99
- // Dequeued by the JS loop: no longer contributing to queue depth.
100
- shared.inflight.fetch_sub(1, Ordering::Relaxed);
101
- let f = cb.to_inner(&mut cx);
102
- for ev in &events {
103
- let obj = ev_to_js(&mut cx, ev)?;
104
- let this = cx.undefined();
105
- let args = [obj.upcast::<JsValue>()];
106
- f.call(&mut cx, this, args)?;
107
- }
108
- Ok(())
109
- });
110
- if result.is_err() {
111
- // The callback will never run, so undo the in-flight increment here.
112
- self.shared.inflight.fetch_sub(1, Ordering::Relaxed);
113
- }
114
- }
115
- }
116
-
117
- struct ParsedUrl {
118
- host: String,
119
- port: u16,
120
- /// SNI / verification host (None for IP literals).
121
- sni: Option<String>,
122
- authority: String,
123
- path: String,
124
- }
125
-
126
- /// Parse a WebTransport URL WITHOUT resolving DNS (resolution is deferred to the
127
- /// driver thread so it never blocks the JS event loop).
128
- fn parse_url(url: &str) -> Result<ParsedUrl, String> {
129
- let rest = url
130
- .strip_prefix("https://")
131
- .ok_or_else(|| "WebTransport URL must use the https:// scheme".to_string())?;
132
-
133
- let (authority, path) = match rest.find('/') {
134
- Some(i) => (&rest[..i], rest[i..].to_string()),
135
- None => (rest, "/".to_string()),
136
- };
137
- if authority.is_empty() {
138
- return Err("WebTransport URL has an empty authority".to_string());
139
- }
140
-
141
- // Split host and port, handling IPv6 literals.
142
- let (host, port): (String, u16) = if let Some(hstr) = authority.strip_prefix('[') {
143
- let end = hstr
144
- .find(']')
145
- .ok_or_else(|| "malformed IPv6 authority".to_string())?;
146
- let host = hstr[..end].to_string();
147
- let after = &hstr[end + 1..];
148
- let port = after
149
- .strip_prefix(':')
150
- .map(|p| p.parse::<u16>().map_err(|_| "invalid port".to_string()))
151
- .transpose()?
152
- .unwrap_or(443);
153
- (host, port)
154
- } else if let Some(i) = authority.rfind(':') {
155
- let host = authority[..i].to_string();
156
- let port = authority[i + 1..]
157
- .parse::<u16>()
158
- .map_err(|_| "invalid port".to_string())?;
159
- (host, port)
160
- } else {
161
- (authority.to_string(), 443)
162
- };
163
-
164
- let sni = if host.parse::<IpAddr>().is_ok() {
165
- None
166
- } else {
167
- Some(host.clone())
168
- };
169
-
170
- Ok(ParsedUrl {
171
- host,
172
- port,
173
- sni,
174
- authority: authority.to_string(),
175
- path,
176
- })
177
- }
178
-
179
- /// Convert a JS number to a stream id. NaN / negative / non-finite values map to
180
- /// `u64::MAX`, which matches no real stream, so a malformed call is ignored
181
- /// instead of aliasing the CONNECT (session) stream id 0.
182
- fn to_stream_id(v: f64) -> u64 {
183
- if v.is_finite() && v >= 0.0 {
184
- v as u64
185
- } else {
186
- u64::MAX
187
- }
188
- }
189
-
190
- /// Convert a JS number to a QUIC/WebTransport application code, clamped below the
191
- /// 62-bit varint ceiling so quiche's varint encoder can never panic.
192
- fn to_code(v: f64) -> u64 {
193
- if v.is_finite() && v >= 0.0 {
194
- (v as u64).min((1u64 << 62) - 1)
195
- } else {
196
- 0
197
- }
198
- }
199
-
200
- /// Convert a JS number to a request id (NaN / non-finite → 0).
201
- fn to_request_id(v: f64) -> u64 {
202
- if v.is_finite() && v >= 0.0 {
203
- v as u64
204
- } else {
205
- 0
206
- }
207
- }
208
-
209
- fn connect(mut cx: FunctionContext) -> JsResult<JsBox<SessionHandle>> {
210
- let url = cx.argument::<JsString>(0)?.value(&mut cx);
211
- let hashes_arr = cx.argument::<JsArray>(1)?;
212
- let insecure = cx.argument::<JsBoolean>(2)?.value(&mut cx);
213
- let origin = {
214
- let v = cx.argument::<JsValue>(3)?;
215
- if v.is_a::<JsString, _>(&mut cx) {
216
- Some(v.downcast_or_throw::<JsString, _>(&mut cx)?.value(&mut cx))
217
- } else {
218
- None
219
- }
220
- };
221
- let names_arr = cx.argument::<JsArray>(4)?;
222
- let vals_arr = cx.argument::<JsArray>(5)?;
223
- let callback = cx.argument::<JsFunction>(6)?;
224
-
225
- // Certificate hashes.
226
- let mut hashes: Vec<[u8; 32]> = Vec::new();
227
- let hlen = hashes_arr.len(&mut cx);
228
- for i in 0..hlen {
229
- let elem = hashes_arr.get::<JsTypedArray<u8>, _, _>(&mut cx, i)?;
230
- let slice = elem.as_slice(&cx);
231
- if slice.len() == 32 {
232
- let mut h = [0u8; 32];
233
- h.copy_from_slice(slice);
234
- hashes.push(h);
235
- } else {
236
- return cx.throw_error("serverCertificateHashes entries must be 32 bytes (sha-256)");
237
- }
238
- }
239
-
240
- // Extra headers.
241
- let mut extra_headers: Vec<(String, String)> = Vec::new();
242
- let nlen = names_arr.len(&mut cx).min(vals_arr.len(&mut cx));
243
- for i in 0..nlen {
244
- let k = names_arr.get::<JsString, _, _>(&mut cx, i)?.value(&mut cx);
245
- let v = vals_arr.get::<JsString, _, _>(&mut cx, i)?.value(&mut cx);
246
- extra_headers.push((k, v));
247
- }
248
-
249
- let parsed = match parse_url(&url) {
250
- Ok(p) => p,
251
- Err(e) => return cx.throw_error(e),
252
- };
253
-
254
- let verify = if !hashes.is_empty() {
255
- CertVerification::Hashes(hashes)
256
- } else if insecure {
257
- CertVerification::Insecure
258
- } else {
259
- CertVerification::PkiDefault
260
- };
261
-
262
- let params = ClientConfigParams {
263
- verify,
264
- ..ClientConfigParams::default()
265
- };
266
-
267
- // Event-loop plumbing (created here so the poll registry can back the waker
268
- // stored in the handle). DNS resolution, socket bind, TLS/QUIC config, and
269
- // the handshake all run on the driver thread; see `driver::SessionSetup`.
270
- let poll = match mio::Poll::new() {
271
- Ok(p) => p,
272
- Err(e) => return cx.throw_error(format!("mio poll: {e}")),
273
- };
274
- let waker = match mio::Waker::new(poll.registry(), driver::WAKE_TOKEN) {
275
- Ok(w) => Arc::new(w),
276
- Err(e) => return cx.throw_error(format!("mio waker: {e}")),
277
- };
278
- let (tx, rx) = std::sync::mpsc::channel::<Command>();
279
- let shared = Arc::new(DriverShared::default());
280
-
281
- let sink: Box<dyn EventSink> = Box::new(NeonSink {
282
- channel: cx.channel(),
283
- callback: Arc::new(callback.root(&mut cx)),
284
- shared: shared.clone(),
285
- });
286
-
287
- let setup = driver::SessionSetup {
288
- host: parsed.host,
289
- port: parsed.port,
290
- sni: parsed.sni,
291
- authority: parsed.authority,
292
- path: parsed.path,
293
- origin,
294
- extra_headers,
295
- config: params,
296
- };
297
-
298
- let shared_for_thread = shared.clone();
299
- let thread = match std::thread::Builder::new()
300
- .name("rwt-driver".into())
301
- .spawn(move || {
302
- driver::run(setup, poll, rx, sink, shared_for_thread);
303
- }) {
304
- Ok(h) => h,
305
- Err(e) => return cx.throw_error(format!("failed to spawn driver thread: {e}")),
306
- };
307
-
308
- Ok(cx.boxed(SessionHandle {
309
- tx: Mutex::new(Some(tx)),
310
- waker,
311
- shared,
312
- thread: Mutex::new(Some(thread)),
313
- }))
314
- }
315
-
316
- fn open_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
317
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
318
- let bidi = cx.argument::<JsBoolean>(1)?.value(&mut cx);
319
- let request_id = to_request_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
320
- handle.send(Command::OpenStream { request_id, bidi });
321
- Ok(cx.undefined())
322
- }
323
-
324
- fn write_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
325
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
326
- let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
327
- let data = cx.argument::<JsTypedArray<u8>>(2)?.as_slice(&cx).to_vec();
328
- let request_id = to_request_id(cx.argument::<JsNumber>(3)?.value(&mut cx));
329
- handle.send(Command::Write {
330
- id,
331
- data,
332
- request_id,
333
- });
334
- Ok(cx.undefined())
335
- }
336
-
337
- fn fin_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
338
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
339
- let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
340
- handle.send(Command::Fin { id });
341
- Ok(cx.undefined())
342
- }
343
-
344
- fn reset_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
345
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
346
- let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
347
- let code = to_code(cx.argument::<JsNumber>(2)?.value(&mut cx));
348
- handle.send(Command::ResetStream { id, code });
349
- Ok(cx.undefined())
350
- }
351
-
352
- fn stop_sending(mut cx: FunctionContext) -> JsResult<JsUndefined> {
353
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
354
- let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
355
- let code = to_code(cx.argument::<JsNumber>(2)?.value(&mut cx));
356
- handle.send(Command::StopSending { id, code });
357
- Ok(cx.undefined())
358
- }
359
-
360
- fn set_paused(mut cx: FunctionContext) -> JsResult<JsUndefined> {
361
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
362
- let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
363
- let paused = cx.argument::<JsBoolean>(2)?.value(&mut cx);
364
- handle.send(Command::SetPaused { id, paused });
365
- Ok(cx.undefined())
366
- }
367
-
368
- fn send_datagram(mut cx: FunctionContext) -> JsResult<JsUndefined> {
369
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
370
- let data = cx.argument::<JsTypedArray<u8>>(1)?.as_slice(&cx).to_vec();
371
- let request_id = to_request_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
372
- handle.send(Command::SendDatagram { data, request_id });
373
- Ok(cx.undefined())
374
- }
375
-
376
- fn max_datagram_size(mut cx: FunctionContext) -> JsResult<JsNumber> {
377
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
378
- let n = handle.shared.max_datagram_size.load(Ordering::Relaxed);
379
- Ok(cx.number(n as f64))
380
- }
381
-
382
- fn is_ready(mut cx: FunctionContext) -> JsResult<JsBoolean> {
383
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
384
- Ok(cx.boolean(handle.shared.ready.load(Ordering::Relaxed)))
385
- }
386
-
387
- fn is_closed(mut cx: FunctionContext) -> JsResult<JsBoolean> {
388
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
389
- Ok(cx.boolean(handle.shared.closed.load(Ordering::Relaxed)))
390
- }
391
-
392
- fn close_session(mut cx: FunctionContext) -> JsResult<JsUndefined> {
393
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
394
- let code = to_code(cx.argument::<JsNumber>(1)?.value(&mut cx)) as u32;
395
- let reason = cx.argument::<JsTypedArray<u8>>(2)?.as_slice(&cx).to_vec();
396
- handle.send(Command::Close { code, reason });
397
- Ok(cx.undefined())
398
- }
399
-
400
- fn shutdown(mut cx: FunctionContext) -> JsResult<JsUndefined> {
401
- let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
402
- handle.send(Command::Shutdown);
403
- Ok(cx.undefined())
404
- }
405
-
406
- use server::{ServerCommand, ServerEventSink, ServerMsg, ServerSetup};
407
-
408
- /// JS-facing server handle (a `JsBox`).
409
- struct ServerHandle {
410
- tx: Mutex<Option<Sender<ServerCommand>>>,
411
- waker: Arc<mio::Waker>,
412
- shared: Arc<DriverShared>,
413
- thread: Mutex<Option<std::thread::JoinHandle<()>>>,
414
- }
415
-
416
- impl ServerHandle {
417
- fn send(&self, cmd: ServerCommand) {
418
- if let Ok(guard) = self.tx.lock() {
419
- if let Some(tx) = guard.as_ref() {
420
- let _ = tx.send(cmd);
421
- let _ = self.waker.wake();
422
- }
423
- }
424
- }
425
- }
426
-
427
- impl Finalize for ServerHandle {
428
- fn finalize<'a, C: Context<'a>>(self, _cx: &mut C) {
429
- // Stop and JOIN the server thread before finalize returns, so it never
430
- // races the Node environment teardown from a detached thread. See
431
- // SessionHandle::finalize.
432
- self.send(ServerCommand::Shutdown);
433
- if let Ok(mut guard) = self.thread.lock() {
434
- if let Some(handle) = guard.take() {
435
- let _ = handle.join();
436
- }
437
- }
438
- }
439
- }
440
-
441
- struct NeonServerSink {
442
- channel: Channel,
443
- callback: Arc<Root<JsFunction>>,
444
- shared: Arc<DriverShared>,
445
- }
446
-
447
- impl ServerEventSink for NeonServerSink {
448
- fn emit(&self, messages: Vec<ServerMsg>) {
449
- let cb = self.callback.clone();
450
- let shared = self.shared.clone();
451
- // Balance every emit (setup, teardown, and per-loop batches) so the
452
- // backpressure counter can never underflow and silently disable itself.
453
- self.shared.inflight.fetch_add(1, Ordering::Relaxed);
454
- // `try_send`, not `send`: see NeonSink::emit. `send` would panic across
455
- // the N-API boundary if the environment is shutting down.
456
- let result = self.channel.try_send(move |mut cx| {
457
- shared.inflight.fetch_sub(1, Ordering::Relaxed);
458
- let f = cb.to_inner(&mut cx);
459
- for msg in &messages {
460
- let obj = server_msg_to_js(&mut cx, msg)?;
461
- let this = cx.undefined();
462
- let args = [obj.upcast::<JsValue>()];
463
- f.call(&mut cx, this, args)?;
464
- }
465
- Ok(())
466
- });
467
- if result.is_err() {
468
- self.shared.inflight.fetch_sub(1, Ordering::Relaxed);
469
- }
470
- }
471
- }
472
-
473
- fn server_listen(mut cx: FunctionContext) -> JsResult<JsBox<ServerHandle>> {
474
- let cert_path = cx.argument::<JsString>(0)?.value(&mut cx);
475
- let key_path = cx.argument::<JsString>(1)?.value(&mut cx);
476
- let host = cx.argument::<JsString>(2)?.value(&mut cx);
477
- let port = cx.argument::<JsNumber>(3)?.value(&mut cx) as u16;
478
- let reuse_port = cx.argument::<JsBoolean>(4)?.value(&mut cx);
479
- let callback = cx.argument::<JsFunction>(5)?;
480
-
481
- let poll = match mio::Poll::new() {
482
- Ok(p) => p,
483
- Err(e) => return cx.throw_error(format!("mio poll: {e}")),
484
- };
485
- let waker = match mio::Waker::new(poll.registry(), driver::WAKE_TOKEN) {
486
- Ok(w) => Arc::new(w),
487
- Err(e) => return cx.throw_error(format!("mio waker: {e}")),
488
- };
489
- let (tx, rx) = std::sync::mpsc::channel::<ServerCommand>();
490
- let shared = Arc::new(DriverShared::default());
491
-
492
- let sink: Box<dyn ServerEventSink> = Box::new(NeonServerSink {
493
- channel: cx.channel(),
494
- callback: Arc::new(callback.root(&mut cx)),
495
- shared: shared.clone(),
496
- });
497
-
498
- let setup = ServerSetup {
499
- host,
500
- port,
501
- cert_path,
502
- key_path,
503
- reuse_port,
504
- };
505
-
506
- let shared_for_thread = shared.clone();
507
- let thread = match std::thread::Builder::new()
508
- .name("rwt-server".into())
509
- .spawn(move || {
510
- server::run(setup, poll, rx, sink, shared_for_thread);
511
- }) {
512
- Ok(h) => h,
513
- Err(e) => return cx.throw_error(format!("failed to spawn server thread: {e}")),
514
- };
515
-
516
- Ok(cx.boxed(ServerHandle {
517
- tx: Mutex::new(Some(tx)),
518
- waker,
519
- shared,
520
- thread: Mutex::new(Some(thread)),
521
- }))
522
- }
523
-
524
- fn server_open_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
525
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
526
- let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
527
- let bidi = cx.argument::<JsBoolean>(2)?.value(&mut cx);
528
- let request_id = to_request_id(cx.argument::<JsNumber>(3)?.value(&mut cx));
529
- handle.send(ServerCommand::OpenStream {
530
- session,
531
- request_id,
532
- bidi,
533
- });
534
- Ok(cx.undefined())
535
- }
536
-
537
- fn server_write(mut cx: FunctionContext) -> JsResult<JsUndefined> {
538
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
539
- let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
540
- let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
541
- let data = cx.argument::<JsTypedArray<u8>>(3)?.as_slice(&cx).to_vec();
542
- let request_id = to_request_id(cx.argument::<JsNumber>(4)?.value(&mut cx));
543
- handle.send(ServerCommand::Write {
544
- session,
545
- id,
546
- data,
547
- request_id,
548
- });
549
- Ok(cx.undefined())
550
- }
551
-
552
- fn server_fin(mut cx: FunctionContext) -> JsResult<JsUndefined> {
553
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
554
- let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
555
- let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
556
- handle.send(ServerCommand::Fin { session, id });
557
- Ok(cx.undefined())
558
- }
559
-
560
- fn server_reset(mut cx: FunctionContext) -> JsResult<JsUndefined> {
561
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
562
- let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
563
- let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
564
- let code = to_code(cx.argument::<JsNumber>(3)?.value(&mut cx));
565
- handle.send(ServerCommand::ResetStream { session, id, code });
566
- Ok(cx.undefined())
567
- }
568
-
569
- fn server_stop_sending(mut cx: FunctionContext) -> JsResult<JsUndefined> {
570
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
571
- let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
572
- let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
573
- let code = to_code(cx.argument::<JsNumber>(3)?.value(&mut cx));
574
- handle.send(ServerCommand::StopSending { session, id, code });
575
- Ok(cx.undefined())
576
- }
577
-
578
- fn server_set_paused(mut cx: FunctionContext) -> JsResult<JsUndefined> {
579
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
580
- let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
581
- let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
582
- let paused = cx.argument::<JsBoolean>(3)?.value(&mut cx);
583
- handle.send(ServerCommand::SetPaused {
584
- session,
585
- id,
586
- paused,
587
- });
588
- Ok(cx.undefined())
589
- }
590
-
591
- fn server_send_datagram(mut cx: FunctionContext) -> JsResult<JsUndefined> {
592
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
593
- let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
594
- let data = cx.argument::<JsTypedArray<u8>>(2)?.as_slice(&cx).to_vec();
595
- let request_id = to_request_id(cx.argument::<JsNumber>(3)?.value(&mut cx));
596
- handle.send(ServerCommand::SendDatagram {
597
- session,
598
- data,
599
- request_id,
600
- });
601
- Ok(cx.undefined())
602
- }
603
-
604
- fn server_max_datagram_size(mut cx: FunctionContext) -> JsResult<JsNumber> {
605
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
606
- let n = handle.shared.max_datagram_size.load(Ordering::Relaxed);
607
- Ok(cx.number(n as f64))
608
- }
609
-
610
- fn server_close_session(mut cx: FunctionContext) -> JsResult<JsUndefined> {
611
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
612
- let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
613
- let code = to_code(cx.argument::<JsNumber>(2)?.value(&mut cx)) as u32;
614
- let reason = cx.argument::<JsTypedArray<u8>>(3)?.as_slice(&cx).to_vec();
615
- handle.send(ServerCommand::CloseSession {
616
- session,
617
- code,
618
- reason,
619
- });
620
- Ok(cx.undefined())
621
- }
622
-
623
- fn server_shutdown(mut cx: FunctionContext) -> JsResult<JsUndefined> {
624
- let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
625
- handle.send(ServerCommand::Shutdown);
626
- Ok(cx.undefined())
627
- }
628
-
629
- fn server_msg_to_js<'a>(cx: &mut TaskContext<'a>, msg: &ServerMsg) -> JsResult<'a, JsObject> {
630
- match msg {
631
- ServerMsg::Listening(port) => {
632
- let obj = cx.empty_object();
633
- set_str(cx, &obj, "type", "listening")?;
634
- set_num(cx, &obj, "port", *port as f64)?;
635
- Ok(obj)
636
- }
637
- ServerMsg::ServerError(m) => {
638
- let obj = cx.empty_object();
639
- set_str(cx, &obj, "type", "serverError")?;
640
- set_str(cx, &obj, "message", m)?;
641
- Ok(obj)
642
- }
643
- ServerMsg::ServerClosed => {
644
- let obj = cx.empty_object();
645
- set_str(cx, &obj, "type", "serverClosed")?;
646
- Ok(obj)
647
- }
648
- ServerMsg::Session(session, ev) => {
649
- let obj = ev_to_js(cx, ev)?;
650
- set_num(cx, &obj, "session", *session as f64)?;
651
- Ok(obj)
652
- }
653
- }
654
- }
655
-
656
- fn ev_to_js<'a>(cx: &mut TaskContext<'a>, ev: &Ev) -> JsResult<'a, JsObject> {
657
- let obj = cx.empty_object();
658
- match ev {
659
- Ev::Ready => {
660
- set_str(cx, &obj, "type", "ready")?;
661
- }
662
- Ev::ServerReady {
663
- authority,
664
- path,
665
- origin,
666
- headers,
667
- remote_addr,
668
- remote_port,
669
- } => {
670
- set_str(cx, &obj, "type", "serverReady")?;
671
- set_str(cx, &obj, "authority", authority)?;
672
- set_str(cx, &obj, "path", path)?;
673
- match origin {
674
- Some(o) => set_str(cx, &obj, "origin", o)?,
675
- None => {
676
- let n = cx.null();
677
- obj.set(cx, "origin", n)?;
678
- }
679
- }
680
- let hobj = cx.empty_object();
681
- for (k, v) in headers {
682
- set_str(cx, &hobj, k, v)?;
683
- }
684
- obj.set(cx, "headers", hobj)?;
685
- set_str(cx, &obj, "remoteAddress", remote_addr)?;
686
- set_num(cx, &obj, "remotePort", *remote_port as f64)?;
687
- }
688
- Ev::Closed {
689
- code,
690
- reason,
691
- remote,
692
- } => {
693
- set_str(cx, &obj, "type", "closed")?;
694
- set_num(cx, &obj, "code", *code as f64)?;
695
- set_buf(cx, &obj, "reason", reason)?;
696
- set_bool(cx, &obj, "remote", *remote)?;
697
- }
698
- Ev::Error(msg) => {
699
- set_str(cx, &obj, "type", "error")?;
700
- set_str(cx, &obj, "message", msg)?;
701
- }
702
- Ev::Datagram(data) => {
703
- set_str(cx, &obj, "type", "datagram")?;
704
- set_buf(cx, &obj, "data", data)?;
705
- }
706
- Ev::IncomingStream { id, bidi } => {
707
- set_str(cx, &obj, "type", "stream")?;
708
- set_num(cx, &obj, "streamId", *id as f64)?;
709
- set_bool(cx, &obj, "bidi", *bidi)?;
710
- }
711
- Ev::StreamData { id, data } => {
712
- set_str(cx, &obj, "type", "streamData")?;
713
- set_num(cx, &obj, "streamId", *id as f64)?;
714
- set_buf(cx, &obj, "data", data)?;
715
- }
716
- Ev::StreamFinished { id } => {
717
- set_str(cx, &obj, "type", "streamFin")?;
718
- set_num(cx, &obj, "streamId", *id as f64)?;
719
- }
720
- Ev::StreamReset { id, code } => {
721
- set_str(cx, &obj, "type", "streamReset")?;
722
- set_num(cx, &obj, "streamId", *id as f64)?;
723
- set_num(cx, &obj, "code", *code as f64)?;
724
- }
725
- Ev::StreamStopSending { id, code } => {
726
- set_str(cx, &obj, "type", "streamStopSending")?;
727
- set_num(cx, &obj, "streamId", *id as f64)?;
728
- set_num(cx, &obj, "code", *code as f64)?;
729
- }
730
- Ev::StreamOpened { request_id, id } => {
731
- set_str(cx, &obj, "type", "streamOpened")?;
732
- set_num(cx, &obj, "requestId", *request_id as f64)?;
733
- set_num(cx, &obj, "streamId", *id as f64)?;
734
- }
735
- Ev::WriteAck { request_id } => {
736
- set_str(cx, &obj, "type", "writeAck")?;
737
- set_num(cx, &obj, "requestId", *request_id as f64)?;
738
- }
739
- Ev::DatagramAck { request_id, sent } => {
740
- set_str(cx, &obj, "type", "datagramAck")?;
741
- set_num(cx, &obj, "requestId", *request_id as f64)?;
742
- set_bool(cx, &obj, "sent", *sent)?;
743
- }
744
- }
745
- Ok(obj)
746
- }
747
-
748
- fn set_str<'a>(
749
- cx: &mut TaskContext<'a>,
750
- obj: &Handle<'a, JsObject>,
751
- key: &str,
752
- val: &str,
753
- ) -> NeonResult<()> {
754
- let v = cx.string(val);
755
- obj.set(cx, key, v)?;
756
- Ok(())
757
- }
758
-
759
- fn set_num<'a>(
760
- cx: &mut TaskContext<'a>,
761
- obj: &Handle<'a, JsObject>,
762
- key: &str,
763
- val: f64,
764
- ) -> NeonResult<()> {
765
- let v = cx.number(val);
766
- obj.set(cx, key, v)?;
767
- Ok(())
768
- }
769
-
770
- fn set_bool<'a>(
771
- cx: &mut TaskContext<'a>,
772
- obj: &Handle<'a, JsObject>,
773
- key: &str,
774
- val: bool,
775
- ) -> NeonResult<()> {
776
- let v = cx.boolean(val);
777
- obj.set(cx, key, v)?;
778
- Ok(())
779
- }
780
-
781
- fn set_buf<'a>(
782
- cx: &mut TaskContext<'a>,
783
- obj: &Handle<'a, JsObject>,
784
- key: &str,
785
- val: &[u8],
786
- ) -> NeonResult<()> {
787
- let v = JsBuffer::from_slice(cx, val)?;
788
- obj.set(cx, key, v)?;
789
- Ok(())
790
- }
791
-
792
- #[neon::main]
793
- fn main(mut cx: ModuleContext) -> NeonResult<()> {
794
- cx.export_function("connect", connect)?;
795
- cx.export_function("openStream", open_stream)?;
796
- cx.export_function("writeStream", write_stream)?;
797
- cx.export_function("finStream", fin_stream)?;
798
- cx.export_function("resetStream", reset_stream)?;
799
- cx.export_function("stopSending", stop_sending)?;
800
- cx.export_function("setPaused", set_paused)?;
801
- cx.export_function("sendDatagram", send_datagram)?;
802
- cx.export_function("maxDatagramSize", max_datagram_size)?;
803
- cx.export_function("isReady", is_ready)?;
804
- cx.export_function("isClosed", is_closed)?;
805
- cx.export_function("closeSession", close_session)?;
806
- cx.export_function("shutdown", shutdown)?;
807
-
808
- // Server surface.
809
- cx.export_function("serverListen", server_listen)?;
810
- cx.export_function("serverOpenStream", server_open_stream)?;
811
- cx.export_function("serverWrite", server_write)?;
812
- cx.export_function("serverFin", server_fin)?;
813
- cx.export_function("serverReset", server_reset)?;
814
- cx.export_function("serverStopSending", server_stop_sending)?;
815
- cx.export_function("serverSetPaused", server_set_paused)?;
816
- cx.export_function("serverSendDatagram", server_send_datagram)?;
817
- cx.export_function("serverMaxDatagramSize", server_max_datagram_size)?;
818
- cx.export_function("serverCloseSession", server_close_session)?;
819
- cx.export_function("serverShutdown", server_shutdown)?;
820
- Ok(())
821
- }
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ //! rwebtransport native addon: a WebTransport **client** for Node.js.
3
+ //!
4
+ //! This crate binds a native QUIC/HTTP-3/WebTransport client (Cloudflare quiche
5
+ //! with BoringSSL) to Node through neon (N-API). The public surface is
6
+ //! intentionally low-level and event-driven; the WHATWG `WebTransport` API is
7
+ //! layered on top in TypeScript. See the JS↔native contract below.
8
+ //!
9
+ //! ## JS-visible functions
10
+ //! * `connect(url, hashes[], insecure, origin|null, hdrNames[], hdrVals[], onEvent) -> handle`
11
+ //! * `openStream(handle, bidi, requestId)`
12
+ //! * `writeStream(handle, streamId, bytes, requestId)`
13
+ //! * `finStream(handle, streamId)`
14
+ //! * `resetStream(handle, streamId, code)`
15
+ //! * `stopSending(handle, streamId, code)`
16
+ //! * `setPaused(handle, streamId, paused)`
17
+ //! * `sendDatagram(handle, bytes, requestId)`
18
+ //! * `maxDatagramSize(handle) -> number`
19
+ //! * `isReady(handle) -> boolean` / `isClosed(handle) -> boolean`
20
+ //! * `closeSession(handle, code, reasonBytes)`
21
+ //! * `shutdown(handle)`
22
+ //!
23
+ //! Events delivered to `onEvent(ev)` are plain objects `{ type, ... }`. See
24
+ //! `ev_to_js`.
25
+
26
+ mod config;
27
+ mod driver;
28
+ mod server;
29
+ mod session;
30
+ mod tls;
31
+
32
+ use std::net::IpAddr;
33
+ use std::sync::atomic::Ordering;
34
+ use std::sync::mpsc::Sender;
35
+ use std::sync::{Arc, Mutex};
36
+
37
+ use neon::prelude::*;
38
+ use neon::types::buffer::TypedArray;
39
+
40
+ use config::ClientConfigParams;
41
+ use driver::{Command, DriverShared, EventSink};
42
+ use session::Ev;
43
+ use tls::CertVerification;
44
+
45
+ /// JS-facing session handle (a `JsBox`).
46
+ struct SessionHandle {
47
+ tx: Mutex<Option<Sender<Command>>>,
48
+ waker: Arc<mio::Waker>,
49
+ shared: Arc<DriverShared>,
50
+ thread: Mutex<Option<std::thread::JoinHandle<()>>>,
51
+ }
52
+
53
+ impl SessionHandle {
54
+ fn send(&self, cmd: Command) {
55
+ if let Ok(guard) = self.tx.lock() {
56
+ if let Some(tx) = guard.as_ref() {
57
+ let _ = tx.send(cmd);
58
+ let _ = self.waker.wake();
59
+ }
60
+ }
61
+ }
62
+ }
63
+
64
+ impl Finalize for SessionHandle {
65
+ fn finalize<'a, C: Context<'a>>(self, _cx: &mut C) {
66
+ // Tell the driver thread to stop, then JOIN it before returning. Finalize
67
+ // runs while the Node environment is still valid, so the thread drops its
68
+ // neon `Channel` and `Root` here rather than racing the environment's
69
+ // teardown from a detached thread (which crashes the process on Windows).
70
+ self.send(Command::Shutdown);
71
+ if let Ok(mut guard) = self.thread.lock() {
72
+ if let Some(handle) = guard.take() {
73
+ let _ = handle.join();
74
+ }
75
+ }
76
+ }
77
+ }
78
+
79
+ /// Bridges driver events onto the JS event loop.
80
+ struct NeonSink {
81
+ channel: Channel,
82
+ callback: Arc<Root<JsFunction>>,
83
+ shared: Arc<DriverShared>,
84
+ }
85
+
86
+ impl EventSink for NeonSink {
87
+ fn emit(&self, events: Vec<Ev>) {
88
+ let cb = self.callback.clone();
89
+ let shared = self.shared.clone();
90
+ // Count this batch as in flight to the JS loop; the driver reads this to
91
+ // back off from pulling more data out of quiche when JS falls behind.
92
+ self.shared.inflight.fetch_add(1, Ordering::Relaxed);
93
+ // `try_send`, not `send`: `send` panics if the callback cannot be
94
+ // scheduled (for example while the Node environment is shutting down),
95
+ // and that panic would unwind across the N-API C frame (undefined
96
+ // behaviour that aborts the process on some platforms). Failing the emit
97
+ // silently is the correct behaviour during teardown.
98
+ let result = self.channel.try_send(move |mut cx| {
99
+ // Dequeued by the JS loop: no longer contributing to queue depth.
100
+ shared.inflight.fetch_sub(1, Ordering::Relaxed);
101
+ let f = cb.to_inner(&mut cx);
102
+ for ev in &events {
103
+ let obj = ev_to_js(&mut cx, ev)?;
104
+ let this = cx.undefined();
105
+ let args = [obj.upcast::<JsValue>()];
106
+ f.call(&mut cx, this, args)?;
107
+ }
108
+ Ok(())
109
+ });
110
+ if result.is_err() {
111
+ // The callback will never run, so undo the in-flight increment here.
112
+ self.shared.inflight.fetch_sub(1, Ordering::Relaxed);
113
+ }
114
+ }
115
+ }
116
+
117
+ struct ParsedUrl {
118
+ host: String,
119
+ port: u16,
120
+ /// SNI / verification host (None for IP literals).
121
+ sni: Option<String>,
122
+ authority: String,
123
+ path: String,
124
+ }
125
+
126
+ /// Parse a WebTransport URL WITHOUT resolving DNS (resolution is deferred to the
127
+ /// driver thread so it never blocks the JS event loop).
128
+ fn parse_url(url: &str) -> Result<ParsedUrl, String> {
129
+ let rest = url
130
+ .strip_prefix("https://")
131
+ .ok_or_else(|| "WebTransport URL must use the https:// scheme".to_string())?;
132
+
133
+ let (authority, path) = match rest.find('/') {
134
+ Some(i) => (&rest[..i], rest[i..].to_string()),
135
+ None => (rest, "/".to_string()),
136
+ };
137
+ if authority.is_empty() {
138
+ return Err("WebTransport URL has an empty authority".to_string());
139
+ }
140
+
141
+ // Split host and port, handling IPv6 literals.
142
+ let (host, port): (String, u16) = if let Some(hstr) = authority.strip_prefix('[') {
143
+ let end = hstr
144
+ .find(']')
145
+ .ok_or_else(|| "malformed IPv6 authority".to_string())?;
146
+ let host = hstr[..end].to_string();
147
+ let after = &hstr[end + 1..];
148
+ let port = after
149
+ .strip_prefix(':')
150
+ .map(|p| p.parse::<u16>().map_err(|_| "invalid port".to_string()))
151
+ .transpose()?
152
+ .unwrap_or(443);
153
+ (host, port)
154
+ } else if let Some(i) = authority.rfind(':') {
155
+ let host = authority[..i].to_string();
156
+ let port = authority[i + 1..]
157
+ .parse::<u16>()
158
+ .map_err(|_| "invalid port".to_string())?;
159
+ (host, port)
160
+ } else {
161
+ (authority.to_string(), 443)
162
+ };
163
+
164
+ let sni = if host.parse::<IpAddr>().is_ok() {
165
+ None
166
+ } else {
167
+ Some(host.clone())
168
+ };
169
+
170
+ Ok(ParsedUrl {
171
+ host,
172
+ port,
173
+ sni,
174
+ authority: authority.to_string(),
175
+ path,
176
+ })
177
+ }
178
+
179
+ /// Convert a JS number to a stream id. NaN / negative / non-finite values map to
180
+ /// `u64::MAX`, which matches no real stream, so a malformed call is ignored
181
+ /// instead of aliasing the CONNECT (session) stream id 0.
182
+ fn to_stream_id(v: f64) -> u64 {
183
+ if v.is_finite() && v >= 0.0 {
184
+ v as u64
185
+ } else {
186
+ u64::MAX
187
+ }
188
+ }
189
+
190
+ /// Convert a JS number to a QUIC/WebTransport application code, clamped below the
191
+ /// 62-bit varint ceiling so quiche's varint encoder can never panic.
192
+ fn to_code(v: f64) -> u64 {
193
+ if v.is_finite() && v >= 0.0 {
194
+ (v as u64).min((1u64 << 62) - 1)
195
+ } else {
196
+ 0
197
+ }
198
+ }
199
+
200
+ /// Convert a JS number to a request id (NaN / non-finite → 0).
201
+ fn to_request_id(v: f64) -> u64 {
202
+ if v.is_finite() && v >= 0.0 {
203
+ v as u64
204
+ } else {
205
+ 0
206
+ }
207
+ }
208
+
209
+ fn connect(mut cx: FunctionContext) -> JsResult<JsBox<SessionHandle>> {
210
+ let url = cx.argument::<JsString>(0)?.value(&mut cx);
211
+ let hashes_arr = cx.argument::<JsArray>(1)?;
212
+ let insecure = cx.argument::<JsBoolean>(2)?.value(&mut cx);
213
+ let origin = {
214
+ let v = cx.argument::<JsValue>(3)?;
215
+ if v.is_a::<JsString, _>(&mut cx) {
216
+ Some(v.downcast_or_throw::<JsString, _>(&mut cx)?.value(&mut cx))
217
+ } else {
218
+ None
219
+ }
220
+ };
221
+ let names_arr = cx.argument::<JsArray>(4)?;
222
+ let vals_arr = cx.argument::<JsArray>(5)?;
223
+ let callback = cx.argument::<JsFunction>(6)?;
224
+
225
+ // Certificate hashes.
226
+ let mut hashes: Vec<[u8; 32]> = Vec::new();
227
+ let hlen = hashes_arr.len(&mut cx);
228
+ for i in 0..hlen {
229
+ let elem = hashes_arr.get::<JsTypedArray<u8>, _, _>(&mut cx, i)?;
230
+ let slice = elem.as_slice(&cx);
231
+ if slice.len() == 32 {
232
+ let mut h = [0u8; 32];
233
+ h.copy_from_slice(slice);
234
+ hashes.push(h);
235
+ } else {
236
+ return cx.throw_error("serverCertificateHashes entries must be 32 bytes (sha-256)");
237
+ }
238
+ }
239
+
240
+ // Extra headers.
241
+ let mut extra_headers: Vec<(String, String)> = Vec::new();
242
+ let nlen = names_arr.len(&mut cx).min(vals_arr.len(&mut cx));
243
+ for i in 0..nlen {
244
+ let k = names_arr.get::<JsString, _, _>(&mut cx, i)?.value(&mut cx);
245
+ let v = vals_arr.get::<JsString, _, _>(&mut cx, i)?.value(&mut cx);
246
+ extra_headers.push((k, v));
247
+ }
248
+
249
+ let parsed = match parse_url(&url) {
250
+ Ok(p) => p,
251
+ Err(e) => return cx.throw_error(e),
252
+ };
253
+
254
+ let verify = if !hashes.is_empty() {
255
+ CertVerification::Hashes(hashes)
256
+ } else if insecure {
257
+ CertVerification::Insecure
258
+ } else {
259
+ CertVerification::PkiDefault
260
+ };
261
+
262
+ let params = ClientConfigParams {
263
+ verify,
264
+ ..ClientConfigParams::default()
265
+ };
266
+
267
+ // Event-loop plumbing (created here so the poll registry can back the waker
268
+ // stored in the handle). DNS resolution, socket bind, TLS/QUIC config, and
269
+ // the handshake all run on the driver thread; see `driver::SessionSetup`.
270
+ let poll = match mio::Poll::new() {
271
+ Ok(p) => p,
272
+ Err(e) => return cx.throw_error(format!("mio poll: {e}")),
273
+ };
274
+ let waker = match mio::Waker::new(poll.registry(), driver::WAKE_TOKEN) {
275
+ Ok(w) => Arc::new(w),
276
+ Err(e) => return cx.throw_error(format!("mio waker: {e}")),
277
+ };
278
+ let (tx, rx) = std::sync::mpsc::channel::<Command>();
279
+ let shared = Arc::new(DriverShared::default());
280
+
281
+ let sink: Box<dyn EventSink> = Box::new(NeonSink {
282
+ channel: cx.channel(),
283
+ callback: Arc::new(callback.root(&mut cx)),
284
+ shared: shared.clone(),
285
+ });
286
+
287
+ let setup = driver::SessionSetup {
288
+ host: parsed.host,
289
+ port: parsed.port,
290
+ sni: parsed.sni,
291
+ authority: parsed.authority,
292
+ path: parsed.path,
293
+ origin,
294
+ extra_headers,
295
+ config: params,
296
+ };
297
+
298
+ let shared_for_thread = shared.clone();
299
+ let thread = match std::thread::Builder::new()
300
+ .name("rwt-driver".into())
301
+ .spawn(move || {
302
+ driver::run(setup, poll, rx, sink, shared_for_thread);
303
+ }) {
304
+ Ok(h) => h,
305
+ Err(e) => return cx.throw_error(format!("failed to spawn driver thread: {e}")),
306
+ };
307
+
308
+ Ok(cx.boxed(SessionHandle {
309
+ tx: Mutex::new(Some(tx)),
310
+ waker,
311
+ shared,
312
+ thread: Mutex::new(Some(thread)),
313
+ }))
314
+ }
315
+
316
+ fn open_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
317
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
318
+ let bidi = cx.argument::<JsBoolean>(1)?.value(&mut cx);
319
+ let request_id = to_request_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
320
+ handle.send(Command::OpenStream { request_id, bidi });
321
+ Ok(cx.undefined())
322
+ }
323
+
324
+ fn write_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
325
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
326
+ let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
327
+ let data = cx.argument::<JsTypedArray<u8>>(2)?.as_slice(&cx).to_vec();
328
+ let request_id = to_request_id(cx.argument::<JsNumber>(3)?.value(&mut cx));
329
+ handle.send(Command::Write {
330
+ id,
331
+ data,
332
+ request_id,
333
+ });
334
+ Ok(cx.undefined())
335
+ }
336
+
337
+ fn fin_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
338
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
339
+ let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
340
+ handle.send(Command::Fin { id });
341
+ Ok(cx.undefined())
342
+ }
343
+
344
+ fn reset_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
345
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
346
+ let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
347
+ let code = to_code(cx.argument::<JsNumber>(2)?.value(&mut cx));
348
+ handle.send(Command::ResetStream { id, code });
349
+ Ok(cx.undefined())
350
+ }
351
+
352
+ fn stop_sending(mut cx: FunctionContext) -> JsResult<JsUndefined> {
353
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
354
+ let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
355
+ let code = to_code(cx.argument::<JsNumber>(2)?.value(&mut cx));
356
+ handle.send(Command::StopSending { id, code });
357
+ Ok(cx.undefined())
358
+ }
359
+
360
+ fn set_paused(mut cx: FunctionContext) -> JsResult<JsUndefined> {
361
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
362
+ let id = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
363
+ let paused = cx.argument::<JsBoolean>(2)?.value(&mut cx);
364
+ handle.send(Command::SetPaused { id, paused });
365
+ Ok(cx.undefined())
366
+ }
367
+
368
+ fn send_datagram(mut cx: FunctionContext) -> JsResult<JsUndefined> {
369
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
370
+ let data = cx.argument::<JsTypedArray<u8>>(1)?.as_slice(&cx).to_vec();
371
+ let request_id = to_request_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
372
+ handle.send(Command::SendDatagram { data, request_id });
373
+ Ok(cx.undefined())
374
+ }
375
+
376
+ fn max_datagram_size(mut cx: FunctionContext) -> JsResult<JsNumber> {
377
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
378
+ let n = handle.shared.max_datagram_size.load(Ordering::Relaxed);
379
+ Ok(cx.number(n as f64))
380
+ }
381
+
382
+ fn is_ready(mut cx: FunctionContext) -> JsResult<JsBoolean> {
383
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
384
+ Ok(cx.boolean(handle.shared.ready.load(Ordering::Relaxed)))
385
+ }
386
+
387
+ fn is_closed(mut cx: FunctionContext) -> JsResult<JsBoolean> {
388
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
389
+ Ok(cx.boolean(handle.shared.closed.load(Ordering::Relaxed)))
390
+ }
391
+
392
+ fn close_session(mut cx: FunctionContext) -> JsResult<JsUndefined> {
393
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
394
+ let code = to_code(cx.argument::<JsNumber>(1)?.value(&mut cx)) as u32;
395
+ let reason = cx.argument::<JsTypedArray<u8>>(2)?.as_slice(&cx).to_vec();
396
+ handle.send(Command::Close { code, reason });
397
+ Ok(cx.undefined())
398
+ }
399
+
400
+ fn shutdown(mut cx: FunctionContext) -> JsResult<JsUndefined> {
401
+ let handle = cx.argument::<JsBox<SessionHandle>>(0)?;
402
+ handle.send(Command::Shutdown);
403
+ Ok(cx.undefined())
404
+ }
405
+
406
+ use server::{ServerCommand, ServerEventSink, ServerMsg, ServerSetup};
407
+
408
+ /// JS-facing server handle (a `JsBox`).
409
+ struct ServerHandle {
410
+ tx: Mutex<Option<Sender<ServerCommand>>>,
411
+ waker: Arc<mio::Waker>,
412
+ shared: Arc<DriverShared>,
413
+ thread: Mutex<Option<std::thread::JoinHandle<()>>>,
414
+ }
415
+
416
+ impl ServerHandle {
417
+ fn send(&self, cmd: ServerCommand) {
418
+ if let Ok(guard) = self.tx.lock() {
419
+ if let Some(tx) = guard.as_ref() {
420
+ let _ = tx.send(cmd);
421
+ let _ = self.waker.wake();
422
+ }
423
+ }
424
+ }
425
+ }
426
+
427
+ impl Finalize for ServerHandle {
428
+ fn finalize<'a, C: Context<'a>>(self, _cx: &mut C) {
429
+ // Stop and JOIN the server thread before finalize returns, so it never
430
+ // races the Node environment teardown from a detached thread. See
431
+ // SessionHandle::finalize.
432
+ self.send(ServerCommand::Shutdown);
433
+ if let Ok(mut guard) = self.thread.lock() {
434
+ if let Some(handle) = guard.take() {
435
+ let _ = handle.join();
436
+ }
437
+ }
438
+ }
439
+ }
440
+
441
+ struct NeonServerSink {
442
+ channel: Channel,
443
+ callback: Arc<Root<JsFunction>>,
444
+ shared: Arc<DriverShared>,
445
+ }
446
+
447
+ impl ServerEventSink for NeonServerSink {
448
+ fn emit(&self, messages: Vec<ServerMsg>) {
449
+ let cb = self.callback.clone();
450
+ let shared = self.shared.clone();
451
+ // Balance every emit (setup, teardown, and per-loop batches) so the
452
+ // backpressure counter can never underflow and silently disable itself.
453
+ self.shared.inflight.fetch_add(1, Ordering::Relaxed);
454
+ // `try_send`, not `send`: see NeonSink::emit. `send` would panic across
455
+ // the N-API boundary if the environment is shutting down.
456
+ let result = self.channel.try_send(move |mut cx| {
457
+ shared.inflight.fetch_sub(1, Ordering::Relaxed);
458
+ let f = cb.to_inner(&mut cx);
459
+ for msg in &messages {
460
+ let obj = server_msg_to_js(&mut cx, msg)?;
461
+ let this = cx.undefined();
462
+ let args = [obj.upcast::<JsValue>()];
463
+ f.call(&mut cx, this, args)?;
464
+ }
465
+ Ok(())
466
+ });
467
+ if result.is_err() {
468
+ self.shared.inflight.fetch_sub(1, Ordering::Relaxed);
469
+ }
470
+ }
471
+ }
472
+
473
+ fn server_listen(mut cx: FunctionContext) -> JsResult<JsBox<ServerHandle>> {
474
+ let cert_path = cx.argument::<JsString>(0)?.value(&mut cx);
475
+ let key_path = cx.argument::<JsString>(1)?.value(&mut cx);
476
+ let host = cx.argument::<JsString>(2)?.value(&mut cx);
477
+ let port = cx.argument::<JsNumber>(3)?.value(&mut cx) as u16;
478
+ let reuse_port = cx.argument::<JsBoolean>(4)?.value(&mut cx);
479
+ let callback = cx.argument::<JsFunction>(5)?;
480
+
481
+ let poll = match mio::Poll::new() {
482
+ Ok(p) => p,
483
+ Err(e) => return cx.throw_error(format!("mio poll: {e}")),
484
+ };
485
+ let waker = match mio::Waker::new(poll.registry(), driver::WAKE_TOKEN) {
486
+ Ok(w) => Arc::new(w),
487
+ Err(e) => return cx.throw_error(format!("mio waker: {e}")),
488
+ };
489
+ let (tx, rx) = std::sync::mpsc::channel::<ServerCommand>();
490
+ let shared = Arc::new(DriverShared::default());
491
+
492
+ let sink: Box<dyn ServerEventSink> = Box::new(NeonServerSink {
493
+ channel: cx.channel(),
494
+ callback: Arc::new(callback.root(&mut cx)),
495
+ shared: shared.clone(),
496
+ });
497
+
498
+ let setup = ServerSetup {
499
+ host,
500
+ port,
501
+ cert_path,
502
+ key_path,
503
+ reuse_port,
504
+ };
505
+
506
+ let shared_for_thread = shared.clone();
507
+ let thread = match std::thread::Builder::new()
508
+ .name("rwt-server".into())
509
+ .spawn(move || {
510
+ server::run(setup, poll, rx, sink, shared_for_thread);
511
+ }) {
512
+ Ok(h) => h,
513
+ Err(e) => return cx.throw_error(format!("failed to spawn server thread: {e}")),
514
+ };
515
+
516
+ Ok(cx.boxed(ServerHandle {
517
+ tx: Mutex::new(Some(tx)),
518
+ waker,
519
+ shared,
520
+ thread: Mutex::new(Some(thread)),
521
+ }))
522
+ }
523
+
524
+ fn server_open_stream(mut cx: FunctionContext) -> JsResult<JsUndefined> {
525
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
526
+ let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
527
+ let bidi = cx.argument::<JsBoolean>(2)?.value(&mut cx);
528
+ let request_id = to_request_id(cx.argument::<JsNumber>(3)?.value(&mut cx));
529
+ handle.send(ServerCommand::OpenStream {
530
+ session,
531
+ request_id,
532
+ bidi,
533
+ });
534
+ Ok(cx.undefined())
535
+ }
536
+
537
+ fn server_write(mut cx: FunctionContext) -> JsResult<JsUndefined> {
538
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
539
+ let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
540
+ let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
541
+ let data = cx.argument::<JsTypedArray<u8>>(3)?.as_slice(&cx).to_vec();
542
+ let request_id = to_request_id(cx.argument::<JsNumber>(4)?.value(&mut cx));
543
+ handle.send(ServerCommand::Write {
544
+ session,
545
+ id,
546
+ data,
547
+ request_id,
548
+ });
549
+ Ok(cx.undefined())
550
+ }
551
+
552
+ fn server_fin(mut cx: FunctionContext) -> JsResult<JsUndefined> {
553
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
554
+ let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
555
+ let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
556
+ handle.send(ServerCommand::Fin { session, id });
557
+ Ok(cx.undefined())
558
+ }
559
+
560
+ fn server_reset(mut cx: FunctionContext) -> JsResult<JsUndefined> {
561
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
562
+ let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
563
+ let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
564
+ let code = to_code(cx.argument::<JsNumber>(3)?.value(&mut cx));
565
+ handle.send(ServerCommand::ResetStream { session, id, code });
566
+ Ok(cx.undefined())
567
+ }
568
+
569
+ fn server_stop_sending(mut cx: FunctionContext) -> JsResult<JsUndefined> {
570
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
571
+ let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
572
+ let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
573
+ let code = to_code(cx.argument::<JsNumber>(3)?.value(&mut cx));
574
+ handle.send(ServerCommand::StopSending { session, id, code });
575
+ Ok(cx.undefined())
576
+ }
577
+
578
+ fn server_set_paused(mut cx: FunctionContext) -> JsResult<JsUndefined> {
579
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
580
+ let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
581
+ let id = to_stream_id(cx.argument::<JsNumber>(2)?.value(&mut cx));
582
+ let paused = cx.argument::<JsBoolean>(3)?.value(&mut cx);
583
+ handle.send(ServerCommand::SetPaused {
584
+ session,
585
+ id,
586
+ paused,
587
+ });
588
+ Ok(cx.undefined())
589
+ }
590
+
591
+ fn server_send_datagram(mut cx: FunctionContext) -> JsResult<JsUndefined> {
592
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
593
+ let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
594
+ let data = cx.argument::<JsTypedArray<u8>>(2)?.as_slice(&cx).to_vec();
595
+ let request_id = to_request_id(cx.argument::<JsNumber>(3)?.value(&mut cx));
596
+ handle.send(ServerCommand::SendDatagram {
597
+ session,
598
+ data,
599
+ request_id,
600
+ });
601
+ Ok(cx.undefined())
602
+ }
603
+
604
+ fn server_max_datagram_size(mut cx: FunctionContext) -> JsResult<JsNumber> {
605
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
606
+ let n = handle.shared.max_datagram_size.load(Ordering::Relaxed);
607
+ Ok(cx.number(n as f64))
608
+ }
609
+
610
+ fn server_close_session(mut cx: FunctionContext) -> JsResult<JsUndefined> {
611
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
612
+ let session = to_stream_id(cx.argument::<JsNumber>(1)?.value(&mut cx));
613
+ let code = to_code(cx.argument::<JsNumber>(2)?.value(&mut cx)) as u32;
614
+ let reason = cx.argument::<JsTypedArray<u8>>(3)?.as_slice(&cx).to_vec();
615
+ handle.send(ServerCommand::CloseSession {
616
+ session,
617
+ code,
618
+ reason,
619
+ });
620
+ Ok(cx.undefined())
621
+ }
622
+
623
+ fn server_shutdown(mut cx: FunctionContext) -> JsResult<JsUndefined> {
624
+ let handle = cx.argument::<JsBox<ServerHandle>>(0)?;
625
+ handle.send(ServerCommand::Shutdown);
626
+ Ok(cx.undefined())
627
+ }
628
+
629
+ fn server_msg_to_js<'a>(cx: &mut TaskContext<'a>, msg: &ServerMsg) -> JsResult<'a, JsObject> {
630
+ match msg {
631
+ ServerMsg::Listening(port) => {
632
+ let obj = cx.empty_object();
633
+ set_str(cx, &obj, "type", "listening")?;
634
+ set_num(cx, &obj, "port", *port as f64)?;
635
+ Ok(obj)
636
+ }
637
+ ServerMsg::ServerError(m) => {
638
+ let obj = cx.empty_object();
639
+ set_str(cx, &obj, "type", "serverError")?;
640
+ set_str(cx, &obj, "message", m)?;
641
+ Ok(obj)
642
+ }
643
+ ServerMsg::ServerClosed => {
644
+ let obj = cx.empty_object();
645
+ set_str(cx, &obj, "type", "serverClosed")?;
646
+ Ok(obj)
647
+ }
648
+ ServerMsg::Session(session, ev) => {
649
+ let obj = ev_to_js(cx, ev)?;
650
+ set_num(cx, &obj, "session", *session as f64)?;
651
+ Ok(obj)
652
+ }
653
+ }
654
+ }
655
+
656
+ fn ev_to_js<'a>(cx: &mut TaskContext<'a>, ev: &Ev) -> JsResult<'a, JsObject> {
657
+ let obj = cx.empty_object();
658
+ match ev {
659
+ Ev::Ready => {
660
+ set_str(cx, &obj, "type", "ready")?;
661
+ }
662
+ Ev::ServerReady {
663
+ authority,
664
+ path,
665
+ origin,
666
+ headers,
667
+ remote_addr,
668
+ remote_port,
669
+ } => {
670
+ set_str(cx, &obj, "type", "serverReady")?;
671
+ set_str(cx, &obj, "authority", authority)?;
672
+ set_str(cx, &obj, "path", path)?;
673
+ match origin {
674
+ Some(o) => set_str(cx, &obj, "origin", o)?,
675
+ None => {
676
+ let n = cx.null();
677
+ obj.set(cx, "origin", n)?;
678
+ }
679
+ }
680
+ let hobj = cx.empty_object();
681
+ for (k, v) in headers {
682
+ set_str(cx, &hobj, k, v)?;
683
+ }
684
+ obj.set(cx, "headers", hobj)?;
685
+ set_str(cx, &obj, "remoteAddress", remote_addr)?;
686
+ set_num(cx, &obj, "remotePort", *remote_port as f64)?;
687
+ }
688
+ Ev::Closed {
689
+ code,
690
+ reason,
691
+ remote,
692
+ } => {
693
+ set_str(cx, &obj, "type", "closed")?;
694
+ set_num(cx, &obj, "code", *code as f64)?;
695
+ set_buf(cx, &obj, "reason", reason)?;
696
+ set_bool(cx, &obj, "remote", *remote)?;
697
+ }
698
+ Ev::Error(msg) => {
699
+ set_str(cx, &obj, "type", "error")?;
700
+ set_str(cx, &obj, "message", msg)?;
701
+ }
702
+ Ev::Datagram(data) => {
703
+ set_str(cx, &obj, "type", "datagram")?;
704
+ set_buf(cx, &obj, "data", data)?;
705
+ }
706
+ Ev::IncomingStream { id, bidi } => {
707
+ set_str(cx, &obj, "type", "stream")?;
708
+ set_num(cx, &obj, "streamId", *id as f64)?;
709
+ set_bool(cx, &obj, "bidi", *bidi)?;
710
+ }
711
+ Ev::StreamData { id, data } => {
712
+ set_str(cx, &obj, "type", "streamData")?;
713
+ set_num(cx, &obj, "streamId", *id as f64)?;
714
+ set_buf(cx, &obj, "data", data)?;
715
+ }
716
+ Ev::StreamFinished { id } => {
717
+ set_str(cx, &obj, "type", "streamFin")?;
718
+ set_num(cx, &obj, "streamId", *id as f64)?;
719
+ }
720
+ Ev::StreamReset { id, code } => {
721
+ set_str(cx, &obj, "type", "streamReset")?;
722
+ set_num(cx, &obj, "streamId", *id as f64)?;
723
+ set_num(cx, &obj, "code", *code as f64)?;
724
+ }
725
+ Ev::StreamStopSending { id, code } => {
726
+ set_str(cx, &obj, "type", "streamStopSending")?;
727
+ set_num(cx, &obj, "streamId", *id as f64)?;
728
+ set_num(cx, &obj, "code", *code as f64)?;
729
+ }
730
+ Ev::StreamOpened { request_id, id } => {
731
+ set_str(cx, &obj, "type", "streamOpened")?;
732
+ set_num(cx, &obj, "requestId", *request_id as f64)?;
733
+ set_num(cx, &obj, "streamId", *id as f64)?;
734
+ }
735
+ Ev::WriteAck { request_id } => {
736
+ set_str(cx, &obj, "type", "writeAck")?;
737
+ set_num(cx, &obj, "requestId", *request_id as f64)?;
738
+ }
739
+ Ev::DatagramAck { request_id, sent } => {
740
+ set_str(cx, &obj, "type", "datagramAck")?;
741
+ set_num(cx, &obj, "requestId", *request_id as f64)?;
742
+ set_bool(cx, &obj, "sent", *sent)?;
743
+ }
744
+ }
745
+ Ok(obj)
746
+ }
747
+
748
+ fn set_str<'a>(
749
+ cx: &mut TaskContext<'a>,
750
+ obj: &Handle<'a, JsObject>,
751
+ key: &str,
752
+ val: &str,
753
+ ) -> NeonResult<()> {
754
+ let v = cx.string(val);
755
+ obj.set(cx, key, v)?;
756
+ Ok(())
757
+ }
758
+
759
+ fn set_num<'a>(
760
+ cx: &mut TaskContext<'a>,
761
+ obj: &Handle<'a, JsObject>,
762
+ key: &str,
763
+ val: f64,
764
+ ) -> NeonResult<()> {
765
+ let v = cx.number(val);
766
+ obj.set(cx, key, v)?;
767
+ Ok(())
768
+ }
769
+
770
+ fn set_bool<'a>(
771
+ cx: &mut TaskContext<'a>,
772
+ obj: &Handle<'a, JsObject>,
773
+ key: &str,
774
+ val: bool,
775
+ ) -> NeonResult<()> {
776
+ let v = cx.boolean(val);
777
+ obj.set(cx, key, v)?;
778
+ Ok(())
779
+ }
780
+
781
+ fn set_buf<'a>(
782
+ cx: &mut TaskContext<'a>,
783
+ obj: &Handle<'a, JsObject>,
784
+ key: &str,
785
+ val: &[u8],
786
+ ) -> NeonResult<()> {
787
+ let v = JsBuffer::from_slice(cx, val)?;
788
+ obj.set(cx, key, v)?;
789
+ Ok(())
790
+ }
791
+
792
+ #[neon::main]
793
+ fn main(mut cx: ModuleContext) -> NeonResult<()> {
794
+ cx.export_function("connect", connect)?;
795
+ cx.export_function("openStream", open_stream)?;
796
+ cx.export_function("writeStream", write_stream)?;
797
+ cx.export_function("finStream", fin_stream)?;
798
+ cx.export_function("resetStream", reset_stream)?;
799
+ cx.export_function("stopSending", stop_sending)?;
800
+ cx.export_function("setPaused", set_paused)?;
801
+ cx.export_function("sendDatagram", send_datagram)?;
802
+ cx.export_function("maxDatagramSize", max_datagram_size)?;
803
+ cx.export_function("isReady", is_ready)?;
804
+ cx.export_function("isClosed", is_closed)?;
805
+ cx.export_function("closeSession", close_session)?;
806
+ cx.export_function("shutdown", shutdown)?;
807
+
808
+ // Server surface.
809
+ cx.export_function("serverListen", server_listen)?;
810
+ cx.export_function("serverOpenStream", server_open_stream)?;
811
+ cx.export_function("serverWrite", server_write)?;
812
+ cx.export_function("serverFin", server_fin)?;
813
+ cx.export_function("serverReset", server_reset)?;
814
+ cx.export_function("serverStopSending", server_stop_sending)?;
815
+ cx.export_function("serverSetPaused", server_set_paused)?;
816
+ cx.export_function("serverSendDatagram", server_send_datagram)?;
817
+ cx.export_function("serverMaxDatagramSize", server_max_datagram_size)?;
818
+ cx.export_function("serverCloseSession", server_close_session)?;
819
+ cx.export_function("serverShutdown", server_shutdown)?;
820
+ Ok(())
821
+ }