feat(queue): play queue sync — manual pull, idle auto-sync, multi-server push (#1131)

src/hooks/useIdlePlayQueuePull.ts

@@ -0,0 +1,53 @@
+import { useEffect, useRef } from 'react';
+import { applyServerPlayQueue } from '../store/applyServerPlayQueue';
+import { useAuthStore } from '../store/authStore';
+import { useOrbitStore } from '../store/orbitStore';
+import { usePlayerStore } from '../store/playerStore';
+import {
+  getPlaybackIdleSinceMs,
+  hasRecentQueueMutation,
+  isPlaybackIdleLongEnough,
+  markPlaybackIdle,
+} from '../store/queuePlaybackIdle';
+import type { ConnectionStatus } from './useConnectionStatus';
+import { canAutoIdlePlayQueuePull } from './usePlayQueueSyncLedState';
+
+const IDLE_THRESHOLD_MS = 30_000;
+const MUTATION_QUIET_MS = 15_000;
+const POLL_INTERVAL_MS = 10_000;
+
+/** Background pull when paused/stopped long enough on a single-server, in-sync browse context. */
+export function useIdlePlayQueuePull(status: ConnectionStatus) {
+  const activeServerId = useAuthStore(s => s.activeServerId);
+  const orbitRole = useOrbitStore(s => s.role);
+  const isPlaying = usePlayerStore(s => s.isPlaying);
+  const inFlightRef = useRef(false);
+
+  useEffect(() => {
+    if (!isPlaying && getPlaybackIdleSinceMs() === 0) {
+      markPlaybackIdle();
+    }
+  }, [isPlaying]);
+
+  useEffect(() => {
+    if (!canAutoIdlePlayQueuePull(status, orbitRole)) return;
+
+    const tick = () => {
+      if (inFlightRef.current) return;
+      if (!canAutoIdlePlayQueuePull(status, orbitRole)) return;
+      if (isPlaying) return;
+      if (!isPlaybackIdleLongEnough(IDLE_THRESHOLD_MS)) return;
+      if (hasRecentQueueMutation(MUTATION_QUIET_MS)) return;
+      if (!activeServerId) return;
+
+      inFlightRef.current = true;
+      void applyServerPlayQueue(activeServerId, { mode: 'idle', preferServerPosition: true })
+        .finally(() => {
+          inFlightRef.current = false;
+        });
+    };
+
+    const id = window.setInterval(tick, POLL_INTERVAL_MS);
+    return () => window.clearInterval(id);
+  }, [activeServerId, isPlaying, orbitRole, status]);
+}