Files
UHD_Media_Tool/apps/web/app/api/releases.ts
T
rootandClaude Opus 5.5 970296218c feat(search): multi-select quick filters for search results and site releases (SEARCH-3)
- domain release-facets: bucket resolution / codec / release type / site / promotion / HDR /
  release group / season / episode; OR within a dimension, AND across; disjunctive counts
- GET /search/releases and GET /sites/{id}/releases accept qf and return facets; site list
  facets come from local source_release rows only (no site requests), paging stays consistent
- web QuickFilterBar shared by search results and site resources tab: per-dimension popover
  (bottom sheet on phones) with counts, removable tags, clear all, localStorage memory per page
- runbook: quick filter params and bucket definitions

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-29 20:52:29 +08:00

93 lines
3.5 KiB
TypeScript

import { keepPreviousData, useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import {
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: { sourceReleaseId: string; slotId?: string; entityId?: string; note?: string }) =>
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"] });
},
});
}