sonda/internal/api/http
Repository files (latest commit first)
Filename Latest commit message Latest commit date
tgiachi 9f4da2e77e feat(providers): provider settings in a table and a careful outbound HTTP client
- feat(storage): provider_settings table (provider, enabled, api_key, contact);
  migration 0007 for both drivers. A provider with no row, or turned off, is
  never contacted
- feat(providers): a service that validates and applies settings: a Last.fm key
  is 32 hexadecimal characters, enabling a provider that needs a key without
  one is refused, clearing the key turns the provider off, a contact cannot
  contain parentheses or control characters. Each provider states what it sends
  and under which terms, and what it never sends
- feat(api): admin-only GET /providers and PUT /providers/{name}. The API key is
  write-only: responses carry only has_api_key, errors never repeat it and the
  request log never contains it (tested)
- feat(providers/outbound): the only way Sonda talks to the outside: plain GET
  with an identifiable User-Agent, no cookies, no Referer, no Authorization, no
  redirects, bounded answers, a timeout per attempt, a minimum interval between
  requests, retries with exponential backoff that honour Retry-After without
  waiting past the caller's deadline or for an absurd time, and a circuit
  breaker that makes a failing provider fail fast
- feat(providers): UserAgent builds "Sonda/version ( contact )" as MusicBrainz
  asks, defaulting to the project address so no personal address is sent
- breaking(config): providers.lastfm and SONDA_LASTFM_API_KEY are gone; an old
  config, or the variable, fails with a hint instead of being ignored
- docs: OpenAPI operations and schemas, README section on the providers and on
  what leaves the server
- test: fake servers and a fake clock only; no network in the suite
2026-11-11 16:07:12 +01:00
..
api_test.go feat(providers): provider settings in a table and a careful outbound HTTP client 2026-11-11 16:07:12 +01:00
auth_test.go fix(listening): report a deleted account first and document one event per play 2026-11-11 15:02:28 +01:00
catalog_test.go feat(catalog): add the read API for artists, albums and tracks 2026-11-11 13:43:38 +01:00
contract_test.go feat(providers): provider settings in a table and a careful outbound HTTP client 2026-11-11 16:07:12 +01:00
docs.go fix(api): make the spec say what the code does, and make the tests prove it 2026-11-11 14:46:28 +01:00
docs_test.go fix(api): make the spec say what the code does, and make the tests prove it 2026-11-11 14:46:28 +01:00
errors.go feat: add sondad server with config, storage, auth and listening API 2026-11-11 12:06:15 +01:00
handlers_auth.go feat(auth): add refresh tokens, admin role and user management 2026-11-11 12:38:42 +01:00
handlers_catalog.go fix(catalog): keep albums apart, align album counts, reject bad search text 2026-11-11 13:47:31 +01:00
handlers_libraries.go fix(library): make the libraries upgrade and validation robust 2026-11-11 13:34:44 +01:00
handlers_library.go feat(library): count unsupported audio formats and skip NAS system folders 2026-11-11 14:25:33 +01:00
handlers_listen.go feat(listening): count a listen after a minimum play time and expose the history 2026-11-11 14:58:47 +01:00
handlers_providers.go feat(providers): provider settings in a table and a careful outbound HTTP client 2026-11-11 16:07:12 +01:00
handlers_stream.go feat(streaming): stream tracks with HTTP Range support 2026-11-11 12:56:20 +01:00
handlers_users.go feat(auth): add refresh tokens, admin role and user management 2026-11-11 12:38:42 +01:00
libraries_test.go fix(library): make the libraries upgrade and validation robust 2026-11-11 13:34:44 +01:00
library_test.go feat(library): count unsupported audio formats and skip NAS system folders 2026-11-11 14:25:33 +01:00
listens_test.go feat(listening): count a listen after a minimum play time and expose the history 2026-11-11 14:58:47 +01:00
middleware.go fix(api): make the spec say what the code does, and make the tests prove it 2026-11-11 14:46:28 +01:00
providers_test.go feat(providers): provider settings in a table and a careful outbound HTTP client 2026-11-11 16:07:12 +01:00
router.go feat(providers): provider settings in a table and a careful outbound HTTP client 2026-11-11 16:07:12 +01:00
stream_test.go feat(library): named media libraries managed through the API 2026-11-11 13:30:25 +01:00