feat(api): REST на chi + huma с auth-ручками и OpenAPI 3.1

- переход на chi + huma (решение D-006): huma отдаёт типизированные ручки и
  генерирует документ, auth-ручки живут на chi (cookie и заголовки напрямую)
- единый формат ошибок: код (auth.invalid_credentials, auth.2fa_required,
  perm.denied и т.д.) + человекочитаемое сообщение (AGENT.md 8.5)
- cookie сессии __Host-session: HttpOnly, SameSite=Lax, Secure при TLS;
  альтернатива — Bearer-токен для desktop/CLI (AGENT.md 8.1)
- ручки: register, login, logout, logout-all, sessions, step-up, 2fa/setup,
  2fa/enable, users/@me; IP и User-Agent прокидываются из запроса в контекст
- /api/v1/openapi.json: объединённый документ (схемы huma + контракт auth)
- тесты: регистрация через API с cookie, ошибки входа, обязательная сессия,
  валидация, наличие всех путей в OpenAPI

This commit is contained in:

grendervill

2026-09-19 21:36:00 +03:00

parent 16218ee045

commit f61751ed26

12 changed files with 984 additions and 148 deletions

									
										go.mod
									
		+2
		
												View File
												
				@@ -3,6 +3,8 @@ module glchat

				go 1.26.0

				require (

					github.com/danielgtaylor/huma/v2 v2.39.1

					github.com/go-chi/chi/v5 v5.3.2

					github.com/mattn/go-sqlite3 v1.14.52

					github.com/pquerna/otp v1.5.0

					github.com/pressly/goose/v3 v3.28.0