Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

4.5 KB
Raw Blame
/* 首页筛选栏与侧栏读的那两份聚合:`/api/facets`(侧栏各组与标签条)和 `/api/tops`(女优、厂牌两排)。
 * 存在全站那一个 `QueryClient` 里(`@peach/query`),壳启动时直接取,不等 React 包。
 *
 * 两个键,参数串都由壳按当前语境算好递进来,查询函数不读壳的变量:
 * - `['facets', 口径串, 代次]`:口径是 JAV、资料页或详情的范围、状态页与那一组筛选。
 * - `['tops', 参数串, 口径串, 代次]`:参数串是请求方传的那一份(条数、种子、JAV、状态页),回退到全库口径
 *   之后键也不变。键里另带口径串:两份是一对,口径一变两份一起重取,侧栏刷新计数时上面那两排也照样取一次。
 * - `['tops', 参数串, 代次]`:续页(参数串带 `page`)。回包只由参数串决定,两排同时要同一页只发一次。
 *
 * 同一标签页内复用同一份口径,同时要同一份只发一次请求。写操作与主动换一批由壳调 `dropBars()`:
 * 代次加一,下一次一定真的发请求;路上那一趟照样交给正在等它的调用方。 */
import { api } from '@peach/legacy/core';

import { queryClient } from './query';

/** 同一标签页内保留聚合,写操作与主动刷新通过代次失效。 */
export const BARS_STALE_MS = Infinity;

let revision = 0;

export const facetsKey = (scope: string, generation = revision) => ['facets', scope, generation] as const;
export const topsKey = (params: string, scope: string, generation = revision) =>
  ['tops', params, scope, generation] as const;
export const topsPageKey = (params: string, generation = revision) => ['tops', params, generation] as const;

export interface TopsData { performers: unknown[]; studios: unknown[]; [field: string]: unknown }
export type FacetsData = Record<string, unknown>;

/* 状态页把顶部两排收窄到本页口径,为的是不列出「在这一页一个作品都没有」的人和厂牌。但集合窄到聚合
   结果为空时(「已标记」常年只有几条),收窄就把整排一并收走了:同一条筛选条上换一格,页面顶上凭空少两层,
   读起来是跳去了另一个页面而不是换了筛选。空了就退回全库口径。这一排点开的是实体页,本来就要离开当前
   状态,它回答的从来不是「这一页里有谁」,而是「接下来去看谁」。续页(壳的 `moreTops`)也走这里。 */
export async function loadTops(params: string | URLSearchParams): Promise<TopsData> {
  const query = String(params);
  const scoped = await api(`/api/tops?${query}`) as TopsData;
  const wide = new URLSearchParams(query);
  if (scoped.performers.length || scoped.studios.length || !wide.has('state')) return scoped;
  wide.delete('state');
  return await api(`/api/tops?${wide}`) as TopsData;
}

/** 两份一起取,各自命中各自的缓存;壳等两份都到了再一次画完。 */
export function fetchBars(scope: string, topsParams: string): Promise<[FacetsData, TopsData]> {
  return Promise.all([
    queryClient.fetchQuery({
      queryKey: facetsKey(scope),
      queryFn: () => api(`/api/facets${scope ? `?${scope}` : ''}`) as Promise<FacetsData>,
      staleTime: BARS_STALE_MS,
    }),
    queryClient.fetchQuery({
      queryKey: topsKey(topsParams, scope),
      queryFn: () => loadTops(topsParams),
      staleTime: BARS_STALE_MS,
    }),
  ]);
}

/** 顶部一排的下一页。两排各记各的页号,翻到同一页时参数串相同,共用一次请求。 */
export function fetchTopsPage(params: string): Promise<TopsData> {
  return queryClient.fetchQuery({
    queryKey: topsPageKey(params),
    queryFn: () => loadTops(params),
    staleTime: BARS_STALE_MS,
  });
}

/** 让两族已取的那些全部作废:代次加一,下一次 `fetchBars` 换键重取。
 *
 *  不整族移除:移除会静默取消路上那一趟,正在等它的调用方拿到的是一个 `CancelledError`。
 *  也不用 `invalidateQueries`:没有观察者的查询作废以后,路上那一趟会被下一次 `fetchQuery` 接着用,
 *  手动刷新就没有真的发请求。旧代次里已经落定的顺手移除,路上那几条回来以后没人再读,到 `gcTime` 回收。 */
export function dropBars(): void {
  revision += 1;
  const settled = (query: { state: { fetchStatus: string } }) => query.state.fetchStatus === 'idle';
  queryClient.removeQueries({ queryKey: ['facets'], predicate: settled });
  queryClient.removeQueries({ queryKey: ['tops'], predicate: settled });
}