sonda/web
Repository files (latest commit first)
Filename Latest commit message Latest commit date
tgiachi 89826fcd07 feat(federation): shared libraries and the signed read API for friends
A friend's server can now read what an admin chose to share.

- A library has a shared flag, off by default (migration 0024), set with
  PATCH /libraries/{id}. Changing it never waits for a scan.
- Requests between friends are signed with each server's Ed25519 key: the
  method, the path and query from /api/v1/peer on, a date, a nonce and the
  hash of the empty body. A date more than two minutes off, a nonce used
  before, an unknown or removed key and a bad signature all get the same
  401. A friend still waiting for approval gets 403, and while federation is
  off the routes are missing.
- Routes under /api/v1/peer: info, artists, albums, tracks, covers and
  streaming with Range. The catalogue, the counts and the format come from
  the shared libraries only, and the file served is the one in a shared
  library. No path, library id, listen, taste, user or provider data is part
  of an answer.
- A friend never makes this server build a cover, read an audio file or ask
  a provider: only covers already built from the audio files are served.
- Per-friend limits, set by the admin: parallel streams (default 3) and KiB
  a second (default 4096, 0 for none), shared by all the streams of a friend.
- A log of the last requests friends made (route, status, bytes; never the
  query), kept for 7 days, in GET /federation/requests.
- POST /federation/friends/{id}/check lets the side that pasted an invite
  find out that the other admin approved; a signed call from a friend this
  server is waiting for makes it active too.
- Admin: a Shared with friends switch on each library, which asks first, and
  limits, recent requests and a Check button in the Federation section, in
  English and Italian.
- OpenAPI paths and schemas, contract test, two real servers checked end to
  end with tagged audio files.
2026-11-13 15:04:07 +01:00
..
public feat(web): the app can be installed and opens offline (PWA) 2026-11-13 12:22:00 +01:00
scripts feat(web): scaffold the React app with Vite, Tailwind and shadcn/ui 2026-11-12 11:15:50 +01:00
src feat(federation): shared libraries and the signed read API for friends 2026-11-13 15:04:07 +01:00
.gitignore feat(web): scaffold the React app with Vite, Tailwind and shadcn/ui 2026-11-12 11:15:50 +01:00
.oxlintrc.json feat(web): scaffold the React app with Vite, Tailwind and shadcn/ui 2026-11-12 11:15:50 +01:00
components.json feat(web): scaffold the React app with Vite, Tailwind and shadcn/ui 2026-11-12 11:15:50 +01:00
index.html feat(web): the app can be installed and opens offline (PWA) 2026-11-13 12:22:00 +01:00
package-lock.json feat(web): scaffold the React app with Vite, Tailwind and shadcn/ui 2026-11-12 11:15:50 +01:00
package.json feat(web): scaffold the React app with Vite, Tailwind and shadcn/ui 2026-11-12 11:15:50 +01:00
tsconfig.app.json feat(web): four themes with a contrast test 2026-11-12 11:17:41 +01:00
tsconfig.json feat(web): scaffold the React app with Vite, Tailwind and shadcn/ui 2026-11-12 11:15:50 +01:00
tsconfig.node.json feat(web): scaffold the React app with Vite, Tailwind and shadcn/ui 2026-11-12 11:15:50 +01:00
vite.config.ts feat: embed the built web app in sondad behind the webui build tag 2026-11-12 15:56:34 +01:00