╭ web.zig ──────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ╰───────────────────────────────────────────────────────────────╯
🬐 🬠 🬞🬂🬏 🬟 🬑 🬟 🬑 ╭56782401..╮ 56782401.. see-em: 🬋🬋🬋 🬋🬋🬋 🬋 🬋 │files │ commits refs discuss issues new login 🬐 🬠 🬐 🬠 🬑 🬟 🬰 ╰──────────╯ (657) user
╭────╮ ╭ clone ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ╮ │http│ ssh │ │ ╰────╯ ╰ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ╯
.. embed/ event/ test/ ui/ command.zig diff3.zig event.zig find.zig fork.zig lib.zig main.zig main_wasm.zig markdown.zig patch.zig progress.zig push.zig search.zig search_commit.zig search_thread.zig serve.zig serve_common.zig serve_http.zig serve_ssh.zig serve_ssh_protocol.zig test.zig testnet.zig try.zig ui.zig ╭─────────────────────────────────╮ │web.zig │ ╰─────────────────────────────────╯
1 const std = @import("std"); 2 const xit = @import("xit"); 3 const rp = xit.repo; 4 const obj = xit.object; 5 const hash = xit.hash; 6 const evt = @import("./event.zig"); 7 const serve_common = @import("./serve_common.zig"); 8 const ui = @import("./ui.zig"); 9 const fork = @import("./fork.zig"); 10 const pch = @import("./patch.zig"); 11 const xitui = xit.xitui; 12 const wgt = xitui.widget; 13 const Focus = xitui.focus.Focus; 14 const Grid = xitui.grid.Grid; 15 16 const cookie_name = "haxy_session"; 17 // the session cookie a login or a claimed auto-login sets; both must scope 18 // it the same way. 19 const session_cookie_fmt = cookie_name ++ "={s}; Path=/; HttpOnly; SameSite=Strict"; 20 const form_flash_cookie = "haxy_form_flash"; 21 const local_flash_cookie = "haxy_local_flash"; 22 const local_required_title_prefix = "required_title:"; 23 const local_sync_failure_prefix = "sync:"; 24 25 const Embed = struct { 26 path: []const u8, 27 content_type: []const u8, 28 body: []const u8, 29 }; 30 31 const embeds = [_]Embed{ 32 .{ .path = "index.html", .content_type = "text/html; charset=utf-8", .body = @embedFile("embed/index.html") }, 33 .{ .path = "script.js", .content_type = "text/javascript; charset=utf-8", .body = @embedFile("embed/script.js") }, 34 .{ .path = "term.ttf", .content_type = "font/ttf", .body = @embedFile("embed/term.ttf") }, 35 .{ .path = "haxy.wasm", .content_type = "application/wasm", .body = @embedFile("haxy.wasm") }, 36 }; 37 38 // what a web request is served from: the multi-user server (admin repo + 39 // login sessions) or a single local repo. 40 pub const Host = union(evt.HostKind) { 41 local: ui.RepoSource, 42 server: struct { 43 admin_repo_path: []const u8, 44 users_dir: []const u8, 45 session_store: SessionStore, 46 git_http_port: ?u16, 47 git_ssh_port: ?u16, 48 git_ssh_prefix: []const u8, 49 }, 50 51 // where this host's event writes go 52 pub fn event(self: Host) evt.Host { 53 return switch (self) { 54 .local => .local, 55 .server => |server| .{ .server = .{ .users_dir = server.users_dir } }, 56 }; 57 } 58 }; 59 60 // an on-disk repo resolved from a request url. server paths are owned. 61 const RequestRepoSource = struct { 62 source: ui.RepoSource, 63 owned_path: ?[]const u8 = null, 64 65 fn deinit(self: RequestRepoSource, allocator: std.mem.Allocator) void { 66 if (self.owned_path) |path| allocator.free(path); 67 } 68 }; 69 70 // the "owner:name" identity a repo url base names, or null for any other base 71 fn repoBaseIdentity(repo_base: []const u8) ?[]const u8 { 72 if (repo_base.len < 2 or repo_base[0] != '/') return null; 73 const identity = repo_base[1..]; 74 if (std.mem.indexOfScalar(u8, identity, ':') == null or std.mem.indexOfAny(u8, identity, "/+") != null) return null; 75 return identity; 76 } 77 78 // the route a url names under this host's url scheme 79 fn routeFromUrl(host: Host, path: []const u8) ?ui.RoutablePage { 80 return switch (host) { 81 .server => ui.RoutablePage.fromUrl(path), 82 .local => ui.RoutablePage.fromUrlLocal(path), 83 }; 84 } 85 86 fn requestRepoSource(io: std.Io, allocator: std.mem.Allocator, host: Host, repo_base: []const u8) !?RequestRepoSource { 87 return switch (host) { 88 .server => |server| blk: { 89 const identity = repoBaseIdentity(repo_base) orelse break :blk null; 90 const path = switch (try serve_common.resolveRepoPath(io, allocator, server.users_dir, server.admin_repo_path, identity)) { 91 .ok => |value| value, 92 .invalid, .not_found => break :blk null, 93 }; 94 break :blk .{ 95 .source = .{ .path = path, .repo_kind = .xit }, 96 .owned_path = path, 97 }; 98 }, 99 .local => |source| if (repo_base.len == 0) .{ .source = source } else null, 100 }; 101 } 102 103 pub fn handleConnection( 104 io: std.Io, 105 allocator: std.mem.Allocator, 106 stream: std.Io.net.Stream, 107 host: Host, 108 err: *std.Io.Writer, 109 ) !void { 110 var send_buffer: [4096]u8 = @splat(0); 111 var recv_buffer: [4096]u8 = @splat(0); 112 var conn_br = stream.reader(io, &recv_buffer); 113 var conn_bw = stream.writer(io, &send_buffer); 114 var http_server = std.http.Server.init(&conn_br.interface, &conn_bw.interface); 115 116 // serve multiple requests on a single connection so HTTP/1.1 keep-alive 117 // works — important for browser-native form POST: after the 303 the 118 // browser issues GET / on the same socket, and forcibly closing here 119 // would race the follow-up request into a "site can't be reached". 120 while (http_server.reader.state == .ready) { 121 var request = http_server.receiveHead() catch |receive_err| switch (receive_err) { 122 error.HttpConnectionClosing => break, 123 error.ReadFailed => break, 124 else => |e| return e, 125 }; 126 127 handleRequest(io, &request, allocator, host) catch |request_err| { 128 serve_common.logError(io, err, "web ui request failed: {s}\n", .{@errorName(request_err)}); 129 // best-effort 500. if handleRequest already started writing a 130 // response before throwing, this respond may fail too, but at 131 // that point the connection is unrecoverable anyway. 132 request.respond(@errorName(request_err), .{ 133 .status = .internal_server_error, 134 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 135 }) catch {}; 136 }; 137 } 138 } 139 140 fn handleRequest( 141 io: std.Io, 142 request: *std.http.Server.Request, 143 allocator: std.mem.Allocator, 144 host: Host, 145 ) !void { 146 const method = request.head.method; 147 const owned_target = if (method == .POST) try allocator.dupe(u8, request.head.target) else null; 148 defer if (owned_target) |target| allocator.free(target); 149 const uri = try std.Uri.parseAfterScheme("", owned_target orelse request.head.target); 150 const path = uri.path.percent_encoded; 151 152 // POST routes can be scoped by any page, so they can redirect using 153 // the base of the URL. this allows logging in to keep you on the page 154 // you were on. local mode has no accounts, so only the repo routes. 155 if (method == .POST) { 156 switch (host) { 157 .server => |server| { 158 // "repo/new" and "user/new" come before "new", which would claim them 159 const PostRoute = enum { login, logout, @"repo/new", @"user/new", user, settings, grant, revoke, promote, demote, new, edit, remove, open, close, resolve, publish, merge, squash, attach, undo, clear }; 160 inline for (@typeInfo(PostRoute).@"enum".field_names) |name| { 161 const suffix = "/" ++ name; 162 if (std.mem.endsWith(u8, path, suffix)) { 163 const base = path[0 .. path.len - suffix.len]; 164 return switch (@field(PostRoute, name)) { 165 .login => handleLogin(io, request, allocator, base, server.admin_repo_path, server.session_store), 166 .logout => handleLogout(request, base, server.session_store), 167 .@"repo/new" => handleRepoNew(io, request, allocator, path, server.admin_repo_path, server.users_dir, server.session_store), 168 .@"user/new" => handleUserNew(io, request, allocator, path, server.admin_repo_path, server.users_dir, server.session_store), 169 .user => handleUserSettings(io, request, allocator, path, server.admin_repo_path, server.users_dir, server.session_store), 170 .settings => handleRepoSettings(io, request, allocator, path, host), 171 .grant => handleRoles(io, request, allocator, base, host, .grant), 172 .revoke => handleRoles(io, request, allocator, base, host, .revoke), 173 .promote => handleRoles(io, request, allocator, base, host, .promote), 174 .demote => handleRoles(io, request, allocator, base, host, .demote), 175 .new => handleNew(io, request, allocator, base, host), 176 .edit => handleEdit(io, request, allocator, base, host), 177 .remove => handleRemove(io, request, allocator, base, host), 178 .open => handleThreadStatus(io, request, allocator, base, host, true), 179 .close => handleThreadStatus(io, request, allocator, base, host, false), 180 .resolve => handleThreadResolve(io, request, allocator, base, host), 181 .publish => handlePatchPublish(io, request, allocator, base, host), 182 .merge => handlePatchMerge(io, request, allocator, base, host, .source), 183 .squash => handlePatchMerge(io, request, allocator, base, host, .squash), 184 .undo => handleUndo(io, request, allocator, base, host, .undo), 185 .clear => handleUndo(io, request, allocator, base, host, .clear), 186 .attach => handleAttach(io, request, allocator, base, host), 187 }; 188 } 189 } 190 }, 191 .local => |local| { 192 const PostRoute = enum { new, edit, remove, open, close, resolve, sync, attach, undo, clear }; 193 inline for (@typeInfo(PostRoute).@"enum".field_names) |name| { 194 const suffix = "/" ++ name; 195 if (std.mem.endsWith(u8, path, suffix)) { 196 const base = path[0 .. path.len - suffix.len]; 197 return switch (@field(PostRoute, name)) { 198 .new => handleNew(io, request, allocator, base, host), 199 .edit => handleEdit(io, request, allocator, base, host), 200 .remove => handleRemove(io, request, allocator, base, host), 201 .open => handleThreadStatus(io, request, allocator, base, host, true), 202 .close => handleThreadStatus(io, request, allocator, base, host, false), 203 .resolve => handleThreadResolve(io, request, allocator, base, host), 204 .sync => handleSync(io, request, allocator, base, local), 205 .undo => handleUndo(io, request, allocator, base, host, .undo), 206 .clear => handleUndo(io, request, allocator, base, host, .clear), 207 .attach => handleAttach(io, request, allocator, base, host), 208 }; 209 } 210 } 211 }, 212 } 213 } 214 215 const get_or_head = method == .GET or method == .HEAD; 216 if (!get_or_head) { 217 try request.respond("method not allowed", .{ 218 .status = .method_not_allowed, 219 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 220 }); 221 return; 222 } 223 224 if (std.mem.eql(u8, path, "/favicon.ico")) { 225 try request.respond("", .{ 226 .status = .no_content, 227 .extra_headers = &.{.{ .name = "content-type", .value = "image/x-icon" }}, 228 }); 229 return; 230 } 231 232 // an attachment serves raw bytes rather than a page, so it is matched 233 // before the routable pages 234 if (attachmentRequest(path)) |attachment| return serveAttachment(io, request, allocator, attachment, host); 235 236 // embeds are matched before the pages so an embed's name never reads as a user 237 if (findEmbed(path)) |embed| { 238 // the embeds change with every build, so the browser must revalidate 239 // rather than heuristically cache them across server restarts 240 try request.respond(embed.body, .{ 241 .extra_headers = &.{ 242 .{ .name = "content-type", .value = embed.content_type }, 243 .{ .name = "cache-control", .value = "no-cache" }, 244 }, 245 }); 246 return; 247 } 248 { 249 // a path that's neither a page nor an embed gets the not-found page 250 const current_page = routeFromUrl(host, path) orelse .not_found; 251 // resolve the haxy_session cookie's token to a user_id via the 252 // store. user_id_buf lives on the stack for the rest of handleRequest, 253 // which is plenty for renderIndexHtml to consume. local mode has no 254 // accounts, so it is always logged out. 255 var user_id_buf: [evt.event_id_size]u8 = undefined; 256 var user_id: ?[]const u8 = null; 257 // the session token that named the user, so a stale one can be revoked 258 var token_buf: [SessionStore.token_hex_len]u8 = undefined; 259 var session_token: ?[]const u8 = null; 260 var form_arena = std.heap.ArenaAllocator.init(allocator); 261 defer form_arena.deinit(); 262 var form_feedback: ?ui.Session.FormFeedback = null; 263 var form_cookie_seen = false; 264 var local_flash_seen = false; 265 var sync_failure: ?[]const u8 = null; 266 var sync_failure_allocated: ?[]u8 = null; 267 defer if (sync_failure_allocated) |value| allocator.free(value); 268 // backs the cookie a claimed auto-login sets 269 var cookie_buf: [256]u8 = undefined; 270 var session_cookie: ?[]const u8 = null; 271 switch (host) { 272 .server => |server| { 273 user_id = blk: { 274 const token = getCookieValue(request, cookie_name) orelse break :blk null; 275 if (!server.session_store.lookup(token, &user_id_buf)) break :blk null; 276 session_token = token; 277 break :blk user_id_buf[0..evt.event_id_size]; 278 }; 279 // whoever seeded the store may have left a session to claim 280 if (user_id == null) { 281 if (server.session_store.autoLogin(&token_buf) and server.session_store.lookup(&token_buf, &user_id_buf)) { 282 session_cookie = try std.fmt.bufPrint(&cookie_buf, session_cookie_fmt, .{token_buf}); 283 session_token = &token_buf; 284 user_id = user_id_buf[0..evt.event_id_size]; 285 } 286 } 287 if (getCookieValue(request, form_flash_cookie)) |token| { 288 form_cookie_seen = true; 289 form_feedback = server.session_store.takeFlash(form_arena.allocator(), token); 290 } 291 }, 292 .local => { 293 if (getCookieValue(request, local_flash_cookie)) |raw| { 294 local_flash_seen = true; 295 if (std.mem.startsWith(u8, raw, local_required_title_prefix)) { 296 const tag = std.meta.stringToEnum(std.meta.Tag(ui.Session.FormFeedback), raw[local_required_title_prefix.len..]); 297 form_feedback = if (tag) |feedback_tag| switch (feedback_tag) { 298 .issue => .{ .issue = .{ .failure = .required_title } }, 299 .patch => .{ .patch = .{ .failure = .required_title } }, 300 .discussion => .{ .discussion = .{ .failure = .required_title } }, 301 else => null, 302 } else null; 303 } else if (std.mem.startsWith(u8, raw, local_sync_failure_prefix)) { 304 const value = try allocator.dupe(u8, raw[local_sync_failure_prefix.len..]); 305 sync_failure_allocated = value; 306 sync_failure = std.Uri.percentDecodeInPlace(value); 307 } 308 } 309 }, 310 } 311 312 const git_http_port: ?u16, const git_ssh_port: ?u16, const git_ssh_prefix: []const u8 = switch (host) { 313 .server => |server| .{ server.git_http_port, server.git_ssh_port, server.git_ssh_prefix }, 314 .local => .{ null, null, "" }, 315 }; 316 var session_data: ui.Session.Data = .{ 317 .user_id = user_id, 318 .form_feedback = form_feedback, 319 .sync_failure = sync_failure, 320 .current_page = current_page, 321 .host_kind = std.meta.activeTag(host), 322 .git_http_port = git_http_port, 323 .git_ssh_port = git_ssh_port, 324 .git_ssh_prefix = git_ssh_prefix, 325 }; 326 // a page that can't be built shows the not-found page instead 327 const html = renderIndexHtml(io, allocator, host, session_token, session_data) catch |err| switch (err) { 328 error.NotFound => blk: { 329 session_data.current_page = .not_found; 330 break :blk try renderIndexHtml(io, allocator, host, session_token, session_data); 331 }, 332 else => |e| return e, 333 }; 334 defer allocator.free(html); 335 336 const expired_form_cookie = if (form_cookie_seen) 337 try allocator.print(form_flash_cookie ++ "=; Path={s}; Max-Age=0", .{path}) 338 else 339 null; 340 defer if (expired_form_cookie) |cookie| allocator.free(cookie); 341 var header_buf: [4]std.http.Header = undefined; 342 var headers: std.ArrayList(std.http.Header) = .initBuffer(&header_buf); 343 headers.appendAssumeCapacity(.{ .name = "content-type", .value = "text/html; charset=utf-8" }); 344 if (expired_form_cookie) |cookie| headers.appendAssumeCapacity(.{ .name = "set-cookie", .value = cookie }); 345 if (local_flash_seen) headers.appendAssumeCapacity(.{ .name = "set-cookie", .value = local_flash_cookie ++ "=; Path=/; Max-Age=0" }); 346 if (session_cookie) |cookie| headers.appendAssumeCapacity(.{ .name = "set-cookie", .value = cookie }); 347 try request.respond(html, .{ 348 .status = if (session_data.current_page == .not_found) .not_found else .ok, 349 .extra_headers = headers.items, 350 }); 351 } 352 } 353 354 fn handleLogin( 355 io: std.Io, 356 request: *std.http.Server.Request, 357 allocator: std.mem.Allocator, 358 base: []const u8, 359 admin_repo_path: []const u8, 360 session_store: SessionStore, 361 ) !void { 362 const body = try readFormBody(request, allocator); 363 defer allocator.free(body); 364 365 const username = (try parseFormField(allocator, body, "username")) orelse try allocator.dupe(u8, ""); 366 defer allocator.free(username); 367 const password = (try parseFormField(allocator, body, "password")) orelse try allocator.dupe(u8, ""); 368 defer allocator.free(password); 369 370 const Repo = rp.Repo(.xit, evt.admin_repo_opts); 371 var repo = try Repo.open(io, allocator, .{ .path = admin_repo_path }); 372 defer repo.deinit(io, allocator); 373 374 var arena = std.heap.ArenaAllocator.init(allocator); 375 defer arena.deinit(); 376 377 const haxy_moment = try evt.currentMoment(evt.admin_repo_opts, &repo); 378 const result = try evt.User.verifyCredentials(evt.AdminDB, evt.admin_repo_opts.hash, haxy_moment, &arena, username, password); 379 380 // on success, return to the page the login came from (base, or "/" at the 381 // root); on failure, stay on its user tab to surface the error. 382 const success_location: []const u8 = if (base.len == 0) "/" else base; 383 const failure_location = try arena.allocator().print("{s}/user", .{base}); 384 385 switch (result) { 386 .success => |user_id| { 387 const token = try session_store.create(&user_id); 388 var cookie_buf: [256]u8 = undefined; 389 const cookie = try std.fmt.bufPrint(&cookie_buf, session_cookie_fmt, .{token}); 390 try request.respond("", .{ 391 .status = .see_other, 392 .extra_headers = &.{ 393 .{ .name = "location", .value = success_location }, 394 .{ .name = "set-cookie", .value = cookie }, 395 }, 396 }); 397 }, 398 .unknown_user => try respondFormFailure(request, allocator, session_store, failure_location, .{ .login = .{ .failure = .unknown_user, .username = username } }), 399 .wrong_password => try respondFormFailure(request, allocator, session_store, failure_location, .{ .login = .{ .failure = .wrong_password, .username = username } }), 400 } 401 } 402 403 fn respondFormFailure(request: *std.http.Server.Request, allocator: std.mem.Allocator, session_store: SessionStore, location: []const u8, feedback: ui.Session.FormFeedback) !void { 404 const token = try session_store.createFlash(allocator, feedback); 405 const cookie = try allocator.print(form_flash_cookie ++ "={s}; Path={s}; HttpOnly; SameSite=Strict", .{ token, location }); 406 defer allocator.free(cookie); 407 try request.respond("", .{ 408 .status = .see_other, 409 .extra_headers = &.{ 410 .{ .name = "location", .value = location }, 411 .{ .name = "set-cookie", .value = cookie }, 412 }, 413 }); 414 } 415 416 fn respondThreadFormFailure(request: *std.http.Server.Request, allocator: std.mem.Allocator, host: Host, location: []const u8, feedback: ui.Session.FormFeedback) !void { 417 return switch (host) { 418 .server => |server| respondFormFailure(request, allocator, server.session_store, location, feedback), 419 .local => { 420 const tag = std.meta.activeTag(feedback); 421 const required_title = switch (feedback) { 422 .issue => |value| value.failure == .required_title, 423 .discussion => |value| value.failure == .required_title, 424 .patch => |value| value.failure == .required_title, 425 else => false, 426 }; 427 if (!required_title) return error.InvalidFormFeedback; 428 const cookie = try allocator.print(local_flash_cookie ++ "=" ++ local_required_title_prefix ++ "{s}; Path=/; HttpOnly; SameSite=Strict", .{@tagName(tag)}); 429 defer allocator.free(cookie); 430 try request.respond("", .{ 431 .status = .see_other, 432 .extra_headers = &.{ 433 .{ .name = "location", .value = location }, 434 .{ .name = "set-cookie", .value = cookie }, 435 }, 436 }); 437 }, 438 }; 439 } 440 441 fn requiredTitleFeedback(kind: evt.EventKind, title: []const u8, labels: []const u8, description: []const u8, target_branch: []const u8, source_branch: ?[]const u8) ui.Session.FormFeedback { 442 return switch (kind) { 443 .issue => .{ .issue = .{ .failure = .required_title, .fields = .{ 444 .title = title, 445 .labels = labels, 446 .description = description, 447 } } }, 448 .patch => patchFeedback(.required_title, title, labels, description, target_branch, source_branch), 449 .discuss => .{ .discussion = .{ .failure = .required_title, .fields = .{ 450 .title = title, 451 .labels = labels, 452 .description = description, 453 } } }, 454 else => unreachable, 455 }; 456 } 457 458 fn patchFeedback(failure: ui.Session.FormFeedback.PatchFailure, title: []const u8, labels: []const u8, description: []const u8, target_branch: []const u8, source_branch: ?[]const u8) ui.Session.FormFeedback { 459 return .{ .patch = .{ .failure = failure, .fields = .{ 460 .title = title, 461 .labels = labels, 462 .description = description, 463 .target_branch = target_branch, 464 .source_branch = source_branch orelse "", 465 .source_kind = if (source_branch != null) .branch else .fork, 466 } } }; 467 } 468 469 fn handleLogout(request: *std.http.Server.Request, base: []const u8, session_store: SessionStore) !void { 470 // revoke the session server-side so the cookie is dead for anyone holding 471 // a copy, not just this browser. 472 if (getCookieValue(request, cookie_name)) |token| session_store.remove(token); 473 // return to the page the logout came from (base, or "/" at the root). 474 const location: []const u8 = if (base.len == 0) "/" else base; 475 // close the connection instead of keeping it alive: we don't read the 476 // request body, and respond()'s keep-alive path would otherwise try to 477 // discard it — which asserts on a bodyless POST that carries no 478 // content-length, and would block on one with no framing at all. a logout 479 // is just a redirect, so the browser reconnects for the follow-up GET. 480 try request.respond("", .{ 481 .status = .see_other, 482 .keep_alive = false, 483 .extra_headers = &.{ 484 .{ .name = "location", .value = location }, 485 .{ .name = "set-cookie", .value = cookie_name ++ "=; Path=/; HttpOnly; SameSite=Strict; Max-Age=0" }, 486 }, 487 }); 488 } 489 490 // the actor for a write to the repo `repo_base` names with at least `min_role` 491 // and in the `thread_kind` tab when there is one, or null once the refusal has 492 // been sent. local mode always writes. 493 fn authorizeWrite( 494 io: std.Io, 495 allocator: std.mem.Allocator, 496 arena: *std.heap.ArenaAllocator, 497 request: *std.http.Server.Request, 498 host: Host, 499 repo_base: []const u8, 500 min_role: evt.Repo.Role, 501 thread_kind: ?evt.EventKind, 502 ) !?ui.Actor { 503 const server = switch (host) { 504 .server => |server| server, 505 .local => |src| return .{ .author = try ui.localAuthor(src, io, allocator, arena), .role = .owner }, 506 }; 507 const authorization: ui.Authorization = blk: { 508 const user_id = requestUserId(request, server.session_store) orelse break :blk .login_required; 509 510 const identity = repoBaseIdentity(repo_base) orelse break :blk .repo_not_found; 511 512 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 513 defer admin_repo.deinit(io, allocator); 514 const moment = try evt.currentMoment(evt.admin_repo_opts, &admin_repo); 515 break :blk try ui.authorizeUser(io, moment, arena, server.users_dir, user_id, identity, min_role, thread_kind); 516 }; 517 switch (authorization) { 518 .actor => |actor| return actor, 519 .login_required => try respondLoginRequired(request), 520 .repo_not_found => try respondRepoNotFound(request), 521 .forbidden => try respondForbidden(request), 522 } 523 return null; 524 } 525 526 // whether the request may read the repo `repo_base` names. local mode always 527 // may. 528 fn mayRead( 529 io: std.Io, 530 allocator: std.mem.Allocator, 531 request: *std.http.Server.Request, 532 host: Host, 533 repo_base: []const u8, 534 ) !bool { 535 const server = switch (host) { 536 .server => |server| server, 537 .local => return true, 538 }; 539 const identity = repoBaseIdentity(repo_base) orelse return false; 540 541 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 542 defer admin_repo.deinit(io, allocator); 543 var arena = std.heap.ArenaAllocator.init(allocator); 544 defer arena.deinit(); 545 const moment = try evt.currentMoment(evt.admin_repo_opts, &admin_repo); 546 const user_id = blk: { 547 const id = requestUserId(request, server.session_store) orelse break :blk null; 548 break :blk if (try ui.activeUser(moment, &arena, id) != null) id else null; 549 }; 550 const owner_repo = evt.parseOwnerRepoPath(identity) orelse return false; 551 const repo = (try evt.readRepoByOwnerAndName(io, allocator, &arena, moment, server.users_dir, owner_repo.owner, owner_repo.name, user_id)) orelse return false; 552 return repo.role != null; 553 } 554 555 // the logged-in user the request's session cookie names 556 fn requestUserId(request: *std.http.Server.Request, session_store: SessionStore) ?[evt.event_id_size]u8 { 557 const token = getCookieValue(request, cookie_name) orelse return null; 558 var user_id: [evt.event_id_size]u8 = undefined; 559 return if (session_store.lookup(token, &user_id)) user_id else null; 560 } 561 562 // refuse a write from a request with no logged-in user. the body goes unread, 563 // so the connection closes. 564 fn respondLoginRequired(request: *std.http.Server.Request) !void { 565 try request.respond("log in to make changes", .{ 566 .status = .forbidden, 567 .keep_alive = false, 568 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 569 }); 570 } 571 572 // refuse a write the user's role in the repo doesn't allow 573 fn respondForbidden(request: *std.http.Server.Request) !void { 574 try request.respond("you don't have permission to do that", .{ 575 .status = .forbidden, 576 .keep_alive = false, 577 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 578 }); 579 } 580 581 fn respondRepoNotFound(request: *std.http.Server.Request) !void { 582 try request.respond("repo not found", .{ 583 .status = .not_found, 584 .keep_alive = false, 585 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 586 }); 587 } 588 589 // new actions share a suffix; the base identifies whether the form creates a 590 // thread or comment. 591 fn handleNew( 592 io: std.Io, 593 request: *std.http.Server.Request, 594 allocator: std.mem.Allocator, 595 base: []const u8, 596 host: Host, 597 ) !void { 598 if (commentBaseParts(host, base) != null) return handleCommentNew(io, request, allocator, base, host); 599 600 const issues_suffix = "/issues"; 601 if (std.mem.endsWith(u8, base, issues_suffix)) 602 return handleThreadNew(io, request, allocator, base[0 .. base.len - issues_suffix.len], host, .issue); 603 const discussions_suffix = "/discussions"; 604 if (std.mem.endsWith(u8, base, discussions_suffix)) 605 return handleThreadNew(io, request, allocator, base[0 .. base.len - discussions_suffix.len], host, .discuss); 606 const patches_suffix = "/patches"; 607 if (std.mem.endsWith(u8, base, patches_suffix)) 608 return handleThreadNew(io, request, allocator, base[0 .. base.len - patches_suffix.len], host, .patch); 609 610 try request.respond("new event target not found", .{ 611 .status = .not_found, 612 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 613 }); 614 } 615 616 // create a repo for the logged-in user and redirect to it. a failure goes 617 // back to the new-repo page that posted the form. 618 fn handleRepoNew( 619 io: std.Io, 620 request: *std.http.Server.Request, 621 allocator: std.mem.Allocator, 622 form_location: []const u8, 623 admin_repo_path: []const u8, 624 users_dir: []const u8, 625 session_store: SessionStore, 626 ) !void { 627 const user_id = requestUserId(request, session_store) orelse return respondLoginRequired(request); 628 var arena = std.heap.ArenaAllocator.init(allocator); 629 defer arena.deinit(); 630 const user = blk: { 631 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = admin_repo_path }); 632 defer admin_repo.deinit(io, allocator); 633 const moment = try evt.currentMoment(evt.admin_repo_opts, &admin_repo); 634 break :blk (try ui.activeUser(moment, &arena, user_id)) orelse return respondLoginRequired(request); 635 }; 636 637 const body = try readFormBody(request, allocator); 638 defer allocator.free(body); 639 const name = (try parseFormField(allocator, body, "name")) orelse try allocator.dupe(u8, ""); 640 defer allocator.free(name); 641 const description = (try parseFormField(allocator, body, "description")) orelse try allocator.dupe(u8, ""); 642 defer allocator.free(description); 643 const hash_value = (try parseFormField(allocator, body, "hash")) orelse try allocator.dupe(u8, ""); 644 defer allocator.free(hash_value); 645 const access_value = (try parseFormField(allocator, body, "access")) orelse try allocator.dupe(u8, ""); 646 defer allocator.free(access_value); 647 const bad_request: std.http.Server.Request.RespondOptions = .{ .status = .bad_request, .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }} }; 648 const hash_kind = std.meta.stringToEnum(hash.HashKind, hash_value) orelse return request.respond("invalid hash", bad_request); 649 const access = std.meta.stringToEnum(evt.Repo.Access, access_value) orelse return request.respond("invalid access", bad_request); 650 651 _ = evt.createRepo(io, allocator, users_dir, &user_id, .{ .name = user.event.name, .email = user.event.email }, name, description, access, hash_kind) catch |err| { 652 const failure = ui.Session.FormFeedback.RepoFailure.fromError(err) orelse return err; 653 return respondFormFailure(request, allocator, session_store, form_location, .{ .repo = .{ .failure = failure, .fields = .{ 654 .name = name, 655 .description = description, 656 .hash = hash_kind, 657 .access = access, 658 } } }); 659 }; 660 661 const location = try allocator.print("/{s}:{s}", .{ user.event.name, name }); 662 defer allocator.free(location); 663 try request.respond("", .{ 664 .status = .see_other, 665 .extra_headers = &.{.{ .name = "location", .value = location }}, 666 }); 667 } 668 669 // change the repo the settings url `form_location` names as its owner, then 670 // redirect to its settings under its new name. a failure goes back to the 671 // settings page. 672 fn handleRepoSettings( 673 io: std.Io, 674 request: *std.http.Server.Request, 675 allocator: std.mem.Allocator, 676 form_location: []const u8, 677 host: Host, 678 ) !void { 679 const server = switch (host) { 680 .server => |server| server, 681 .local => return respondRepoNotFound(request), 682 }; 683 const route = routeFromUrl(host, form_location) orelse return respondRepoNotFound(request); 684 if (route != .repo_settings) return respondRepoNotFound(request); 685 var arena = std.heap.ArenaAllocator.init(allocator); 686 defer arena.deinit(); 687 const repo_base = try arena.allocator().print("/{s}", .{route.repo_settings.slice()}); 688 const actor = (try authorizeWrite(io, allocator, &arena, request, host, repo_base, .owner, null)) orelse return; 689 690 const body = try readFormBody(request, allocator); 691 defer allocator.free(body); 692 const name = (try parseFormField(allocator, body, "name")) orelse try allocator.dupe(u8, ""); 693 defer allocator.free(name); 694 const description = (try parseFormField(allocator, body, "description")) orelse try allocator.dupe(u8, ""); 695 defer allocator.free(description); 696 const access_value = (try parseFormField(allocator, body, "access")) orelse try allocator.dupe(u8, ""); 697 defer allocator.free(access_value); 698 const access = std.meta.stringToEnum(evt.Repo.Access, access_value) orelse return request.respond("invalid access", .{ .status = .bad_request, .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }} }); 699 var roles: [3]?evt.Repo.Role = undefined; 700 for (&roles, [_][]const u8{ "discuss_role", "issue_role", "patch_role" }) |*role, field| { 701 const role_value = (try parseFormField(allocator, body, field)) orelse try allocator.dupe(u8, ""); 702 defer allocator.free(role_value); 703 role.* = ui.Repo.Settings.labelRole(role_value) catch return request.respond("invalid role", .{ .status = .bad_request, .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }} }); 704 } 705 const discuss_role, const issue_role, const patch_role = roles; 706 707 const updated = ui.Repo.Settings.update(io, allocator, server.users_dir, actor, route.repo_settings.slice(), name, description, access, discuss_role, issue_role, patch_role) catch |err| switch (err) { 708 error.NotFound => return respondRepoNotFound(request), 709 else => { 710 const failure = ui.Session.FormFeedback.RepoFailure.fromError(err) orelse return err; 711 return respondFormFailure(request, allocator, server.session_store, form_location, .{ .repo_settings = .{ .failure = failure, .fields = .{ 712 .name = name, 713 .description = description, 714 .access = access, 715 .discuss_role = discuss_role, 716 .issue_role = issue_role, 717 .patch_role = patch_role, 718 } } }); 719 }, 720 }; 721 722 try request.respond("", .{ 723 .status = .see_other, 724 .extra_headers = &.{.{ .name = "location", .value = try updated.toUrl(&arena) }}, 725 }); 726 } 727 728 // act on a user's role in the repo the roles url `base` names, as one of its 729 // owners, then redirect back to the list. the add form names the user in its 730 // body and the row forms in the url. 731 fn handleRoles(io: std.Io, request: *std.http.Server.Request, allocator: std.mem.Allocator, base: []const u8, host: Host, action: ui.Repo.Roles.Action) !void { 732 const server = switch (host) { 733 .server => |server| server, 734 .local => return respondRepoNotFound(request), 735 }; 736 const route = routeFromUrl(host, base) orelse return respondRepoNotFound(request); 737 if (route != .repo_roles) return respondRepoNotFound(request); 738 const target = route.repo_roles; 739 var arena = std.heap.ArenaAllocator.init(allocator); 740 defer arena.deinit(); 741 const identity = target.name.slice(); 742 const actor = (try authorizeWrite(io, allocator, &arena, request, host, try arena.allocator().print("/{s}", .{identity}), .owner, null)) orelse return; 743 744 const name = switch (action) { 745 .grant => blk: { 746 const body = try readFormBody(request, allocator); 747 defer allocator.free(body); 748 break :blk (try parseFormField(arena.allocator(), body, "name")) orelse ""; 749 }, 750 .revoke, .promote, .demote => if (target.user.len != 0) target.user.slice() else return respondRepoNotFound(request), 751 }; 752 753 const failure = blk: { 754 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 755 defer admin_repo.deinit(io, allocator); 756 const moment = try evt.currentMoment(evt.admin_repo_opts, &admin_repo); 757 break :blk ui.Repo.Roles.perform(io, allocator, moment, server.users_dir, actor, identity, action, name) catch |err| switch (err) { 758 error.NotFound, error.EventNotFound => return respondRepoNotFound(request), 759 else => return err, 760 }; 761 }; 762 if (failure) |value| { 763 const location = try (ui.RoutablePage.repoRolesRoute(identity, target.start) orelse return error.RouteTooLong).toUrl(&arena); 764 return respondFormFailure(request, allocator, server.session_store, location, .{ .repo_roles = .{ .failure = value, .name = name } }); 765 } 766 const location = try (ui.Repo.Roles.landingRoute(identity, target.start, actor, action, name) orelse return error.RouteTooLong).toUrl(&arena); 767 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = location }} }); 768 } 769 770 // create a user, log them in, and redirect to their page. a failure goes 771 // back to the new-user page that posted the form. 772 fn handleUserNew( 773 io: std.Io, 774 request: *std.http.Server.Request, 775 allocator: std.mem.Allocator, 776 form_location: []const u8, 777 admin_repo_path: []const u8, 778 users_dir: []const u8, 779 session_store: SessionStore, 780 ) !void { 781 if (requestUserId(request, session_store) != null) { 782 return request.respond("log out to create a user", .{ 783 .status = .forbidden, 784 .keep_alive = false, 785 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 786 }); 787 } 788 789 const body = try readFormBody(request, allocator); 790 defer allocator.free(body); 791 const name = (try parseFormField(allocator, body, "name")) orelse try allocator.dupe(u8, ""); 792 defer allocator.free(name); 793 const email = (try parseFormField(allocator, body, "email")) orelse try allocator.dupe(u8, ""); 794 defer allocator.free(email); 795 const password = (try parseFormField(allocator, body, "password")) orelse try allocator.dupe(u8, ""); 796 defer allocator.free(password); 797 const password_again = (try parseFormField(allocator, body, "password_again")) orelse try allocator.dupe(u8, ""); 798 defer allocator.free(password_again); 799 800 const user_id = blk: { 801 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = admin_repo_path }); 802 defer admin_repo.deinit(io, allocator); 803 break :blk evt.createUser(io, allocator, users_dir, &admin_repo, name, email, password, password_again) catch |err| { 804 const failure = ui.Session.FormFeedback.UserFailure.fromError(err) orelse return err; 805 return respondFormFailure(request, allocator, session_store, form_location, .{ .user = .{ .failure = failure, .fields = .{ .name = name, .email = email } } }); 806 }; 807 }; 808 809 const token = try session_store.create(&user_id); 810 var cookie_buf: [256]u8 = undefined; 811 const cookie = try std.fmt.bufPrint(&cookie_buf, session_cookie_fmt, .{token}); 812 const location = try allocator.print("/{s}", .{name}); 813 defer allocator.free(location); 814 try request.respond("", .{ 815 .status = .see_other, 816 .extra_headers = &.{ 817 .{ .name = "location", .value = location }, 818 .{ .name = "set-cookie", .value = cookie }, 819 }, 820 }); 821 } 822 823 // change the logged-in user's settings, then return to the page that posted 824 // the form, which a failure also goes back to. 825 fn handleUserSettings( 826 io: std.Io, 827 request: *std.http.Server.Request, 828 allocator: std.mem.Allocator, 829 form_location: []const u8, 830 admin_repo_path: []const u8, 831 users_dir: []const u8, 832 session_store: SessionStore, 833 ) !void { 834 const user_id = requestUserId(request, session_store) orelse return respondLoginRequired(request); 835 836 const body = try readFormBody(request, allocator); 837 defer allocator.free(body); 838 const email = (try parseFormField(allocator, body, "email")) orelse try allocator.dupe(u8, ""); 839 defer allocator.free(email); 840 const current_password = (try parseFormField(allocator, body, "current_password")) orelse try allocator.dupe(u8, ""); 841 defer allocator.free(current_password); 842 const new_password = (try parseFormField(allocator, body, "new_password")) orelse try allocator.dupe(u8, ""); 843 defer allocator.free(new_password); 844 const new_password_again = (try parseFormField(allocator, body, "new_password_again")) orelse try allocator.dupe(u8, ""); 845 defer allocator.free(new_password_again); 846 847 { 848 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = admin_repo_path }); 849 defer admin_repo.deinit(io, allocator); 850 evt.updateUser(io, allocator, users_dir, &admin_repo, &user_id, email, current_password, new_password, new_password_again) catch |err| switch (err) { 851 error.NotFound => return respondLoginRequired(request), 852 else => { 853 const failure = ui.Session.FormFeedback.UserFailure.fromError(err) orelse return err; 854 return respondFormFailure(request, allocator, session_store, form_location, .{ .user_settings = .{ .failure = failure, .fields = .{ .email = email } } }); 855 }, 856 }; 857 } 858 859 try request.respond("", .{ 860 .status = .see_other, 861 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 862 }); 863 } 864 865 // create a thread in the repo the form's page names and redirect to it. 866 fn handleThreadNew( 867 io: std.Io, 868 request: *std.http.Server.Request, 869 allocator: std.mem.Allocator, 870 base: []const u8, 871 host: Host, 872 kind: evt.EventKind, 873 ) !void { 874 var author_arena = std.heap.ArenaAllocator.init(allocator); 875 defer author_arena.deinit(); 876 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, base, .read, kind)) orelse return; 877 const author = actor.author; 878 const body = try readFormBody(request, allocator); 879 defer allocator.free(body); 880 881 const title = (try parseFormField(allocator, body, "title")) orelse try allocator.dupe(u8, ""); 882 defer allocator.free(title); 883 const labels = (try parseFormField(allocator, body, "labels")) orelse try allocator.dupe(u8, ""); 884 defer allocator.free(labels); 885 const description_crlf = (try parseFormField(allocator, body, "description")) orelse try allocator.dupe(u8, ""); 886 defer allocator.free(description_crlf); 887 // form submission normalizes textarea line breaks to CRLF; store plain 888 // newlines so the text renders the same on every host 889 const description = try std.mem.replaceOwned(u8, allocator, description_crlf, "\r\n", "\n"); 890 defer allocator.free(description); 891 const target_branch = (try parseFormField(allocator, body, "target_branch")) orelse try allocator.dupe(u8, ""); 892 defer allocator.free(target_branch); 893 894 const source_branch = if (kind == .patch) try parseFormField(allocator, body, "source_branch") else null; 895 defer if (source_branch) |branch| allocator.free(branch); 896 897 const valid = switch (kind) { 898 .issue => evt.Issue.fieldsValid(title, labels), 899 .patch => evt.Patch.fieldsValid(title, labels), 900 .discuss => evt.Discussion.fieldsValid(title, labels), 901 else => unreachable, 902 }; 903 if (!valid) { 904 const list_name: []const u8 = switch (kind) { 905 .issue => "issues", 906 .patch => "patches", 907 .discuss => "discussions", 908 else => unreachable, 909 }; 910 const form_location = try allocator.print("{s}/{s}/new", .{ base, list_name }); 911 defer allocator.free(form_location); 912 if (!evt.titleValid(title)) { 913 return respondThreadFormFailure(request, allocator, host, form_location, requiredTitleFeedback(kind, title, labels, description, target_branch, source_branch)); 914 } 915 try request.respond("", .{ 916 .status = .see_other, 917 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 918 }); 919 return; 920 } 921 922 var id_bytes: [evt.event_id_size]u8 = undefined; 923 io.random(&id_bytes); 924 const event_id_hex = std.fmt.bytesToHex(id_bytes, .lower); 925 926 const not_found = "repo not found"; 927 const request_repo = (try requestRepoSource(io, allocator, host, base)) orelse { 928 try request.respond(not_found, .{ 929 .status = .not_found, 930 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 931 }); 932 return; 933 }; 934 defer request_repo.deinit(allocator); 935 const source = request_repo.source; 936 if (kind == .patch and source_branch == null) { 937 const server = switch (host) { 938 .server => |server| server, 939 .local => return respondRemoveNotFound(request), 940 }; 941 const user_id = actor.user_id orelse return respondLoginRequired(request); 942 if (!evt.Patch.branchValid(target_branch) or !try request_repo.source.hasBranch(io, allocator, target_branch)) { 943 const form_location = try allocator.print("{s}/patches/new", .{base}); 944 defer allocator.free(form_location); 945 return respondThreadFormFailure(request, allocator, host, form_location, patchFeedback(.invalid_target_branch, title, labels, description, target_branch, null)); 946 } 947 const repo_id = evt.parseEventId(std.Io.Dir.path.basename(request_repo.source.path)) catch return respondRemoveNotFound(request); 948 const repo_user_id = actor.repo_user_id orelse unreachable; 949 const fork_path = try fork.create(.{}, io, allocator, server.users_dir, .{ 950 .id = event_id_hex, 951 .user_id = user_id, 952 .repo_id = repo_id, 953 .repo_user_id = repo_user_id, 954 .title = title, 955 .description = description, 956 .labels = labels, 957 .target_branch = target_branch, 958 .author = author, 959 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 960 }); 961 defer allocator.free(fork_path); 962 } else { 963 const event = evt.EventWithId{ 964 .id = event_id_hex, 965 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 966 .author = author, 967 .event = switch (kind) { 968 .issue => .{ .issue = .{ .title = title, .description = description, .labels = labels } }, 969 .patch => .{ .patch = .{ .title = title, .description = description, .labels = labels, .target_branch = target_branch, .source_branch = source_branch } }, 970 .discuss => .{ .discuss = .{ .title = title, .description = description, .labels = labels } }, 971 else => unreachable, 972 }, 973 }; 974 975 switch (source.repo_kind) { 976 inline else => |repo_kind| { 977 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 978 defer any_repo.deinit(io, allocator); 979 switch (any_repo) { 980 inline else => |*repo| { 981 const result = if (kind == .patch) 982 pch.writeBranchPatch(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, event_id_hex, event.event.patch orelse unreachable, null, author) 983 else 984 evt.consume(host.event(), .repo, repo_kind, repo.self_repo_opts, io, allocator, repo, evt.events_ref, &.{event}); 985 result catch |err| { 986 if (kind != .patch) return err; 987 const failure = ui.Session.FormFeedback.PatchFailure.fromError(err) orelse return err; 988 const form_location = try allocator.print("{s}/patches/new", .{base}); 989 defer allocator.free(form_location); 990 return respondThreadFormFailure(request, allocator, host, form_location, patchFeedback(failure, title, labels, description, target_branch, source_branch)); 991 }; 992 }, 993 } 994 }, 995 } 996 } 997 998 const location = try allocator.print("{s}/{s}:{s}", .{ base, @tagName(kind), &event_id_hex }); 999 defer allocator.free(location); 1000 try request.respond("", .{ 1001 .status = .see_other, 1002 .extra_headers = &.{.{ .name = "location", .value = location }}, 1003 }); 1004 } 1005 1006 const CommentBaseParts = struct { 1007 repo_base: []const u8, 1008 thread_kind: evt.EventKind, 1009 thread_id: [evt.event_id_size]u8, 1010 comment_id: ?[evt.event_id_size]u8, 1011 }; 1012 1013 fn commentBaseParts(host: Host, base: []const u8) ?CommentBaseParts { 1014 const route = routeFromUrl(host, base) orelse return null; 1015 const identity, const thread_kind, const thread_hex, const comment_hex = switch (route) { 1016 .repo_issues => |*issue| .{ issue.name.slice(), evt.EventKind.issue, issue.selected.slice(), issue.comment.slice() }, 1017 .repo_patches => |*patch| .{ patch.name.slice(), evt.EventKind.patch, patch.selected.slice(), patch.comment.slice() }, 1018 .repo_discussions => |*discussion| .{ discussion.name.slice(), evt.EventKind.discuss, discussion.selected.slice(), discussion.comment.slice() }, 1019 else => return null, 1020 }; 1021 const thread_id = evt.parseEventId(thread_hex) catch return null; 1022 const comment_id = if (comment_hex.len == 0) null else evt.parseEventId(comment_hex) catch return null; 1023 const repo_base_len = if (identity.len == 0) 0 else "/".len + identity.len; 1024 return .{ .repo_base = base[0..repo_base_len], .thread_kind = thread_kind, .thread_id = thread_id, .comment_id = comment_id }; 1025 } 1026 1027 fn handlePatchPublish( 1028 io: std.Io, 1029 request: *std.http.Server.Request, 1030 allocator: std.mem.Allocator, 1031 base: []const u8, 1032 host: Host, 1033 ) !void { 1034 const parts = commentBaseParts(host, base) orelse return respondRemoveNotFound(request); 1035 if (parts.thread_kind != .patch or parts.comment_id != null) return respondRemoveNotFound(request); 1036 const server = switch (host) { 1037 .server => |server| server, 1038 .local => return respondRemoveNotFound(request), 1039 }; 1040 var author_arena = std.heap.ArenaAllocator.init(allocator); 1041 defer author_arena.deinit(); 1042 // only the draft's author may publish it, which publish checks 1043 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, .patch)) orelse return; 1044 const user_id = actor.user_id orelse return respondLoginRequired(request); 1045 const author = actor.author; 1046 1047 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1048 defer request_repo.deinit(allocator); 1049 const repo_id = evt.parseEventId(std.Io.Dir.path.basename(request_repo.source.path)) catch return respondRemoveNotFound(request); 1050 var target_repo = try rp.AnyRepo(.xit, .{}).open(io, allocator, request_repo.source.localInitOpts()); 1051 defer target_repo.deinit(io, allocator); 1052 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 1053 defer admin_repo.deinit(io, allocator); 1054 const id = std.fmt.bytesToHex(parts.thread_id, .lower); 1055 switch (target_repo) { 1056 inline else => |*repo| try pch.publish(repo.self_repo_opts, io, allocator, server.users_dir, &admin_repo, repo, .{ 1057 .id = id, 1058 .user_id = user_id, 1059 .repo_id = repo_id, 1060 .author = author, 1061 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 1062 }), 1063 } 1064 try request.respond("", .{ 1065 .status = .see_other, 1066 .extra_headers = &.{.{ .name = "location", .value = base }}, 1067 }); 1068 } 1069 1070 fn handlePatchMerge( 1071 io: std.Io, 1072 request: *std.http.Server.Request, 1073 allocator: std.mem.Allocator, 1074 base: []const u8, 1075 host: Host, 1076 revision: evt.Patch.MergeRevision, 1077 ) !void { 1078 const parts = commentBaseParts(host, base) orelse return respondRemoveNotFound(request); 1079 if (parts.thread_kind != .patch or parts.comment_id != null) return respondRemoveNotFound(request); 1080 const server = switch (host) { 1081 .server => |server| server, 1082 .local => return respondRemoveNotFound(request), 1083 }; 1084 var author_arena = std.heap.ArenaAllocator.init(allocator); 1085 defer author_arena.deinit(); 1086 const author = ((try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .write, .patch)) orelse return).author; 1087 1088 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1089 defer request_repo.deinit(allocator); 1090 var target_repo = try rp.AnyRepo(.xit, .{}).open(io, allocator, request_repo.source.localInitOpts()); 1091 defer target_repo.deinit(io, allocator); 1092 1093 const id = std.fmt.bytesToHex(parts.thread_id, .lower); 1094 const merged = switch (target_repo) { 1095 inline else => |*repo| pch.mergeAndRemoveFork(repo.self_repo_opts, io, allocator, server.users_dir, repo, .{ 1096 .id = id, 1097 .revision = revision, 1098 .author = author, 1099 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 1100 }), 1101 }; 1102 merged catch |err| switch (err) { 1103 error.MergeConflict => return request.respond("merge conflict", .{ 1104 .status = .conflict, 1105 .keep_alive = false, 1106 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1107 }), 1108 error.MergeCheckUnavailable, error.PatchOutOfDate, error.PatchDataUnavailable => {}, 1109 else => return err, 1110 }; 1111 1112 const location = try allocator.print("{s}/patch:{s}", .{ parts.repo_base, &id }); 1113 defer allocator.free(location); 1114 try request.respond("", .{ 1115 .status = .see_other, 1116 .keep_alive = false, 1117 .extra_headers = &.{.{ .name = "location", .value = location }}, 1118 }); 1119 } 1120 1121 // create a reply and redirect to its permalink. 1122 fn handleCommentNew( 1123 io: std.Io, 1124 request: *std.http.Server.Request, 1125 allocator: std.mem.Allocator, 1126 base: []const u8, 1127 host: Host, 1128 ) !void { 1129 const not_found = "comment parent not found"; 1130 const parts = commentBaseParts(host, base) orelse { 1131 try request.respond(not_found, .{ 1132 .status = .not_found, 1133 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1134 }); 1135 return; 1136 }; 1137 1138 var author_arena = std.heap.ArenaAllocator.init(allocator); 1139 defer author_arena.deinit(); 1140 const author = ((try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return).author; 1141 1142 const form_body = try readFormBody(request, allocator); 1143 defer allocator.free(form_body); 1144 const body_crlf = (try parseFormField(allocator, form_body, "body")) orelse try allocator.dupe(u8, ""); 1145 defer allocator.free(body_crlf); 1146 const body = try std.mem.replaceOwned(u8, allocator, body_crlf, "\r\n", "\n"); 1147 defer allocator.free(body); 1148 1149 if (!evt.Comment.fieldsValid(body)) { 1150 const form_location = try allocator.print("{s}/new", .{base}); 1151 defer allocator.free(form_location); 1152 try request.respond("", .{ 1153 .status = .see_other, 1154 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 1155 }); 1156 return; 1157 } 1158 1159 const thread_id_hex = std.fmt.bytesToHex(parts.thread_id, .lower); 1160 const parent_id_hex = std.fmt.bytesToHex(parts.comment_id orelse parts.thread_id, .lower); 1161 1162 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse { 1163 try request.respond(not_found, .{ 1164 .status = .not_found, 1165 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1166 }); 1167 return; 1168 }; 1169 defer request_repo.deinit(allocator); 1170 const source = request_repo.source; 1171 var event_id_hex: [evt.event_id_size * 2]u8 = undefined; 1172 switch (source.repo_kind) { 1173 inline else => |repo_kind| { 1174 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1175 defer any_repo.deinit(io, allocator); 1176 switch (any_repo) { 1177 inline else => |*repo| event_id_hex = evt.Comment.create(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, parts.thread_kind, &thread_id_hex, &parent_id_hex, body, author) catch |err| switch (err) { 1178 // the url's thread or parent comment isn't what it claims 1179 error.NotFound => return request.respond(not_found, .{ 1180 .status = .not_found, 1181 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1182 }), 1183 else => |e| return e, 1184 }, 1185 } 1186 }, 1187 } 1188 1189 const location = try allocator.print("{s}/{s}:{s}/comment:{s}", .{ parts.repo_base, @tagName(parts.thread_kind), &thread_id_hex, &event_id_hex }); 1190 defer allocator.free(location); 1191 try request.respond("", .{ 1192 .status = .see_other, 1193 .extra_headers = &.{.{ .name = "location", .value = location }}, 1194 }); 1195 } 1196 1197 const AttachmentRequest = struct { 1198 repo_base: []const u8, 1199 id: [evt.event_id_size]u8, 1200 }; 1201 1202 // an attachment url is its repo's base and the attachment's event id 1203 fn attachmentRequest(path: []const u8) ?AttachmentRequest { 1204 const infix = "/attachment:"; 1205 const at = std.mem.lastIndexOf(u8, path, infix) orelse return null; 1206 const tail = path[at + infix.len ..]; 1207 const id = evt.parseEventId(tail) catch return null; 1208 return .{ .repo_base = path[0..at], .id = id }; 1209 } 1210 1211 // serve an attachment's bytes from the repo its url names 1212 fn serveAttachment( 1213 io: std.Io, 1214 request: *std.http.Server.Request, 1215 allocator: std.mem.Allocator, 1216 attachment: AttachmentRequest, 1217 host: Host, 1218 ) !void { 1219 if (!try mayRead(io, allocator, request, host, attachment.repo_base)) return respondAttachmentNotFound(request); 1220 const request_repo = (try requestRepoSource(io, allocator, host, attachment.repo_base)) orelse return respondAttachmentNotFound(request); 1221 defer request_repo.deinit(allocator); 1222 const source = request_repo.source; 1223 switch (source.repo_kind) { 1224 inline else => |repo_kind| { 1225 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1226 defer any_repo.deinit(io, allocator); 1227 switch (any_repo) { 1228 inline else => |*repo| try sendAttachment(repo_kind, repo.self_repo_opts, io, request, allocator, repo, &attachment.id), 1229 } 1230 }, 1231 } 1232 } 1233 1234 fn sendAttachment( 1235 comptime repo_kind: rp.RepoKind, 1236 comptime repo_opts: rp.RepoOpts(repo_kind), 1237 io: std.Io, 1238 request: *std.http.Server.Request, 1239 allocator: std.mem.Allocator, 1240 repo: *rp.Repo(repo_kind, repo_opts), 1241 id: *const [evt.event_id_size]u8, 1242 ) !void { 1243 var arena = std.heap.ArenaAllocator.init(allocator); 1244 defer arena.deinit(); 1245 1246 const DB = evt.EventDB(repo_opts.hash); 1247 var event_db_maybe: ?evt.LocalEventDB(repo_opts.hash) = if (repo_kind == .git) try evt.LocalEventDB(repo_opts.hash).openReadOnly(io, allocator, repo.core.repo_dir) else null; 1248 defer if (event_db_maybe) |*event_db| event_db.deinit(io, allocator); 1249 const haxy_moment = (if (event_db_maybe) |*event_db| 1250 evt.currentMomentFromDb(repo_opts.hash, event_db.db) 1251 else if (repo_kind == .git) 1252 return respondAttachmentNotFound(request) 1253 else 1254 evt.currentMoment(repo_opts, repo)) catch return respondAttachmentNotFound(request); 1255 1256 const record = (try evt.Attachment.readById(DB, repo_opts.hash, haxy_moment, &arena, id)) orelse return respondAttachmentNotFound(request); 1257 if (record.removed) return respondAttachmentNotFound(request); 1258 if (record.blob_oid.len != hash.hexLen(repo_opts.hash)) return respondAttachmentNotFound(request); 1259 const blob_oid: *const [hash.hexLen(repo_opts.hash)]u8 = @ptrCast(record.blob_oid.ptr); 1260 1261 var moment = repo.core.latestMoment() catch return respondAttachmentNotFound(request); 1262 const state = rp.Repo(repo_kind, repo_opts).State(.read_only){ .core = &repo.core, .extra = .{ .moment = &moment } }; 1263 var object_reader = obj.ObjectReader(repo_kind, repo_opts).init(state, io, allocator, blob_oid) catch return respondAttachmentNotFound(request); 1264 defer object_reader.deinit(); 1265 if (object_reader.header().kind != .blob) return respondAttachmentNotFound(request); 1266 1267 const content_type = attachmentContentType(record.name); 1268 const encoded_name = try ui.urlEncodeRef(allocator, record.name); 1269 defer allocator.free(encoded_name); 1270 const disposition = try allocator.print("{s}; filename*=UTF-8''{s}", .{ if (content_type == null) "attachment" else "inline", encoded_name }); 1271 defer allocator.free(disposition); 1272 1273 var send_buf: [8192]u8 = undefined; 1274 var body = try request.respondStreaming(&send_buf, .{ 1275 .content_length = object_reader.header().size, 1276 .respond_options = .{ 1277 .extra_headers = &.{ 1278 .{ .name = "content-type", .value = content_type orelse "application/octet-stream" }, 1279 .{ .name = "content-disposition", .value = disposition }, 1280 // uploaded bytes are never sniffed into a type that could run 1281 // as script on this origin 1282 .{ .name = "x-content-type-options", .value = "nosniff" }, 1283 }, 1284 }, 1285 }); 1286 _ = try object_reader.interface.streamRemaining(&body.writer); 1287 try body.end(); 1288 } 1289 1290 // the images a browser renders safely inline. anything else downloads as 1291 // opaque bytes, so an uploaded page can't run on this origin. 1292 fn attachmentContentType(name: []const u8) ?[]const u8 { 1293 const types = [_]struct { ext: []const u8, value: []const u8 }{ 1294 .{ .ext = ".png", .value = "image/png" }, 1295 .{ .ext = ".jpg", .value = "image/jpeg" }, 1296 .{ .ext = ".jpeg", .value = "image/jpeg" }, 1297 .{ .ext = ".gif", .value = "image/gif" }, 1298 .{ .ext = ".webp", .value = "image/webp" }, 1299 }; 1300 for (types) |entry| { 1301 if (name.len > entry.ext.len and std.ascii.eqlIgnoreCase(name[name.len - entry.ext.len ..], entry.ext)) return entry.value; 1302 } 1303 return null; 1304 } 1305 1306 fn respondAttachmentNotFound(request: *std.http.Server.Request) !void { 1307 try request.respond("attachment not found", .{ 1308 .status = .not_found, 1309 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1310 }); 1311 } 1312 1313 fn respondAttachmentParentNotFound(request: *std.http.Server.Request) !void { 1314 try request.respond("attachment parent not found", .{ 1315 .status = .not_found, 1316 .keep_alive = false, 1317 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1318 }); 1319 } 1320 1321 // the upload declares its file's name here, since the body is the file itself 1322 const attachment_name_header = "x-attachment-name"; 1323 1324 const AttachParentParts = struct { 1325 repo_base: []const u8, 1326 kind: evt.EventKind, 1327 id_bytes: [evt.event_id_size]u8, 1328 }; 1329 1330 // what an attachment hangs off: the `<kind>:<id>` segment the form's page ends 1331 // with, whatever kind that is 1332 fn attachParentParts(base: []const u8) ?AttachParentParts { 1333 const segment_at = std.mem.lastIndexOfScalar(u8, base, '/') orelse return null; 1334 const segment = base[segment_at + 1 ..]; 1335 const colon_at = std.mem.lastIndexOfScalar(u8, segment, ':') orelse return null; 1336 const kind = std.meta.stringToEnum(evt.EventKind, segment[0..colon_at]) orelse return null; 1337 const id_bytes = evt.parseEventId(segment[colon_at + 1 ..]) catch return null; 1338 return .{ .repo_base = base[0..segment_at], .kind = kind, .id_bytes = id_bytes }; 1339 } 1340 1341 // attach the uploaded file to the event the url names, then reload. the file is 1342 // the whole request body, so it streams from the socket into the object store 1343 // without being buffered. 1344 fn handleAttach( 1345 io: std.Io, 1346 request: *std.http.Server.Request, 1347 allocator: std.mem.Allocator, 1348 base: []const u8, 1349 host: Host, 1350 ) !void { 1351 const parts = attachParentParts(base) orelse return respondAttachmentParentNotFound(request); 1352 1353 var author_arena = std.heap.ArenaAllocator.init(allocator); 1354 defer author_arena.deinit(); 1355 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.kind)) orelse return; 1356 const author = actor.author; 1357 // an attachment changes the event it hangs off 1358 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondAttachmentParentNotFound(request); 1359 defer request_repo.deinit(allocator); 1360 const source = request_repo.source; 1361 if (!try source.canModify(io, allocator, actor, parts.kind, &parts.id_bytes)) return respondForbidden(request); 1362 1363 const name = (try attachmentName(allocator, request)) orelse return respondUploadError(request, .bad_request, "attachment needs a name"); 1364 defer allocator.free(name); 1365 if (!evt.Attachment.nameValid(name)) return respondUploadError(request, .bad_request, "invalid attachment name"); 1366 1367 const size = request.head.content_length orelse return respondUploadError(request, .length_required, "attachments must declare a content length"); 1368 if (size == 0) return respondUploadError(request, .bad_request, "attachment is empty"); 1369 if (size > evt.Attachment.max_size) return respondUploadError(request, .payload_too_large, "attachment is too large"); 1370 1371 const parent_id_hex = std.fmt.bytesToHex(parts.id_bytes, .lower); 1372 1373 var body_buf: [4096]u8 = undefined; 1374 const blob: evt.Blob = .{ .name = name, .size = size, .reader = try request.readerExpectContinue(&body_buf) }; 1375 1376 switch (source.repo_kind) { 1377 inline else => |repo_kind| { 1378 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1379 defer any_repo.deinit(io, allocator); 1380 switch (any_repo) { 1381 inline else => |*repo| _ = evt.Attachment.create(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, parts.kind, &parent_id_hex, blob, author) catch |err| switch (err) { 1382 error.ParentNotFound => return respondAttachmentParentNotFound(request), 1383 else => return err, 1384 }, 1385 } 1386 }, 1387 } 1388 1389 // the client reloads the page itself 1390 try request.respond("", .{ .status = .no_content, .keep_alive = false }); 1391 } 1392 1393 // the name the upload declares for its file, percent-encoded so it survives a 1394 // header 1395 fn attachmentName(allocator: std.mem.Allocator, request: *std.http.Server.Request) !?[]u8 { 1396 var iter = request.iterateHeaders(); 1397 while (iter.next()) |header| { 1398 if (!std.ascii.eqlIgnoreCase(header.name, attachment_name_header)) continue; 1399 return try decodeFormValue(allocator, header.value); 1400 } 1401 return null; 1402 } 1403 1404 // an upload that failed leaves the body partly read, so the connection closes 1405 fn respondUploadError(request: *std.http.Server.Request, status: std.http.Status, message: []const u8) !void { 1406 try request.respond(message, .{ 1407 .status = status, 1408 .keep_alive = false, 1409 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1410 }); 1411 } 1412 1413 // re-emit the comment `parts` names with a new body, in the repo the host 1414 // resolves the base to. 1415 fn updateComment( 1416 io: std.Io, 1417 allocator: std.mem.Allocator, 1418 host: Host, 1419 parts: CommentBaseParts, 1420 body: []const u8, 1421 author: evt.CommitAuthor, 1422 ) !void { 1423 const comment_id = parts.comment_id orelse return error.NotFound; 1424 const thread_id = std.fmt.bytesToHex(parts.thread_id, .lower); 1425 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return error.NotFound; 1426 defer request_repo.deinit(allocator); 1427 const source = request_repo.source; 1428 switch (source.repo_kind) { 1429 inline else => |repo_kind| { 1430 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1431 defer any_repo.deinit(io, allocator); 1432 switch (any_repo) { 1433 inline else => |*repo| try evt.Comment.update(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, parts.thread_kind, &thread_id, &comment_id, body, author), 1434 } 1435 }, 1436 } 1437 } 1438 1439 // edit actions share a suffix; the base identifies the event being edited. 1440 fn handleEdit( 1441 io: std.Io, 1442 request: *std.http.Server.Request, 1443 allocator: std.mem.Allocator, 1444 base: []const u8, 1445 host: Host, 1446 ) !void { 1447 const parts = commentBaseParts(host, base) orelse return respondRemoveNotFound(request); 1448 if (parts.comment_id != null) return handleCommentEdit(io, request, allocator, base, host, parts); 1449 return handleThreadEdit(io, request, allocator, base, host, parts); 1450 } 1451 1452 // replace the body of the comment the url names, then redirect to its 1453 // permalink. 1454 fn handleCommentEdit( 1455 io: std.Io, 1456 request: *std.http.Server.Request, 1457 allocator: std.mem.Allocator, 1458 base: []const u8, 1459 host: Host, 1460 parts: CommentBaseParts, 1461 ) !void { 1462 var author_arena = std.heap.ArenaAllocator.init(allocator); 1463 defer author_arena.deinit(); 1464 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 1465 const author = actor.author; 1466 // edits only reach here for a comment 1467 const comment_id = parts.comment_id orelse unreachable; 1468 { 1469 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1470 defer request_repo.deinit(allocator); 1471 if (!try request_repo.source.canModify(io, allocator, actor, .comment, &comment_id)) return respondForbidden(request); 1472 } 1473 1474 const form_body = try readFormBody(request, allocator); 1475 defer allocator.free(form_body); 1476 const body_crlf = (try parseFormField(allocator, form_body, "body")) orelse try allocator.dupe(u8, ""); 1477 defer allocator.free(body_crlf); 1478 const body = try std.mem.replaceOwned(u8, allocator, body_crlf, "\r\n", "\n"); 1479 defer allocator.free(body); 1480 1481 if (!evt.Comment.fieldsValid(body)) { 1482 const form_location = try allocator.print("{s}/edit", .{base}); 1483 defer allocator.free(form_location); 1484 try request.respond("", .{ 1485 .status = .see_other, 1486 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 1487 }); 1488 return; 1489 } 1490 1491 const not_found = "comment not found"; 1492 updateComment(io, allocator, host, parts, body, author) catch |err| switch (err) { 1493 error.NotFound => { 1494 try request.respond(not_found, .{ 1495 .status = .not_found, 1496 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1497 }); 1498 return; 1499 }, 1500 else => |e| return e, 1501 }; 1502 1503 try request.respond("", .{ 1504 .status = .see_other, 1505 .extra_headers = &.{.{ .name = "location", .value = base }}, 1506 }); 1507 } 1508 1509 fn updateThread( 1510 comptime Event: type, 1511 io: std.Io, 1512 allocator: std.mem.Allocator, 1513 host: Host, 1514 repo_base: []const u8, 1515 id: *const [evt.event_id_size]u8, 1516 update: Event.Update, 1517 author: evt.CommitAuthor, 1518 ) !void { 1519 const request_repo = (try requestRepoSource(io, allocator, host, repo_base)) orelse return error.NotFound; 1520 defer request_repo.deinit(allocator); 1521 const source = request_repo.source; 1522 switch (source.repo_kind) { 1523 inline else => |repo_kind| { 1524 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1525 defer any_repo.deinit(io, allocator); 1526 switch (any_repo) { 1527 inline else => |*repo| try Event.update(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, id, update, author), 1528 } 1529 }, 1530 } 1531 } 1532 1533 const RemoveParts = struct { 1534 repo_base: []const u8, 1535 kind: evt.EventKind, 1536 // the thread the removed event is, or belongs to 1537 thread_kind: evt.EventKind, 1538 thread_id: [evt.event_id_size]u8, 1539 id: [evt.event_id_size]u8, 1540 }; 1541 1542 // split a remove url into the repo and event it names 1543 fn removeParts(host: Host, base: []const u8) ?RemoveParts { 1544 if (attachmentRequest(base)) |attachment| { 1545 const parent = attachParentParts(attachment.repo_base) orelse return null; 1546 return .{ 1547 .repo_base = parent.repo_base, 1548 .kind = .attach, 1549 .thread_kind = parent.kind, 1550 .thread_id = parent.id_bytes, 1551 .id = attachment.id, 1552 }; 1553 } 1554 if (commentBaseParts(host, base)) |thread| return .{ 1555 .repo_base = thread.repo_base, 1556 .kind = if (thread.comment_id != null) .comment else thread.thread_kind, 1557 .thread_kind = thread.thread_kind, 1558 .thread_id = thread.thread_id, 1559 .id = thread.comment_id orelse thread.thread_id, 1560 }; 1561 return null; 1562 } 1563 1564 // remove the event named by the form's url 1565 fn handleRemove( 1566 io: std.Io, 1567 request: *std.http.Server.Request, 1568 allocator: std.mem.Allocator, 1569 base: []const u8, 1570 host: Host, 1571 ) !void { 1572 const parts = removeParts(host, base) orelse return respondRemoveNotFound(request); 1573 1574 var author_arena = std.heap.ArenaAllocator.init(allocator); 1575 defer author_arena.deinit(); 1576 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 1577 const author = actor.author; 1578 1579 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1580 defer request_repo.deinit(allocator); 1581 const source = request_repo.source; 1582 1583 if (parts.kind == .patch) switch (host) { 1584 .server => |server| { 1585 const user_id = actor.user_id orelse return respondLoginRequired(request); 1586 1587 // a draft lives in its author's user repo 1588 if (try evt.readForkById(io, allocator, &author_arena, server.users_dir, &user_id, &parts.id)) |fork_record| { 1589 const repo_id = evt.parseEventId(std.Io.Dir.path.basename(source.path)) catch return respondRemoveNotFound(request); 1590 if (!fork_record.removed and fork_record.event.stage == .draft and std.mem.eql(u8, fork_record.event.repo_id, &repo_id)) { 1591 const id = std.fmt.bytesToHex(parts.id, .lower); 1592 try fork.remove(io, allocator, server.users_dir, &user_id, &id, author); 1593 1594 const location = try allocator.print("{s}/patches/drafts", .{parts.repo_base}); 1595 defer allocator.free(location); 1596 try request.respond("", .{ 1597 .status = .see_other, 1598 .keep_alive = false, 1599 .extra_headers = &.{.{ .name = "location", .value = location }}, 1600 }); 1601 return; 1602 } 1603 } 1604 }, 1605 .local => {}, 1606 }; 1607 1608 // a draft is its author's alone, which its removal above checks 1609 if (!try source.canModify(io, allocator, actor, parts.kind, &parts.id)) return respondForbidden(request); 1610 1611 switch (source.repo_kind) { 1612 inline else => |repo_kind| { 1613 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1614 defer any_repo.deinit(io, allocator); 1615 switch (any_repo) { 1616 inline else => |*repo| evt.removeInThread(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, parts.thread_kind, &parts.thread_id, parts.kind, &parts.id, author) catch |err| switch (err) { 1617 error.EventNotFound => return respondRemoveNotFound(request), 1618 else => |e| return e, 1619 }, 1620 } 1621 }, 1622 } 1623 1624 const id = std.fmt.bytesToHex(parts.id, .lower); 1625 const location = try allocator.print("{s}/event:{s}/kind:{s}", .{ parts.repo_base, &id, @tagName(parts.kind) }); 1626 defer allocator.free(location); 1627 try request.respond("", .{ 1628 .status = .see_other, 1629 .keep_alive = false, 1630 .extra_headers = &.{.{ .name = "location", .value = location }}, 1631 }); 1632 } 1633 1634 fn respondRemoveNotFound(request: *std.http.Server.Request) !void { 1635 try request.respond("event not found", .{ 1636 .status = .not_found, 1637 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1638 }); 1639 } 1640 1641 fn updateDiscussion( 1642 io: std.Io, 1643 allocator: std.mem.Allocator, 1644 host: Host, 1645 repo_base: []const u8, 1646 id: *const [evt.event_id_size]u8, 1647 title: []const u8, 1648 labels: []const u8, 1649 description: []const u8, 1650 author: evt.CommitAuthor, 1651 ) !void { 1652 const request_repo = (try requestRepoSource(io, allocator, host, repo_base)) orelse return error.NotFound; 1653 defer request_repo.deinit(allocator); 1654 const source = request_repo.source; 1655 switch (source.repo_kind) { 1656 inline else => |repo_kind| { 1657 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1658 defer any_repo.deinit(io, allocator); 1659 switch (any_repo) { 1660 inline else => |*repo| try evt.Discussion.update(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, id, title, labels, description, author), 1661 } 1662 }, 1663 } 1664 } 1665 1666 // set the status of the issue the url names (base is 1667 // "/<owner>:<name>/issue:<id>", identity elided in local mode) by 1668 // re-emitting its event, then redirect back to it 1669 fn handleThreadStatus( 1670 io: std.Io, 1671 request: *std.http.Server.Request, 1672 allocator: std.mem.Allocator, 1673 base: []const u8, 1674 host: Host, 1675 open: bool, 1676 ) !void { 1677 const not_found = "thread not found"; 1678 const parts = commentBaseParts(host, base) orelse { 1679 try request.respond(not_found, .{ 1680 .status = .not_found, 1681 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1682 }); 1683 return; 1684 }; 1685 1686 var author_arena = std.heap.ArenaAllocator.init(allocator); 1687 defer author_arena.deinit(); 1688 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 1689 const author = actor.author; 1690 { 1691 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1692 defer request_repo.deinit(allocator); 1693 if (!try request_repo.source.canModify(io, allocator, actor, parts.thread_kind, &parts.thread_id)) return respondForbidden(request); 1694 } 1695 1696 (switch (parts.thread_kind) { 1697 .issue => updateThread(evt.Issue, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .status = if (open) .open else .closed }, author), 1698 .patch => updateThread(evt.Patch, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .status = if (open) .open else .closed }, author), 1699 else => return respondRemoveNotFound(request), 1700 }) catch |err| switch (err) { 1701 error.NotFound => { 1702 try request.respond(not_found, .{ 1703 .status = .not_found, 1704 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1705 }); 1706 return; 1707 }, 1708 else => |e| return e, 1709 }; 1710 1711 // like logout, this is a bodyless POST, so close the connection rather than 1712 // letting the keep-alive path try to discard a body that isn't framed. 1713 try request.respond("", .{ 1714 .status = .see_other, 1715 .keep_alive = false, 1716 .extra_headers = &.{.{ .name = "location", .value = base }}, 1717 }); 1718 } 1719 1720 // replace a thread's editable fields. 1721 fn handleThreadEdit( 1722 io: std.Io, 1723 request: *std.http.Server.Request, 1724 allocator: std.mem.Allocator, 1725 base: []const u8, 1726 host: Host, 1727 parts: CommentBaseParts, 1728 ) !void { 1729 var author_arena = std.heap.ArenaAllocator.init(allocator); 1730 defer author_arena.deinit(); 1731 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 1732 const author = actor.author; 1733 1734 const body = try readFormBody(request, allocator); 1735 defer allocator.free(body); 1736 1737 const title = (try parseFormField(allocator, body, "title")) orelse try allocator.dupe(u8, ""); 1738 defer allocator.free(title); 1739 const labels = (try parseFormField(allocator, body, "labels")) orelse try allocator.dupe(u8, ""); 1740 defer allocator.free(labels); 1741 const description_crlf = (try parseFormField(allocator, body, "description")) orelse try allocator.dupe(u8, ""); 1742 defer allocator.free(description_crlf); 1743 // form submission normalizes textarea line breaks to CRLF; store plain 1744 // newlines so the text renders the same on every host 1745 const description = try std.mem.replaceOwned(u8, allocator, description_crlf, "\r\n", "\n"); 1746 defer allocator.free(description); 1747 const target_branch = (try parseFormField(allocator, body, "target_branch")) orelse try allocator.dupe(u8, ""); 1748 defer allocator.free(target_branch); 1749 1750 // invalid fields send the user back to the edit form 1751 const valid = switch (parts.thread_kind) { 1752 .issue => evt.Issue.fieldsValid(title, labels), 1753 .patch => evt.Patch.fieldsValid(title, labels), 1754 .discuss => evt.Discussion.fieldsValid(title, labels), 1755 else => unreachable, 1756 }; 1757 if (!valid) { 1758 const form_location = try allocator.print("{s}/edit", .{base}); 1759 defer allocator.free(form_location); 1760 if (!evt.titleValid(title)) { 1761 return respondThreadFormFailure(request, allocator, host, form_location, requiredTitleFeedback(parts.thread_kind, title, labels, description, target_branch, null)); 1762 } 1763 try request.respond("", .{ 1764 .status = .see_other, 1765 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 1766 }); 1767 return; 1768 } 1769 1770 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1771 defer request_repo.deinit(allocator); 1772 1773 const draft_user_id = if (parts.thread_kind == .patch) actor.user_id else null; 1774 if (draft_user_id) |user_id| { 1775 const server = switch (host) { 1776 .server => |server| server, 1777 .local => unreachable, 1778 }; 1779 if (!evt.Patch.branchValid(target_branch) or !try request_repo.source.hasBranch(io, allocator, target_branch)) { 1780 const form_location = try allocator.print("{s}/edit", .{base}); 1781 defer allocator.free(form_location); 1782 return respondThreadFormFailure(request, allocator, host, form_location, patchFeedback(.invalid_target_branch, title, labels, description, target_branch, null)); 1783 } 1784 const repo_id = evt.parseEventId(std.Io.Dir.path.basename(request_repo.source.path)) catch return respondRemoveNotFound(request); 1785 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 1786 defer admin_repo.deinit(io, allocator); 1787 const id = std.fmt.bytesToHex(parts.thread_id, .lower); 1788 if (try pch.editDraft(.{}, io, allocator, server.users_dir, &admin_repo, .{ 1789 .id = id, 1790 .user_id = user_id, 1791 .repo_id = repo_id, 1792 .title = title, 1793 .labels = labels, 1794 .description = description, 1795 .target_branch = target_branch, 1796 .author = author, 1797 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 1798 })) { 1799 try request.respond("", .{ 1800 .status = .see_other, 1801 .extra_headers = &.{.{ .name = "location", .value = base }}, 1802 }); 1803 return; 1804 } 1805 } 1806 1807 // a draft is its author's alone, which its edit above checks 1808 if (!try request_repo.source.canModify(io, allocator, actor, parts.thread_kind, &parts.thread_id)) return respondForbidden(request); 1809 1810 const not_found = switch (parts.thread_kind) { 1811 .issue => "issue not found", 1812 .patch => "patch not found", 1813 .discuss => "discussion not found", 1814 else => unreachable, 1815 }; 1816 (switch (parts.thread_kind) { 1817 .issue => updateThread(evt.Issue, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .fields = .{ 1818 .title = title, 1819 .labels = labels, 1820 .description = description, 1821 } }, author), 1822 .patch => updateThread(evt.Patch, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .fields = .{ 1823 .title = title, 1824 .labels = labels, 1825 .description = description, 1826 .target_branch = target_branch, 1827 } }, author), 1828 .discuss => updateDiscussion(io, allocator, host, parts.repo_base, &parts.thread_id, title, labels, description, author), 1829 else => unreachable, 1830 }) catch |err| switch (err) { 1831 error.NotFound => { 1832 try request.respond(not_found, .{ 1833 .status = .not_found, 1834 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1835 }); 1836 return; 1837 }, 1838 else => { 1839 if (parts.thread_kind != .patch) return err; 1840 const failure = ui.Session.FormFeedback.PatchFailure.fromError(err) orelse return err; 1841 const form_location = try allocator.print("{s}/edit", .{base}); 1842 defer allocator.free(form_location); 1843 return respondThreadFormFailure(request, allocator, host, form_location, patchFeedback(failure, title, labels, description, target_branch, null)); 1844 }, 1845 }; 1846 1847 try request.respond("", .{ 1848 .status = .see_other, 1849 .extra_headers = &.{.{ .name = "location", .value = base }}, 1850 }); 1851 } 1852 1853 // resolve every conflicted field of the thread the url names 1854 fn handleThreadResolve( 1855 io: std.Io, 1856 request: *std.http.Server.Request, 1857 allocator: std.mem.Allocator, 1858 base: []const u8, 1859 host: Host, 1860 ) !void { 1861 const parts = commentBaseParts(host, base) orelse { 1862 try request.respond("thread not found", .{ 1863 .status = .not_found, 1864 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1865 }); 1866 return; 1867 }; 1868 1869 var author_arena = std.heap.ArenaAllocator.init(allocator); 1870 defer author_arena.deinit(); 1871 const author = ((try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .write, parts.thread_kind)) orelse return).author; 1872 1873 const body = try readFormBody(request, allocator); 1874 defer allocator.free(body); 1875 1876 var field_arena = std.heap.ArenaAllocator.init(allocator); 1877 defer field_arena.deinit(); 1878 const aa = field_arena.allocator(); 1879 const title = try parseFormField(aa, body, "title"); 1880 const labels = try parseFormField(aa, body, "labels"); 1881 1882 // the hunk inputs are submitted as d0, d1, ...; form submission normalizes their 1883 // textarea line breaks to CRLF 1884 var hunks: std.ArrayList([]const u8) = .empty; 1885 var hunk_index: usize = 0; 1886 while (true) : (hunk_index += 1) { 1887 const name = try aa.print("d{d}", .{hunk_index}); 1888 const submitted = (try parseFormField(aa, body, name)) orelse break; 1889 try hunks.append(aa, try std.mem.replaceOwned(u8, aa, submitted, "\r\n", "\n")); 1890 } 1891 1892 if (parts.comment_id != null or (parts.thread_kind != .issue and parts.thread_kind != .patch)) { 1893 try request.respond("thread not found", .{ 1894 .status = .not_found, 1895 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1896 }); 1897 return; 1898 } 1899 const route = routeFromUrl(host, base) orelse { 1900 try request.respond("thread not found", .{ 1901 .status = .not_found, 1902 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1903 }); 1904 return; 1905 }; 1906 const theirs: []const u8 = switch (route) { 1907 .repo_patches => |*patch| patch.theirs.slice(), 1908 .repo_issues => "", 1909 else => unreachable, 1910 }; 1911 const not_found = if (parts.thread_kind == .patch) "patch not found" else "issue not found"; 1912 1913 (switch (parts.thread_kind) { 1914 .issue => updateThread(evt.Issue, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .resolve = .{ 1915 .title = title, 1916 .labels = labels, 1917 .hunks = hunks.items, 1918 } }, author), 1919 .patch => updateThread(evt.Patch, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .resolve = .{ 1920 .title = title, 1921 .labels = labels, 1922 .hunks = hunks.items, 1923 .theirs = theirs, 1924 } }, author), 1925 else => unreachable, 1926 }) catch |err| switch (err) { 1927 error.NotFound => { 1928 try request.respond(not_found, .{ 1929 .status = .not_found, 1930 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1931 }); 1932 return; 1933 }, 1934 // invalid fields send the user back to the resolve form 1935 error.InvalidFields => { 1936 const form_location = try allocator.print("{s}/resolve", .{base}); 1937 defer allocator.free(form_location); 1938 try request.respond("", .{ 1939 .status = .see_other, 1940 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 1941 }); 1942 return; 1943 }, 1944 else => |e| return e, 1945 }; 1946 1947 try request.respond("", .{ 1948 .status = .see_other, 1949 .extra_headers = &.{.{ .name = "location", .value = base }}, 1950 }); 1951 } 1952 1953 // the posted path drops the action's own segment, so the route it parses is 1954 // the undo page the action applies to, never the confirmation page itself 1955 fn handleUndo(io: std.Io, request: *std.http.Server.Request, allocator: std.mem.Allocator, base: []const u8, host: Host, action: enum { undo, clear }) !void { 1956 const route = routeFromUrl(host, base) orelse return respondRepoNotFound(request); 1957 if (route != .repo_undo) return respondRepoNotFound(request); 1958 const target = route.repo_undo; 1959 var arena = std.heap.ArenaAllocator.init(allocator); 1960 defer arena.deinit(); 1961 const repo_base = if (target.name.len == 0) "" else try arena.allocator().print("/{s}", .{target.name.slice()}); 1962 _ = (try authorizeWrite(io, allocator, &arena, request, host, repo_base, .owner, null)) orelse return; 1963 const resolved = (try requestRepoSource(io, allocator, host, repo_base)) orelse return respondRepoNotFound(request); 1964 defer resolved.deinit(allocator); 1965 (switch (action) { 1966 .undo => ui.Repo.Undo.execute(io, allocator, resolved.source, target.index orelse return respondRepoNotFound(request)), 1967 .clear => ui.Repo.Undo.clearHistory(io, allocator, resolved.source), 1968 }) catch |err| switch (err) { 1969 error.NotFound, error.InvalidHistoryIndex, error.TransactionNotFound => return respondRepoNotFound(request), 1970 else => return err, 1971 }; 1972 const location = try (ui.RoutablePage.repoUndoRoute(target.name.slice(), null) orelse return error.RouteTooLong).toUrl(&arena); 1973 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = location }} }); 1974 } 1975 1976 fn handleSync( 1977 io: std.Io, 1978 request: *std.http.Server.Request, 1979 allocator: std.mem.Allocator, 1980 base: []const u8, 1981 source: ui.RepoSource, 1982 ) !void { 1983 if (base.len != 0) { 1984 try request.respond("not found", .{ 1985 .status = .not_found, 1986 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1987 }); 1988 return; 1989 } 1990 1991 var owned_failure: ?[]u8 = null; 1992 defer if (owned_failure) |message| allocator.free(message); 1993 const failure: ?[]const u8 = blk: { 1994 owned_failure = ui.Repo.Events.sync(io, allocator, source) catch |err| break :blk @errorName(err); 1995 break :blk owned_failure; 1996 }; 1997 if (failure) |message| { 1998 var encoded: std.Io.Writer.Allocating = .init(allocator); 1999 defer encoded.deinit(); 2000 try std.Uri.Component.percentEncode(&encoded.writer, message, struct { 2001 fn isUnreserved(c: u8) bool { 2002 return std.ascii.isAlphanumeric(c) or c == '-' or c == '.' or c == '_' or c == '~'; 2003 } 2004 }.isUnreserved); 2005 const cookie = try allocator.print( 2006 local_flash_cookie ++ "=" ++ local_sync_failure_prefix ++ "{s}; Path=/; HttpOnly; SameSite=Strict", 2007 .{encoded.written()}, 2008 ); 2009 defer allocator.free(cookie); 2010 try request.respond("", .{ 2011 .status = .see_other, 2012 .extra_headers = &.{ 2013 .{ .name = "location", .value = "/events" }, 2014 .{ .name = "set-cookie", .value = cookie }, 2015 }, 2016 }); 2017 return; 2018 } 2019 2020 try request.respond("", .{ 2021 .status = .see_other, 2022 .extra_headers = &.{ 2023 .{ .name = "location", .value = "/events" }, 2024 .{ .name = "set-cookie", .value = local_flash_cookie ++ "=; Path=/; Max-Age=0" }, 2025 }, 2026 }); 2027 } 2028 2029 fn renderIndexHtml( 2030 io: std.Io, 2031 allocator: std.mem.Allocator, 2032 host: Host, 2033 session_token: ?[]const u8, 2034 session_data: ui.Session.Data, 2035 ) ![]const u8 { 2036 const template = (findEmbed("/index.html") orelse return error.MissingIndexAsset).body; 2037 2038 var page_arena = std.heap.ArenaAllocator.init(allocator); 2039 defer page_arena.deinit(); 2040 2041 // the server admin repo must outlive the page build, since the session's 2042 // moment reads from it. 2043 var repo_maybe: ?rp.Repo(.xit, evt.admin_repo_opts) = null; 2044 defer if (repo_maybe) |*repo| repo.deinit(io, allocator); 2045 2046 var session = switch (host) { 2047 .server => |server| blk: { 2048 // open the admin repo to read live user/repo data. 2049 repo_maybe = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 2050 const repo = if (repo_maybe) |*repo| repo else unreachable; 2051 var session = try ui.Session.init(&page_arena, repo, session_data); 2052 // the session dropped a user whose account was removed, so revoke 2053 // the token that named them 2054 if (session_token) |token| { 2055 if (session.data.user_id == null) server.session_store.remove(token); 2056 } 2057 // give the page builders filesystem access to the on-disk repos (a 2058 // sibling "users" dir next to the admin repo) so the Repo page can 2059 // read its files. 2060 session.users_dir = server.users_dir; 2061 break :blk session; 2062 }, 2063 .local => |local| ui.Session{ 2064 .data = session_data, 2065 .arena = &page_arena, 2066 .page_arena = &page_arena, 2067 .local = local, 2068 }, 2069 }; 2070 session.io = io; 2071 2072 var page = try ui.Page.init(session.page_arena, &session, session.data.current_page); 2073 var root = try ui.initRoot(allocator, &page, &session); 2074 defer root.deinit(allocator); 2075 2076 const snapshot: ui.Snapshot = .{ .page = page, .session = session.data }; 2077 2078 const content = try generateHtml(allocator, &root, &session); 2079 defer allocator.free(content); 2080 2081 // serialize the snapshot so the wasm side can parse it back without making 2082 // a second request. it's embedded raw in a <script type="application/json"> 2083 // block, whose content is raw text terminated only by "</script". in json, 2084 // '<' appears solely inside string values, so escaping every '<' (and '>' 2085 // for good measure) to its \uXXXX form yields equivalent json that can't 2086 // break out of the tag. 2087 var json: std.Io.Writer.Allocating = .init(allocator); 2088 defer json.deinit(); 2089 try std.json.Stringify.value(snapshot, .{}, &json.writer); 2090 2091 var json_escaped: std.ArrayList(u8) = .empty; 2092 defer json_escaped.deinit(allocator); 2093 for (json.written()) |c| switch (c) { 2094 '<' => try json_escaped.appendSlice(allocator, "\\u003c"), 2095 '>' => try json_escaped.appendSlice(allocator, "\\u003e"), 2096 else => try json_escaped.append(allocator, c), 2097 }; 2098 2099 var out: std.ArrayList(u8) = .empty; 2100 errdefer out.deinit(allocator); 2101 { 2102 var cursor: usize = 0; 2103 for (&[_]struct { needle: []const u8, replacement: []const u8 }{ 2104 .{ .needle = "{{{ HAXY_HTML }}}", .replacement = content }, 2105 .{ .needle = "{{{ HAXY_JSON }}}", .replacement = json_escaped.items }, 2106 }) |sub| { 2107 const idx = std.mem.indexOfPos(u8, template, cursor, sub.needle) orelse return error.MissingTemplateToken; 2108 try out.appendSlice(allocator, template[cursor..idx]); 2109 try out.appendSlice(allocator, sub.replacement); 2110 cursor = idx + sub.needle.len; 2111 } 2112 try out.appendSlice(allocator, template[cursor..]); 2113 } 2114 return try out.toOwnedSlice(allocator); 2115 } 2116 2117 fn findEmbed(request_path: []const u8) ?Embed { 2118 // embeds are matched before pages, so a dot keeps them from claiming a username or tab 2119 comptime for (embeds) |embed| { 2120 if (std.mem.indexOfScalar(u8, embed.path, '.') == null) @compileError("embed path needs a '.' so it can't shadow a page: " ++ embed.path); 2121 }; 2122 if (request_path.len < 2 or request_path[0] != '/') return null; 2123 const path = request_path[1..]; 2124 2125 for (embeds) |embed| { 2126 if (std.mem.eql(u8, path, embed.path)) return embed; 2127 } 2128 return null; 2129 } 2130 2131 // emits the TUI grid cells as static HTML. each web-native Scroll becomes its 2132 // own absolutely-positioned, natively-scrollable <div> holding its full content, 2133 // rendered recursively so nested scrolls work. 2134 pub fn generateHtml(allocator: std.mem.Allocator, root: *ui.Widget, session: *ui.Session) ![]const u8 { 2135 const grid = root.getGrid() orelse return error.MissingGrid; 2136 const root_focus = root.getFocus(); 2137 2138 var out: std.ArrayList(u8) = .empty; 2139 errdefer out.deinit(allocator); 2140 2141 switch (root.*) { 2142 .background => |*background| { 2143 if (background.art.getGrid()) |art| { 2144 try out.print(allocator, "<div class=\"ansi-art\" aria-hidden=\"true\" style=\"left:{d}ch;opacity:{d}%\">", .{ grid.size.width -| art.size.width, ui.widget.AnsiBackground.art_opacity }); 2145 try renderPanel(allocator, &out, background.art.getFocus(), art, session, root_focus); 2146 try out.appendSlice(allocator, "</div>"); 2147 } 2148 }, 2149 else => {}, 2150 } 2151 try out.appendSlice(allocator, "<div class=\"grid-content\" data-key=\"panel:root\">"); 2152 try renderPanel(allocator, &out, root_focus, grid, session, root_focus); 2153 try out.appendSlice(allocator, "</div>"); 2154 try renderForms(allocator, &out, root_focus); 2155 return try out.toOwnedSlice(allocator); 2156 } 2157 2158 // render one panel — a focus subtree and its content grid — as HTML, recursing 2159 // once per web-native Scroll inside it. the root panel is the whole page; each 2160 // Scroll becomes a nested, natively-scrollable div holding its full content. 2161 // emits the panel's grid cells as text, leaving holes where child scrolls sit, 2162 // then the child scroll divs over those holes. 2163 fn renderPanel(allocator: std.mem.Allocator, output: *std.ArrayList(u8), focus: *Focus, grid: Grid, session: *ui.Session, root_focus: *Focus) !void { 2164 // `direct` is this panel's scroll children, each drawn as an overlaid div. 2165 // `excluded` is every focus id that belongs to a scroll (the scroll nodes 2166 // plus their descendants, which the focus tree flattens into this panel's 2167 // children): the cell hit-test below skips them so this panel doesn't claim 2168 // cells that are really rendered inside a child scroll's own panel. 2169 // (scrolls aren't nested in practice, so every scroll child is direct here.) 2170 var direct: std.ArrayList(usize) = .empty; 2171 defer direct.deinit(allocator); 2172 var excluded: std.AutoHashMapUnmanaged(usize, void) = .empty; 2173 defer excluded.deinit(allocator); 2174 { 2175 var it = focus.children.iterator(); 2176 while (it.next()) |e| { 2177 if (e.value_ptr.focus.scroll == null) continue; 2178 try direct.append(allocator, e.key_ptr.*); 2179 try excluded.put(allocator, e.key_ptr.*, {}); 2180 var mit = e.value_ptr.focus.children.iterator(); 2181 while (mit.next()) |m| try excluded.put(allocator, m.key_ptr.*, {}); 2182 } 2183 } 2184 2185 // the HTML element a run of cells is wrapped in, chosen from the cell's 2186 // focusable kind 2187 const CellTag = union(enum) { 2188 span, // clickable focusable cell 2189 a: []const u8, // clickable focusable link 2190 plain, // non-focusable, colored 2191 2192 const a_prefix = "a:"; 2193 // an "in-page" anchor: rendered as a real <a href> so it works with js 2194 // disabled, but wasm handles it without navigating. 2195 fn init(str: []const u8) @This() { 2196 if (std.mem.startsWith(u8, str, ui.raw_link_prefix)) { 2197 return .{ .a = str[ui.raw_link_prefix.len..] }; 2198 } 2199 if (std.mem.startsWith(u8, str, ui.in_page_link_prefix)) { 2200 return .{ .a = str[ui.in_page_link_prefix.len..] }; 2201 } 2202 if (std.mem.startsWith(u8, str, a_prefix)) { 2203 return .{ .a = str[a_prefix.len..] }; 2204 } 2205 return .span; 2206 } 2207 2208 fn writeOpenTag(self: @This(), alloc: std.mem.Allocator, out: *std.ArrayList(u8), id: usize, style_attr: []const u8) !void { 2209 var id_buf: [32]u8 = undefined; 2210 switch (self) { 2211 .span => { 2212 try out.appendSlice(alloc, "<span class=\"clickable\" data-focus-id=\""); 2213 try out.appendSlice(alloc, try std.fmt.bufPrint(&id_buf, "{d}", .{id})); 2214 try out.appendSlice(alloc, "\""); 2215 try out.appendSlice(alloc, style_attr); 2216 try out.appendSlice(alloc, ">"); 2217 }, 2218 .a => |href| { 2219 // tabindex=-1 keeps these out of the browser's tab order 2220 try out.appendSlice(alloc, "<a class=\"clickable\" tabindex=\"-1\" data-focus-id=\""); 2221 try out.appendSlice(alloc, try std.fmt.bufPrint(&id_buf, "{d}", .{id})); 2222 try out.appendSlice(alloc, "\" href=\""); 2223 try appendEscapedHtml(alloc, out, href); 2224 try out.appendSlice(alloc, "\""); 2225 try out.appendSlice(alloc, style_attr); 2226 try out.appendSlice(alloc, ">"); 2227 }, 2228 .plain => { 2229 try out.appendSlice(alloc, "<span"); 2230 try out.appendSlice(alloc, style_attr); 2231 try out.appendSlice(alloc, ">"); 2232 }, 2233 } 2234 } 2235 2236 fn closeTag(self: @This()) []const u8 { 2237 return switch (self) { 2238 .span, .plain => "</span>", 2239 .a => "</a>", 2240 }; 2241 } 2242 }; 2243 2244 // the focusable owning each cell, among this panel's own (skipping any 2245 // that belong to a child scroll, whose cells are drawn in their own panel). 2246 // claimed in focus order, so the first focusable over a cell keeps it. 2247 // looking every focusable up for every cell is quadratic in a long list. 2248 const owners = try allocator.alloc(?usize, grid.size.width * grid.size.height); 2249 defer allocator.free(owners); 2250 @memset(owners, null); 2251 { 2252 var it = focus.children.iterator(); 2253 while (it.next()) |entry| { 2254 const child = entry.value_ptr.*; 2255 if (child.focus.mode != .all) continue; 2256 if (excluded.contains(entry.key_ptr.*)) continue; 2257 const r = child.rect; 2258 for (@min(r.y, grid.size.height)..@min(r.y + r.size.height, grid.size.height)) |y| { 2259 for (@min(r.x, grid.size.width)..@min(r.x + r.size.width, grid.size.width)) |x| { 2260 const owner = &owners[y * grid.size.width + x]; 2261 if (owner.* == null) owner.* = entry.key_ptr.*; 2262 } 2263 } 2264 } 2265 } 2266 2267 // the cells are the volatile part of a panel. js replaces this one subtree 2268 // wholesale while retaining the panel's native controls and scroll shells. 2269 try output.appendSlice(allocator, "<div class=\"grid-cells\">"); 2270 2271 // emit this panel's grid as rows of text, coalescing adjacent cells that 2272 // share a focus id and style into one tag (a clickable span, a link, or a 2273 // plain styled span). cells under a child scroll keep only their background. 2274 // a cell's own link is an anchor nested in that tag. 2275 for (0..grid.size.height) |y| { 2276 var cur_id: ?usize = null; 2277 var cur_style: Grid.Style = .{}; 2278 var open_tag: ?CellTag = null; 2279 var open_link: ?[]const u8 = null; 2280 var first = true; 2281 for (0..grid.size.width) |x| { 2282 const cell = (try grid.cell(x, y)).*; 2283 // a cell covered by a child scroll's viewport is drawn by that scroll's 2284 // own div, so blank its glyph and make it non-clickable here — but keep 2285 // its background, so the backdrop still shows through the scroll's 2286 // transparent div instead of a bare hole. 2287 const covered_by_scroll = blk: { 2288 for (direct.items) |id| { 2289 const r = (focus.children.get(id) orelse continue).rect; 2290 if (x >= r.x and y >= r.y and x < r.x + r.size.width and y < r.y + r.size.height) break :blk true; 2291 } 2292 break :blk false; 2293 }; 2294 // the focusable owning the cell at (x, y); none for a covered cell. 2295 const cell_id = if (covered_by_scroll) null else owners[y * grid.size.width + x]; 2296 const style: Grid.Style = if (covered_by_scroll) .{ .bg = cell.style.bg } else cell.style; 2297 2298 if (first or cell_id != cur_id or !style.eql(cur_style)) { 2299 if (open_link != null) try output.appendSlice(allocator, "</a>"); 2300 open_link = null; 2301 if (open_tag) |t| try output.appendSlice(allocator, t.closeTag()); 2302 2303 var new_tag: ?CellTag = null; 2304 if (cell_id) |id| { 2305 if (focus.children.get(id)) |child| { 2306 new_tag = switch (child.focus.kind) { 2307 .custom => |custom| CellTag.init(custom), 2308 else => .span, 2309 }; 2310 } 2311 } 2312 if (new_tag == null and !style.eql(.{})) new_tag = .plain; 2313 2314 if (new_tag) |t| { 2315 var style_buf: [192]u8 = undefined; 2316 try t.writeOpenTag(allocator, output, cell_id orelse 0, styleAttr(&style_buf, style)); 2317 } 2318 2319 open_tag = new_tag; 2320 cur_id = cell_id; 2321 cur_style = style; 2322 first = false; 2323 } 2324 2325 // an anchor can't nest in another, so a link tag's cells skip theirs 2326 const in_anchor = if (open_tag) |t| t == .a else false; 2327 const link = if (covered_by_scroll or in_anchor) null else webLink(cell.link); 2328 if (!sameLink(link, open_link)) { 2329 if (open_link != null) try output.appendSlice(allocator, "</a>"); 2330 if (link) |url| { 2331 // a page path opens in this tab, any other url in a new one 2332 try output.appendSlice(allocator, if (url[0] == '/') 2333 "<a class=\"cell-link\" tabindex=\"-1\" href=\"" 2334 else 2335 "<a class=\"cell-link\" tabindex=\"-1\" target=\"_blank\" rel=\"noopener noreferrer\" href=\""); 2336 try appendEscapedHtml(allocator, output, url); 2337 try output.appendSlice(allocator, "\">"); 2338 } 2339 open_link = link; 2340 } 2341 2342 if (covered_by_scroll) { 2343 try appendEscapedHtml(allocator, output, " "); 2344 } else if (cell.continuation) { 2345 // the wide rune to the left was emitted 2ch wide, covering this column 2346 } else if (cell.rune) |rune| { 2347 var encoded: [4]u8 = undefined; 2348 const encoded_len = try std.unicode.utf8Encode(rune, &encoded); 2349 const rune_text = encoded[0..encoded_len]; 2350 // a double-width rune is pinned inside a 2ch span so the 2351 // fallback glyph's advance width can't shift the rest of the row 2352 const wide = x + 1 < grid.size.width and (try grid.cell(x + 1, y)).continuation; 2353 if (wide) { 2354 try output.appendSlice(allocator, "<span class=\"w2\">"); 2355 try appendEscapedHtml(allocator, output, rune_text); 2356 try output.appendSlice(allocator, "</span>"); 2357 } else { 2358 try appendEscapedHtml(allocator, output, rune_text); 2359 } 2360 } else { 2361 try appendEscapedHtml(allocator, output, " "); 2362 } 2363 } 2364 if (open_link != null) try output.appendSlice(allocator, "</a>"); 2365 if (open_tag) |t| try output.appendSlice(allocator, t.closeTag()); 2366 try output.append(allocator, '\n'); 2367 } 2368 try output.appendSlice(allocator, "</div>"); 2369 2370 // native controls live in their panel, beside the replaceable cells. their 2371 // stable keys let JS update layout without recreating their DOM nodes, and 2372 // being actual descendants of a scroll gives them native movement/clipping. 2373 try renderPanelControls(allocator, output, focus, session, root_focus, &excluded); 2374 2375 // each child scroll becomes a natively-scrollable div positioned over its 2376 // viewport, holding its full content rendered recursively. 2377 for (direct.items) |id| { 2378 const child = focus.children.get(id) orelse continue; 2379 const info = child.focus.scroll orelse continue; 2380 const r = child.rect; 2381 // overflow only on the axes the widget scrolls; `auto` shows a bar only 2382 // when that axis actually overflows. the other axis is clipped (hidden), 2383 // matching how the terminal Scroll handles its non-scrolling axis. 2384 const overflow = switch (info.direction) { 2385 .vert => "overflow-x:hidden;overflow-y:auto", 2386 .horiz => "overflow-x:auto;overflow-y:hidden", 2387 .both => "overflow:auto", 2388 }; 2389 // the id carries a content version so JS preserves the native scroll 2390 // position across re-renders of the same content but resets it when the 2391 // content is replaced — e.g. selecting a different commit. the widget's 2392 // scroll offset (in cells) rides along so JS can apply it when it has no 2393 // preserved position, letting a wasm-side scrollToRect (the files list 2394 // scrolling to its selected row on page load) reach the browser. 2395 var buf: [256]u8 = undefined; 2396 try output.appendSlice(allocator, try std.fmt.bufPrint(&buf, "<div class=\"scroll\" data-key=\"scroll:{d}\" data-scroll-id=\"{d}-{d}\" data-scroll-direction=\"{s}\" data-scroll-x=\"{d}\" data-scroll-y=\"{d}\" style=\"left:{d}ch;top:{d}em;width:{d}ch;height:{d}em;{s}\">", .{ id, id, child.focus.version, @tagName(info.direction), info.offset_x, info.offset_y, r.x, r.y, r.size.width, r.size.height, overflow })); 2397 try renderPanel(allocator, output, child.focus, info.content, session, root_focus); 2398 try output.appendSlice(allocator, "</div>"); 2399 } 2400 } 2401 2402 const form_prefix = "form:"; 2403 const form_id_prefix = "haxy-form-"; 2404 2405 fn formAction(focus: *const Focus) ?[]const u8 { 2406 return switch (focus.kind) { 2407 .custom => |custom| if (std.mem.startsWith(u8, custom, form_prefix)) custom[form_prefix.len..] else null, 2408 else => null, 2409 }; 2410 } 2411 2412 // find the form ancestor of a flattened focus-tree child. html's `form` 2413 // attribute then associates the control with that form without requiring the 2414 // form and control to share a DOM parent. 2415 fn formOwner(root_focus: *Focus, focus_id: usize) ?usize { 2416 var id = focus_id; 2417 while (root_focus.children.get(id)) |child| { 2418 const parent_id = child.parent_id; 2419 if (parent_id == root_focus.id) return if (formAction(root_focus) != null) root_focus.id else null; 2420 const parent = root_focus.children.get(parent_id) orelse return null; 2421 if (formAction(parent.focus) != null) return parent_id; 2422 id = parent_id; 2423 } 2424 return null; 2425 } 2426 2427 fn appendFormAttribute(allocator: std.mem.Allocator, output: *std.ArrayList(u8), root_focus: *Focus, focus_id: usize) !void { 2428 const form_id = formOwner(root_focus, focus_id) orelse return; 2429 var buf: [64]u8 = undefined; 2430 try output.appendSlice(allocator, try std.fmt.bufPrint(&buf, " form=\"" ++ form_id_prefix ++ "{d}\"", .{form_id})); 2431 } 2432 2433 fn renderPanelControls( 2434 allocator: std.mem.Allocator, 2435 output: *std.ArrayList(u8), 2436 focus: *Focus, 2437 session: *ui.Session, 2438 root_focus: *Focus, 2439 excluded: *const std.AutoHashMapUnmanaged(usize, void), 2440 ) !void { 2441 var iter = focus.children.iterator(); 2442 while (iter.next()) |entry| { 2443 const id = entry.key_ptr.*; 2444 if (excluded.contains(id)) continue; 2445 const child = entry.value_ptr.*; 2446 const r = child.rect; 2447 2448 if (r.size.width == 0 or r.size.height == 0) continue; // not laid out, rather than merely off-screen 2449 2450 switch (child.focus.kind) { 2451 .text_input, .text_input_password, .text_area => { 2452 const ti = session.text_inputs.get(id) orelse continue; 2453 2454 const inner_left = r.x + 1; 2455 const inner_top = r.y + 1; 2456 const inner_width = if (r.size.width > 2) r.size.width - 2 else 0; 2457 const preserve = !ti.options.read_only; 2458 2459 if (child.focus.kind == .text_area) { 2460 const value = try ti.text(allocator); 2461 defer allocator.free(value); 2462 var id_buf: [128]u8 = undefined; 2463 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "<textarea data-key=\"control:{d}\" data-focus-id=\"{d}\"", .{ id, id })); 2464 if (preserve) try output.appendSlice(allocator, " data-preserve-value") else try output.appendSlice(allocator, " readonly"); 2465 try appendFormAttribute(allocator, output, root_focus, id); 2466 if (ti.options.name.len > 0) { 2467 try output.appendSlice(allocator, " name=\""); 2468 try appendEscapedHtml(allocator, output, ti.options.name); 2469 try output.append(allocator, '"'); 2470 } 2471 const inner_height = if (r.size.height > 2) r.size.height - 2 else 0; 2472 var pos_buf: [128]u8 = undefined; 2473 try output.appendSlice(allocator, try std.fmt.bufPrint(&pos_buf, " style=\"left:{d}ch;top:{d}em;width:{d}ch;height:{d}em\">\n", .{ inner_left, inner_top, inner_width, inner_height })); 2474 try appendEscapedHtml(allocator, output, value); 2475 try output.appendSlice(allocator, "</textarea>"); 2476 continue; 2477 } 2478 2479 var id_buf: [160]u8 = undefined; 2480 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "<input type=\"{s}\" data-key=\"control:{d}\" data-focus-id=\"{d}\"", .{ if (child.focus.kind == .text_input_password) "password" else "text", id, id })); 2481 if (preserve) try output.appendSlice(allocator, " data-preserve-value") else try output.appendSlice(allocator, " readonly"); 2482 try appendFormAttribute(allocator, output, root_focus, id); 2483 if (ti.options.name.len > 0) { 2484 try output.appendSlice(allocator, " name=\""); 2485 try appendEscapedHtml(allocator, output, ti.options.name); 2486 try output.append(allocator, '"'); 2487 } 2488 if (child.focus.kind != .text_input_password) { 2489 const value = try ti.text(allocator); 2490 defer allocator.free(value); 2491 try output.appendSlice(allocator, " value=\""); 2492 try appendEscapedHtml(allocator, output, value); 2493 try output.append(allocator, '"'); 2494 } 2495 var pos_buf: [96]u8 = undefined; 2496 try output.appendSlice(allocator, try std.fmt.bufPrint(&pos_buf, " style=\"left:{d}ch;top:{d}em;width:{d}ch;height:1em\">", .{ inner_left, inner_top, inner_width })); 2497 }, 2498 .custom => |custom| { 2499 if (std.mem.eql(u8, custom, "submit") or std.mem.startsWith(u8, custom, ui.submit_action_prefix)) { 2500 if (formOwner(root_focus, id) == null) continue; 2501 var id_buf: [128]u8 = undefined; 2502 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "<button type=\"submit\" data-key=\"control:{d}\" data-focus-id=\"{d}\"", .{ id, id })); 2503 try appendFormAttribute(allocator, output, root_focus, id); 2504 if (std.mem.startsWith(u8, custom, ui.submit_action_prefix)) { 2505 try output.appendSlice(allocator, " formaction=\""); 2506 try appendEscapedHtml(allocator, output, custom[ui.submit_action_prefix.len..]); 2507 try output.append(allocator, '"'); 2508 } 2509 var pos_buf: [128]u8 = undefined; 2510 try output.appendSlice(allocator, try std.fmt.bufPrint(&pos_buf, " style=\"left:{d}ch;top:{d}em;width:{d}ch;height:{d}em\"></button>", .{ r.x, r.y, r.size.width, r.size.height })); 2511 } else if (std.mem.startsWith(u8, custom, ui.radio_prefix)) { 2512 // an invisible native radio over the option, checked when the option is its row's selection 2513 const field = custom[ui.radio_prefix.len..]; 2514 const separator = std.mem.indexOfScalar(u8, field, '=') orelse continue; 2515 const row = root_focus.children.get(child.parent_id) orelse continue; 2516 var id_buf: [128]u8 = undefined; 2517 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "<input type=\"radio\" data-key=\"control:{d}\" data-focus-id=\"{d}\"", .{ id, id })); 2518 try appendFormAttribute(allocator, output, root_focus, id); 2519 try output.appendSlice(allocator, " name=\""); 2520 try appendEscapedHtml(allocator, output, field[0..separator]); 2521 try output.appendSlice(allocator, "\" value=\""); 2522 try appendEscapedHtml(allocator, output, field[separator + 1 ..]); 2523 try output.append(allocator, '"'); 2524 if (row.focus.child_id == id) try output.appendSlice(allocator, " checked"); 2525 var pos_buf: [128]u8 = undefined; 2526 try output.appendSlice(allocator, try std.fmt.bufPrint(&pos_buf, " style=\"opacity:0;left:{d}ch;top:{d}em;width:{d}ch;height:{d}em\">", .{ r.x, r.y, r.size.width, r.size.height })); 2527 } else if (std.mem.startsWith(u8, custom, ui.file_input_prefix)) { 2528 try output.appendSlice(allocator, "<input type=\"file\" data-preserve-value data-action=\""); 2529 try appendEscapedHtml(allocator, output, custom[ui.file_input_prefix.len..]); 2530 var id_buf: [128]u8 = undefined; 2531 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "\" data-key=\"control:{d}\" data-focus-id=\"{d}\" style=\"opacity:0;left:{d}ch;top:{d}em;width:{d}ch;height:{d}em\">", .{ id, id, r.x, r.y, r.size.width, r.size.height })); 2532 } 2533 }, 2534 else => {}, 2535 } 2536 } 2537 } 2538 2539 // emit hidden form owners beside the rendered panels. their controls point 2540 // back here with the standard HTML `form` attribute. 2541 fn renderForms(allocator: std.mem.Allocator, output: *std.ArrayList(u8), root_focus: *Focus) !void { 2542 // the focus child map preserves insertion order, which matches the order 2543 // widgets were added in code 2544 var iter = root_focus.children.iterator(); 2545 while (iter.next()) |entry| { 2546 const child = entry.value_ptr.*; 2547 const action_url = formAction(child.focus) orelse continue; 2548 2549 try output.appendSlice(allocator, "<form hidden data-key=\"form:"); 2550 var id_buf: [96]u8 = undefined; 2551 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "{d}\" id=\"" ++ form_id_prefix ++ "{d}\" action=\"", .{ entry.key_ptr.*, entry.key_ptr.* })); 2552 try appendEscapedHtml(allocator, output, action_url); 2553 try output.appendSlice(allocator, "\" method=\"post\"></form>"); 2554 } 2555 } 2556 2557 // the 16 ansi colors as the browser shows them (xterm's defaults) 2558 const ansi_palette = [16]Grid.Color.Rgb{ 2559 .{ .r = 0x00, .g = 0x00, .b = 0x00 }, .{ .r = 0xcd, .g = 0x00, .b = 0x00 }, .{ .r = 0x00, .g = 0xcd, .b = 0x00 }, .{ .r = 0xcd, .g = 0xcd, .b = 0x00 }, 2560 .{ .r = 0x00, .g = 0x00, .b = 0xee }, .{ .r = 0xcd, .g = 0x00, .b = 0xcd }, .{ .r = 0x00, .g = 0xcd, .b = 0xcd }, .{ .r = 0xe5, .g = 0xe5, .b = 0xe5 }, 2561 .{ .r = 0x7f, .g = 0x7f, .b = 0x7f }, .{ .r = 0xff, .g = 0x00, .b = 0x00 }, .{ .r = 0x00, .g = 0xff, .b = 0x00 }, .{ .r = 0xff, .g = 0xff, .b = 0x00 }, 2562 .{ .r = 0x5c, .g = 0x5c, .b = 0xff }, .{ .r = 0xff, .g = 0x00, .b = 0xff }, .{ .r = 0x00, .g = 0xff, .b = 0xff }, .{ .r = 0xff, .g = 0xff, .b = 0xff }, 2563 }; 2564 2565 // resolve any color to rgb: palette colors through the ansi table and the 2566 // xterm 256-color layout (16 ansi, a 6x6x6 cube, then 24 grays) 2567 fn colorRgb(color: Grid.Color) Grid.Color.Rgb { 2568 return switch (color) { 2569 .rgb => |c| c, 2570 .ansi => |a| ansi_palette[@backingInt(a)], 2571 .indexed => |n| if (n < 16) 2572 ansi_palette[n] 2573 else if (n < 232) blk: { 2574 const levels = [6]u8{ 0, 0x5f, 0x87, 0xaf, 0xd7, 0xff }; 2575 const i = n - 16; 2576 break :blk .{ .r = levels[i / 36], .g = levels[(i / 6) % 6], .b = levels[i % 6] }; 2577 } else blk: { 2578 const v: u8 = 8 + (n - 232) * 10; 2579 break :blk .{ .r = v, .g = v, .b = v }; 2580 }, 2581 }; 2582 } 2583 2584 // builds an HTML ` style="color:…;background-color:…"` attribute from a 2585 // cell's style into `buf`, omitting whichever color is unset. an inverted 2586 // cell swaps the two, falling back to the page's --fg/--bg variables for 2587 // whichever side is unset. text attributes follow the colors. returns an 2588 // empty slice when nothing is set. 2589 fn styleAttr(buf: []u8, style: Grid.Style) []const u8 { 2590 if (style.eql(.{})) return buf[0..0]; 2591 const prefix = " style=\""; 2592 @memcpy(buf[0..prefix.len], prefix); 2593 var i: usize = prefix.len; 2594 const inverted = style.inverted; 2595 i = cssColor(buf, i, "color", if (inverted) style.bg else style.fg, if (inverted) "var(--bg)" else null) orelse return buf[0..0]; 2596 i = cssColor(buf, i, "background-color", if (inverted) style.fg else style.bg, if (inverted) "var(--fg)" else null) orelse return buf[0..0]; 2597 const decoration: []const u8 = if (style.underline and style.strikethrough) 2598 "text-decoration:underline line-through;" 2599 else if (style.underline) 2600 "text-decoration:underline;" 2601 else if (style.strikethrough) 2602 "text-decoration:line-through;" 2603 else 2604 ""; 2605 const attributes = std.fmt.bufPrint(buf[i..], "{s}{s}{s}{s}", .{ 2606 if (style.bold) "font-weight:bold;" else "", 2607 if (style.italic) "font-style:italic;" else "", 2608 decoration, 2609 if (style.dim) "opacity:.6;" else "", 2610 }) catch return buf[0..0]; 2611 i += attributes.len; 2612 if (i >= buf.len) return buf[0..0]; 2613 buf[i] = '"'; 2614 return buf[0 .. i + 1]; 2615 } 2616 2617 // append `prop:value;` at buf[i..] for the color, or for the fallback when 2618 // the color is unset (nothing when both are). returns the new end, or null 2619 // when it doesn't fit. 2620 fn cssColor(buf: []u8, i: usize, prop: []const u8, color: ?Grid.Color, fallback: ?[]const u8) ?usize { 2621 const s = if (color) |c| blk: { 2622 const v = colorRgb(c); 2623 break :blk std.fmt.bufPrint(buf[i..], "{s}:#{x:0>2}{x:0>2}{x:0>2};", .{ prop, v.r, v.g, v.b }) catch return null; 2624 } else if (fallback) |f| 2625 std.fmt.bufPrint(buf[i..], "{s}:{s};", .{ prop, f }) catch return null 2626 else 2627 return i; 2628 return i + s.len; 2629 } 2630 2631 // a cell's link as an href, when it's a page path or a web or mail url 2632 fn webLink(link: ?[]const u8) ?[]const u8 { 2633 const url = link orelse return null; 2634 // a page path, not a protocol-relative url 2635 if (url.len > 1 and url[0] == '/' and url[1] != '/') return url; 2636 for ([_][]const u8{ "http://", "https://", "mailto:" }) |scheme| { 2637 if (std.ascii.startsWithIgnoreCase(url, scheme)) return url; 2638 } 2639 return null; 2640 } 2641 2642 fn sameLink(a: ?[]const u8, b: ?[]const u8) bool { 2643 if (a) |x| return if (b) |y| std.mem.eql(u8, x, y) else false; 2644 return b == null; 2645 } 2646 2647 fn appendEscapedHtml(allocator: std.mem.Allocator, out: *std.ArrayList(u8), input: []const u8) !void { 2648 for (input) |ch| { 2649 switch (ch) { 2650 '&' => try out.appendSlice(allocator, "&amp;"), 2651 '<' => try out.appendSlice(allocator, "&lt;"), 2652 '>' => try out.appendSlice(allocator, "&gt;"), 2653 '"' => try out.appendSlice(allocator, "&quot;"), 2654 '\'' => try out.appendSlice(allocator, "&#39;"), 2655 else => try out.append(allocator, ch), 2656 } 2657 } 2658 } 2659 2660 // --- helpers -------------------------------------------------------------- 2661 2662 fn getCookieValue(request: *std.http.Server.Request, name: []const u8) ?[]const u8 { 2663 var iter = request.iterateHeaders(); 2664 while (iter.next()) |header| { 2665 if (!std.ascii.eqlIgnoreCase(header.name, "cookie")) continue; 2666 var pairs = std.mem.splitScalar(u8, header.value, ';'); 2667 while (pairs.next()) |pair| { 2668 const trimmed = std.mem.trim(u8, pair, " \t"); 2669 const eq = std.mem.indexOfScalar(u8, trimmed, '=') orelse continue; 2670 if (std.mem.eql(u8, trimmed[0..eq], name)) { 2671 return trimmed[eq + 1 ..]; 2672 } 2673 } 2674 } 2675 return null; 2676 } 2677 2678 fn parseFormField(allocator: std.mem.Allocator, body: []const u8, key: []const u8) !?[]u8 { 2679 var iter = std.mem.splitScalar(u8, body, '&'); 2680 while (iter.next()) |pair| { 2681 const eq = std.mem.indexOfScalar(u8, pair, '=') orelse continue; 2682 if (std.mem.eql(u8, pair[0..eq], key)) { 2683 return try decodeFormValue(allocator, pair[eq + 1 ..]); 2684 } 2685 } 2686 return null; 2687 } 2688 2689 fn readFormBody(request: *std.http.Server.Request, allocator: std.mem.Allocator) ![]u8 { 2690 var buffer: [256]u8 = undefined; 2691 return request.readerExpectNone(&buffer).allocRemaining(allocator, .limited(65536)); 2692 } 2693 2694 fn decodeFormValue(allocator: std.mem.Allocator, encoded: []const u8) ![]u8 { 2695 var out: std.ArrayList(u8) = .empty; 2696 errdefer out.deinit(allocator); 2697 var i: usize = 0; 2698 while (i < encoded.len) : (i += 1) { 2699 switch (encoded[i]) { 2700 '+' => try out.append(allocator, ' '), 2701 '%' => { 2702 if (i + 2 >= encoded.len) return error.InvalidPercentEncoding; 2703 const hi = std.fmt.charToDigit(encoded[i + 1], 16) catch return error.InvalidPercentEncoding; 2704 const lo = std.fmt.charToDigit(encoded[i + 2], 16) catch return error.InvalidPercentEncoding; 2705 try out.append(allocator, hi * 16 + lo); 2706 i += 2; 2707 }, 2708 else => try out.append(allocator, encoded[i]), 2709 } 2710 } 2711 return try out.toOwnedSlice(allocator); 2712 } 2713 2714 // disk-backed web session store. each login mints a random, opaque token 2715 // (not the user's id) that is stored as a file named by the token hex, whose 2716 // contents are the raw user_id bytes. authenticating a request is a lookup of 2717 // the cookie's token; logout deletes the file, revoking the session. there is 2718 // deliberately no expiry — a session lives until logout. form failures use 2719 // files in the flash subdirectory that the redirected GET consumes. the 2720 // directory is cleared whenever the server starts. 2721 pub const SessionStore = struct { 2722 io: std.Io, 2723 dir: std.Io.Dir, 2724 flash_dir: std.Io.Dir, 2725 auto_login: ?[token_hex_len]u8, 2726 2727 pub const token_hex_len = evt.event_id_size * 2; 2728 2729 pub fn init(io: std.Io, data_dir: std.Io.Dir) !SessionStore { 2730 try data_dir.createDirPath(io, "sessions"); 2731 const dir = try data_dir.openDir(io, "sessions", .{}); 2732 errdefer dir.close(io); 2733 try dir.deleteTree(io, "flash"); 2734 try dir.createDirPath(io, "flash"); 2735 const flash_dir = try dir.openDir(io, "flash", .{}); 2736 errdefer flash_dir.close(io); 2737 const auto_login = blk: { 2738 const file = dir.openFile(io, auto_login_name, .{ .mode = .read_only }) catch break :blk null; 2739 defer file.close(io); 2740 var token: [token_hex_len]u8 = undefined; 2741 var storage: [token_hex_len]u8 = undefined; 2742 var reader = file.reader(io, &storage); 2743 reader.interface.readSliceAll(&token) catch break :blk null; 2744 break :blk token; 2745 }; 2746 return .{ .io = io, .dir = dir, .flash_dir = flash_dir, .auto_login = auto_login }; 2747 } 2748 2749 pub fn deinit(self: SessionStore) void { 2750 self.flash_dir.close(self.io); 2751 self.dir.close(self.io); 2752 } 2753 2754 // mint a new session for user_id, returning the token hex to set as the 2755 // cookie value. 2756 pub fn create(self: SessionStore, user_id: *const [evt.event_id_size]u8) ![token_hex_len]u8 { 2757 var token: [evt.event_id_size]u8 = undefined; 2758 self.io.random(&token); 2759 const token_hex = std.fmt.bytesToHex(token, .lower); 2760 const file = try self.dir.createFile(self.io, &token_hex, .{}); 2761 defer file.close(self.io); 2762 try file.writeStreamingAll(self.io, user_id); 2763 return token_hex; 2764 } 2765 2766 fn createFlash(self: SessionStore, allocator: std.mem.Allocator, value: ui.Session.FormFeedback) ![token_hex_len]u8 { 2767 var token: [evt.event_id_size]u8 = undefined; 2768 self.io.random(&token); 2769 const token_hex = std.fmt.bytesToHex(token, .lower); 2770 const file = try self.flash_dir.createFile(self.io, &token_hex, .{}); 2771 errdefer self.flash_dir.deleteFile(self.io, &token_hex) catch {}; 2772 defer file.close(self.io); 2773 2774 var json: std.Io.Writer.Allocating = .init(allocator); 2775 defer json.deinit(); 2776 try std.json.Stringify.value(value, .{}, &json.writer); 2777 try file.writeStreamingAll(self.io, json.written()); 2778 return token_hex; 2779 } 2780 2781 fn takeFlash(self: SessionStore, allocator: std.mem.Allocator, token_hex: []const u8) ?ui.Session.FormFeedback { 2782 if (!isToken(token_hex)) return null; 2783 const file = self.flash_dir.openFile(self.io, token_hex, .{ .mode = .read_only }) catch return null; 2784 defer self.flash_dir.deleteFile(self.io, token_hex) catch {}; 2785 defer file.close(self.io); 2786 2787 var storage: [4096]u8 = undefined; 2788 var reader = file.reader(self.io, &storage); 2789 const bytes = reader.interface.allocRemaining(allocator, .limited(512 * 1024)) catch return null; 2790 return std.json.parseFromSliceLeaky(ui.Session.FormFeedback, allocator, bytes, .{}) catch null; 2791 } 2792 2793 // resolve a cookie's token to its user_id. returns false (logged out) for a 2794 // missing, malformed, or unknown token. 2795 pub fn lookup(self: SessionStore, token_hex: []const u8, out: *[evt.event_id_size]u8) bool { 2796 if (!isToken(token_hex)) return false; 2797 const file = self.dir.openFile(self.io, token_hex, .{ .mode = .read_only }) catch return false; 2798 defer file.close(self.io); 2799 var storage: [evt.event_id_size]u8 = undefined; 2800 var file_reader = file.reader(self.io, &storage); 2801 file_reader.interface.readSliceAll(out) catch return false; 2802 return true; 2803 } 2804 2805 // revoke a session. a no-op for a missing or malformed token. 2806 pub fn remove(self: SessionStore, token_hex: []const u8) void { 2807 if (!isToken(token_hex)) return; 2808 self.dir.deleteFile(self.io, token_hex) catch {}; 2809 } 2810 2811 // leave `token_hex`'s session for visitors arriving without one. only the 2812 // `try` fixture writes one. the name can't collide with a session token. 2813 pub fn offerAutoLogin(self: SessionStore, token_hex: *const [token_hex_len]u8) !void { 2814 const file = try self.dir.createFile(self.io, auto_login_name, .{}); 2815 defer file.close(self.io); 2816 try file.writeStreamingAll(self.io, token_hex); 2817 } 2818 2819 pub fn autoLogin(self: SessionStore, out: *[token_hex_len]u8) bool { 2820 out.* = self.auto_login orelse return false; 2821 return true; 2822 } 2823 2824 const auto_login_name = "auto-login"; 2825 2826 // a token is exactly token_hex_len hex chars. validating before using the 2827 // value as a path keeps attacker-supplied cookies from escaping the 2828 // sessions dir (e.g. via "/" or ".." bytes). 2829 fn isToken(token_hex: []const u8) bool { 2830 if (token_hex.len != token_hex_len) return false; 2831 for (token_hex) |c| if (!std.ascii.isHex(c)) return false; 2832 return true; 2833 } 2834 }; 2835