feat(share): library deep links (psysonic2) with paste + toolbar actions (#261)

* feat(share): library deep links (psysonic2) with paste and toolbar actions Add base64url-encoded payloads for track, album, artist, and ordered queue. Handle paste outside inputs to switch server, validate entities, navigate or play. Reuse clipboard helper for context menu, queue panel, album and artist headers. Tests distinguish server invite strings from library shares. * fix(share): play partial queue when some shared tracks are missing Skip unavailable song IDs when pasting a queue share while preserving order. Toast when some tracks are missing; error only if none resolve. Add openedQueuePartial and queueAllUnavailable i18n; remove queueTracksMissing. * feat(settings): paste server invites globally and scroll to add form Handle psysonic1- magic strings outside inputs: navigate to settings or login with prefilled add-server fields. Decode invites embedded in surrounding text. Scroll the add-server block into view when opening from a paste so long server lists stay oriented. --------- Co-authored-by: Maxim Isaev <im@friclub.ru>
2026-07-22 07:15:47 +00:00 · 2026-04-22 11:21:00 +02:00
parent 21d00889aa
commit 7c9a300022
22 changed files with 779 additions and 18 deletions
@@ -0,0 +1,113 @@
+import type { NavigateFunction } from 'react-router-dom';
+import type { TFunction } from 'i18next';
+import { getAlbum, getArtist, getSong, type SubsonicSong } from '../api/subsonic';
+import { useAuthStore } from '../store/authStore';
+import { songToTrack, usePlayerStore } from '../store/playerStore';
+import { findServerIdForShareUrl, type SharePayloadV1 } from './shareLink';
+import { showToast } from './toast';
+
+const RESOLVE_QUEUE_CHUNK = 12;
+
+/**
+ * Switches to the matching server, validates the entity on the server, then
+ * plays or navigates. Caller should `preventDefault` on the paste event when
+ * the payload was already decoded successfully.
+ */
+export async function applySharePastePayload(
+  payload: SharePayloadV1,
+  navigate: NavigateFunction,
+  t: TFunction,
+): Promise<void> {
+  const { servers, isLoggedIn, setActiveServer } = useAuthStore.getState();
+  if (!isLoggedIn) {
+    showToast(t('sharePaste.notLoggedIn'), 4000, 'info');
+    return;
+  }
+
+  const serverId = findServerIdForShareUrl(servers, payload.srv);
+  if (!serverId) {
+    showToast(t('sharePaste.noMatchingServer', { url: payload.srv }), 6000, 'error');
+    return;
+  }
+
+  if (useAuthStore.getState().activeServerId !== serverId) {
+    setActiveServer(serverId);
+  }
+
+  try {
+    if (payload.k === 'track') {
+      const song = await getSong(payload.id);
+      if (!song) {
+        showToast(t('sharePaste.trackUnavailable'), 5000, 'error');
+        return;
+      }
+      const track = songToTrack(song);
+      usePlayerStore.getState().clearQueue();
+      usePlayerStore.getState().playTrack(track, [track]);
+      showToast(t('sharePaste.openedTrack'), 3000, 'info');
+      return;
+    }
+
+    if (payload.k === 'album') {
+      try {
+        await getAlbum(payload.id);
+      } catch {
+        showToast(t('sharePaste.albumUnavailable'), 5000, 'error');
+        return;
+      }
+      navigate(`/album/${payload.id}`);
+      showToast(t('sharePaste.openedAlbum'), 3000, 'info');
+      return;
+    }
+
+    if (payload.k === 'artist') {
+      try {
+        await getArtist(payload.id);
+      } catch {
+        showToast(t('sharePaste.artistUnavailable'), 5000, 'error');
+        return;
+      }
+      navigate(`/artist/${payload.id}`);
+      showToast(t('sharePaste.openedArtist'), 3000, 'info');
+      return;
+    }
+
+    if (payload.k === 'queue') {
+      const { ids } = payload;
+      if (ids.length === 0) {
+        showToast(t('sharePaste.genericError'), 5000, 'error');
+        return;
+      }
+      const resolved: SubsonicSong[] = [];
+      for (let i = 0; i < ids.length; i += RESOLVE_QUEUE_CHUNK) {
+        const chunk = ids.slice(i, i + RESOLVE_QUEUE_CHUNK);
+        const songs = await Promise.all(chunk.map(id => getSong(id)));
+        for (let j = 0; j < songs.length; j++) {
+          const s = songs[j];
+          if (s) resolved.push(s);
+        }
+      }
+      const skipped = ids.length - resolved.length;
+      if (resolved.length === 0) {
+        showToast(t('sharePaste.queueAllUnavailable'), 6000, 'error');
+        return;
+      }
+      const tracks = resolved.map(songToTrack);
+      usePlayerStore.getState().clearQueue();
+      usePlayerStore.getState().playTrack(tracks[0]!, tracks);
+      if (skipped > 0) {
+        showToast(
+          t('sharePaste.openedQueuePartial', { played: tracks.length, total: ids.length, skipped }),
+          5000,
+          'info',
+        );
+      } else {
+        showToast(t('sharePaste.openedQueue', { count: tracks.length }), 3000, 'info');
+      }
+      return;
+    }
+  } catch (e) {
+    console.error('[psysonic] share paste failed', e);
+    showToast(t('sharePaste.genericError'), 5000, 'error');
+  }
+}