╭─────────────╮ │scroll to top│ ╰─────────────╯ ╭ web.zig ──────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ╰───────────────────────────────────────────────────────────────╯
🬐 🬠 🬞🬂🬏 🬟 🬑 🬟 🬑 ╭master╮ master haxy: 🬋🬋🬋 🬋🬋🬋 🬋 🬋 │files │ commits refs discuss issues patches new login 🬐 🬠 🬐 🬠 🬑 🬟 🬰 ╰──────╯ (716) user
╭ find file ─ ─ ─ ─ ─ ─ ─ ─ ─ ─╮ ╭────╮ ╭ 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 notify.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 │ ╰─────────────────────────────────╯
465 break :blk try arena.allocator().print(local_flash_cookie ++ "=" ++ local_required_title_prefix ++ "{s}; Path=/; HttpOnly; SameSite=Strict", .{@tagName(std.meta.activeTag(feedback))}); 466 }, 467 }; 468 try request.respond("", .{ 469 .status = .see_other, 470 .extra_headers = &.{ 471 .{ .name = "location", .value = location }, 472 .{ .name = "set-cookie", .value = cookie }, 473 }, 474 }); 475 }, 476 }; 477 } 478 479 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 { 480 return switch (kind) { 481 .issue => .{ .issue = .{ .failure = .required_title, .fields = .{ 482 .title = title, 483 .labels = labels, 484 .description = description, 485 } } }, 486 .patch => patchFeedback(.required_title, title, labels, description, target_branch, source_branch), 487 .discuss => .{ .discussion = .{ .failure = .required_title, .fields = .{ 488 .title = title, 489 .labels = labels, 490 .description = description, 491 } } }, 492 else => unreachable, 493 }; 494 } 495 496 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 { 497 return .{ .patch = .{ .failure = failure, .fields = .{ 498 .title = title, 499 .labels = labels, 500 .description = description, 501 .target_branch = target_branch, 502 .source_branch = source_branch orelse "", 503 .source_kind = if (source_branch != null) .branch else .fork, 504 } } }; 505 } 506 507 // the root of the page whose user tab route is `base` 508 fn userTabPageRoot(arena: *std.heap.ArenaAllocator, base: []const u8) ![]const u8 { 509 const route = ui.RoutablePage.fromUrl(base) orelse return "/"; 510 return route.pageRoot().toUrl(arena); 511 } 512 513 fn handleLogout(request: *std.http.Server.Request, allocator: std.mem.Allocator, base: []const u8, session_store: SessionStore) !void { 514 // revoke the session server-side so the cookie is dead for anyone holding 515 // a copy, not just this browser. 516 if (getCookieValue(request, cookie_name)) |token| session_store.remove(token); 517 var arena = std.heap.ArenaAllocator.init(allocator); 518 defer arena.deinit(); 519 // return to the page whose user tab the logout came from 520 const location = try userTabPageRoot(&arena, base); 521 // close the connection instead of keeping it alive: we don't read the 522 // request body, and respond()'s keep-alive path would otherwise try to 523 // discard it — which asserts on a bodyless POST that carries no 524 // content-length, and would block on one with no framing at all. a logout 525 // is just a redirect, so the browser reconnects for the follow-up GET. 526 try request.respond("", .{ 527 .status = .see_other, 528 .keep_alive = false, 529 .extra_headers = &.{ 530 .{ .name = "location", .value = location }, 531 .{ .name = "set-cookie", .value = cookie_name ++ "=; Path=/; HttpOnly; SameSite=Strict; Max-Age=0" }, 532 }, 533 }); 534 } 535 536 // the actor for a write to the repo `repo_base` names with at least `min_role` 537 // and in the `thread_kind` tab when there is one, or null once the refusal has 538 // been sent. local mode always writes. 539 fn authorizeWrite( 540 io: std.Io, 541 allocator: std.mem.Allocator, 542 arena: *std.heap.ArenaAllocator, 543 request: *std.http.Server.Request, 544 host: Host, 545 repo_base: []const u8, 546 min_role: evt.Repo.Role, 547 thread_kind: ?evt.EventKind, 548 ) !?ui.Actor { 549 const server = switch (host) { 550 .server => |server| server, 551 .local => |src| return .{ .author = try ui.localAuthor(src, io, allocator, arena), .role = .owner }, 552 }; 553 const authorization: ui.Authorization = blk: { 554 const user_id = requestUserId(request, server.session_store) orelse break :blk .login_required; 555 556 const identity = repoBaseIdentity(repo_base) orelse break :blk .repo_not_found; 557 558 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 559 defer admin_repo.deinit(io, allocator); 560 const moment = try evt.currentMoment(evt.admin_repo_opts, &admin_repo); 561 break :blk try ui.authorizeUser(io, moment, arena, server.users_dir, user_id, identity, min_role, thread_kind); 562 }; 563 switch (authorization) { 564 .actor => |actor| return actor, 565 .login_required => try respondLoginRequired(request), 566 .repo_not_found => try respondRepoNotFound(request), 567 .forbidden => try respondForbidden(request), 568 } 569 return null; 570 } 571 572 // whether the request may read the repo `repo_base` names. local mode always 573 // may. 574 fn mayRead( 575 io: std.Io, 576 allocator: std.mem.Allocator, 577 request: *std.http.Server.Request, 578 host: Host, 579 repo_base: []const u8, 580 ) !bool { 581 const server = switch (host) { 582 .server => |server| server, 583 .local => return true, 584 }; 585 const identity = repoBaseIdentity(repo_base) orelse return false; 586 587 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 588 defer admin_repo.deinit(io, allocator); 589 var arena = std.heap.ArenaAllocator.init(allocator); 590 defer arena.deinit(); 591 const moment = try evt.currentMoment(evt.admin_repo_opts, &admin_repo); 592 const user_id = blk: { 593 const id = requestUserId(request, server.session_store) orelse break :blk null; 594 break :blk if (try ui.activeUser(moment, &arena, id) != null) id else null; 595 }; 596 const owner_repo = evt.parseOwnerRepoPath(identity) orelse return false; 597 const repo = (try evt.readRepoByOwnerAndName(io, allocator, &arena, moment, server.users_dir, owner_repo.owner, owner_repo.name, user_id)) orelse return false; 598 return repo.role != null; 599 } 600 601 // the logged-in user the request's session cookie names 602 fn requestUserId(request: *std.http.Server.Request, session_store: SessionStore) ?[evt.event_id_size]u8 { 603 const token = getCookieValue(request, cookie_name) orelse return null; 604 var user_id: [evt.event_id_size]u8 = undefined; 605 return if (session_store.lookup(token, &user_id)) user_id else null; 606 } 607 608 // refuse a write from a request with no logged-in user. the body goes unread, 609 // so the connection closes. 610 fn respondLoginRequired(request: *std.http.Server.Request) !void { 611 try request.respond("log in to make changes", .{ 612 .status = .forbidden, 613 .keep_alive = false, 614 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 615 }); 616 } 617 618 // refuse a write the user's role in the repo doesn't allow 619 fn respondForbidden(request: *std.http.Server.Request) !void { 620 try request.respond("you don't have permission to do that", .{ 621 .status = .forbidden, 622 .keep_alive = false, 623 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 624 }); 625 } 626 627 fn respondRepoNotFound(request: *std.http.Server.Request) !void { 628 try request.respond("repo not found", .{ 629 .status = .not_found, 630 .keep_alive = false, 631 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 632 }); 633 } 634 635 // new actions share a suffix; the base identifies whether the form creates a 636 // thread or comment. 637 fn handleNew( 638 io: std.Io, 639 request: *std.http.Server.Request, 640 allocator: std.mem.Allocator, 641 base: []const u8, 642 host: Host, 643 ) !void { 644 if (commentBaseParts(host, base) != null) return handleCommentNew(io, request, allocator, base, host); 645 646 const issues_suffix = "/issues"; 647 if (std.mem.endsWith(u8, base, issues_suffix)) 648 return handleThreadNew(io, request, allocator, base[0 .. base.len - issues_suffix.len], host, .issue); 649 const discussions_suffix = "/discussions"; 650 if (std.mem.endsWith(u8, base, discussions_suffix)) 651 return handleThreadNew(io, request, allocator, base[0 .. base.len - discussions_suffix.len], host, .discuss); 652 const patches_suffix = "/patches"; 653 if (std.mem.endsWith(u8, base, patches_suffix)) 654 return handleThreadNew(io, request, allocator, base[0 .. base.len - patches_suffix.len], host, .patch); 655 656 try request.respond("new event target not found", .{ 657 .status = .not_found, 658 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 659 }); 660 } 661 662 // create a repo for the logged-in user and redirect to it. a failure goes 663 // back to the new-repo page that posted the form. 664 fn handleRepoNew( 665 io: std.Io, 666 request: *std.http.Server.Request, 667 allocator: std.mem.Allocator, 668 form_location: []const u8, 669 admin_repo_path: []const u8, 670 users_dir: []const u8, 671 session_store: SessionStore, 672 ) !void { 673 const user_id = requestUserId(request, session_store) orelse return respondLoginRequired(request); 674 var arena = std.heap.ArenaAllocator.init(allocator); 675 defer arena.deinit(); 676 const user = blk: { 677 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = admin_repo_path }); 678 defer admin_repo.deinit(io, allocator); 679 const moment = try evt.currentMoment(evt.admin_repo_opts, &admin_repo); 680 break :blk (try ui.activeUser(moment, &arena, user_id)) orelse return respondLoginRequired(request); 681 }; 682 683 const body = try readFormBody(request, allocator); 684 defer allocator.free(body); 685 const name = (try parseFormField(allocator, body, "name")) orelse try allocator.dupe(u8, ""); 686 defer allocator.free(name); 687 const description = (try parseFormField(allocator, body, "description")) orelse try allocator.dupe(u8, ""); 688 defer allocator.free(description); 689 const hash_value = (try parseFormField(allocator, body, "hash")) orelse try allocator.dupe(u8, ""); 690 defer allocator.free(hash_value); 691 const access_value = (try parseFormField(allocator, body, "access")) orelse try allocator.dupe(u8, ""); 692 defer allocator.free(access_value); 693 const bad_request: std.http.Server.Request.RespondOptions = .{ .status = .bad_request, .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }} }; 694 const hash_kind = std.meta.stringToEnum(hash.HashKind, hash_value) orelse return request.respond("invalid hash", bad_request); 695 const access = std.meta.stringToEnum(evt.Repo.Access, access_value) orelse return request.respond("invalid access", bad_request); 696 697 _ = evt.createRepo(io, allocator, users_dir, &user_id, .{ .name = user.event.name, .email = user.event.email }, name, description, access, hash_kind) catch |err| { 698 const failure = ui.Session.FormFeedback.RepoFailure.fromError(err) orelse return err; 699 return respondFormFailure(request, allocator, session_store, form_location, .{ .repo = .{ .failure = failure, .fields = .{ 700 .name = name, 701 .description = description, 702 .hash = hash_kind, 703 .access = access, 704 } } }); 705 }; 706 707 const location = try allocator.print("/{s}:{s}", .{ user.event.name, name }); 708 defer allocator.free(location); 709 try request.respond("", .{ 710 .status = .see_other, 711 .extra_headers = &.{.{ .name = "location", .value = location }}, 712 }); 713 } 714 715 // change the repo the settings url `form_location` names as its owner, then 716 // redirect to its settings under its new name. a failure goes back to the 717 // settings page. 718 fn handleRepoSettings( 719 io: std.Io, 720 request: *std.http.Server.Request, 721 allocator: std.mem.Allocator, 722 form_location: []const u8, 723 host: Host, 724 ) !void { 725 const server = switch (host) { 726 .server => |server| server, 727 .local => return respondRepoNotFound(request), 728 }; 729 const route = routeFromUrl(host, form_location) orelse return respondRepoNotFound(request); 730 if (route != .repo_settings) return respondRepoNotFound(request); 731 var arena = std.heap.ArenaAllocator.init(allocator); 732 defer arena.deinit(); 733 const repo_base = try arena.allocator().print("/{s}", .{route.repo_settings.slice()}); 734 const actor = (try authorizeWrite(io, allocator, &arena, request, host, repo_base, .owner, null)) orelse return; 735 736 const body = try readFormBody(request, allocator); 737 defer allocator.free(body); 738 const name = (try parseFormField(allocator, body, "name")) orelse try allocator.dupe(u8, ""); 739 defer allocator.free(name); 740 const description = (try parseFormField(allocator, body, "description")) orelse try allocator.dupe(u8, ""); 741 defer allocator.free(description); 742 const access_value = (try parseFormField(allocator, body, "access")) orelse try allocator.dupe(u8, ""); 743 defer allocator.free(access_value); 744 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" }} }); 745 var roles: [3]?evt.Repo.Role = undefined; 746 for (&roles, [_][]const u8{ "discuss_role", "issue_role", "patch_role" }) |*role, field| { 747 const role_value = (try parseFormField(allocator, body, field)) orelse try allocator.dupe(u8, ""); 748 defer allocator.free(role_value); 749 role.* = ui.Repo.Settings.labelRole(role_value) catch return request.respond("invalid role", .{ .status = .bad_request, .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }} }); 750 } 751 const discuss_role, const issue_role, const patch_role = roles; 752 753 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) { 754 error.NotFound => return respondRepoNotFound(request), 755 else => { 756 const failure = ui.Session.FormFeedback.RepoFailure.fromError(err) orelse return err; 757 return respondFormFailure(request, allocator, server.session_store, form_location, .{ .repo_settings = .{ .failure = failure, .fields = .{ 758 .name = name, 759 .description = description, 760 .access = access, 761 .discuss_role = discuss_role, 762 .issue_role = issue_role, 763 .patch_role = patch_role, 764 } } }); 765 }, 766 }; 767 768 try request.respond("", .{ 769 .status = .see_other, 770 .extra_headers = &.{.{ .name = "location", .value = try updated.toUrl(&arena) }}, 771 }); 772 } 773 774 // act on a user's role in the repo the members url `base` names, as one of its 775 // owners, then redirect back to the list. the add form names the user in its 776 // body and the row forms in the url. 777 fn handleMembers(io: std.Io, request: *std.http.Server.Request, allocator: std.mem.Allocator, base: []const u8, host: Host, action: ui.Repo.Members.Action) !void { 778 const server = switch (host) { 779 .server => |server| server, 780 .local => return respondRepoNotFound(request), 781 }; 782 const route = routeFromUrl(host, base) orelse return respondRepoNotFound(request); 783 if (route != .repo_members) return respondRepoNotFound(request); 784 const target = route.repo_members; 785 var arena = std.heap.ArenaAllocator.init(allocator); 786 defer arena.deinit(); 787 const identity = target.name.slice(); 788 const actor = (try authorizeWrite(io, allocator, &arena, request, host, try arena.allocator().print("/{s}", .{identity}), .owner, null)) orelse return; 789 790 const name = switch (action) { 791 .grant => blk: { 792 const body = try readFormBody(request, allocator); 793 defer allocator.free(body); 794 break :blk (try parseFormField(arena.allocator(), body, "name")) orelse ""; 795 }, 796 .revoke, .promote, .demote => if (target.user.len != 0) target.user.slice() else return respondRepoNotFound(request), 797 }; 798 799 const failure = blk: { 800 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 801 defer admin_repo.deinit(io, allocator); 802 const moment = try evt.currentMoment(evt.admin_repo_opts, &admin_repo); 803 break :blk ui.Repo.Members.perform(io, allocator, moment, server.users_dir, actor, identity, action, name) catch |err| switch (err) { 804 error.NotFound, error.EventNotFound => return respondRepoNotFound(request), 805 else => return err, 806 }; 807 }; 808 if (failure) |value| { 809 const location = try (ui.RoutablePage.repoMembersRoute(identity, target.start) orelse return error.RouteTooLong).toUrl(&arena); 810 return respondFormFailure(request, allocator, server.session_store, location, .{ .repo_members = .{ .failure = value, .name = name } }); 811 } 812 const location = try (ui.Repo.Members.landingRoute(identity, target.start, actor, action, name) orelse return error.RouteTooLong).toUrl(&arena); 813 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = location }} }); 814 } 815 816 // protect or unprotect a branch of the repo the branches url `base` names, as 817 // one of its owners, then redirect back to the list. the add form names the 818 // branch in its body and the row forms in the url. 819 fn handleBranches(io: std.Io, request: *std.http.Server.Request, allocator: std.mem.Allocator, base: []const u8, host: Host, action: ui.Repo.Branches.Action) !void { 820 const server = switch (host) { 821 .server => |server| server, 822 .local => return respondRepoNotFound(request), 823 }; 824 const route = routeFromUrl(host, base) orelse return respondRepoNotFound(request); 825 if (route != .repo_branches) return respondRepoNotFound(request); 826 const target = route.repo_branches; 827 var arena = std.heap.ArenaAllocator.init(allocator); 828 defer arena.deinit(); 829 const identity = target.name.slice(); 830 const actor = (try authorizeWrite(io, allocator, &arena, request, host, try arena.allocator().print("/{s}", .{identity}), .owner, null)) orelse return; 831 832 const branch = switch (action) { 833 .protect => blk: { 834 const body = try readFormBody(request, allocator); 835 defer allocator.free(body); 836 break :blk (try parseFormField(arena.allocator(), body, "name")) orelse ""; 837 }, 838 .unprotect => if (target.branch.len != 0) std.Uri.percentDecodeInPlace(try arena.allocator().dupe(u8, target.branch.slice())) else return respondRepoNotFound(request), 839 }; 840 841 const failure = ui.Repo.Branches.perform(io, allocator, server.users_dir, actor, identity, action, branch) catch |err| switch (err) { 842 error.NotFound => return respondRepoNotFound(request), 843 else => return err, 844 }; 845 const location = try (ui.RoutablePage.repoBranchesRoute(identity) orelse return error.RouteTooLong).toUrl(&arena); 846 if (failure) |value| return respondFormFailure(request, allocator, server.session_store, location, .{ .repo_branches = .{ .failure = value, .name = branch } }); 847 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = location }} }); 848 } 849 850 // create a user, log them in, and redirect to their page. a failure goes 851 // back to the new-user page that posted the form. 852 fn handleUserNew( 853 io: std.Io, 854 request: *std.http.Server.Request, 855 allocator: std.mem.Allocator, 856 form_location: []const u8, 857 admin_repo_path: []const u8, 858 users_dir: []const u8, 859 session_store: SessionStore, 860 ) !void { 861 if (requestUserId(request, session_store) != null) { 862 return request.respond("log out to create a user", .{ 863 .status = .forbidden, 864 .keep_alive = false, 865 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 866 }); 867 } 868 869 const body = try readFormBody(request, allocator); 870 defer allocator.free(body); 871 const name = (try parseFormField(allocator, body, "name")) orelse try allocator.dupe(u8, ""); 872 defer allocator.free(name); 873 const email = (try parseFormField(allocator, body, "email")) orelse try allocator.dupe(u8, ""); 874 defer allocator.free(email); 875 const password = (try parseFormField(allocator, body, "password")) orelse try allocator.dupe(u8, ""); 876 defer allocator.free(password); 877 const password_again = (try parseFormField(allocator, body, "password_again")) orelse try allocator.dupe(u8, ""); 878 defer allocator.free(password_again); 879 880 const user_id = blk: { 881 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = admin_repo_path }); 882 defer admin_repo.deinit(io, allocator); 883 break :blk evt.createUser(io, allocator, users_dir, &admin_repo, name, email, password, password_again) catch |err| { 884 const failure = ui.Session.FormFeedback.UserFailure.fromError(err) orelse return err; 885 return respondFormFailure(request, allocator, session_store, form_location, .{ .user = .{ .failure = failure, .fields = .{ .name = name, .email = email } } }); 886 }; 887 }; 888 889 const token = try session_store.create(&user_id); 890 var cookie_buf: [256]u8 = undefined; 891 const cookie = try std.fmt.bufPrint(&cookie_buf, session_cookie_fmt, .{token}); 892 const location = try allocator.print("/{s}", .{name}); 893 defer allocator.free(location); 894 try request.respond("", .{ 895 .status = .see_other, 896 .extra_headers = &.{ 897 .{ .name = "location", .value = location }, 898 .{ .name = "set-cookie", .value = cookie }, 899 }, 900 }); 901 } 902 903 // change the logged-in user's settings, then return to the settings tab that 904 // posted the form, which a failure also goes back to. 905 fn handleUserSettings( 906 io: std.Io, 907 request: *std.http.Server.Request, 908 allocator: std.mem.Allocator, 909 form_location: []const u8, 910 admin_repo_path: []const u8, 911 users_dir: []const u8, 912 session_store: SessionStore, 913 ) !void { 914 const user_id = requestUserId(request, session_store) orelse return respondLoginRequired(request); 915 916 const body = try readFormBody(request, allocator); 917 defer allocator.free(body); 918 const email = (try parseFormField(allocator, body, "email")) orelse try allocator.dupe(u8, ""); 919 defer allocator.free(email); 920 const current_password = (try parseFormField(allocator, body, "current_password")) orelse try allocator.dupe(u8, ""); 921 defer allocator.free(current_password); 922 const new_password = (try parseFormField(allocator, body, "new_password")) orelse try allocator.dupe(u8, ""); 923 defer allocator.free(new_password); 924 const new_password_again = (try parseFormField(allocator, body, "new_password_again")) orelse try allocator.dupe(u8, ""); 925 defer allocator.free(new_password_again); 926 927 { 928 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = admin_repo_path }); 929 defer admin_repo.deinit(io, allocator); 930 evt.updateUser(io, allocator, users_dir, &admin_repo, &user_id, email, current_password, new_password, new_password_again) catch |err| switch (err) { 931 error.NotFound => return respondLoginRequired(request), 932 else => { 933 const failure = ui.Session.FormFeedback.UserFailure.fromError(err) orelse return err; 934 return respondFormFailure(request, allocator, session_store, form_location, .{ .user_settings = .{ .failure = failure, .fields = .{ .email = email } } }); 935 }, 936 }; 937 } 938 939 try request.respond("", .{ 940 .status = .see_other, 941 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 942 }); 943 } 944 945 // add one of the logged-in user's ssh keys, then return to the ssh keys tab 946 // that posted the form, which a failure also goes back to. 947 fn handleUserKeyAdd( 948 io: std.Io, 949 request: *std.http.Server.Request, 950 allocator: std.mem.Allocator, 951 form_location: []const u8, 952 admin_repo_path: []const u8, 953 users_dir: []const u8, 954 session_store: SessionStore, 955 ) !void { 956 const user_id = requestUserId(request, session_store) orelse return respondLoginRequired(request); 957 958 const body = try readFormBody(request, allocator); 959 defer allocator.free(body); 960 const key = (try parseFormField(allocator, body, "key")) orelse try allocator.dupe(u8, ""); 961 defer allocator.free(key); 962 963 { 964 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = admin_repo_path }); 965 defer admin_repo.deinit(io, allocator); 966 evt.addUserKey(io, allocator, users_dir, &admin_repo, &user_id, key) catch |err| switch (err) { 967 error.NotFound => return respondLoginRequired(request), 968 else => { 969 const failure = ui.Session.FormFeedback.KeyFailure.fromError(err) orelse return err; 970 return respondFormFailure(request, allocator, session_store, form_location, .{ .user_keys = .{ .failure = failure, .key = key } }); 971 }, 972 }; 973 } 974 975 try request.respond("", .{ 976 .status = .see_other, 977 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 978 }); 979 } 980 981 // remove the logged-in user's ssh key the confirmation url names, then return 982 // to the ssh keys tab 983 fn handleUserKeyRemove( 984 io: std.Io, 985 request: *std.http.Server.Request, 986 allocator: std.mem.Allocator, 987 base: []const u8, 988 admin_repo_path: []const u8, 989 users_dir: []const u8, 990 session_store: SessionStore, 991 ) !void { 992 const user_id = requestUserId(request, session_store) orelse return respondLoginRequired(request); 993 const route = ui.RoutablePage.fromUrl(base) orelse return respondKeyNotFound(request); 994 const tab = route.userTab(); 995 if (tab.view != .keys or tab.key.len != evt.User.fingerprint_len) return respondKeyNotFound(request); 996 997 { 998 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = admin_repo_path }); 999 defer admin_repo.deinit(io, allocator); 1000 evt.removeUserKey(io, allocator, users_dir, &admin_repo, &user_id, &tab.key.bytes) catch |err| switch (err) { 1001 error.NotFound => return respondLoginRequired(request), 1002 else => return err, 1003 }; 1004 } 1005 1006 var arena = std.heap.ArenaAllocator.init(allocator); 1007 defer arena.deinit(); 1008 const location = try route.withUserTab(.{ .view = .keys }).toUrl(&arena); 1009 try request.respond("", .{ 1010 .status = .see_other, 1011 .extra_headers = &.{.{ .name = "location", .value = location }}, 1012 }); 1013 } 1014 1015 // delete the repo, fork or user the delete tab url `base` names, as its main 1016 // owner. a failure goes back to the tab. 1017 fn handleDelete(io: std.Io, request: *std.http.Server.Request, allocator: std.mem.Allocator, base: []const u8, server: @FieldType(Host, "server")) !void { 1018 const user_id = requestUserId(request, server.session_store) orelse return respondLoginRequired(request); 1019 var arena = std.heap.ArenaAllocator.init(allocator); 1020 defer arena.deinit(); 1021 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 1022 defer admin_repo.deinit(io, allocator); 1023 const user = (try ui.activeUser(try evt.currentMoment(evt.admin_repo_opts, &admin_repo), &arena, user_id)) orelse return respondLoginRequired(request); 1024 1025 const route = ui.RoutablePage.fromUrl(base) orelse return respondDeleteNotFound(request); 1026 const target: ui.Delete.Target = switch (route) { 1027 .repo_delete => |*name| .{ .repo = name.slice() }, 1028 .fork_delete => |*f| .{ .fork = .{ .identity = f.name.slice(), .id = f.id.bytes } }, 1029 else => if (route.userTab().view == .delete) .{ .user = user.event.name } else return respondDeleteNotFound(request), 1030 }; 1031 1032 const body = try readFormBody(request, allocator); 1033 defer allocator.free(body); 1034 const confirm = (try parseFormField(arena.allocator(), body, "confirm")) orelse ""; 1035 const password = (try parseFormField(arena.allocator(), body, "password")) orelse ""; 1036 1037 const failure = ui.Delete.perform(io, allocator, server.users_dir, &admin_repo, user_id, target, confirm, password) catch |err| switch (err) { 1038 error.NotFound => return respondDeleteNotFound(request), 1039 else => return err, 1040 }; 1041 if (failure) |value| return respondFormFailure(request, allocator, server.session_store, base, .{ .delete = .{ .failure = value, .target = std.meta.activeTag(target), .confirm = confirm } }); 1042 1043 switch (target) { 1044 .repo, .fork => { 1045 const location = try arena.allocator().print("/{s}", .{user.event.name}); 1046 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = location }} }); 1047 }, 1048 // log the deleted user out, as a logout does 1049 .user => { 1050 if (getCookieValue(request, cookie_name)) |token| server.session_store.remove(token); 1051 try request.respond("", .{ 1052 .status = .see_other, 1053 .keep_alive = false, 1054 .extra_headers = &.{ 1055 .{ .name = "location", .value = "/" }, 1056 .{ .name = "set-cookie", .value = cookie_name ++ "=; Path=/; HttpOnly; SameSite=Strict; Max-Age=0" }, 1057 }, 1058 }); 1059 }, 1060 } 1061 } 1062 1063 fn respondDeleteNotFound(request: *std.http.Server.Request) !void { 1064 try request.respond("nothing to delete", .{ 1065 .status = .not_found, 1066 .keep_alive = false, 1067 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1068 }); 1069 } 1070 1071 fn respondKeyNotFound(request: *std.http.Server.Request) !void { 1072 try request.respond("ssh key not found", .{ 1073 .status = .not_found, 1074 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1075 }); 1076 } 1077 1078 // create a thread in the repo the form's page names and redirect to it. 1079 fn handleThreadNew( 1080 io: std.Io, 1081 request: *std.http.Server.Request, 1082 allocator: std.mem.Allocator, 1083 base: []const u8, 1084 host: Host, 1085 kind: evt.EventKind, 1086 ) !void { 1087 var author_arena = std.heap.ArenaAllocator.init(allocator); 1088 defer author_arena.deinit(); 1089 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, base, .read, kind)) orelse return; 1090 const author = actor.author; 1091 const body = try readFormBody(request, allocator); 1092 defer allocator.free(body); 1093 1094 const title = (try parseFormField(allocator, body, "title")) orelse try allocator.dupe(u8, ""); 1095 defer allocator.free(title); 1096 const labels = (try parseFormField(allocator, body, "labels")) orelse try allocator.dupe(u8, ""); 1097 defer allocator.free(labels); 1098 const description_crlf = (try parseFormField(allocator, body, "description")) orelse try allocator.dupe(u8, ""); 1099 defer allocator.free(description_crlf); 1100 // form submission normalizes textarea line breaks to CRLF; store plain 1101 // newlines so the text renders the same on every host 1102 const description = try std.mem.replaceOwned(u8, allocator, description_crlf, "\r\n", "\n"); 1103 defer allocator.free(description); 1104 const target_branch = (try parseFormField(allocator, body, "target_branch")) orelse try allocator.dupe(u8, ""); 1105 defer allocator.free(target_branch); 1106 1107 const source_branch = if (kind == .patch) try parseFormField(allocator, body, "source_branch") else null; 1108 defer if (source_branch) |branch| allocator.free(branch); 1109 1110 const valid = switch (kind) { 1111 .issue => evt.Issue.fieldsValid(title, labels), 1112 .patch => evt.Patch.fieldsValid(title, labels), 1113 .discuss => evt.Discussion.fieldsValid(title, labels), 1114 else => unreachable, 1115 }; 1116 if (!valid) { 1117 const list_name: []const u8 = switch (kind) { 1118 .issue => "issues", 1119 .patch => "patches", 1120 .discuss => "discussions", 1121 else => unreachable, 1122 }; 1123 const form_location = try allocator.print("{s}/{s}/new", .{ base, list_name }); 1124 defer allocator.free(form_location); 1125 if (!evt.titleValid(title)) { 1126 return respondThreadFormFailure(request, allocator, host, form_location, requiredTitleFeedback(kind, title, labels, description, target_branch, source_branch)); 1127 } 1128 try request.respond("", .{ 1129 .status = .see_other, 1130 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 1131 }); 1132 return; 1133 } 1134 1135 var id_bytes: [evt.event_id_size]u8 = undefined; 1136 io.random(&id_bytes); 1137 const event_id_hex = std.fmt.bytesToHex(id_bytes, .lower); 1138 1139 const not_found = "repo not found"; 1140 const request_repo = (try requestRepoSource(io, allocator, host, base)) orelse { 1141 try request.respond(not_found, .{ 1142 .status = .not_found, 1143 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1144 }); 1145 return; 1146 }; 1147 defer request_repo.deinit(allocator); 1148 const source = request_repo.source; 1149 if (kind == .patch and source_branch == null) { 1150 const server = switch (host) { 1151 .server => |server| server, 1152 .local => return respondRemoveNotFound(request), 1153 }; 1154 const user_id = actor.user_id orelse return respondLoginRequired(request); 1155 if (!evt.Patch.branchValid(target_branch) or !try request_repo.source.hasBranch(io, allocator, target_branch)) { 1156 const form_location = try allocator.print("{s}/patches/new", .{base}); 1157 defer allocator.free(form_location); 1158 return respondThreadFormFailure(request, allocator, host, form_location, patchFeedback(.invalid_target_branch, title, labels, description, target_branch, null)); 1159 } 1160 const repo_id = evt.parseEventId(std.Io.Dir.path.basename(request_repo.source.path)) catch return respondRemoveNotFound(request); 1161 const repo_user_id = actor.repo_user_id orelse unreachable; 1162 const identity = ui.RoutablePage.RepoIdentity.parse(repoBaseIdentity(base) orelse return respondRemoveNotFound(request)) orelse return respondRemoveNotFound(request); 1163 const fork_path = try fork.create(.{}, io, allocator, server.users_dir, .{ 1164 .id = event_id_hex, 1165 .user_id = user_id, 1166 .repo_id = repo_id, 1167 .repo_user_id = repo_user_id, 1168 .repo_name = identity.name, 1169 .title = title, 1170 .description = description, 1171 .labels = labels, 1172 .target_branch = target_branch, 1173 .author = author, 1174 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 1175 }); 1176 defer allocator.free(fork_path); 1177 } else { 1178 const event = evt.EventWithId{ 1179 .id = event_id_hex, 1180 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 1181 .author = author, 1182 .event = switch (kind) { 1183 .issue => .{ .issue = .{ .title = title, .description = description, .labels = labels } }, 1184 .patch => .{ .patch = .{ .title = title, .description = description, .labels = labels, .target_branch = target_branch, .source_branch = source_branch } }, 1185 .discuss => .{ .discuss = .{ .title = title, .description = description, .labels = labels } }, 1186 else => unreachable, 1187 }, 1188 }; 1189 1190 switch (source.repo_kind) { 1191 inline else => |repo_kind| { 1192 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1193 defer any_repo.deinit(io, allocator); 1194 switch (any_repo) { 1195 inline else => |*repo| { 1196 const result = if (kind == .patch) 1197 pch.writeBranchPatch(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, event_id_hex, event.event.patch orelse unreachable, null, author) 1198 else 1199 evt.consume(host.event(), .repo, repo_kind, repo.self_repo_opts, io, allocator, repo, evt.events_ref, &.{event}); 1200 result catch |err| { 1201 if (kind != .patch) return err; 1202 const failure = ui.Session.FormFeedback.PatchFailure.fromError(err) orelse return err; 1203 const form_location = try allocator.print("{s}/patches/new", .{base}); 1204 defer allocator.free(form_location); 1205 return respondThreadFormFailure(request, allocator, host, form_location, patchFeedback(failure, title, labels, description, target_branch, source_branch)); 1206 }; 1207 }, 1208 } 1209 }, 1210 } 1211 } 1212 1213 const location = try allocator.print("{s}/{s}:{s}", .{ base, @tagName(kind), &event_id_hex }); 1214 defer allocator.free(location); 1215 try request.respond("", .{ 1216 .status = .see_other, 1217 .extra_headers = &.{.{ .name = "location", .value = location }}, 1218 }); 1219 } 1220 1221 const CommentBaseParts = struct { 1222 repo_base: []const u8, 1223 thread_kind: evt.EventKind, 1224 thread_id: [evt.event_id_size]u8, 1225 comment_id: ?[evt.event_id_size]u8, 1226 }; 1227 1228 fn commentBaseParts(host: Host, base: []const u8) ?CommentBaseParts { 1229 const route = routeFromUrl(host, base) orelse return null; 1230 const identity, const thread_kind, const thread_hex, const comment_hex = switch (route) { 1231 .repo_issues => |*issue| .{ issue.name.slice(), evt.EventKind.issue, issue.selected.slice(), issue.comment.slice() }, 1232 .repo_patches => |*patch| .{ patch.name.slice(), evt.EventKind.patch, patch.selected.slice(), patch.comment.slice() }, 1233 .repo_discussions => |*discussion| .{ discussion.name.slice(), evt.EventKind.discuss, discussion.selected.slice(), discussion.comment.slice() }, 1234 else => return null, 1235 }; 1236 const thread_id = evt.parseEventId(thread_hex) catch return null; 1237 const comment_id = if (comment_hex.len == 0) null else evt.parseEventId(comment_hex) catch return null; 1238 const repo_base_len = if (identity.len == 0) 0 else "/".len + identity.len; 1239 return .{ .repo_base = base[0..repo_base_len], .thread_kind = thread_kind, .thread_id = thread_id, .comment_id = comment_id }; 1240 } 1241 1242 fn handlePatchPublish( 1243 io: std.Io, 1244 request: *std.http.Server.Request, 1245 allocator: std.mem.Allocator, 1246 base: []const u8, 1247 host: Host, 1248 ) !void { 1249 const parts = commentBaseParts(host, base) orelse return respondRemoveNotFound(request); 1250 if (parts.thread_kind != .patch or parts.comment_id != null) return respondRemoveNotFound(request); 1251 const server = switch (host) { 1252 .server => |server| server, 1253 .local => return respondRemoveNotFound(request), 1254 }; 1255 var author_arena = std.heap.ArenaAllocator.init(allocator); 1256 defer author_arena.deinit(); 1257 // only the draft's author may publish it, which publish checks 1258 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, .patch)) orelse return; 1259 const user_id = actor.user_id orelse return respondLoginRequired(request); 1260 const author = actor.author; 1261 1262 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1263 defer request_repo.deinit(allocator); 1264 const repo_id = evt.parseEventId(std.Io.Dir.path.basename(request_repo.source.path)) catch return respondRemoveNotFound(request); 1265 var target_repo = try rp.AnyRepo(.xit, .{}).open(io, allocator, request_repo.source.localInitOpts()); 1266 defer target_repo.deinit(io, allocator); 1267 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 1268 defer admin_repo.deinit(io, allocator); 1269 const id = std.fmt.bytesToHex(parts.thread_id, .lower); 1270 switch (target_repo) { 1271 inline else => |*repo| try pch.publish(repo.self_repo_opts, io, allocator, host.event().server, &admin_repo, repo, .{ 1272 .id = id, 1273 .user_id = user_id, 1274 .repo_id = repo_id, 1275 .author = author, 1276 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 1277 }), 1278 } 1279 try request.respond("", .{ 1280 .status = .see_other, 1281 .extra_headers = &.{.{ .name = "location", .value = base }}, 1282 }); 1283 } 1284 1285 fn handlePatchMerge( 1286 io: std.Io, 1287 request: *std.http.Server.Request, 1288 allocator: std.mem.Allocator, 1289 base: []const u8, 1290 host: Host, 1291 revision: evt.Patch.MergeRevision, 1292 ) !void { 1293 const parts = commentBaseParts(host, base) orelse return respondRemoveNotFound(request); 1294 if (parts.thread_kind != .patch or parts.comment_id != null) return respondRemoveNotFound(request); 1295 const server = switch (host.event()) { 1296 .server => |server| server, 1297 .local => return respondRemoveNotFound(request), 1298 }; 1299 var author_arena = std.heap.ArenaAllocator.init(allocator); 1300 defer author_arena.deinit(); 1301 const author = ((try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .write, .patch)) orelse return).author; 1302 1303 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1304 defer request_repo.deinit(allocator); 1305 var target_repo = try rp.AnyRepo(.xit, .{}).open(io, allocator, request_repo.source.localInitOpts()); 1306 defer target_repo.deinit(io, allocator); 1307 1308 const id = std.fmt.bytesToHex(parts.thread_id, .lower); 1309 const merged = switch (target_repo) { 1310 inline else => |*repo| pch.mergeAndRemoveFork(repo.self_repo_opts, io, allocator, server, repo, .{ 1311 .id = id, 1312 .revision = revision, 1313 .author = author, 1314 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 1315 }), 1316 }; 1317 merged catch |err| switch (err) { 1318 error.MergeConflict => return request.respond("merge conflict", .{ 1319 .status = .conflict, 1320 .keep_alive = false, 1321 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1322 }), 1323 error.MergeCheckUnavailable, error.PatchOutOfDate, error.PatchDataUnavailable => {}, 1324 else => return err, 1325 }; 1326 1327 const location = try allocator.print("{s}/patch:{s}", .{ parts.repo_base, &id }); 1328 defer allocator.free(location); 1329 try request.respond("", .{ 1330 .status = .see_other, 1331 .keep_alive = false, 1332 .extra_headers = &.{.{ .name = "location", .value = location }}, 1333 }); 1334 } 1335 1336 // create a reply and redirect to its permalink. 1337 fn handleCommentNew( 1338 io: std.Io, 1339 request: *std.http.Server.Request, 1340 allocator: std.mem.Allocator, 1341 base: []const u8, 1342 host: Host, 1343 ) !void { 1344 const not_found = "comment parent not found"; 1345 const parts = commentBaseParts(host, base) orelse { 1346 try request.respond(not_found, .{ 1347 .status = .not_found, 1348 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1349 }); 1350 return; 1351 }; 1352 1353 var author_arena = std.heap.ArenaAllocator.init(allocator); 1354 defer author_arena.deinit(); 1355 const author = ((try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return).author; 1356 1357 const form_body = try readFormBody(request, allocator); 1358 defer allocator.free(form_body); 1359 const body_crlf = (try parseFormField(allocator, form_body, "body")) orelse try allocator.dupe(u8, ""); 1360 defer allocator.free(body_crlf); 1361 const body = try std.mem.replaceOwned(u8, allocator, body_crlf, "\r\n", "\n"); 1362 defer allocator.free(body); 1363 1364 if (!evt.Comment.fieldsValid(body)) { 1365 const form_location = try allocator.print("{s}/new", .{base}); 1366 defer allocator.free(form_location); 1367 try request.respond("", .{ 1368 .status = .see_other, 1369 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 1370 }); 1371 return; 1372 } 1373 1374 const thread_id_hex = std.fmt.bytesToHex(parts.thread_id, .lower); 1375 const parent_id_hex = std.fmt.bytesToHex(parts.comment_id orelse parts.thread_id, .lower); 1376 1377 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse { 1378 try request.respond(not_found, .{ 1379 .status = .not_found, 1380 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1381 }); 1382 return; 1383 }; 1384 defer request_repo.deinit(allocator); 1385 const source = request_repo.source; 1386 var event_id_hex: [evt.event_id_size * 2]u8 = undefined; 1387 switch (source.repo_kind) { 1388 inline else => |repo_kind| { 1389 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1390 defer any_repo.deinit(io, allocator); 1391 switch (any_repo) { 1392 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) { 1393 // the url's thread or parent comment isn't what it claims 1394 error.NotFound => return request.respond(not_found, .{ 1395 .status = .not_found, 1396 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1397 }), 1398 else => |e| return e, 1399 }, 1400 } 1401 }, 1402 } 1403 1404 const location = try allocator.print("{s}/{s}:{s}/comment:{s}", .{ parts.repo_base, @tagName(parts.thread_kind), &thread_id_hex, &event_id_hex }); 1405 defer allocator.free(location); 1406 try request.respond("", .{ 1407 .status = .see_other, 1408 .extra_headers = &.{.{ .name = "location", .value = location }}, 1409 }); 1410 } 1411 1412 const AttachmentRequest = struct { 1413 repo_base: []const u8, 1414 id: [evt.event_id_size]u8, 1415 }; 1416 1417 // an attachment url is its repo's base and the attachment's event id 1418 fn attachmentRequest(path: []const u8) ?AttachmentRequest { 1419 const infix = "/attachment:"; 1420 const at = std.mem.lastIndexOf(u8, path, infix) orelse return null; 1421 const tail = path[at + infix.len ..]; 1422 const id = evt.parseEventId(tail) catch return null; 1423 return .{ .repo_base = path[0..at], .id = id }; 1424 } 1425 1426 // serve an attachment's bytes from the repo its url names 1427 fn serveAttachment( 1428 io: std.Io, 1429 request: *std.http.Server.Request, 1430 allocator: std.mem.Allocator, 1431 attachment: AttachmentRequest, 1432 host: Host, 1433 ) !void { 1434 if (!try mayRead(io, allocator, request, host, attachment.repo_base)) return respondAttachmentNotFound(request); 1435 const request_repo = (try requestRepoSource(io, allocator, host, attachment.repo_base)) orelse return respondAttachmentNotFound(request); 1436 defer request_repo.deinit(allocator); 1437 const source = request_repo.source; 1438 switch (source.repo_kind) { 1439 inline else => |repo_kind| { 1440 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1441 defer any_repo.deinit(io, allocator); 1442 switch (any_repo) { 1443 inline else => |*repo| try sendAttachment(repo_kind, repo.self_repo_opts, io, request, allocator, repo, &attachment.id), 1444 } 1445 }, 1446 } 1447 } 1448 1449 fn sendAttachment( 1450 comptime repo_kind: rp.RepoKind, 1451 comptime repo_opts: rp.RepoOpts(repo_kind), 1452 io: std.Io, 1453 request: *std.http.Server.Request, 1454 allocator: std.mem.Allocator, 1455 repo: *rp.Repo(repo_kind, repo_opts), 1456 id: *const [evt.event_id_size]u8, 1457 ) !void { 1458 var arena = std.heap.ArenaAllocator.init(allocator); 1459 defer arena.deinit(); 1460 1461 const DB = evt.EventDB(repo_opts.hash); 1462 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; 1463 defer if (event_db_maybe) |*event_db| event_db.deinit(io, allocator); 1464 const haxy_moment = (if (event_db_maybe) |*event_db| 1465 evt.currentMomentFromDb(repo_opts.hash, event_db.db) 1466 else if (repo_kind == .git) 1467 return respondAttachmentNotFound(request) 1468 else 1469 evt.currentMoment(repo_opts, repo)) catch return respondAttachmentNotFound(request); 1470 1471 const record = (try evt.Attachment.readById(DB, repo_opts.hash, haxy_moment, &arena, id)) orelse return respondAttachmentNotFound(request); 1472 if (record.removed) return respondAttachmentNotFound(request); 1473 if (record.blob_oid.len != hash.hexLen(repo_opts.hash)) return respondAttachmentNotFound(request); 1474 const blob_oid: *const [hash.hexLen(repo_opts.hash)]u8 = @ptrCast(record.blob_oid.ptr); 1475 1476 var moment = repo.core.latestMoment() catch return respondAttachmentNotFound(request); 1477 const state = rp.Repo(repo_kind, repo_opts).State(.read_only){ .core = &repo.core, .extra = .{ .moment = &moment } }; 1478 var object_reader = obj.ObjectReader(repo_kind, repo_opts).init(state, io, allocator, blob_oid) catch return respondAttachmentNotFound(request); 1479 defer object_reader.deinit(); 1480 if (object_reader.header().kind != .blob) return respondAttachmentNotFound(request); 1481 1482 const content_type = attachmentContentType(record.name); 1483 const encoded_name = try ui.urlEncodeRef(allocator, record.name); 1484 defer allocator.free(encoded_name); 1485 const disposition = try allocator.print("{s}; filename*=UTF-8''{s}", .{ if (content_type == null) "attachment" else "inline", encoded_name }); 1486 defer allocator.free(disposition); 1487 1488 var send_buf: [8192]u8 = undefined; 1489 var body = try request.respondStreaming(&send_buf, .{ 1490 .content_length = object_reader.header().size, 1491 .respond_options = .{ 1492 .extra_headers = &.{ 1493 .{ .name = "content-type", .value = content_type orelse "application/octet-stream" }, 1494 .{ .name = "content-disposition", .value = disposition }, 1495 // uploaded bytes are never sniffed into a type that could run 1496 // as script on this origin 1497 .{ .name = "x-content-type-options", .value = "nosniff" }, 1498 }, 1499 }, 1500 }); 1501 _ = try object_reader.interface.streamRemaining(&body.writer); 1502 try body.end(); 1503 } 1504 1505 // the images a browser renders safely inline. anything else downloads as 1506 // opaque bytes, so an uploaded page can't run on this origin. 1507 fn attachmentContentType(name: []const u8) ?[]const u8 { 1508 const types = [_]struct { ext: []const u8, value: []const u8 }{ 1509 .{ .ext = ".png", .value = "image/png" }, 1510 .{ .ext = ".jpg", .value = "image/jpeg" }, 1511 .{ .ext = ".jpeg", .value = "image/jpeg" }, 1512 .{ .ext = ".gif", .value = "image/gif" }, 1513 .{ .ext = ".webp", .value = "image/webp" }, 1514 }; 1515 for (types) |entry| { 1516 if (name.len > entry.ext.len and std.ascii.eqlIgnoreCase(name[name.len - entry.ext.len ..], entry.ext)) return entry.value; 1517 } 1518 return null; 1519 } 1520 1521 fn respondAttachmentNotFound(request: *std.http.Server.Request) !void { 1522 try request.respond("attachment not found", .{ 1523 .status = .not_found, 1524 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1525 }); 1526 } 1527 1528 fn respondAttachmentTargetNotFound(request: *std.http.Server.Request) !void { 1529 try request.respond("attachment target not found", .{ 1530 .status = .not_found, 1531 .keep_alive = false, 1532 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1533 }); 1534 } 1535 1536 // the upload declares its file's name here, since the body is the file itself 1537 const attachment_name_header = "x-attachment-name"; 1538 1539 const AttachTargetParts = struct { 1540 repo_base: []const u8, 1541 kind: evt.EventKind, 1542 id_bytes: [evt.event_id_size]u8, 1543 }; 1544 1545 // what an attachment hangs off: the `<kind>:<id>` segment the form's page ends 1546 // with, whatever kind that is 1547 fn attachTargetParts(base: []const u8) ?AttachTargetParts { 1548 const segment_at = std.mem.lastIndexOfScalar(u8, base, '/') orelse return null; 1549 const segment = base[segment_at + 1 ..]; 1550 const colon_at = std.mem.lastIndexOfScalar(u8, segment, ':') orelse return null; 1551 const kind = std.meta.stringToEnum(evt.EventKind, segment[0..colon_at]) orelse return null; 1552 const id_bytes = evt.parseEventId(segment[colon_at + 1 ..]) catch return null; 1553 return .{ .repo_base = base[0..segment_at], .kind = kind, .id_bytes = id_bytes }; 1554 } 1555 1556 // attach the uploaded file to the event the url names, then reload. the file is 1557 // the whole request body, so it streams from the socket into the object store 1558 // without being buffered. 1559 fn handleAttach( 1560 io: std.Io, 1561 request: *std.http.Server.Request, 1562 allocator: std.mem.Allocator, 1563 base: []const u8, 1564 host: Host, 1565 ) !void { 1566 const parts = attachTargetParts(base) orelse return respondAttachmentTargetNotFound(request); 1567 1568 var author_arena = std.heap.ArenaAllocator.init(allocator); 1569 defer author_arena.deinit(); 1570 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.kind)) orelse return; 1571 const author = actor.author; 1572 // an attachment changes the event it hangs off 1573 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondAttachmentTargetNotFound(request); 1574 defer request_repo.deinit(allocator); 1575 const source = request_repo.source; 1576 if (!try source.canModify(io, allocator, actor, parts.kind, &parts.id_bytes)) return respondForbidden(request); 1577 1578 const name = (try attachmentName(allocator, request)) orelse return respondUploadError(request, .bad_request, "attachment needs a name"); 1579 defer allocator.free(name); 1580 if (!evt.Attachment.nameValid(name)) return respondUploadError(request, .bad_request, "invalid attachment name"); 1581 1582 const size = request.head.content_length orelse return respondUploadError(request, .length_required, "attachments must declare a content length"); 1583 if (size == 0) return respondUploadError(request, .bad_request, "attachment is empty"); 1584 if (size > evt.Attachment.max_size) return respondUploadError(request, .payload_too_large, "attachment is too large"); 1585 1586 const target_id_hex = std.fmt.bytesToHex(parts.id_bytes, .lower); 1587 1588 var body_buf: [4096]u8 = undefined; 1589 const blob: evt.Blob = .{ .name = name, .size = size, .reader = try request.readerExpectContinue(&body_buf) }; 1590 1591 switch (source.repo_kind) { 1592 inline else => |repo_kind| { 1593 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1594 defer any_repo.deinit(io, allocator); 1595 switch (any_repo) { 1596 inline else => |*repo| _ = evt.Attachment.create(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, parts.kind, &target_id_hex, blob, author) catch |err| switch (err) { 1597 error.TargetNotFound => return respondAttachmentTargetNotFound(request), 1598 else => return err, 1599 }, 1600 } 1601 }, 1602 } 1603 1604 // the client reloads the page itself 1605 try request.respond("", .{ .status = .no_content, .keep_alive = false }); 1606 } 1607 1608 // assign the posted email, or the email of the user it names, to the thread the 1609 // url names, then reload it 1610 fn handleAssign( 1611 io: std.Io, 1612 request: *std.http.Server.Request, 1613 allocator: std.mem.Allocator, 1614 base: []const u8, 1615 host: Host, 1616 ) !void { 1617 const parts = commentBaseParts(host, base) orelse return respondRemoveNotFound(request); 1618 if (parts.comment_id != null) return respondRemoveNotFound(request); 1619 1620 var arena = std.heap.ArenaAllocator.init(allocator); 1621 defer arena.deinit(); 1622 const actor = (try authorizeWrite(io, allocator, &arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 1623 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1624 defer request_repo.deinit(allocator); 1625 const source = request_repo.source; 1626 if (!try source.canModify(io, allocator, actor, parts.thread_kind, &parts.thread_id)) return respondForbidden(request); 1627 1628 const text = blk: { 1629 const body = try readFormBody(request, allocator); 1630 defer allocator.free(body); 1631 break :blk (try parseFormField(arena.allocator(), body, "assignee")) orelse ""; 1632 }; 1633 const failure: ?ui.Session.FormFeedback.AssignmentFailure = blk: { 1634 const lookup = switch (host) { 1635 .local => try ui.assigneeEmail(null, &arena, text), 1636 .server => |server| server: { 1637 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 1638 defer admin_repo.deinit(io, allocator); 1639 break :server try ui.assigneeEmail(try evt.currentMoment(evt.admin_repo_opts, &admin_repo), &arena, text); 1640 }, 1641 }; 1642 const email = switch (lookup) { 1643 .email => |email| email, 1644 .failure => |value| break :blk value, 1645 }; 1646 const thread_id_hex = std.fmt.bytesToHex(parts.thread_id, .lower); 1647 switch (source.repo_kind) { 1648 inline else => |repo_kind| { 1649 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1650 defer any_repo.deinit(io, allocator); 1651 switch (any_repo) { 1652 inline else => |*repo| _ = evt.Assignment.create(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, parts.thread_kind, &thread_id_hex, email, actor.author) catch |err| switch (err) { 1653 error.AlreadyAssigned => break :blk .already_assigned, 1654 error.InvalidFields => break :blk .not_an_email, 1655 error.NotFound => return respondRemoveNotFound(request), 1656 else => |e| return e, 1657 }, 1658 } 1659 }, 1660 } 1661 break :blk null; 1662 }; 1663 if (failure) |value| return respondThreadFormFailure(request, allocator, host, base, .{ .assignment = .{ .failure = value, .text = text } }); 1664 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = base }} }); 1665 } 1666 1667 // unassign the email the url's last segment carries from the thread before it, 1668 // then reload the thread 1669 fn handleUnassign( 1670 io: std.Io, 1671 request: *std.http.Server.Request, 1672 allocator: std.mem.Allocator, 1673 base: []const u8, 1674 host: Host, 1675 ) !void { 1676 const infix = "/assignee:"; 1677 const at = std.mem.lastIndexOf(u8, base, infix) orelse return respondRemoveNotFound(request); 1678 const thread_url = base[0..at]; 1679 const parts = commentBaseParts(host, thread_url) orelse return respondRemoveNotFound(request); 1680 if (parts.comment_id != null) return respondRemoveNotFound(request); 1681 1682 var arena = std.heap.ArenaAllocator.init(allocator); 1683 defer arena.deinit(); 1684 const email = std.Uri.percentDecodeInPlace(try arena.allocator().dupe(u8, base[at + infix.len ..])); 1685 const actor = (try authorizeWrite(io, allocator, &arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 1686 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1687 defer request_repo.deinit(allocator); 1688 const source = request_repo.source; 1689 if (!try source.canModify(io, allocator, actor, parts.thread_kind, &parts.thread_id)) return respondForbidden(request); 1690 1691 switch (source.repo_kind) { 1692 inline else => |repo_kind| { 1693 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1694 defer any_repo.deinit(io, allocator); 1695 switch (any_repo) { 1696 inline else => |*repo| evt.removeInThread(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, parts.thread_kind, &parts.thread_id, .assign, &evt.Assignment.idOf(&parts.thread_id, email), actor.author) catch |err| switch (err) { 1697 error.EventNotFound => return respondRemoveNotFound(request), 1698 else => |e| return e, 1699 }, 1700 } 1701 }, 1702 } 1703 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = thread_url }} }); 1704 } 1705 1706 // subscribe the logged-in user to the thread the url names, or mute it, then reload it 1707 fn handleNotify( 1708 io: std.Io, 1709 request: *std.http.Server.Request, 1710 allocator: std.mem.Allocator, 1711 base: []const u8, 1712 host: Host, 1713 users_dir: []const u8, 1714 mode: ui.NotifyAction, 1715 ) !void { 1716 const parts = commentBaseParts(host, base) orelse return respondRemoveNotFound(request); 1717 if (parts.comment_id != null) return respondRemoveNotFound(request); 1718 1719 var arena = std.heap.ArenaAllocator.init(allocator); 1720 defer arena.deinit(); 1721 const actor = (try authorizeWrite(io, allocator, &arena, request, host, parts.repo_base, .read, null)) orelse return; 1722 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1723 defer request_repo.deinit(allocator); 1724 // a server actor always has both ids 1725 const user_id = actor.user_id orelse unreachable; 1726 const location: evt.RepoLocation = .{ 1727 .owner_id = actor.repo_user_id orelse unreachable, 1728 .repo_id = evt.parseEventId(std.Io.Dir.path.basename(request_repo.source.path)) catch return respondRemoveNotFound(request), 1729 }; 1730 1731 switch (mode) { 1732 .subscribe => try notify.subscribe(io, allocator, users_dir, &user_id, location, &parts.thread_id, actor.author), 1733 .mute => try notify.mute(io, allocator, users_dir, &user_id, location, &parts.thread_id, actor.author), 1734 } 1735 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = base }} }); 1736 } 1737 1738 // the name the upload declares for its file, percent-encoded so it survives a 1739 // header 1740 fn attachmentName(allocator: std.mem.Allocator, request: *std.http.Server.Request) !?[]u8 { 1741 var iter = request.iterateHeaders(); 1742 while (iter.next()) |header| { 1743 if (!std.ascii.eqlIgnoreCase(header.name, attachment_name_header)) continue; 1744 return try decodeFormValue(allocator, header.value); 1745 } 1746 return null; 1747 } 1748 1749 // an upload that failed leaves the body partly read, so the connection closes 1750 fn respondUploadError(request: *std.http.Server.Request, status: std.http.Status, message: []const u8) !void { 1751 try request.respond(message, .{ 1752 .status = status, 1753 .keep_alive = false, 1754 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1755 }); 1756 } 1757 1758 // re-emit the comment `parts` names with a new body, in the repo the host 1759 // resolves the base to. 1760 fn updateComment( 1761 io: std.Io, 1762 allocator: std.mem.Allocator, 1763 host: Host, 1764 parts: CommentBaseParts, 1765 body: []const u8, 1766 author: evt.CommitAuthor, 1767 ) !void { 1768 const comment_id = parts.comment_id orelse return error.NotFound; 1769 const thread_id = std.fmt.bytesToHex(parts.thread_id, .lower); 1770 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return error.NotFound; 1771 defer request_repo.deinit(allocator); 1772 const source = request_repo.source; 1773 switch (source.repo_kind) { 1774 inline else => |repo_kind| { 1775 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1776 defer any_repo.deinit(io, allocator); 1777 switch (any_repo) { 1778 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), 1779 } 1780 }, 1781 } 1782 } 1783 1784 // edit actions share a suffix; the base identifies the event being edited. 1785 fn handleEdit( 1786 io: std.Io, 1787 request: *std.http.Server.Request, 1788 allocator: std.mem.Allocator, 1789 base: []const u8, 1790 host: Host, 1791 ) !void { 1792 const parts = commentBaseParts(host, base) orelse return respondRemoveNotFound(request); 1793 if (parts.comment_id != null) return handleCommentEdit(io, request, allocator, base, host, parts); 1794 return handleThreadEdit(io, request, allocator, base, host, parts); 1795 } 1796 1797 // replace the body of the comment the url names, then redirect to its 1798 // permalink. 1799 fn handleCommentEdit( 1800 io: std.Io, 1801 request: *std.http.Server.Request, 1802 allocator: std.mem.Allocator, 1803 base: []const u8, 1804 host: Host, 1805 parts: CommentBaseParts, 1806 ) !void { 1807 var author_arena = std.heap.ArenaAllocator.init(allocator); 1808 defer author_arena.deinit(); 1809 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 1810 const author = actor.author; 1811 // edits only reach here for a comment 1812 const comment_id = parts.comment_id orelse unreachable; 1813 { 1814 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1815 defer request_repo.deinit(allocator); 1816 if (!try request_repo.source.canModify(io, allocator, actor, .comment, &comment_id)) return respondForbidden(request); 1817 } 1818 1819 const form_body = try readFormBody(request, allocator); 1820 defer allocator.free(form_body); 1821 const body_crlf = (try parseFormField(allocator, form_body, "body")) orelse try allocator.dupe(u8, ""); 1822 defer allocator.free(body_crlf); 1823 const body = try std.mem.replaceOwned(u8, allocator, body_crlf, "\r\n", "\n"); 1824 defer allocator.free(body); 1825 1826 if (!evt.Comment.fieldsValid(body)) { 1827 const form_location = try allocator.print("{s}/edit", .{base}); 1828 defer allocator.free(form_location); 1829 try request.respond("", .{ 1830 .status = .see_other, 1831 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 1832 }); 1833 return; 1834 } 1835 1836 const not_found = "comment not found"; 1837 updateComment(io, allocator, host, parts, body, author) catch |err| switch (err) { 1838 error.NotFound => { 1839 try request.respond(not_found, .{ 1840 .status = .not_found, 1841 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1842 }); 1843 return; 1844 }, 1845 else => |e| return e, 1846 }; 1847 1848 try request.respond("", .{ 1849 .status = .see_other, 1850 .extra_headers = &.{.{ .name = "location", .value = base }}, 1851 }); 1852 } 1853 1854 fn updateThread( 1855 comptime Event: type, 1856 io: std.Io, 1857 allocator: std.mem.Allocator, 1858 host: Host, 1859 repo_base: []const u8, 1860 id: *const [evt.event_id_size]u8, 1861 update: Event.Update, 1862 author: evt.CommitAuthor, 1863 ) !void { 1864 const request_repo = (try requestRepoSource(io, allocator, host, repo_base)) orelse return error.NotFound; 1865 defer request_repo.deinit(allocator); 1866 const source = request_repo.source; 1867 switch (source.repo_kind) { 1868 inline else => |repo_kind| { 1869 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1870 defer any_repo.deinit(io, allocator); 1871 switch (any_repo) { 1872 inline else => |*repo| try Event.update(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, id, update, author), 1873 } 1874 }, 1875 } 1876 } 1877 1878 const RemoveParts = struct { 1879 repo_base: []const u8, 1880 kind: evt.EventKind, 1881 // the thread the removed event is, or belongs to 1882 thread_kind: evt.EventKind, 1883 thread_id: [evt.event_id_size]u8, 1884 id: [evt.event_id_size]u8, 1885 }; 1886 1887 // split a remove url into the repo and event it names 1888 fn removeParts(host: Host, base: []const u8) ?RemoveParts { 1889 if (attachmentRequest(base)) |attachment| { 1890 const target = attachTargetParts(attachment.repo_base) orelse return null; 1891 return .{ 1892 .repo_base = target.repo_base, 1893 .kind = .attach, 1894 .thread_kind = target.kind, 1895 .thread_id = target.id_bytes, 1896 .id = attachment.id, 1897 }; 1898 } 1899 if (commentBaseParts(host, base)) |thread| return .{ 1900 .repo_base = thread.repo_base, 1901 .kind = if (thread.comment_id != null) .comment else thread.thread_kind, 1902 .thread_kind = thread.thread_kind, 1903 .thread_id = thread.thread_id, 1904 .id = thread.comment_id orelse thread.thread_id, 1905 }; 1906 return null; 1907 } 1908 1909 // remove the event named by the form's url 1910 fn handleRemove( 1911 io: std.Io, 1912 request: *std.http.Server.Request, 1913 allocator: std.mem.Allocator, 1914 base: []const u8, 1915 host: Host, 1916 ) !void { 1917 const parts = removeParts(host, base) orelse return respondRemoveNotFound(request); 1918 1919 var author_arena = std.heap.ArenaAllocator.init(allocator); 1920 defer author_arena.deinit(); 1921 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 1922 const author = actor.author; 1923 1924 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 1925 defer request_repo.deinit(allocator); 1926 const source = request_repo.source; 1927 1928 if (parts.kind == .patch) switch (host) { 1929 .server => |server| { 1930 const user_id = actor.user_id orelse return respondLoginRequired(request); 1931 1932 // a draft lives in its author's user repo 1933 if (try evt.readForkById(io, allocator, &author_arena, server.users_dir, &user_id, &parts.id)) |fork_record| { 1934 const repo_id = evt.parseEventId(std.Io.Dir.path.basename(source.path)) catch return respondRemoveNotFound(request); 1935 if (!fork_record.removed and fork_record.event.stage == .draft and std.mem.eql(u8, &fork_record.event.repo_id, &std.fmt.bytesToHex(repo_id, .lower))) { 1936 const id = std.fmt.bytesToHex(parts.id, .lower); 1937 try fork.remove(io, allocator, server.users_dir, &user_id, &id, author); 1938 1939 const location = try allocator.print("{s}/patches/drafts", .{parts.repo_base}); 1940 defer allocator.free(location); 1941 try request.respond("", .{ 1942 .status = .see_other, 1943 .keep_alive = false, 1944 .extra_headers = &.{.{ .name = "location", .value = location }}, 1945 }); 1946 return; 1947 } 1948 } 1949 }, 1950 .local => {}, 1951 }; 1952 1953 // a draft is its author's alone, which its removal above checks 1954 if (!try source.canModify(io, allocator, actor, parts.kind, &parts.id)) return respondForbidden(request); 1955 1956 switch (source.repo_kind) { 1957 inline else => |repo_kind| { 1958 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 1959 defer any_repo.deinit(io, allocator); 1960 switch (any_repo) { 1961 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) { 1962 error.EventNotFound => return respondRemoveNotFound(request), 1963 else => |e| return e, 1964 }, 1965 } 1966 }, 1967 } 1968 1969 const id = std.fmt.bytesToHex(parts.id, .lower); 1970 const location = try allocator.print("{s}/event:{s}/kind:{s}", .{ parts.repo_base, &id, @tagName(parts.kind) }); 1971 defer allocator.free(location); 1972 try request.respond("", .{ 1973 .status = .see_other, 1974 .keep_alive = false, 1975 .extra_headers = &.{.{ .name = "location", .value = location }}, 1976 }); 1977 } 1978 1979 fn respondRemoveNotFound(request: *std.http.Server.Request) !void { 1980 try request.respond("event not found", .{ 1981 .status = .not_found, 1982 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 1983 }); 1984 } 1985 1986 fn updateDiscussion( 1987 io: std.Io, 1988 allocator: std.mem.Allocator, 1989 host: Host, 1990 repo_base: []const u8, 1991 id: *const [evt.event_id_size]u8, 1992 title: []const u8, 1993 labels: []const u8, 1994 description: []const u8, 1995 author: evt.CommitAuthor, 1996 ) !void { 1997 const request_repo = (try requestRepoSource(io, allocator, host, repo_base)) orelse return error.NotFound; 1998 defer request_repo.deinit(allocator); 1999 const source = request_repo.source; 2000 switch (source.repo_kind) { 2001 inline else => |repo_kind| { 2002 var any_repo = try rp.AnyRepo(repo_kind, .{}).open(io, allocator, source.localInitOpts()); 2003 defer any_repo.deinit(io, allocator); 2004 switch (any_repo) { 2005 inline else => |*repo| try evt.Discussion.update(host.event(), repo_kind, repo.self_repo_opts, io, allocator, repo, id, title, labels, description, author), 2006 } 2007 }, 2008 } 2009 } 2010 2011 // set the status of the issue the url names (base is 2012 // "/<owner>:<name>/issue:<id>", identity elided in local mode) by 2013 // re-emitting its event, then redirect back to it 2014 fn handleThreadStatus( 2015 io: std.Io, 2016 request: *std.http.Server.Request, 2017 allocator: std.mem.Allocator, 2018 base: []const u8, 2019 host: Host, 2020 open: bool, 2021 ) !void { 2022 const not_found = "thread not found"; 2023 const parts = commentBaseParts(host, base) orelse { 2024 try request.respond(not_found, .{ 2025 .status = .not_found, 2026 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 2027 }); 2028 return; 2029 }; 2030 2031 var author_arena = std.heap.ArenaAllocator.init(allocator); 2032 defer author_arena.deinit(); 2033 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 2034 const author = actor.author; 2035 { 2036 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 2037 defer request_repo.deinit(allocator); 2038 if (!try request_repo.source.canModify(io, allocator, actor, parts.thread_kind, &parts.thread_id)) return respondForbidden(request); 2039 } 2040 2041 (switch (parts.thread_kind) { 2042 .issue => updateThread(evt.Issue, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .status = if (open) .open else .closed }, author), 2043 .patch => updateThread(evt.Patch, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .status = if (open) .open else .closed }, author), 2044 else => return respondRemoveNotFound(request), 2045 }) catch |err| switch (err) { 2046 error.NotFound => { 2047 try request.respond(not_found, .{ 2048 .status = .not_found, 2049 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 2050 }); 2051 return; 2052 }, 2053 else => |e| return e, 2054 }; 2055 2056 // like logout, this is a bodyless POST, so close the connection rather than 2057 // letting the keep-alive path try to discard a body that isn't framed. 2058 try request.respond("", .{ 2059 .status = .see_other, 2060 .keep_alive = false, 2061 .extra_headers = &.{.{ .name = "location", .value = base }}, 2062 }); 2063 } 2064 2065 // replace a thread's editable fields. 2066 fn handleThreadEdit( 2067 io: std.Io, 2068 request: *std.http.Server.Request, 2069 allocator: std.mem.Allocator, 2070 base: []const u8, 2071 host: Host, 2072 parts: CommentBaseParts, 2073 ) !void { 2074 var author_arena = std.heap.ArenaAllocator.init(allocator); 2075 defer author_arena.deinit(); 2076 const actor = (try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .read, parts.thread_kind)) orelse return; 2077 const author = actor.author; 2078 2079 const body = try readFormBody(request, allocator); 2080 defer allocator.free(body); 2081 2082 const title = (try parseFormField(allocator, body, "title")) orelse try allocator.dupe(u8, ""); 2083 defer allocator.free(title); 2084 const labels = (try parseFormField(allocator, body, "labels")) orelse try allocator.dupe(u8, ""); 2085 defer allocator.free(labels); 2086 const description_crlf = (try parseFormField(allocator, body, "description")) orelse try allocator.dupe(u8, ""); 2087 defer allocator.free(description_crlf); 2088 // form submission normalizes textarea line breaks to CRLF; store plain 2089 // newlines so the text renders the same on every host 2090 const description = try std.mem.replaceOwned(u8, allocator, description_crlf, "\r\n", "\n"); 2091 defer allocator.free(description); 2092 const target_branch = (try parseFormField(allocator, body, "target_branch")) orelse try allocator.dupe(u8, ""); 2093 defer allocator.free(target_branch); 2094 2095 // invalid fields send the user back to the edit form 2096 const valid = switch (parts.thread_kind) { 2097 .issue => evt.Issue.fieldsValid(title, labels), 2098 .patch => evt.Patch.fieldsValid(title, labels), 2099 .discuss => evt.Discussion.fieldsValid(title, labels), 2100 else => unreachable, 2101 }; 2102 if (!valid) { 2103 const form_location = try allocator.print("{s}/edit", .{base}); 2104 defer allocator.free(form_location); 2105 if (!evt.titleValid(title)) { 2106 return respondThreadFormFailure(request, allocator, host, form_location, requiredTitleFeedback(parts.thread_kind, title, labels, description, target_branch, null)); 2107 } 2108 try request.respond("", .{ 2109 .status = .see_other, 2110 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 2111 }); 2112 return; 2113 } 2114 2115 const request_repo = (try requestRepoSource(io, allocator, host, parts.repo_base)) orelse return respondRemoveNotFound(request); 2116 defer request_repo.deinit(allocator); 2117 2118 const draft_user_id = if (parts.thread_kind == .patch) actor.user_id else null; 2119 if (draft_user_id) |user_id| { 2120 const server = switch (host) { 2121 .server => |server| server, 2122 .local => unreachable, 2123 }; 2124 if (!evt.Patch.branchValid(target_branch) or !try request_repo.source.hasBranch(io, allocator, target_branch)) { 2125 const form_location = try allocator.print("{s}/edit", .{base}); 2126 defer allocator.free(form_location); 2127 return respondThreadFormFailure(request, allocator, host, form_location, patchFeedback(.invalid_target_branch, title, labels, description, target_branch, null)); 2128 } 2129 const repo_id = evt.parseEventId(std.Io.Dir.path.basename(request_repo.source.path)) catch return respondRemoveNotFound(request); 2130 var admin_repo = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 2131 defer admin_repo.deinit(io, allocator); 2132 const id = std.fmt.bytesToHex(parts.thread_id, .lower); 2133 if (try pch.editDraft(.{}, io, allocator, server.users_dir, &admin_repo, .{ 2134 .id = id, 2135 .user_id = user_id, 2136 .repo_id = repo_id, 2137 .title = title, 2138 .labels = labels, 2139 .description = description, 2140 .target_branch = target_branch, 2141 .author = author, 2142 .timestamp = @intCast(std.Io.Timestamp.now(io, .real).toSeconds()), 2143 })) { 2144 try request.respond("", .{ 2145 .status = .see_other, 2146 .extra_headers = &.{.{ .name = "location", .value = base }}, 2147 }); 2148 return; 2149 } 2150 } 2151 2152 // a draft is its author's alone, which its edit above checks 2153 if (!try request_repo.source.canModify(io, allocator, actor, parts.thread_kind, &parts.thread_id)) return respondForbidden(request); 2154 2155 const not_found = switch (parts.thread_kind) { 2156 .issue => "issue not found", 2157 .patch => "patch not found", 2158 .discuss => "discussion not found", 2159 else => unreachable, 2160 }; 2161 (switch (parts.thread_kind) { 2162 .issue => updateThread(evt.Issue, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .fields = .{ 2163 .title = title, 2164 .labels = labels, 2165 .description = description, 2166 } }, author), 2167 .patch => updateThread(evt.Patch, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .fields = .{ 2168 .title = title, 2169 .labels = labels, 2170 .description = description, 2171 .target_branch = target_branch, 2172 } }, author), 2173 .discuss => updateDiscussion(io, allocator, host, parts.repo_base, &parts.thread_id, title, labels, description, author), 2174 else => unreachable, 2175 }) catch |err| switch (err) { 2176 error.NotFound => { 2177 try request.respond(not_found, .{ 2178 .status = .not_found, 2179 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 2180 }); 2181 return; 2182 }, 2183 else => { 2184 if (parts.thread_kind != .patch) return err; 2185 const failure = ui.Session.FormFeedback.PatchFailure.fromError(err) orelse return err; 2186 const form_location = try allocator.print("{s}/edit", .{base}); 2187 defer allocator.free(form_location); 2188 return respondThreadFormFailure(request, allocator, host, form_location, patchFeedback(failure, title, labels, description, target_branch, null)); 2189 }, 2190 }; 2191 2192 try request.respond("", .{ 2193 .status = .see_other, 2194 .extra_headers = &.{.{ .name = "location", .value = base }}, 2195 }); 2196 } 2197 2198 // resolve every conflicted field of the thread the url names 2199 fn handleThreadResolve( 2200 io: std.Io, 2201 request: *std.http.Server.Request, 2202 allocator: std.mem.Allocator, 2203 base: []const u8, 2204 host: Host, 2205 ) !void { 2206 const parts = commentBaseParts(host, base) orelse { 2207 try request.respond("thread not found", .{ 2208 .status = .not_found, 2209 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 2210 }); 2211 return; 2212 }; 2213 2214 var author_arena = std.heap.ArenaAllocator.init(allocator); 2215 defer author_arena.deinit(); 2216 const author = ((try authorizeWrite(io, allocator, &author_arena, request, host, parts.repo_base, .write, parts.thread_kind)) orelse return).author; 2217 2218 const body = try readFormBody(request, allocator); 2219 defer allocator.free(body); 2220 2221 var field_arena = std.heap.ArenaAllocator.init(allocator); 2222 defer field_arena.deinit(); 2223 const aa = field_arena.allocator(); 2224 const title = try parseFormField(aa, body, "title"); 2225 const labels = try parseFormField(aa, body, "labels"); 2226 2227 // the hunk inputs are submitted as d0, d1, ...; form submission normalizes their 2228 // textarea line breaks to CRLF 2229 var hunks: std.ArrayList([]const u8) = .empty; 2230 var hunk_index: usize = 0; 2231 while (true) : (hunk_index += 1) { 2232 const name = try aa.print("d{d}", .{hunk_index}); 2233 const submitted = (try parseFormField(aa, body, name)) orelse break; 2234 try hunks.append(aa, try std.mem.replaceOwned(u8, aa, submitted, "\r\n", "\n")); 2235 } 2236 2237 if (parts.comment_id != null or (parts.thread_kind != .issue and parts.thread_kind != .patch)) { 2238 try request.respond("thread not found", .{ 2239 .status = .not_found, 2240 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 2241 }); 2242 return; 2243 } 2244 const route = routeFromUrl(host, base) orelse { 2245 try request.respond("thread not found", .{ 2246 .status = .not_found, 2247 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 2248 }); 2249 return; 2250 }; 2251 const theirs: []const u8 = switch (route) { 2252 .repo_patches => |*patch| patch.theirs.slice(), 2253 .repo_issues => "", 2254 else => unreachable, 2255 }; 2256 const not_found = if (parts.thread_kind == .patch) "patch not found" else "issue not found"; 2257 2258 (switch (parts.thread_kind) { 2259 .issue => updateThread(evt.Issue, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .resolve = .{ 2260 .title = title, 2261 .labels = labels, 2262 .hunks = hunks.items, 2263 } }, author), 2264 .patch => updateThread(evt.Patch, io, allocator, host, parts.repo_base, &parts.thread_id, .{ .resolve = .{ 2265 .title = title, 2266 .labels = labels, 2267 .hunks = hunks.items, 2268 .theirs = theirs, 2269 } }, author), 2270 else => unreachable, 2271 }) catch |err| switch (err) { 2272 error.NotFound => { 2273 try request.respond(not_found, .{ 2274 .status = .not_found, 2275 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 2276 }); 2277 return; 2278 }, 2279 // invalid fields send the user back to the resolve form 2280 error.InvalidFields => { 2281 const form_location = try allocator.print("{s}/resolve", .{base}); 2282 defer allocator.free(form_location); 2283 try request.respond("", .{ 2284 .status = .see_other, 2285 .extra_headers = &.{.{ .name = "location", .value = form_location }}, 2286 }); 2287 return; 2288 }, 2289 else => |e| return e, 2290 }; 2291 2292 try request.respond("", .{ 2293 .status = .see_other, 2294 .extra_headers = &.{.{ .name = "location", .value = base }}, 2295 }); 2296 } 2297 2298 // the posted path drops the action's own segment, so the route it parses is 2299 // the undo page the action applies to 2300 fn handleUndo(io: std.Io, request: *std.http.Server.Request, allocator: std.mem.Allocator, base: []const u8, host: Host) !void { 2301 const route = routeFromUrl(host, base) orelse return respondRepoNotFound(request); 2302 if (route != .repo_undo) return respondRepoNotFound(request); 2303 const target = route.repo_undo; 2304 var arena = std.heap.ArenaAllocator.init(allocator); 2305 defer arena.deinit(); 2306 const repo_base = if (target.name.len == 0) "" else try arena.allocator().print("/{s}", .{target.name.slice()}); 2307 _ = (try authorizeWrite(io, allocator, &arena, request, host, repo_base, .owner, null)) orelse return; 2308 const resolved = (try requestRepoSource(io, allocator, host, repo_base)) orelse return respondRepoNotFound(request); 2309 defer resolved.deinit(allocator); 2310 ui.Repo.Undo.execute(io, allocator, resolved.source, target.index orelse return respondRepoNotFound(request)) catch |err| switch (err) { 2311 error.NotFound, error.InvalidHistoryIndex, error.TransactionNotFound => return respondRepoNotFound(request), 2312 else => return err, 2313 }; 2314 const location = try (ui.RoutablePage.repoUndoRoute(target.name.slice(), null) orelse return error.RouteTooLong).toUrl(&arena); 2315 try request.respond("", .{ .status = .see_other, .keep_alive = false, .extra_headers = &.{.{ .name = "location", .value = location }} }); 2316 } 2317 2318 fn handleSync( 2319 io: std.Io, 2320 request: *std.http.Server.Request, 2321 allocator: std.mem.Allocator, 2322 base: []const u8, 2323 source: ui.RepoSource, 2324 ) !void { 2325 if (base.len != 0) { 2326 try request.respond("not found", .{ 2327 .status = .not_found, 2328 .extra_headers = &.{.{ .name = "content-type", .value = "text/plain" }}, 2329 }); 2330 return; 2331 } 2332 2333 var owned_failure: ?[]u8 = null; 2334 defer if (owned_failure) |message| allocator.free(message); 2335 const failure: ?[]const u8 = blk: { 2336 owned_failure = ui.Repo.Events.sync(io, allocator, source) catch |err| break :blk @errorName(err); 2337 break :blk owned_failure; 2338 }; 2339 if (failure) |message| { 2340 var encoded: std.Io.Writer.Allocating = .init(allocator); 2341 defer encoded.deinit(); 2342 try std.Uri.Component.percentEncode(&encoded.writer, message, struct { 2343 fn isUnreserved(c: u8) bool { 2344 return std.ascii.isAlphanumeric(c) or c == '-' or c == '.' or c == '_' or c == '~'; 2345 } 2346 }.isUnreserved); 2347 const cookie = try allocator.print( 2348 local_flash_cookie ++ "=" ++ local_sync_failure_prefix ++ "{s}; Path=/; HttpOnly; SameSite=Strict", 2349 .{encoded.written()}, 2350 ); 2351 defer allocator.free(cookie); 2352 try request.respond("", .{ 2353 .status = .see_other, 2354 .extra_headers = &.{ 2355 .{ .name = "location", .value = "/events" }, 2356 .{ .name = "set-cookie", .value = cookie }, 2357 }, 2358 }); 2359 return; 2360 } 2361 2362 try request.respond("", .{ 2363 .status = .see_other, 2364 .extra_headers = &.{ 2365 .{ .name = "location", .value = "/events" }, 2366 .{ .name = "set-cookie", .value = local_flash_cookie ++ "=; Path=/; Max-Age=0" }, 2367 }, 2368 }); 2369 } 2370 2371 fn renderIndexHtml( 2372 io: std.Io, 2373 allocator: std.mem.Allocator, 2374 host: Host, 2375 session_token: ?[]const u8, 2376 session_data: ui.Session.Data, 2377 ) ![]const u8 { 2378 const template = (findEmbed("/index.html") orelse return error.MissingIndexAsset).body; 2379 2380 var page_arena = std.heap.ArenaAllocator.init(allocator); 2381 defer page_arena.deinit(); 2382 2383 // the server admin repo must outlive the page build, since the session's 2384 // moment reads from it. 2385 var repo_maybe: ?rp.Repo(.xit, evt.admin_repo_opts) = null; 2386 defer if (repo_maybe) |*repo| repo.deinit(io, allocator); 2387 2388 var session = switch (host) { 2389 .server => |server| blk: { 2390 // open the admin repo to read live user/repo data. 2391 repo_maybe = try rp.Repo(.xit, evt.admin_repo_opts).open(io, allocator, .{ .path = server.admin_repo_path }); 2392 const repo = if (repo_maybe) |*repo| repo else unreachable; 2393 var session = try ui.Session.init(&page_arena, repo, session_data); 2394 // the session dropped a user whose account was removed, so revoke 2395 // the token that named them 2396 if (session_token) |token| { 2397 if (session.data.user_id == null) server.session_store.remove(token); 2398 } 2399 // give the page builders filesystem access to the on-disk repos (a 2400 // sibling "users" dir next to the admin repo) so the Repo page can 2401 // read its files. 2402 session.users_dir = server.users_dir; 2403 break :blk session; 2404 }, 2405 .local => |local| ui.Session{ 2406 .data = session_data, 2407 .arena = &page_arena, 2408 .page_arena = &page_arena, 2409 .local = local, 2410 }, 2411 }; 2412 session.io = io; 2413 session.data.now = std.math.cast(i64, std.Io.Timestamp.now(io, .real).toSeconds()) orelse return error.TimestampOutOfRange; 2414 2415 var page = try ui.Page.init(session.page_arena, &session, session.data.current_page); 2416 var root = try ui.initRoot(allocator, &page, &session); 2417 defer root.deinit(allocator); 2418 2419 const snapshot: ui.Snapshot = .{ .page = page, .session = session.data }; 2420 2421 const content = try generateHtml(allocator, &root, &session); 2422 defer allocator.free(content); 2423 2424 // serialize the snapshot so the wasm side can parse it back without making 2425 // a second request. it's embedded raw in a <script type="application/json"> 2426 // block, whose content is raw text terminated only by "</script". in json, 2427 // '<' appears solely inside string values, so escaping every '<' (and '>' 2428 // for good measure) to its \uXXXX form yields equivalent json that can't 2429 // break out of the tag. 2430 var json: std.Io.Writer.Allocating = .init(allocator); 2431 defer json.deinit(); 2432 try std.json.Stringify.value(snapshot, .{}, &json.writer); 2433 2434 var json_escaped: std.ArrayList(u8) = .empty; 2435 defer json_escaped.deinit(allocator); 2436 for (json.written()) |c| switch (c) { 2437 '<' => try json_escaped.appendSlice(allocator, "\\u003c"), 2438 '>' => try json_escaped.appendSlice(allocator, "\\u003e"), 2439 else => try json_escaped.append(allocator, c), 2440 }; 2441 2442 var out: std.ArrayList(u8) = .empty; 2443 errdefer out.deinit(allocator); 2444 { 2445 var cursor: usize = 0; 2446 for (&[_]struct { needle: []const u8, replacement: []const u8 }{ 2447 .{ .needle = "{{{ HAXY_HTML }}}", .replacement = content }, 2448 .{ .needle = "{{{ HAXY_JSON }}}", .replacement = json_escaped.items }, 2449 }) |sub| { 2450 const idx = std.mem.indexOfPos(u8, template, cursor, sub.needle) orelse return error.MissingTemplateToken; 2451 try out.appendSlice(allocator, template[cursor..idx]); 2452 try out.appendSlice(allocator, sub.replacement); 2453 cursor = idx + sub.needle.len; 2454 } 2455 try out.appendSlice(allocator, template[cursor..]); 2456 } 2457 return try out.toOwnedSlice(allocator); 2458 } 2459 2460 fn findEmbed(request_path: []const u8) ?Embed { 2461 // embeds are matched before pages, so a dot keeps them from claiming a username or tab 2462 comptime for (embeds) |embed| { 2463 if (std.mem.indexOfScalar(u8, embed.path, '.') == null) @compileError("embed path needs a '.' so it can't shadow a page: " ++ embed.path); 2464 }; 2465 if (request_path.len < 2 or request_path[0] != '/') return null; 2466 const path = request_path[1..]; 2467 2468 for (embeds) |embed| { 2469 if (std.mem.eql(u8, path, embed.path)) return embed; 2470 } 2471 return null; 2472 } 2473 2474 // emits the TUI grid cells as static HTML. each web-native Scroll becomes its 2475 // own absolutely-positioned, natively-scrollable <div> holding its full content, 2476 // rendered recursively so nested scrolls work. 2477 pub fn generateHtml(allocator: std.mem.Allocator, root: *ui.Widget, session: *ui.Session) ![]const u8 { 2478 const grid = root.getGrid() orelse return error.MissingGrid; 2479 const root_focus = root.getFocus(); 2480 2481 var out: std.ArrayList(u8) = .empty; 2482 errdefer out.deinit(allocator); 2483 2484 switch (root.*) { 2485 .background => |*background| { 2486 if (background.art.getGrid()) |art| { 2487 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 }); 2488 try renderPanel(allocator, &out, background.art.getFocus(), art, session, root_focus); 2489 try out.appendSlice(allocator, "</div>"); 2490 } 2491 }, 2492 else => {}, 2493 } 2494 try out.appendSlice(allocator, "<div class=\"grid-content\" data-key=\"panel:root\">"); 2495 try renderPanel(allocator, &out, root_focus, grid, session, root_focus); 2496 try out.appendSlice(allocator, "</div>"); 2497 try renderForms(allocator, &out, root_focus); 2498 return try out.toOwnedSlice(allocator); 2499 } 2500 2501 // render one panel — a focus subtree and its content grid — as HTML, recursing 2502 // once per web-native Scroll inside it. the root panel is the whole page; each 2503 // Scroll becomes a nested, natively-scrollable div holding its full content. 2504 // emits the panel's grid cells as text, leaving holes where child scrolls sit, 2505 // then the child scroll divs over those holes. 2506 fn renderPanel(allocator: std.mem.Allocator, output: *std.ArrayList(u8), focus: *Focus, grid: Grid, session: *ui.Session, root_focus: *Focus) !void { 2507 // `direct` is this panel's scroll children, each drawn as an overlaid div. 2508 // `excluded` is every focus id that belongs to a scroll (the scroll nodes 2509 // plus their descendants, which the focus tree flattens into this panel's 2510 // children): the cell hit-test below skips them so this panel doesn't claim 2511 // cells that are really rendered inside a child scroll's own panel. 2512 // (scrolls aren't nested in practice, so every scroll child is direct here.) 2513 var direct: std.ArrayList(usize) = .empty; 2514 defer direct.deinit(allocator); 2515 var excluded: std.AutoHashMapUnmanaged(usize, void) = .empty; 2516 defer excluded.deinit(allocator); 2517 { 2518 var it = focus.children.iterator(); 2519 while (it.next()) |e| { 2520 if (e.value_ptr.focus.scroll == null) continue; 2521 try direct.append(allocator, e.key_ptr.*); 2522 try excluded.put(allocator, e.key_ptr.*, {}); 2523 var mit = e.value_ptr.focus.children.iterator(); 2524 while (mit.next()) |m| try excluded.put(allocator, m.key_ptr.*, {}); 2525 } 2526 } 2527 2528 // the HTML element a run of cells is wrapped in, chosen from the cell's 2529 // focusable kind 2530 const CellTag = union(enum) { 2531 span, // clickable focusable cell 2532 a: []const u8, // clickable focusable link 2533 plain, // non-focusable, colored 2534 2535 const a_prefix = "a:"; 2536 // an "in-page" anchor: rendered as a real <a href> so it works with js 2537 // disabled, but wasm handles it without navigating. 2538 fn init(str: []const u8) @This() { 2539 if (std.mem.startsWith(u8, str, ui.raw_link_prefix)) { 2540 return .{ .a = str[ui.raw_link_prefix.len..] }; 2541 } 2542 if (std.mem.startsWith(u8, str, ui.in_page_link_prefix)) { 2543 return .{ .a = str[ui.in_page_link_prefix.len..] }; 2544 } 2545 if (std.mem.startsWith(u8, str, a_prefix)) { 2546 return .{ .a = str[a_prefix.len..] }; 2547 } 2548 return .span; 2549 } 2550 2551 fn writeOpenTag(self: @This(), alloc: std.mem.Allocator, out: *std.ArrayList(u8), id: usize, style_attr: []const u8) !void { 2552 var id_buf: [32]u8 = undefined; 2553 switch (self) { 2554 .span => { 2555 try out.appendSlice(alloc, "<span class=\"clickable\" data-focus-id=\""); 2556 try out.appendSlice(alloc, try std.fmt.bufPrint(&id_buf, "{d}", .{id})); 2557 try out.appendSlice(alloc, "\""); 2558 try out.appendSlice(alloc, style_attr); 2559 try out.appendSlice(alloc, ">"); 2560 }, 2561 .a => |href| { 2562 // tabindex=-1 keeps these out of the browser's tab order 2563 try out.appendSlice(alloc, "<a class=\"clickable\" tabindex=\"-1\" data-focus-id=\""); 2564 try out.appendSlice(alloc, try std.fmt.bufPrint(&id_buf, "{d}", .{id})); 2565 try out.appendSlice(alloc, "\" href=\""); 2566 try appendEscapedHtml(alloc, out, href); 2567 try out.appendSlice(alloc, "\""); 2568 try out.appendSlice(alloc, style_attr); 2569 try out.appendSlice(alloc, ">"); 2570 }, 2571 .plain => { 2572 try out.appendSlice(alloc, "<span"); 2573 try out.appendSlice(alloc, style_attr); 2574 try out.appendSlice(alloc, ">"); 2575 }, 2576 } 2577 } 2578 2579 fn closeTag(self: @This()) []const u8 { 2580 return switch (self) { 2581 .span, .plain => "</span>", 2582 .a => "</a>", 2583 }; 2584 } 2585 }; 2586 2587 // the focusable owning each cell, among this panel's own (skipping any 2588 // that belong to a child scroll, whose cells are drawn in their own panel). 2589 // claimed in focus order, so the first focusable over a cell keeps it. 2590 // looking every focusable up for every cell is quadratic in a long list. 2591 const owners = try allocator.alloc(?usize, grid.size.width * grid.size.height); 2592 defer allocator.free(owners); 2593 @memset(owners, null); 2594 { 2595 var it = focus.children.iterator(); 2596 while (it.next()) |entry| { 2597 const child = entry.value_ptr.*; 2598 if (child.focus.mode != .all) continue; 2599 if (excluded.contains(entry.key_ptr.*)) continue; 2600 const r = child.rect; 2601 for (@min(r.y, grid.size.height)..@min(r.y + r.size.height, grid.size.height)) |y| { 2602 for (@min(r.x, grid.size.width)..@min(r.x + r.size.width, grid.size.width)) |x| { 2603 const owner = &owners[y * grid.size.width + x]; 2604 if (owner.* == null) owner.* = entry.key_ptr.*; 2605 } 2606 } 2607 } 2608 } 2609 2610 // the cells are the volatile part of a panel. js replaces this one subtree 2611 // wholesale while retaining the panel's native controls and scroll shells. 2612 try output.appendSlice(allocator, "<div class=\"grid-cells\">"); 2613 2614 // emit this panel's grid as rows of text, coalescing adjacent cells that 2615 // share a focus id and style into one tag (a clickable span, a link, or a 2616 // plain styled span). cells under a child scroll keep only their background. 2617 // a cell's own link is an anchor nested in that tag. 2618 for (0..grid.size.height) |y| { 2619 var cur_id: ?usize = null; 2620 var cur_style: Grid.Style = .{}; 2621 var open_tag: ?CellTag = null; 2622 var open_link: ?[]const u8 = null; 2623 var first = true; 2624 for (0..grid.size.width) |x| { 2625 const cell = (try grid.cell(x, y)).*; 2626 // a cell covered by a child scroll's viewport is drawn by that scroll's 2627 // own div, so blank its glyph and make it non-clickable here — but keep 2628 // its background, so the backdrop still shows through the scroll's 2629 // transparent div instead of a bare hole. 2630 const covered_by_scroll = blk: { 2631 for (direct.items) |id| { 2632 const r = (focus.children.get(id) orelse continue).rect; 2633 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; 2634 } 2635 break :blk false; 2636 }; 2637 // the focusable owning the cell at (x, y); none for a covered cell. 2638 const cell_id = if (covered_by_scroll) null else owners[y * grid.size.width + x]; 2639 const style: Grid.Style = if (covered_by_scroll) .{ .bg = cell.style.bg } else cell.style; 2640 2641 if (first or cell_id != cur_id or !style.eql(cur_style)) { 2642 if (open_link != null) try output.appendSlice(allocator, "</a>"); 2643 open_link = null; 2644 if (open_tag) |t| try output.appendSlice(allocator, t.closeTag()); 2645 2646 var new_tag: ?CellTag = null; 2647 if (cell_id) |id| { 2648 if (focus.children.get(id)) |child| { 2649 new_tag = switch (child.focus.kind) { 2650 .custom => |custom| CellTag.init(custom), 2651 else => .span, 2652 }; 2653 } 2654 } 2655 if (new_tag == null and !style.eql(.{})) new_tag = .plain; 2656 2657 if (new_tag) |t| { 2658 var style_buf: [192]u8 = undefined; 2659 try t.writeOpenTag(allocator, output, cell_id orelse 0, styleAttr(&style_buf, style)); 2660 } 2661 2662 open_tag = new_tag; 2663 cur_id = cell_id; 2664 cur_style = style; 2665 first = false; 2666 } 2667 2668 // an anchor can't nest in another, so a link tag's cells skip theirs 2669 const in_anchor = if (open_tag) |t| t == .a else false; 2670 const link = if (covered_by_scroll or in_anchor) null else webLink(cell.link); 2671 if (!sameLink(link, open_link)) { 2672 if (open_link != null) try output.appendSlice(allocator, "</a>"); 2673 if (link) |url| { 2674 // a page path opens in this tab, any other url in a new one 2675 try output.appendSlice(allocator, if (url[0] == '/') 2676 "<a class=\"cell-link\" tabindex=\"-1\" href=\"" 2677 else 2678 "<a class=\"cell-link\" tabindex=\"-1\" target=\"_blank\" rel=\"noopener noreferrer\" href=\""); 2679 try appendEscapedHtml(allocator, output, url); 2680 try output.appendSlice(allocator, "\">"); 2681 } 2682 open_link = link; 2683 } 2684 2685 if (covered_by_scroll) { 2686 try appendEscapedHtml(allocator, output, " "); 2687 } else if (cell.continuation) { 2688 // the wide rune to the left was emitted 2ch wide, covering this column 2689 } else if (cell.rune) |rune| { 2690 var encoded: [4]u8 = undefined; 2691 const encoded_len = try std.unicode.utf8Encode(rune, &encoded); 2692 const rune_text = encoded[0..encoded_len]; 2693 // a double-width rune is pinned inside a 2ch span so the 2694 // fallback glyph's advance width can't shift the rest of the row 2695 const wide = x + 1 < grid.size.width and (try grid.cell(x + 1, y)).continuation; 2696 if (wide) { 2697 try output.appendSlice(allocator, "<span class=\"w2\">"); 2698 try appendEscapedHtml(allocator, output, rune_text); 2699 try output.appendSlice(allocator, "</span>"); 2700 } else { 2701 try appendEscapedHtml(allocator, output, rune_text); 2702 } 2703 } else { 2704 try appendEscapedHtml(allocator, output, " "); 2705 } 2706 } 2707 if (open_link != null) try output.appendSlice(allocator, "</a>"); 2708 if (open_tag) |t| try output.appendSlice(allocator, t.closeTag()); 2709 try output.append(allocator, '\n'); 2710 } 2711 try output.appendSlice(allocator, "</div>"); 2712 2713 // native controls live in their panel, beside the replaceable cells. their 2714 // stable keys let JS update layout without recreating their DOM nodes, and 2715 // being actual descendants of a scroll gives them native movement/clipping. 2716 try renderPanelControls(allocator, output, focus, session, root_focus, &excluded); 2717 2718 // each child scroll becomes a natively-scrollable div positioned over its 2719 // viewport, holding its full content rendered recursively. 2720 for (direct.items) |id| { 2721 const child = focus.children.get(id) orelse continue; 2722 const info = child.focus.scroll orelse continue; 2723 const r = child.rect; 2724 // overflow only on the axes the widget scrolls; `auto` shows a bar only 2725 // when that axis actually overflows. the other axis is clipped (hidden), 2726 // matching how the terminal Scroll handles its non-scrolling axis. 2727 const overflow = switch (info.direction) { 2728 .vert => "overflow-x:hidden;overflow-y:auto", 2729 .horiz => "overflow-x:auto;overflow-y:hidden", 2730 .both => "overflow:auto", 2731 }; 2732 // the id carries a content version so JS preserves the native scroll 2733 // position across re-renders of the same content but resets it when the 2734 // content is replaced — e.g. selecting a different commit. the widget's 2735 // scroll offset (in cells) rides along so JS can apply it when it has no 2736 // preserved position, letting a wasm-side scrollToRect (the files list 2737 // scrolling to its selected row on page load) reach the browser. 2738 var buf: [256]u8 = undefined; 2739 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 })); 2740 try renderPanel(allocator, output, child.focus, info.content, session, root_focus); 2741 try output.appendSlice(allocator, "</div>"); 2742 } 2743 } 2744 2745 const form_prefix = "form:"; 2746 const form_id_prefix = "haxy-form-"; 2747 2748 fn formAction(focus: *const Focus) ?[]const u8 { 2749 return switch (focus.kind) { 2750 .custom => |custom| if (std.mem.startsWith(u8, custom, form_prefix)) custom[form_prefix.len..] else null, 2751 else => null, 2752 }; 2753 } 2754 2755 // find the form ancestor of a flattened focus-tree child. html's `form` 2756 // attribute then associates the control with that form without requiring the 2757 // form and control to share a DOM parent. 2758 fn formOwner(root_focus: *Focus, focus_id: usize) ?usize { 2759 var id = focus_id; 2760 while (root_focus.children.get(id)) |child| { 2761 const parent_id = child.parent_id; 2762 if (parent_id == root_focus.id) return if (formAction(root_focus) != null) root_focus.id else null; 2763 const parent = root_focus.children.get(parent_id) orelse return null; 2764 if (formAction(parent.focus) != null) return parent_id; 2765 id = parent_id; 2766 } 2767 return null; 2768 } 2769 2770 fn appendFormAttribute(allocator: std.mem.Allocator, output: *std.ArrayList(u8), root_focus: *Focus, focus_id: usize) !void { 2771 const form_id = formOwner(root_focus, focus_id) orelse return; 2772 var buf: [64]u8 = undefined; 2773 try output.appendSlice(allocator, try std.fmt.bufPrint(&buf, " form=\"" ++ form_id_prefix ++ "{d}\"", .{form_id})); 2774 } 2775 2776 fn renderPanelControls( 2777 allocator: std.mem.Allocator, 2778 output: *std.ArrayList(u8), 2779 focus: *Focus, 2780 session: *ui.Session, 2781 root_focus: *Focus, 2782 excluded: *const std.AutoHashMapUnmanaged(usize, void), 2783 ) !void { 2784 var iter = focus.children.iterator(); 2785 while (iter.next()) |entry| { 2786 const id = entry.key_ptr.*; 2787 if (excluded.contains(id)) continue; 2788 const child = entry.value_ptr.*; 2789 const r = child.rect; 2790 2791 if (r.size.width == 0 or r.size.height == 0) continue; // not laid out, rather than merely off-screen 2792 2793 switch (child.focus.kind) { 2794 .text_input, .text_input_password, .text_area => { 2795 const ti = session.text_inputs.get(id) orelse continue; 2796 2797 const inner_left = r.x + 1; 2798 const inner_top = r.y + 1; 2799 const inner_width = if (r.size.width > 2) r.size.width - 2 else 0; 2800 const preserve = !ti.options.read_only; 2801 2802 if (child.focus.kind == .text_area) { 2803 const value = try ti.text(allocator); 2804 defer allocator.free(value); 2805 var id_buf: [128]u8 = undefined; 2806 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "<textarea data-key=\"control:{d}\" data-focus-id=\"{d}\"", .{ id, id })); 2807 if (preserve) try output.appendSlice(allocator, " data-preserve-value") else try output.appendSlice(allocator, " readonly"); 2808 try appendFormAttribute(allocator, output, root_focus, id); 2809 if (ti.options.name.len > 0) { 2810 try output.appendSlice(allocator, " name=\""); 2811 try appendEscapedHtml(allocator, output, ti.options.name); 2812 try output.append(allocator, '"'); 2813 } 2814 const inner_height = if (r.size.height > 2) r.size.height - 2 else 0; 2815 var pos_buf: [128]u8 = undefined; 2816 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 })); 2817 try appendEscapedHtml(allocator, output, value); 2818 try output.appendSlice(allocator, "</textarea>"); 2819 continue; 2820 } 2821 2822 var id_buf: [160]u8 = undefined; 2823 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 })); 2824 if (preserve) try output.appendSlice(allocator, " data-preserve-value") else try output.appendSlice(allocator, " readonly"); 2825 try appendFormAttribute(allocator, output, root_focus, id); 2826 if (ti.options.name.len > 0) { 2827 try output.appendSlice(allocator, " name=\""); 2828 try appendEscapedHtml(allocator, output, ti.options.name); 2829 try output.append(allocator, '"'); 2830 } 2831 if (child.focus.kind != .text_input_password) { 2832 const value = try ti.text(allocator); 2833 defer allocator.free(value); 2834 try output.appendSlice(allocator, " value=\""); 2835 try appendEscapedHtml(allocator, output, value); 2836 try output.append(allocator, '"'); 2837 } 2838 var pos_buf: [96]u8 = undefined; 2839 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 })); 2840 }, 2841 .custom => |custom| { 2842 if (std.mem.eql(u8, custom, "submit") or std.mem.startsWith(u8, custom, ui.submit_action_prefix)) { 2843 if (formOwner(root_focus, id) == null) continue; 2844 var id_buf: [128]u8 = undefined; 2845 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "<button type=\"submit\" data-key=\"control:{d}\" data-focus-id=\"{d}\"", .{ id, id })); 2846 try appendFormAttribute(allocator, output, root_focus, id); 2847 if (std.mem.startsWith(u8, custom, ui.submit_action_prefix)) { 2848 try output.appendSlice(allocator, " formaction=\""); 2849 try appendEscapedHtml(allocator, output, custom[ui.submit_action_prefix.len..]); 2850 try output.append(allocator, '"'); 2851 } 2852 var pos_buf: [128]u8 = undefined; 2853 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 })); 2854 } else if (std.mem.startsWith(u8, custom, ui.radio_prefix)) { 2855 // an invisible native radio over the option, checked when the option is its row's selection 2856 const field = custom[ui.radio_prefix.len..]; 2857 const separator = std.mem.indexOfScalar(u8, field, '=') orelse continue; 2858 const row = root_focus.children.get(child.parent_id) orelse continue; 2859 var id_buf: [128]u8 = undefined; 2860 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "<input type=\"radio\" data-key=\"control:{d}\" data-focus-id=\"{d}\"", .{ id, id })); 2861 try appendFormAttribute(allocator, output, root_focus, id); 2862 try output.appendSlice(allocator, " name=\""); 2863 try appendEscapedHtml(allocator, output, field[0..separator]); 2864 try output.appendSlice(allocator, "\" value=\""); 2865 try appendEscapedHtml(allocator, output, field[separator + 1 ..]); 2866 try output.append(allocator, '"'); 2867 if (row.focus.child_id == id) try output.appendSlice(allocator, " checked"); 2868 var pos_buf: [128]u8 = undefined; 2869 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 })); 2870 } else if (std.mem.startsWith(u8, custom, ui.file_input_prefix)) { 2871 try output.appendSlice(allocator, "<input type=\"file\" data-preserve-value data-action=\""); 2872 try appendEscapedHtml(allocator, output, custom[ui.file_input_prefix.len..]); 2873 var id_buf: [128]u8 = undefined; 2874 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 })); 2875 } 2876 }, 2877 else => {}, 2878 } 2879 } 2880 } 2881 2882 // emit hidden form owners beside the rendered panels. their controls point 2883 // back here with the standard HTML `form` attribute. 2884 fn renderForms(allocator: std.mem.Allocator, output: *std.ArrayList(u8), root_focus: *Focus) !void { 2885 // the focus child map preserves insertion order, which matches the order 2886 // widgets were added in code 2887 var iter = root_focus.children.iterator(); 2888 while (iter.next()) |entry| { 2889 const child = entry.value_ptr.*; 2890 const action_url = formAction(child.focus) orelse continue; 2891 2892 try output.appendSlice(allocator, "<form hidden data-key=\"form:"); 2893 var id_buf: [96]u8 = undefined; 2894 try output.appendSlice(allocator, try std.fmt.bufPrint(&id_buf, "{d}\" id=\"" ++ form_id_prefix ++ "{d}\" action=\"", .{ entry.key_ptr.*, entry.key_ptr.* })); 2895 try appendEscapedHtml(allocator, output, action_url); 2896 try output.appendSlice(allocator, "\" method=\"post\"></form>"); 2897 } 2898 } 2899 2900 // the 16 ansi colors as the browser shows them (xterm's defaults) 2901 const ansi_palette = [16]Grid.Color.Rgb{ 2902 .{ .r = 0x00, .g = 0x00, .b = 0x00 }, .{ .r = 0xcd, .g = 0x00, .b = 0x00 }, .{ .r = 0x00, .g = 0xcd, .b = 0x00 }, .{ .r = 0xcd, .g = 0xcd, .b = 0x00 }, 2903 .{ .r = 0x00, .g = 0x00, .b = 0xee }, .{ .r = 0xcd, .g = 0x00, .b = 0xcd }, .{ .r = 0x00, .g = 0xcd, .b = 0xcd }, .{ .r = 0xe5, .g = 0xe5, .b = 0xe5 }, 2904 .{ .r = 0x7f, .g = 0x7f, .b = 0x7f }, .{ .r = 0xff, .g = 0x00, .b = 0x00 }, .{ .r = 0x00, .g = 0xff, .b = 0x00 }, .{ .r = 0xff, .g = 0xff, .b = 0x00 }, 2905 .{ .r = 0x5c, .g = 0x5c, .b = 0xff }, .{ .r = 0xff, .g = 0x00, .b = 0xff }, .{ .r = 0x00, .g = 0xff, .b = 0xff }, .{ .r = 0xff, .g = 0xff, .b = 0xff }, 2906 }; 2907 2908 // resolve any color to rgb: palette colors through the ansi table and the 2909 // xterm 256-color layout (16 ansi, a 6x6x6 cube, then 24 grays) 2910 fn colorRgb(color: Grid.Color) Grid.Color.Rgb { 2911 return switch (color) { 2912 .rgb => |c| c, 2913 .ansi => |a| ansi_palette[@backingInt(a)], 2914 .indexed => |n| if (n < 16) 2915 ansi_palette[n] 2916 else if (n < 232) blk: { 2917 const levels = [6]u8{ 0, 0x5f, 0x87, 0xaf, 0xd7, 0xff }; 2918 const i = n - 16; 2919 break :blk .{ .r = levels[i / 36], .g = levels[(i / 6) % 6], .b = levels[i % 6] }; 2920 } else blk: { 2921 const v: u8 = 8 + (n - 232) * 10; 2922 break :blk .{ .r = v, .g = v, .b = v }; 2923 }, 2924 }; 2925 } 2926 2927 // builds an HTML ` style="color:…;background-color:…"` attribute from a 2928 // cell's style into `buf`, omitting whichever color is unset. an inverted 2929 // cell swaps the two, falling back to the page's --fg/--bg variables for 2930 // whichever side is unset. text attributes follow the colors. returns an 2931 // empty slice when nothing is set. 2932 fn styleAttr(buf: []u8, style: Grid.Style) []const u8 { 2933 if (style.eql(.{})) return buf[0..0]; 2934 const prefix = " style=\""; 2935 @memcpy(buf[0..prefix.len], prefix); 2936 var i: usize = prefix.len; 2937 const inverted = style.inverted; 2938 i = cssColor(buf, i, "color", if (inverted) style.bg else style.fg, if (inverted) "var(--bg)" else null) orelse return buf[0..0]; 2939 i = cssColor(buf, i, "background-color", if (inverted) style.fg else style.bg, if (inverted) "var(--fg)" else null) orelse return buf[0..0]; 2940 const decoration: []const u8 = if (style.underline and style.strikethrough) 2941 "text-decoration:underline line-through;" 2942 else if (style.underline) 2943 "text-decoration:underline;" 2944 else if (style.strikethrough) 2945 "text-decoration:line-through;" 2946 else 2947 ""; 2948 const attributes = std.fmt.bufPrint(buf[i..], "{s}{s}{s}{s}", .{ 2949 if (style.bold) "font-weight:bold;" else "", 2950 if (style.italic) "font-style:italic;" else "", 2951 decoration, 2952 if (style.dim) "opacity:.6;" else "", 2953 }) catch return buf[0..0]; 2954 i += attributes.len; 2955 if (i >= buf.len) return buf[0..0]; 2956 buf[i] = '"'; 2957 return buf[0 .. i + 1]; 2958 } 2959 2960 // append `prop:value;` at buf[i..] for the color, or for the fallback when 2961 // the color is unset (nothing when both are). returns the new end, or null 2962 // when it doesn't fit. 2963 fn cssColor(buf: []u8, i: usize, prop: []const u8, color: ?Grid.Color, fallback: ?[]const u8) ?usize { 2964 const s = if (color) |c| blk: { 2965 const v = colorRgb(c); 2966 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; 2967 } else if (fallback) |f| 2968 std.fmt.bufPrint(buf[i..], "{s}:{s};", .{ prop, f }) catch return null 2969 else 2970 return i; 2971 return i + s.len; 2972 } 2973 2974 // a cell's link as an href, when it's a page path or a web or mail url 2975 fn webLink(link: ?[]const u8) ?[]const u8 { 2976 const url = link orelse return null; 2977 // a page path, not a protocol-relative url 2978 if (url.len > 1 and url[0] == '/' and url[1] != '/') return url; 2979 for ([_][]const u8{ "http://", "https://", "mailto:" }) |scheme| { 2980 if (std.ascii.startsWithIgnoreCase(url, scheme)) return url; 2981 } 2982 return null; 2983 } 2984 2985 fn sameLink(a: ?[]const u8, b: ?[]const u8) bool { 2986 if (a) |x| return if (b) |y| std.mem.eql(u8, x, y) else false; 2987 return b == null; 2988 } 2989 2990 fn appendEscapedHtml(allocator: std.mem.Allocator, out: *std.ArrayList(u8), input: []const u8) !void { 2991 for (input) |ch| { 2992 switch (ch) { 2993 '&' => try out.appendSlice(allocator, "&amp;"), 2994 '<' => try out.appendSlice(allocator, "&lt;"), 2995 '>' => try out.appendSlice(allocator, "&gt;"), 2996 '"' => try out.appendSlice(allocator, "&quot;"), 2997 '\'' => try out.appendSlice(allocator, "&#39;"), 2998 else => try out.append(allocator, ch), 2999 } 3000 } 3001 } 3002 3003 // --- helpers -------------------------------------------------------------- 3004 3005 fn getCookieValue(request: *std.http.Server.Request, name: []const u8) ?[]const u8 { 3006 var iter = request.iterateHeaders(); 3007 while (iter.next()) |header| { 3008 if (!std.ascii.eqlIgnoreCase(header.name, "cookie")) continue; 3009 var pairs = std.mem.splitScalar(u8, header.value, ';'); 3010 while (pairs.next()) |pair| { 3011 const trimmed = std.mem.trim(u8, pair, " \t"); 3012 const eq = std.mem.indexOfScalar(u8, trimmed, '=') orelse continue; 3013 if (std.mem.eql(u8, trimmed[0..eq], name)) { 3014 return trimmed[eq + 1 ..]; 3015 } 3016 } 3017 } 3018 return null; 3019 } 3020 3021 fn parseFormField(allocator: std.mem.Allocator, body: []const u8, key: []const u8) !?[]u8 { 3022 var iter = std.mem.splitScalar(u8, body, '&'); 3023 while (iter.next()) |pair| { 3024 const eq = std.mem.indexOfScalar(u8, pair, '=') orelse continue; 3025 if (std.mem.eql(u8, pair[0..eq], key)) { 3026 return try decodeFormValue(allocator, pair[eq + 1 ..]); 3027 } 3028 } 3029 return null; 3030 } 3031 3032 fn readFormBody(request: *std.http.Server.Request, allocator: std.mem.Allocator) ![]u8 { 3033 var buffer: [256]u8 = undefined; 3034 return request.readerExpectNone(&buffer).allocRemaining(allocator, .limited(65536)); 3035 } 3036 3037 fn decodeFormValue(allocator: std.mem.Allocator, encoded: []const u8) ![]u8 { 3038 var out: std.ArrayList(u8) = .empty; 3039 errdefer out.deinit(allocator); 3040 var i: usize = 0; 3041 while (i < encoded.len) : (i += 1) { 3042 switch (encoded[i]) { 3043 '+' => try out.append(allocator, ' '), 3044 '%' => { 3045 if (i + 2 >= encoded.len) return error.InvalidPercentEncoding; 3046 const hi = std.fmt.charToDigit(encoded[i + 1], 16) catch return error.InvalidPercentEncoding; 3047 const lo = std.fmt.charToDigit(encoded[i + 2], 16) catch return error.InvalidPercentEncoding; 3048 try out.append(allocator, hi * 16 + lo); 3049 i += 2; 3050 }, 3051 else => try out.append(allocator, encoded[i]), 3052 } 3053 } 3054 return try out.toOwnedSlice(allocator); 3055 } 3056 3057 // disk-backed web session store. each login mints a random, opaque token 3058 // (not the user's id) that is stored as a file named by the token hex, whose 3059 // contents are the raw user_id bytes. authenticating a request is a lookup of 3060 // the cookie's token; logout deletes the file, revoking the session. there is 3061 // deliberately no expiry — a session lives until logout. form failures use 3062 // files in the flash subdirectory that the redirected GET consumes. the 3063 // directory is cleared whenever the server starts. 3064 pub const SessionStore = struct { 3065 io: std.Io, 3066 dir: std.Io.Dir, 3067 flash_dir: std.Io.Dir, 3068 auto_login: ?[token_hex_len]u8, 3069 3070 pub const token_hex_len = evt.event_id_size * 2; 3071 3072 pub fn init(io: std.Io, data_dir: std.Io.Dir) !SessionStore { 3073 try data_dir.createDirPath(io, "sessions"); 3074 const dir = try data_dir.openDir(io, "sessions", .{}); 3075 errdefer dir.close(io); 3076 try dir.deleteTree(io, "flash"); 3077 try dir.createDirPath(io, "flash"); 3078 const flash_dir = try dir.openDir(io, "flash", .{}); 3079 errdefer flash_dir.close(io); 3080 const auto_login = blk: { 3081 const file = dir.openFile(io, auto_login_name, .{ .mode = .read_only }) catch break :blk null; 3082 defer file.close(io); 3083 var token: [token_hex_len]u8 = undefined; 3084 var storage: [token_hex_len]u8 = undefined; 3085 var reader = file.reader(io, &storage); 3086 reader.interface.readSliceAll(&token) catch break :blk null; 3087 break :blk token; 3088 }; 3089 return .{ .io = io, .dir = dir, .flash_dir = flash_dir, .auto_login = auto_login }; 3090 } 3091 3092 pub fn deinit(self: SessionStore) void { 3093 self.flash_dir.close(self.io); 3094 self.dir.close(self.io); 3095 } 3096 3097 // mint a new session for user_id, returning the token hex to set as the 3098 // cookie value. 3099 pub fn create(self: SessionStore, user_id: *const [evt.event_id_size]u8) ![token_hex_len]u8 { 3100 var token: [evt.event_id_size]u8 = undefined; 3101 self.io.random(&token); 3102 const token_hex = std.fmt.bytesToHex(token, .lower); 3103 const file = try self.dir.createFile(self.io, &token_hex, .{}); 3104 defer file.close(self.io); 3105 try file.writeStreamingAll(self.io, user_id); 3106 return token_hex; 3107 } 3108 3109 fn createFlash(self: SessionStore, allocator: std.mem.Allocator, value: ui.Session.FormFeedback) ![token_hex_len]u8 { 3110 var token: [evt.event_id_size]u8 = undefined; 3111 self.io.random(&token); 3112 const token_hex = std.fmt.bytesToHex(token, .lower); 3113 const file = try self.flash_dir.createFile(self.io, &token_hex, .{}); 3114 errdefer self.flash_dir.deleteFile(self.io, &token_hex) catch {}; 3115 defer file.close(self.io); 3116 3117 var json: std.Io.Writer.Allocating = .init(allocator); 3118 defer json.deinit(); 3119 try std.json.Stringify.value(value, .{}, &json.writer); 3120 try file.writeStreamingAll(self.io, json.written()); 3121 return token_hex; 3122 } 3123 3124 fn takeFlash(self: SessionStore, allocator: std.mem.Allocator, token_hex: []const u8) ?ui.Session.FormFeedback { 3125 if (!isToken(token_hex)) return null; 3126 const file = self.flash_dir.openFile(self.io, token_hex, .{ .mode = .read_only }) catch return null; 3127 defer self.flash_dir.deleteFile(self.io, token_hex) catch {}; 3128 defer file.close(self.io); 3129 3130 var storage: [4096]u8 = undefined; 3131 var reader = file.reader(self.io, &storage); 3132 const bytes = reader.interface.allocRemaining(allocator, .limited(512 * 1024)) catch return null; 3133 return std.json.parseFromSliceLeaky(ui.Session.FormFeedback, allocator, bytes, .{}) catch null; 3134 } 3135 3136 // resolve a cookie's token to its user_id. returns false (logged out) for a 3137 // missing, malformed, or unknown token. 3138 pub fn lookup(self: SessionStore, token_hex: []const u8, out: *[evt.event_id_size]u8) bool { 3139 if (!isToken(token_hex)) return false; 3140 const file = self.dir.openFile(self.io, token_hex, .{ .mode = .read_only }) catch return false; 3141 defer file.close(self.io); 3142 var storage: [evt.event_id_size]u8 = undefined; 3143 var file_reader = file.reader(self.io, &storage); 3144 file_reader.interface.readSliceAll(out) catch return false; 3145 return true; 3146 } 3147 3148 // revoke a session. a no-op for a missing or malformed token. 3149 pub fn remove(self: SessionStore, token_hex: []const u8) void { 3150 if (!isToken(token_hex)) return; 3151 self.dir.deleteFile(self.io, token_hex) catch {}; 3152 } 3153 3154 // leave `token_hex`'s session for visitors arriving without one. only the 3155 // `try` fixture writes one. the name can't collide with a session token. 3156 pub fn offerAutoLogin(self: SessionStore, token_hex: *const [token_hex_len]u8) !void { 3157 const file = try self.dir.createFile(self.io, auto_login_name, .{}); 3158 defer file.close(self.io); 3159 try file.writeStreamingAll(self.io, token_hex); 3160 } 3161 3162 pub fn autoLogin(self: SessionStore, out: *[token_hex_len]u8) bool { 3163 out.* = self.auto_login orelse return false; 3164 return true; 3165 } 3166 3167 const auto_login_name = "auto-login"; 3168 3169 // a token is exactly token_hex_len hex chars. validating before using the 3170 // value as a path keeps attacker-supplied cookies from escaping the 3171 // sessions dir (e.g. via "/" or ".." bytes). 3172 fn isToken(token_hex: []const u8) bool { 3173 if (token_hex.len != token_hex_len) return false; 3174 for (token_hex) |c| if (!std.ascii.isHex(c)) return false; 3175 return true; 3176 } 3177 }; 3178