feat(search): queue pasted share links from Live Search and mobile search

Implement share-link detection in search (track, queue, album, artist, composer): enqueue tracks/queues without interrupting playback; preview album/artist/composer without switching the active server; queue preview modal with scrollable track list. Based on community PR #551. Co-authored-by: Daniel Wagner <daniel.iuser@icloud.com>
2026-07-21 22:15:40 +00:00 · 2026-05-15 13:38:35 +03:00
parent 02fd828049
commit e7431b94b8
30 changed files with 2323 additions and 16 deletions
@@ -0,0 +1,98 @@
+import { useCallback, useMemo, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
+import { useTranslation } from 'react-i18next';
+import { useAuthStore } from '../store/authStore';
+import {
+  activateShareSearchServer,
+  enqueueShareSearchPayload,
+} from '../utils/share/enqueueShareSearchPayload';
+import type { ServerProfile } from '../store/authStoreTypes';
+import { findServerIdForShareUrl } from '../utils/share/shareLink';
+import { shareServerOriginLabel } from '../utils/share/shareServerOriginLabel';
+import { parseShareSearchText } from '../utils/share/shareSearch';
+import { useShareSearchPreview } from './useShareSearchPreview';
+
+export function useShareSearch(query: string, onSuccess?: () => void) {
+  const { t } = useTranslation();
+  const navigate = useNavigate();
+  const servers = useAuthStore(s => s.servers);
+  const activeServerId = useAuthStore(s => s.activeServerId);
+  const shareMatch = useMemo(() => parseShareSearchText(query), [query]);
+  const shareServerLabel = useMemo(
+    () => shareServerOriginLabel(shareMatch, servers, activeServerId),
+    [shareMatch, servers, activeServerId],
+  );
+  const shareCoverServer = useMemo((): ServerProfile | null => {
+    if (!shareMatch || shareMatch.type === 'unsupported') return null;
+    const serverId = findServerIdForShareUrl(servers, shareMatch.payload.srv);
+    if (!serverId || serverId === activeServerId) return null;
+    return servers.find(s => s.id === serverId) ?? null;
+  }, [shareMatch, servers, activeServerId]);
+  const preview = useShareSearchPreview(shareMatch);
+  const [shareQueueBusy, setShareQueueBusy] = useState(false);
+
+  const canQueueShareMatch =
+    shareMatch?.type === 'queueable' &&
+    (shareMatch.payload.k === 'queue' ||
+      (!preview.shareTrackResolving && !!preview.shareTrackSong));
+
+  const canOpenShareAlbum =
+    shareMatch?.type === 'album' && !!preview.shareAlbum && !preview.shareAlbumResolving;
+  const canOpenShareArtist =
+    shareMatch?.type === 'artist' && !!preview.shareArtist && !preview.shareArtistResolving;
+  const canOpenShareComposer =
+    shareMatch?.type === 'composer' && !!preview.shareComposer && !preview.shareComposerResolving;
+
+  const hasShareKeyboardTarget =
+    canQueueShareMatch || canOpenShareAlbum || canOpenShareArtist || canOpenShareComposer;
+
+  const openShareAlbum = useCallback(() => {
+    if (shareMatch?.type !== 'album' || !preview.shareAlbum) return;
+    if (!activateShareSearchServer(shareMatch.payload.srv, t)) return;
+    navigate(`/album/${preview.shareAlbum.id}`);
+    onSuccess?.();
+  }, [shareMatch, preview.shareAlbum, navigate, t, onSuccess]);
+
+  const openShareArtist = useCallback(() => {
+    if (shareMatch?.type !== 'artist' || !preview.shareArtist) return;
+    if (!activateShareSearchServer(shareMatch.payload.srv, t)) return;
+    navigate(`/artist/${preview.shareArtist.id}`);
+    onSuccess?.();
+  }, [shareMatch, preview.shareArtist, navigate, t, onSuccess]);
+
+  const openShareComposer = useCallback(() => {
+    if (shareMatch?.type !== 'composer' || !preview.shareComposer) return;
+    if (!activateShareSearchServer(shareMatch.payload.srv, t)) return;
+    navigate(`/composer/${preview.shareComposer.id}`);
+    onSuccess?.();
+  }, [shareMatch, preview.shareComposer, navigate, t, onSuccess]);
+
+  const enqueueShareMatch = useCallback(async () => {
+    if (shareMatch?.type !== 'queueable' || shareQueueBusy) return false;
+    if (shareMatch.payload.k === 'track' && (!preview.shareTrackSong || preview.shareTrackResolving)) {
+      return false;
+    }
+    setShareQueueBusy(true);
+    const ok = await enqueueShareSearchPayload(shareMatch.payload, t);
+    setShareQueueBusy(false);
+    if (ok) onSuccess?.();
+    return ok;
+  }, [shareMatch, shareQueueBusy, preview.shareTrackSong, preview.shareTrackResolving, t, onSuccess]);
+
+  return {
+    shareMatch,
+    shareServerLabel,
+    shareCoverServer,
+    shareQueueBusy,
+    canQueueShareMatch,
+    canOpenShareAlbum,
+    canOpenShareArtist,
+    canOpenShareComposer,
+    hasShareKeyboardTarget,
+    openShareAlbum,
+    openShareArtist,
+    openShareComposer,
+    enqueueShareMatch,
+    ...preview,
+  };
+}