Skip to content

armgit / peach

Public Imported from GitHub
0

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

4.0 KB
Raw Blame
/* 播放列表页的数据契约与三个写操作。
 *
 * 读 `/api/playlists`(`src/peach/web_playlists.py` 的 `q_playlists`,按最近改动排),写一律
 * POST `/api/playlist`。写端点回的是带 `items` 的整份列表,不是列表页那一行的形状,
 * 改名还会动 `updated_at`、换掉排序,所以写完一律让列表键重取,不拿回话拼缓存。
 *
 * 首页存完一份 Mix 再进来要看得到它:首屏 `prefetch` 每次都向服务端重取,不读缓存里
 * 上一次的那一份。 */
import { apiGet, apiSend } from '../../api';
import { queryClient } from '../query';

export const PLAYLISTS_URL = '/api/playlists';
export const PLAYLIST_URL = '/api/playlist';
export const PLAYLISTS_KEY = ['playlists'] as const;

/** 列表卡的署名:列表里出镜最多的那几位(服务端最多给三位)。 */
export interface PlaylistFace {
  kind: string;
  id: number;
  name: string;
  has_image: boolean;
  image_version?: string;
  avatar_focus?: unknown;
}

/** `/api/playlists` 的一行。 */
export interface PlaylistRow {
  id: number;
  name: string;
  /** `mix` 是从 Mix 存下来的,其余是手动建的。 */
  source_kind: string;
  source_seed_asset_id: number | null;
  current_asset_id: number | null;
  created_at: string;
  updated_at: string;
  item_count: number;
  /** 静止封面:续播点那一个,没有续播点时是第一个。空列表是 null。 */
  preview_asset_id: number | null;
  /** 悬停时翻过的封面,续播点那张在最前,最多五张。 */
  preview_ids: number[];
  faces: PlaylistFace[];
}

export interface PlaylistsData { items: PlaylistRow[] }

/** `/api/playlist?id=` 与写端点回话里的那一份整列表。这一页只用得到下面几项。 */
export interface PlaylistDetail {
  id: number;
  name: string;
  source_kind: string;
  source_seed_asset_id: number | null;
  current_asset_id: number | null;
  items: { id: number }[];
}

export const fetchPlaylists = (signal?: AbortSignal) => apiGet<PlaylistsData>(PLAYLISTS_URL, signal);

/** 首屏。`staleTime: 0` 写明:缓存里有上一次的列表也照样重取。 */
export async function prefetchPlaylists(signal: AbortSignal): Promise<void> {
  await queryClient.fetchQuery({ queryKey: PLAYLISTS_KEY, queryFn: () => fetchPlaylists(signal), staleTime: 0 });
}

/** 写完之后重读列表。 */
export const refreshPlaylists = () => queryClient.invalidateQueries({ queryKey: PLAYLISTS_KEY, exact: true });

/** 点卡片从哪一个接着播:续播点,没有就是第一个。空列表没有去处。 */
export const resumeAssetId = (row: PlaylistRow) => row.current_asset_id || row.preview_asset_id || null;

export const posterUrl = (id: number) => `/poster?id=${id}&c=4`;

type Written = { ok: true; playlist: PlaylistDetail };

export const createPlaylist = (name: string) =>
  apiSend<Written>(PLAYLIST_URL, { action: 'create', name, asset_ids: [] });

export const renamePlaylist = (id: number, name: string) =>
  apiSend<Written>(PLAYLIST_URL, { action: 'rename', id, name });

export const deletePlaylist = (id: number) =>
  apiSend<{ ok: true; deleted: number }>(PLAYLIST_URL, { action: 'delete', id });

/** 删之前先把内容取回来:`delete` 连 playlist_item 一起清,删完就没有地方能问出这份列表
 *  装着哪些视频。取不到就是 null,那一次删除不给撤销。 */
export const keepPlaylist = (id: number): Promise<PlaylistDetail | null> =>
  apiGet<PlaylistDetail>(`${PLAYLIST_URL}?id=${id}`).catch(() => null);

/** 撤销删除:重建一份新记录,装同一批视频、同一个来源。Mix 种子不在列表里了就不带,
 *  服务端要求种子必须在列表中。 */
export function recreatePlaylist(kept: PlaylistDetail) {
  const ids = (kept.items || []).map((entry) => entry.id);
  const seed = kept.source_seed_asset_id;
  return apiSend<Written>(PLAYLIST_URL, {
    action: 'create', name: kept.name, asset_ids: ids, source_kind: kept.source_kind,
    source_seed_asset_id: seed !== null && ids.includes(seed) ? seed : null,
  });
}