UHD_Media_Tool/apps/web/app/api/releases.ts

import { keepPreviousData, useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import {
  type ManualAcquisitionRequest,
  ManualAcquisitionResult,
  type ResolutionStatus,
  WorkbenchReleaseDetail,
  WorkbenchReleasePage,
} from "@umt/contracts";
import { apiMutate, apiParsed, cleanParams } from "./parse.ts";

// 站点工作台整理视图(W2-B:/sites/{id}/releases、/sites/{id}/releases/{rid})

export type ReleaseFilters = {
  q?: string;
  category?: string;
  promotion?: string;
  resolution?: ResolutionStatus;
  /** 快速筛选(SEARCH-3):`维度:值,值;维度:值`;只筛本地数据 */
  qf?: string;
};

export const releaseKeys = {
  all: ["releases"] as const,
  list: (siteId: string, f: ReleaseFilters, live: boolean) => ["releases", "list", siteId, f, live] as const,
  detail: (siteId: string, rid: string) => ["releases", "detail", siteId, rid] as const,
};

/**
 * 统一资源列表,游标分页。live=true 强制实时补查(只对第一页);否则让服务端按"本地无结果或快照过期"自行决定。
 * 翻页时保留上一次数据,避免"提取失败 = 空列表"。
 */
export function useSiteReleases(siteId: string | undefined, filters: ReleaseFilters, live = false) {
  return useInfiniteQuery({
    queryKey: releaseKeys.list(siteId ?? "", filters, live),
    enabled: !!siteId,
    initialPageParam: undefined as string | undefined,
    placeholderData: keepPreviousData,
    queryFn: ({ pageParam, signal }) =>
      apiParsed(WorkbenchReleasePage, "/api/v1/sites/:id/releases", {
        pathParams: { id: siteId ?? "" },
        params: cleanParams({
          ...filters,
          cursor: pageParam,
          limit: 50,
          live: live && !pageParam ? "true" : undefined,
        }),
        signal,
      }),
    getNextPageParam: (last) => last.nextCursor ?? undefined,
  });
}

/** 资源详情;refresh=true 时实时复核(失败保留既有数据并带 refreshError) */
export function useReleaseDetail(siteId: string | undefined, rid: string | undefined) {
  return useQuery({
    queryKey: releaseKeys.detail(siteId ?? "", rid ?? ""),
    enabled: !!siteId && !!rid,
    queryFn: ({ signal }) =>
      apiParsed(WorkbenchReleaseDetail, "/api/v1/sites/:id/releases/:rid", {
        pathParams: { id: siteId ?? "", rid: rid ?? "" },
        signal,
      }),
  });
}

export function useRefreshReleaseDetail() {
  const qc = useQueryClient();
  return useMutation({
    mutationFn: ({ siteId, rid }: { siteId: string; rid: string }) =>
      apiParsed(WorkbenchReleaseDetail, "/api/v1/sites/:id/releases/:rid", {
        pathParams: { id: siteId, rid },
        params: { refresh: "true" },
      }),
    onSuccess: (d, v) => qc.setQueryData(releaseKeys.detail(v.siteId, v.rid), d),
  });
}

/**
 * 统一下载入口 POST /acquisition-plans:与自动收录同一条流程(download.plan → download.submit:
 * 硬条件/预算/缓存阈值/授权 → 预留 Slot → submitDownload)。未生成计划时 submitted=false 并给出逐个 Slot 的原因。
 */
export function useSubmitRelease() {
  const qc = useQueryClient();
  return useMutation({
    mutationFn: (body: ManualAcquisitionRequest) =>
      apiMutate("/api/v1/acquisition-plans", { body }).then((d) => ManualAcquisitionResult.parse(d)),
    onSuccess: (r) => {
      if (r.submitted) void qc.invalidateQueries({ queryKey: ["downloads"] });
      void qc.invalidateQueries({ queryKey: ["inventory"] });
      void qc.invalidateQueries({ queryKey: ["library"] });
    },
  });
}