chore(server): checkpoint deployed services and unfinished forums

User requested a checkpoint and stopped all agents. Deployed artifacts remain the last verified releases; unfinished settings/categories/forums are preserved as WIP. See TODO/roadmap for verification and remaining release/updater work.
This commit is contained in:
Loki 2026-11-01 15:31:20 +01:00
parent d6d406bbf5
commit c18ccadf99
Signed by: boba
GPG key ID: 253067914055423B
96 changed files with 8665 additions and 276 deletions

View file

@ -0,0 +1,25 @@
# Hub community server directory HTTP contract
Listings are unverified user submissions, not endorsements or evidence of server ownership,
reachability, protocol compatibility or safety. Hub performs no DNS resolution or network probes.
This is a Hub HTTP API and does not change LNEx.
- `GET /v1/servers` is public and returns `{ "servers": [...] }`, at most 100
rows ordered by ID ascending. `?after=<UUID>` continues after the final ID.
- `POST /v1/servers` requires the existing session cookie, exact Origin and CSRF token.
JSON fields are `name` (1–80 characters), `address` (public DNS/IP and explicit nonzero
port), and `description` (0–500 characters). Strings are trimmed; controls and bidi
formatting are rejected. DNS names become lowercase; IPs and ports are canonicalized.
Success is 201 `{ "server": {...} }`; duplicate normalized addresses return 409
`address_taken`. A user can hold at most 10 listings (409 `listing_limit`).
- `DELETE /v1/servers/{id}` requires the same session, Origin and CSRF protections.
Owners receive 204; missing and other users' listings receive 404 `server_not_found`.
Each record has `id`, `name`, `address`, `description`, `owner_id`, `created_at`
(Unix seconds). Addresses are globally unique; account deletion cascades to listings.
Mutation bodies are capped at 4096 bytes; JSON errors return 400 `invalid_request`
(or 413 when oversized), invalid field values return 422 `invalid_server`.
Mutation attempts share an independent per-account 10/hour and source 30/hour budget;
public reads use an independent 20/source and 300/global minute budget. Exhaustion returns 429
`try_later`. Storage errors return 503 `try_later`. The proxy must overwrite
X-Forwarded-For as required by the existing Hub authentication contract.