notes

1.3 KB

1. // ONE SESSION — a browser's bag on the server. A CLASS, not a hybrid, on purpose:
2. // the language passes an instance by handle (through maps, lists, assignments and
3. // emit payloads; an ordinary call argument copies, hence `&` at the dispatch) and
4. // a face that logs a session in writes the session it was HANDED. On disk it is
5. // the JSON of these members, and a file comes back as `rec > new Session()`.
6. // THE APP'S OWN DATA GOES INTO `data`, a hybrid: `session.data.cart = …` rides along,
7. // and an entry nobody wrote reads null — as a hybrid does. An UNDECLARED member of
8. // an instance is not that: the language lets a write mint it on one instance and
9. // refuses the read on another (measured 2026-09-13: `session.signupEmail` read in an
10. // audience function on a session that never set it was an UndefinedProperty error).
11. String id = null
12. Number created = 0 // epoch ms
13. Number seen = 0 // epoch ms of the last request or frame that presented it
14. user = null // whoever logged this session in, or null
15. data = {} // the app's own fields, absent ones read null
16. // THE QUEUED EMITS THIS SESSION'S BROWSERS HAVE HAD HANDLED (COMPONENTS §10): the last
17. // `handledKept` of them, oldest first, each `{ q, ok, error }` — its stable id and the
18. // ack it got. A replay of one of these ids is answered from here and runs no face again.
19. handled = []