Files
notas-online/internal/api/notes.go
T
lgcosta a55591d208 feat: presença por sessão, eventos SSE em tempo real e autosave
- presence.go: hub SSE + registro de presença (TTL 30s por heartbeat)
- GET /api/events (EventSource, auth cookie/Bearer) transmite saved/presence;
  POST /api/presence publica {session, notes[]}; create/update/restore/delete
  publicam savedEvent com a session de origem (eco ignorado pelo autor)
- PUT/POST/restore aceitam campo opcional session
- UI: id de sessão em sessionStorage; selo 👥 na aba, na lista de notas e no
  topo do editor quando outra sessão tem a mesma nota aberta; aba LIMPA
  recarrega sozinha ao receber saved; aba SUJA abre o diálogo de conflito
  automaticamente (conflictPending evita diálogos empilhados)
- Autosave: debounce de 1,5s em qualquer alteração (rascunho vira nota),
  mensagem de revisão 'autosave', status 'salvando…', toggle nas Preferências
- Testes: SSE hello/presence/saved + presença 400/401 via httptest
2026-11-04 13:35:33 -03:00

189 lines
5.1 KiB
Go

package api
import (
"errors"
"io/fs"
"net/http"
"strings"
"github.com/lgcosta/notas-online/internal/store"
)
// serveIndex entrega o shell da aplicação.
func (s *Server) serveIndex(w http.ResponseWriter, r *http.Request) {
data, err := fs.ReadFile(s.webFS, "index.html")
if err != nil {
http.Error(w, "frontend ausente no binário", http.StatusInternalServerError)
return
}
w.Header().Set("Content-Type", "text/html; charset=utf-8")
w.Header().Set("Cache-Control", "no-cache")
_, _ = w.Write(data)
}
// noteInput é o corpo aceito por POST/PUT de notas.
type noteInput struct {
Title string `json:"title"`
Format string `json:"format"`
Categories []string `json:"categories"` // IDs da árvore de categorias
Content string `json:"content"`
Author string `json:"author"`
Message string `json:"message"`
BaseHash string `json:"base_hash"` // hash em que a edição se baseia (opcional; evita sobrescrever mudanças remotas)
Session string `json:"session"` // id da sessão do cliente (presença/eventos; opcional)
}
func (in noteInput) fields() (string, string, []string, string, string, string, string) {
f := in.Format
if f == "" {
f = store.FormatTxt
}
return in.Title, f, in.Categories, in.Content, in.Author, in.Message, in.BaseHash
}
// noteView é a representação completa (meta + conteúdo) de uma nota.
type noteView struct {
*store.Note
Content string `json:"content"`
}
func (s *Server) handleListNotes(w http.ResponseWriter, r *http.Request) {
q := r.URL.Query()
recursive := q.Get("recursive") != "0"
notes, err := s.st.List(store.Filter{
Category: q.Get("category"),
Recursive: recursive,
Tag: q.Get("tag"),
Query: q.Get("q"),
})
if err != nil {
mapStoreError(w, err)
return
}
if notes == nil {
notes = []*store.Note{}
}
writeJSON(w, http.StatusOK, notes)
}
func (s *Server) handleCreateNote(w http.ResponseWriter, r *http.Request) {
var in noteInput
if err := decodeJSON(r, &in, maxBody); err != nil {
writeError(w, http.StatusBadRequest, "corpo JSON inválido")
return
}
title, format, categories, content, author, message, _ := in.fields()
n, err := s.st.Create(title, format, categories, content, author, message)
if err != nil {
mapStoreError(w, err)
return
}
s.publishSaved(n, author, in.Session, false)
writeJSON(w, http.StatusCreated, noteView{n, content})
}
func (s *Server) handleGetNote(w http.ResponseWriter, r *http.Request) {
content, n, err := s.st.Content(r.PathValue("id"))
if err != nil {
mapStoreError(w, err)
return
}
writeJSON(w, http.StatusOK, noteView{n, content})
}
func (s *Server) handleUpdateNote(w http.ResponseWriter, r *http.Request) {
var in noteInput
if err := decodeJSON(r, &in, maxBody); err != nil {
writeError(w, http.StatusBadRequest, "corpo JSON inválido")
return
}
title, format, categories, content, author, message, baseHash := in.fields()
n, err := s.st.Update(r.PathValue("id"), title, format, categories, content, author, message, baseHash)
if errors.Is(err, store.ErrConflict) {
// 409 com o estado atual: o cliente decide entre recarregar ou forçar.
writeJSON(w, http.StatusConflict, map[string]any{
"error": "a nota foi alterada em outro dispositivo",
"server_hash": n.Hash,
"updated_at": n.UpdatedAt,
})
return
}
if err != nil {
mapStoreError(w, err)
return
}
s.publishSaved(n, author, in.Session, false)
writeJSON(w, http.StatusOK, noteView{n, content})
}
func (s *Server) handleDeleteNote(w http.ResponseWriter, r *http.Request) {
id := r.PathValue("id")
n, err := s.st.Get(id)
if err != nil {
mapStoreError(w, err)
return
}
if err := s.st.Delete(id); err != nil {
mapStoreError(w, err)
return
}
s.publishSaved(n, "", "", true)
w.WriteHeader(http.StatusNoContent)
}
// handleRaw baixa a nota como arquivo (Content-Disposition attachment).
func (s *Server) handleRaw(w http.ResponseWriter, r *http.Request) {
content, n, err := s.st.Content(r.PathValue("id"))
if err != nil {
mapStoreError(w, err)
return
}
ctype := "text/plain; charset=utf-8"
switch n.Format {
case store.FormatMD:
ctype = "text/markdown; charset=utf-8"
case store.FormatHTML:
ctype = "text/html; charset=utf-8"
}
w.Header().Set("Content-Type", ctype)
w.Header().Set("Content-Disposition",
`attachment; filename="`+sanitizeFilename(n.Filename())+`"`)
w.Header().Set("Cache-Control", "no-store")
_, _ = w.Write([]byte(content))
}
// sanitizeFilename elimina caracteres que quebrariam o header.
func sanitizeFilename(name string) string {
return strings.Map(func(r rune) rune {
switch r {
case '"', '\\', '\n', '\r', '/':
return '_'
}
return r
}, name)
}
func (s *Server) handleTags(w http.ResponseWriter, r *http.Request) {
tags, err := s.st.Tags()
if err != nil {
mapStoreError(w, err)
return
}
if tags == nil {
tags = []store.TagCount{}
}
writeJSON(w, http.StatusOK, tags)
}
func (s *Server) handleCategories(w http.ResponseWriter, r *http.Request) {
cats, err := s.st.Categories()
if err != nil {
mapStoreError(w, err)
return
}
if cats == nil {
cats = []store.CategoryView{}
}
writeJSON(w, http.StatusOK, cats)
}