psysonic/src/cover/coverTraffic.ts

import {
  libraryCoverBackfillConfigure,
  libraryCoverBackfillSetUiPriority,
} from '../api/coverCache';
import { coverEnsureCancelPending } from './ensureQueue';
import { coverPeekCancelPending } from './peekQueue';
import { coverPrefetchClearRegistry } from './prefetchRegistry';

function cancelVisibleCoverWork(): void {
  coverEnsureCancelPending();
  coverPeekCancelPending();
  coverPrefetchClearRegistry();
}

let navigationHoldDepth = 0;
let serverSwitchHold = false;
let resumeTimer: ReturnType<typeof setTimeout> | null = null;
let serverSwitchEndTimer: ReturnType<typeof setTimeout> | null = null;

const NAVIGATION_QUIET_MS = 400;
const SERVER_SWITCH_QUIET_MS = 700;

function syncBackfillUiPriority(): void {
  const hold = navigationHoldDepth > 0 || serverSwitchHold;
  void libraryCoverBackfillSetUiPriority(hold);
}

function pauseLibraryBackfillSession(): void {
  void libraryCoverBackfillConfigure({
    enabled: false,
    serverIndexKey: '',
    libraryServerId: '',
    restBaseUrl: '',
    username: '',
    password: '',
  });
}

/** Route change — drop queued peek/ensure/prefetch so the new page is not behind the old one. */
export function coverTrafficBeginNavigation(): void {
  navigationHoldDepth += 1;
  cancelVisibleCoverWork();
  syncBackfillUiPriority();
}

export function coverTrafficEndNavigation(): void {
  navigationHoldDepth = Math.max(0, navigationHoldDepth - 1);
  scheduleNavigationResume();
}

/** Active server change — stop all cover IPC so ping + menu stay responsive. */
export function coverTrafficBeginServerSwitch(): void {
  serverSwitchHold = true;
  if (serverSwitchEndTimer) {
    clearTimeout(serverSwitchEndTimer);
    serverSwitchEndTimer = null;
  }
  cancelVisibleCoverWork();
  pauseLibraryBackfillSession();
  syncBackfillUiPriority();
}

export function coverTrafficEndServerSwitch(): void {
  if (serverSwitchEndTimer) clearTimeout(serverSwitchEndTimer);
  serverSwitchEndTimer = setTimeout(() => {
    serverSwitchHold = false;
    serverSwitchEndTimer = null;
    syncBackfillUiPriority();
  }, SERVER_SWITCH_QUIET_MS);
}

export function coverTrafficBackgroundPaused(): boolean {
  return navigationHoldDepth > 0 || serverSwitchHold;
}

/** Hard stop for ensure/peek pumps (includes visible `high` grid jobs). */
export function coverTrafficServerSwitchPaused(): boolean {
  return serverSwitchHold;
}

function scheduleNavigationResume(): void {
  if (resumeTimer) clearTimeout(resumeTimer);
  resumeTimer = setTimeout(() => {
    resumeTimer = null;
    syncBackfillUiPriority();
  }, NAVIGATION_QUIET_MS);
}