Novinky

Podrobnější informace o změnách v jednotlivých verzích naleznete přímo v GitHub Releases.

v1.3.0

• 🌐 PgArachne Explorer – moderní PWA: Kompletní vizuální a funkční obnova – tmavý/světlý motiv (automaticky), responzivní rozložení karet, zvýrazňování syntaxe JSON, tlačítko pro kopírování, lepší UX přihlašování (záložky heslo/token), podpora instalace PWA (manifest, ikony, service worker), sdílitelné odkazy pomocí parametru ?url=….
• 🛠️ Podpora Model Context Protocol (MCP): Nový endpoint /{prefix}/{db}/mcp se standardními metodami resources/list, resources/read, prompts/list, prompts/get – plně podporovaný funkcemi PostgreSQL a znovu využívající stávající autentizaci a přepínání rolí.
• 🔧 Konfigurovatelný prefix API: Výchozí hodnota změněna na /db/{database}/jsonrpc a /db/{database}/sse. Staré cesty /api/… nyní vrací trvalé přesměrování 307. Řízeno novou proměnnou prostředí API_PREFIX.
• 🛡️ Ochrana idempotence: Volitelné pole idempotencyKey v JSON-RPC požadavcích – automatická detekce duplicit (HTTP 409 + chybový kód při kolizi) pomocí pgarachne.save_idempotency_key().
• 📚 Vylepšení dokumentace: Nová sekce /tools/ s kartami (Explorer + chystaný macOS Toolbar), nová stránka“Architectural Decisions”, SECURITY.md s instrukcemi pro hlášení zranitelností, lepší typografie ve všech jazycích díky TypoLima, vylepšená podpora stránky 404 pro GitHub Pages.
• 📝 Přejmenování metody přihlášení: JSON-RPC metoda login byla přejmenována na get_jwt (starý název zůstává jako zastaralý alias s varováním v logu).
• 📊 Vyčištění logování: Při logování do souboru se na konzoli zobrazují pouze minimální informace o spuštění → čistší výstup v produkčních/docker prostředích.

v1.2.0

• 🛡️ Bezpečnost: Validace přístupových tokenů probíhá ještě před navázáním spojení s databází. Zlepšena ochrana proti podvržení IP adres (přidáno nastavení TRUSTED_PROXIES) a skrytí interních databázových chyb před koncovým uživatelem.
• 📊 Izolované metriky: Prometheus endpoint /metrics se přesunul z veřejného API na vlastní zabezpečený port (ve výchozím stavu dostupný pouze na 127.0.0.1:9090).
• 📦 Nová možnost instalace: Projekt má nyní oficiální Homebrew tap pro macOS a Linux. Buildy jsou podepsané a generované přes GoReleaser.
• 📚 Přepracovaná dokumentace: Zcela nový vzhled postavený na frameworku Hugo. Přidáno bleskové full-textové vyhledávání, možnost kopírování kódu a příklady pro produkční nasazení (Nginx hardening, BYO JWT).
• ⚙️ Vylepšená správa démona: Přidána podpora pro vlastní konfiguraci cesty k PID_FILE.

v1.1.0

• 🔌 Sjednocené API: Volání přes POST /api/<db> (volaná metoda je specifikována v JSON-RPC body).
• ⚡ Real-time notifikace: Nový endpoint GET /sse/<db>?channels=... pro poslouchání událostí z databáze s podporou více kanálů.
• 📈 Observabilita: Detailní Prometheus metriky pro HTTP, auth, JSON-RPC a SSE.
• 🏋️ Zásadní zvýšení stability: Ochrana proti pomalým klientům, striktní timeouty a automatické čištění spojení.