notes

1.1 KB

1. \* hl:http1 — module exports beside the class surface (NativeHttpServer,
2. NativeWebSocketServer, Response, WsClient in their own files). *\
4. \* Bind a plain HTTP/1.1 listener; answers the request event source. *\
5. listen(
6. Number port \\ the port to bind
7. ) {
8. return __native("http1.listen", port)
9. }
11. \* The full-featured constructor: interface, TLS pair, worker count. *\
12. create_server(
13. Number port \\ the port to bind
14. String host = '0.0.0.0' \\ the interface
15. String cert = null \\ PEM certificate path — with key, serve https
16. String key = null \\ PEM key path
17. Number threads = 4 \\ I/O worker threads
18. ) {
19. return __native("http1.create_server", port, host, cert, key, threads)
20. }
22. \* A cookie-grade random token: n lowercase hex characters read from the
23. KERNEL's CSPRNG, never a seeded PRNG — a session id is the only thing
24. between a stranger and someone else's session (hl:math's random() is a
25. clock-seeded xoshiro whose state a handful of outputs reveal). Lives here
26. because the session cookie is an HTTP artifact. *\
27. randomToken(
28. Number n \\ how many hex characters
29. ) {
30. return __native("http1.random_token", n)
31. }