Commit graph

156 commits

Author SHA1 Message Date
tgiachi
f447a11269 fix(web): wait for the address in the search page test instead of assuming it
The test read the address right after the Artists section appeared, but the address is updated by an effect a moment later. On a busy machine it failed in every full run and passed alone. Closes #80.
2026-11-12 15:41:47 +01:00
squidd
e018bfde38 Merge pull request 'feat(web): bulk jobs in the admin area (F3d)' (#79) from feat/admin-jobs into main 2026-11-12 15:38:24 +01:00
tgiachi
82f6e91d7a feat(web): a Jobs section in the admin area
Three cards at /admin/jobs, for admins only; anyone else gets the notice and the server is not asked. The page reads which providers are on to block a job whose provider is off. README says the admin area now covers everything the API offers an admin.
2026-11-12 15:34:33 +01:00
tgiachi
3ca3226e91 feat(web): a card for each bulk job, with what it sends, progress, stop and the last result
Starting asks first and says the job goes through the whole library and what it sends; reading everything again is a separate choice. A job whose providers are off cannot be started and the card says which. The status follows the job while it runs.
2026-11-12 15:33:24 +01:00
tgiachi
c8bad5538b feat(web): hooks for the bulk jobs (covers, artist pictures, descriptions)
One set of hooks for the three jobs: read the status (again and again while it runs, by itself stopping), start (optionally reading everything again) and stop.
2026-11-12 15:31:53 +01:00
squidd
8339b043b7 Merge pull request 'feat(web): volume control in the player' (#78) from feat/volume into main 2026-11-12 15:29:36 +01:00
tgiachi
f1b99aed0a fix(web): line the volume control up with the other controls in the full-screen player 2026-11-12 15:24:41 +01:00
tgiachi
99d25acd9a feat(web): the volume control in the player bar and the full-screen player
Both places move the same volume. README mentions it.
2026-11-12 15:23:50 +01:00
tgiachi
606845ae72 feat(web): a volume control with a mute button and a slider
The slider shows zero while muted and moving it unmutes; on a phone the slider is hidden, since the device has its own volume, and the button stays.
2026-11-12 15:22:57 +01:00
tgiachi
edab170d3f feat(web): the audio follows the volume and mute of the player
The audio starts at the remembered level and follows every change, also while a track plays; once the engine is gone it is left alone.
2026-11-12 15:22:23 +01:00
tgiachi
394208de75 feat(web): volume and mute in the player state, remembered in the browser
The level is kept while muted so unmuting brings it back, moving it unmutes, pressing mute on silence raises it instead of doing nothing, and a browser that refuses storage just forgets it.
2026-11-12 15:21:41 +01:00
squidd
dd128a315f Merge pull request 'feat(web): external providers in the admin area (F3c)' (#76) from feat/admin-providers into main 2026-11-12 15:16:56 +01:00
tgiachi
fed1213030 feat(web): a Providers section in the admin area
One card for each provider at /admin/providers, for admins only; anyone else gets the notice and the server is not asked. README says what the admin area covers.
2026-11-12 15:12:23 +01:00
tgiachi
369bd2ec3f feat(web): choose what is sent to Lidarr when an artist is added
Nothing is asked of Lidarr until the admin loads its choices on purpose, which needs its address and a key. A folder Lidarr cannot use is shown and cannot be picked; saving sends all the options at once.
2026-11-12 15:11:20 +01:00
tgiachi
0ddcaff8e1 feat(web): the provider card with the switch, the write-only key, contact, address, test and removing data
Turning a provider on asks first and repeats what it will be sent; one that needs a key or an address cannot be turned on without it and the card says why. The key is never shown or filled in, and is gone from the page once saved; removing it says it also turns the provider off. The confirm dialog is now shared with the users section.
2026-11-12 15:09:54 +01:00
tgiachi
c3edc564f4 feat(web): hooks for the external providers
List them, change one (only the fields given are sent), test a key, remove what a provider gave, and read what Lidarr offers only when asked.
2026-11-12 15:05:42 +01:00
squidd
fc499214b4 Merge pull request 'feat(web): users in the admin area (F3b)' (#73) from feat/admin-users into main 2026-11-12 15:02:50 +01:00
tgiachi
a39c0f7719 fix(web): clear the short-password complaint when the password is changed
Found in a real browser: after the complaint, typing a valid password left it on screen until the next submit. Same in the reset dialog and the add form.
2026-11-12 14:59:37 +01:00
tgiachi
52569a0f8d feat(web): a Users section in the admin area
Opens at /admin/users next to Libraries, for admins only; anyone else gets the notice and the server is not asked. README says what the admin area covers.
2026-11-12 14:58:01 +01:00
tgiachi
9b1594e9f2 feat(web): the user list with its actions and the form to add a user
Give the admin role at once, take it away or delete an account after a question, reset a password in a dialog that forgets it (and ends that person's sessions), and add an account by email. Your own row has no buttons, and the last admin cannot be changed: the page says so.
2026-11-12 14:57:22 +01:00
tgiachi
b190835185 feat(web): hooks for listing, creating, changing and deleting users
Listing, creating, giving or taking the admin role, resetting a password and deleting, each refreshing the list when the list changes.
2026-11-12 14:55:26 +01:00
tgiachi
04526f8576 fix(web): build test users with an email address, so the type check passes
The tests of Discover, the Lidarr button and the admin libraries built a signed-in user with a username, which no longer exists since accounts are identified by email. They passed, but the type check failed on 18 fixtures and so did npm run build. Closes #71.
2026-11-12 14:52:20 +01:00
squidd
0b9d158f2b Merge pull request 'feat(web): admin area with libraries and scanning (F3a)' (#70) from feat/admin-libraries into main 2026-11-12 14:49:29 +01:00
tgiachi
d88710fd73 feat(web): the Admin area with libraries and scanning, and an Admin link for admins
The Admin link is shown only to an admin and /admin opens the libraries. Someone else who opens the address gets a notice and the server is not asked anything. README describes what the admin area covers so far.
2026-11-12 14:44:08 +01:00
tgiachi
3dd85fc230 feat(web): admin layout, library list, add form and scan panel
The admin frame shows its sections only to an admin and asks nothing of the server for anyone else. Libraries can be added, edited (only what changed is sent) and removed after a confirmation that says the music on disk is never touched; a scan can be started for one library or all, optionally reading every file again, and the panel follows it and shows the summary, with the files in unsupported formats standing out.
2026-11-12 14:42:54 +01:00
squidd
7b24f76c46 Merge pull request 'feat(auth): accounts are identified by an email address' (#69) from feat/email-login into main 2026-11-12 14:41:32 +01:00
tgiachi
96ad8b1f62 feat(auth): accounts are identified by an email address
Registration, login and the admin's create-user call take `email` instead of
`username`, and the user object returns `email`. The address is checked for its
shape (a plain address, no display name, at most 254 bytes), trimmed, lowercased
and unique. Sonda sends no mail and does not verify it.

- Migration 0018 renames the users column (and the PostgreSQL index); values are
  kept, so an account made before keeps its plain name and still logs in with it
  (login does not check the shape).
- Error code username_taken becomes email_taken; the JWT claim is now `email`,
  so access tokens issued before the upgrade are refused once and clients refresh.
- OpenAPI spec, README, the web login form (type email), strings (en, it) and
  the generated API types follow.

Closes #65
2026-11-12 14:40:33 +01:00
tgiachi
1f8498f6ea feat(web): hooks for libraries and scanning
List, add, rename or move and remove libraries, start a scan of one or all (reading every file again on request), and follow the scan by reading its status while it runs.
2026-11-12 14:40:22 +01:00
squidd
04906fa8da Merge pull request 'feat(web): Request on Lidarr button for admins (F2b)' (#67) from feat/lidarr-button into main 2026-11-12 14:34:01 +01:00
tgiachi
6d830a3f21 docs: the Lidarr button in the web app section 2026-11-12 14:31:53 +01:00
tgiachi
0527a12c87 feat(web): the Lidarr button on the artist page and on Discover cards
The artist page reads what Lidarr has first, so it also works for an artist the library has nothing of. A card does not ask Lidarr anything until an admin sends the artist.
2026-11-12 14:30:29 +01:00
tgiachi
67205ec2e1 feat(web): the Request on Lidarr button, for admins, with a confirmation first
Only an admin gets it. It reads what Lidarr has before showing itself (or, on a list card, not at all), asks before sending, sends one artist once, and explains every outcome in words, including a timeout that rereads the state. The API types are regenerated from the spec, which gained the Lidarr endpoints and providers since they were last built.
2026-11-12 14:29:46 +01:00
tgiachi
9dcb7637e7 feat(web): hooks to read and send an artist to Lidarr
Reading is a status, never an error. Sending is one POST for one artist; when it worked, or Lidarr did not answer in time, what Lidarr has is read again.
2026-11-12 14:28:17 +01:00
squidd
bfcf954673 Merge pull request 'feat(web): Discover, wishlist and not-interested lists (F2a)' (#64) from feat/discover-wishlist into main 2026-11-12 14:24:36 +01:00
tgiachi
44dbc727aa fix(web): no photo lookups for artists you do not have, and stale suggestions after changes
A suggestion for an artist outside the library no longer asks for its photo, since that makes the server look the name up at the providers for every card. Changing a wish or a dismissal marks the kept suggestions old without asking Discover at once. Visible focus on the switch, the tabs and the chip buttons.
2026-11-12 14:17:05 +01:00
tgiachi
edbe212f46 fix(web): clear the artist box after choosing, wrap suggestion cards on phones
Found in a real browser: after choosing a starting artist the box kept its text and claimed nothing matched, the card's buttons squeezed the name on a phone, and the switch knob was almost invisible when off.
2026-11-12 14:15:51 +01:00
tgiachi
0198a6d10b fix(web): say what to do when Discover starts from a listening that is empty
Found against a real server: with the setting on and nothing played, the answer is empty with no seeds. The page now says to play something or pick an artist, instead of a plain 'no suggestions'.
2026-11-12 14:12:57 +01:00
tgiachi
88d3df9f61 feat(web): the Discover page with its three tabs, a sidebar link and a route
The tab is kept in the address (?tab=) and moves with the arrow keys; only the open tab asks the server for its list. README now describes Discover in the web app.
2026-11-12 14:11:27 +01:00
squidd
850ae11f3d Merge pull request 'perf(storage): fix stale search keys in batches on PostgreSQL' (#63) from perf/refresh-keys-batches into main 2026-11-12 14:10:18 +01:00
tgiachi
6d03b1b661 feat(web): the wishlist and the not-interested lists
Paged rows with remove, not interested and interested again. An artist links to its page only when it is in the library, since one kept alive only by a mark answers 404. The wishlist can hide the artists you already have.
2026-11-12 14:10:07 +01:00
tgiachi
60349153c0 feat(web): the Suggestions tab of Discover with seeds, taste and clear states
Nothing is asked of Discover until there is an artist the user picked or their listening is allowed. Covers a busy server (Retry-After countdown), Last.fm off or failing, cancelling a slow request when leaving, and no automatic retries. Also adds the starting-artist picker and a taste panel.
2026-11-12 14:09:24 +01:00
tgiachi
77be31ea4a perf(storage): fix stale match and search keys in batches on PostgreSQL
The refresh at start fixed each stale row with its own UPDATE. On PostgreSQL that
is one round trip per row: 100,000 stale rows took 5.3 s on localhost, and more
over a network. The rows now go 500 at a time in one UPDATE ... FROM (VALUES ...):
1.9 s for the same rows. SQLite keeps one UPDATE per row, which is faster there
(no round trip to save). A run with nothing to fix is unchanged (about 0.1 s per
100,000 rows).

A test with 1,250 stale rows covers more than two batches on both databases.
2026-11-12 14:08:40 +01:00
tgiachi
71b0b39a07 feat(web): a card for a Discover suggestion with its score explained
Shows the score in percent, the seeds it comes from, a part-by-part explanation (a missing genre is not a zero), and the wishlist and not-interested actions.
2026-11-12 14:06:49 +01:00
tgiachi
3cd0ef7150 feat(web): a switch in Settings for starting Discover from your listening
Turning it on shows a dialog that says the names of the most played artists go to Last.fm. Turning it off asks nothing, and a failed change leaves the switch as it was.
2026-11-12 14:05:49 +01:00
tgiachi
63ed483936 feat(web): data hooks for Discover, the wishlist, dismissed artists, taste and own settings
Suggestions are kept five minutes and cancelled when nobody looks. Wishlist and dismiss change the suggestions at once and go back if the call fails.
2026-11-12 14:04:16 +01:00
tgiachi
54b19d6d4f feat(web): lists in query values, request cancelling and Retry-After in the API client
A list value is sent once per item (seed=1&seed=2). A signal can cancel a request and a cancelled call rejects with AbortError, not as a lost connection. ApiError keeps Retry-After in seconds.
2026-11-12 14:03:11 +01:00
squidd
64c14a51c5 Merge pull request 'feat(web): a button for browser full screen' (#59) from feat/fullscreen-button into main 2026-11-12 12:35:41 +01:00
squidd
5d143ca444 Merge pull request 'feat(docker): an image of sondad and a compose example' (#60) from feat/docker-image into main 2026-11-12 12:31:40 +01:00
tgiachi
95ba06311e fix(docker): keep the secret, quiet health checks, and tighter files
- The README keeps the JWT secret in a file that is passed every time, so an upgrade
  does not make a new one and sign everybody out.
- A health check that succeeds is logged at debug level, so a container does not write
  thousands of lines a day; any other answer, and every other request, still goes at info.
- .dockerignore patterns match in every folder, as .gitignore does.
- compose.yaml waits 15 seconds for Sonda to stop (it allows itself 10) and requires
  MUSIC_DIR instead of creating an empty folder.
- The README says that the library path is the one inside the container, that the health
  check follows SONDA_LISTEN, and that a sonda.toml in /data works as a secrets file.
2026-11-12 12:29:38 +01:00
tgiachi
075e000fd8 feat(web): a button for browser full screen
- one button in the player bar and one in the full-screen player puts the whole page in full screen and takes it out
- it follows the browser: Esc and F11 flip it back, a refused request leaves the page as it was
- left out where the browser has no Fullscreen API (for example iPhone Safari)
- English and Italian labels
2026-11-12 12:28:15 +01:00