Files
UHD_Media_Tool/apps/web/app/api/instances.ts
T
rootandClaude Opus 5.5 ceb66f8c77 feat: v0.3.8–v0.3.14 工作区汇总(依赖升级、整理来源、手动入库、原地入库等)
生产 v0.3.8~v0.3.13 均由 8013196 加工作区修改构建部署,此前未提交;本提交补齐源码,
并含未部署的 v0.3.14 原地入库。中间各版本源码状态未保存,无法逐版拆分,详见
docs/plan/17-full-upgrade.md 与 docs/plan/18-organize-release.md。

- v0.3.8 全面升级:Deno workspace 依赖、Router 8 / Vite 8、camofox 1.18.0 / Node 24、
  PostgreSQL 18.6、备份客户端 18.6、演示 qB 5.2.4
- v0.3.9 媒体整理:分类规则、整理来源与目录快照(0059)、文件管理整理入口
- v0.3.10 手动下载与入库:独立手动下载、详情页资源下载、TMDB / Local 元数据兜底
  (metadata.resolve_organize)、正常多版本 / 一次性洗版(0060)
- v0.3.11 搜索详情与桌面黑边修复
- v0.3.12 列表分页、搜索历史、首页概况
- v0.3.13 统一整理弹窗与队列
- v0.3.14 原地入库(0061,未部署)

同批审计修复:
- 刮削入队:确认原记录存在后才删重放产生的新记录;写回 run 关联失败时保持 queued,
  由处理器补关联(对齐 MP 先登记、只在入队失败时记失败)
- 识别升级链只在结果更确定时采用,不再用 no_match 顶替原有歧义候选
- bluray_dir 资产以原盘目录本身为刮削根(MP 同做法)
- metadata.resolve_organize 登记到入库排障 Skill 与能力地图
- db/src/types.ts 按迁移重新生成;contracts 整理动作枚举顺序与数据库对齐
- 测试:原地入库用例改为直接查记录表;domain 测试模板补 version
- 前端:通知铃铛弹层与用户菜单统一样式;站点卡片共用卡头、底栏贴底、分页间距

依赖升级证据只提交摘要文件,registry-snapshot.json 移至 .local/(SHA-256 记于文档)。

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-02 15:47:17 +08:00

176 lines
5.8 KiB
TypeScript

import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import type {
CursorPage,
DownloaderInstance,
DownloaderInstanceCreate,
DownloaderInstanceUpdate,
InstanceTestResult,
LibraryRoot,
LibraryRootCreate,
LibraryRootUpdate,
MediaServerInstance,
MediaServerInstanceCreate,
MediaServerInstanceUpdate,
PathMapping,
PathMappingCreate,
PathMappingUpdate,
Site,
SiteAccount,
SiteAccountUpdate,
SiteCreate,
SiteCredentialsPut,
SiteCredentialsResult,
SiteUpdate,
} from "@umt/contracts";
import { apiData } from "~/lib/api.ts";
import { type QueryArea, qk } from "~/lib/query-keys.ts";
import { fetchAllCursorPages } from "./parse.ts";
/** 实例类资源的标准 CRUD 钩子(列表按游标取齐配置) */
function crudHooks<Row extends { id: string }, Create, Update>(area: QueryArea, base: string) {
return {
useList: () =>
useQuery({
queryKey: qk.list(area),
queryFn: ({ signal }) =>
fetchAllCursorPages((cursor) => apiData<CursorPage<Row>>(base, { params: { limit: 200, cursor }, signal })),
}),
useCreate: () => {
const qc = useQueryClient();
return useMutation({
mutationFn: (body: Create) => apiData<Row>(base, { method: "POST", body }),
onSuccess: () => qc.invalidateQueries({ queryKey: qk.all(area) }),
});
},
useUpdate: () => {
const qc = useQueryClient();
return useMutation({
mutationFn: ({ id, body }: { id: string; body: Update }) =>
apiData<Row>(`${base}/{id}`, { method: "PATCH", pathParams: { id }, body }),
onSuccess: () => qc.invalidateQueries({ queryKey: qk.all(area) }),
});
},
useRemove: () => {
const qc = useQueryClient();
return useMutation({
mutationFn: (id: string) => apiData<unknown>(`${base}/{id}`, { method: "DELETE", pathParams: { id } }),
onSuccess: () => qc.invalidateQueries({ queryKey: qk.all(area) }),
});
},
};
}
/** 连接测试 / 校验类动作(结果写回 health,完成后刷新列表) */
function actionHook<R>(area: QueryArea, path: string) {
return () => {
const qc = useQueryClient();
return useMutation({
mutationFn: (id: string) => apiData<R>(path, { method: "POST", pathParams: { id }, body: {} }),
onSettled: () => qc.invalidateQueries({ queryKey: qk.all(area) }),
});
};
}
export const downloaders = {
...crudHooks<DownloaderInstance, DownloaderInstanceCreate, DownloaderInstanceUpdate>(
"downloader-instances",
"/downloader-instances",
),
useTest: actionHook<InstanceTestResult>("downloader-instances", "/downloader-instances/{id}/test"),
};
export const mediaServers = {
...crudHooks<MediaServerInstance, MediaServerInstanceCreate, MediaServerInstanceUpdate>(
"media-server-instances",
"/media-server-instances",
),
useTest: actionHook<InstanceTestResult>("media-server-instances", "/media-server-instances/{id}/test"),
};
export const libraryRoots = {
...crudHooks<LibraryRoot, LibraryRootCreate, LibraryRootUpdate>("library-roots", "/library-roots"),
useTest: actionHook<InstanceTestResult>("library-roots", "/library-roots/{id}/test"),
};
export const pathMappings = {
...crudHooks<PathMapping, PathMappingCreate, PathMappingUpdate>("path-mappings", "/path-mappings"),
useVerify: actionHook<PathMapping>("path-mappings", "/path-mappings/{id}/verify"),
};
// ─── 站点账号凭证(设置页录入;站点本身由站点工作台管理) ───
export function useSiteOptions() {
return useQuery({
queryKey: qk.list("sites", { limit: 200 }),
queryFn: ({ signal }) =>
fetchAllCursorPages((cursor) => apiData<CursorPage<Site>>("/sites", { params: { limit: 200, cursor }, signal })),
});
}
export function useSiteAccounts() {
return useQuery({
queryKey: qk.list("site-accounts"),
queryFn: ({ signal }) =>
fetchAllCursorPages((cursor) =>
apiData<CursorPage<SiteAccount>>("/site-accounts", { params: { limit: 200, cursor }, signal }),
),
});
}
export function usePutSiteCredentials() {
const qc = useQueryClient();
return useMutation({
mutationFn: ({ siteId, body }: { siteId: string; body: SiteCredentialsPut }) =>
apiData<SiteCredentialsResult>("/sites/{id}/credentials", { method: "PUT", pathParams: { id: siteId }, body }),
onSuccess: () => {
qc.invalidateQueries({ queryKey: qk.all("site-accounts") });
qc.invalidateQueries({ queryKey: qk.all("sites") });
},
});
}
// ─── 站点登记与参数(设置"站点与账号";浏览在站点工作台) ───
function useInvalidateSites() {
const qc = useQueryClient();
return () => {
// sites.ts 用 ["sites", …],这里的列表用 qk.list("sites"),两者同前缀
qc.invalidateQueries({ queryKey: qk.all("sites") });
qc.invalidateQueries({ queryKey: qk.all("site-accounts") });
};
}
export function useCreateSite() {
const inv = useInvalidateSites();
return useMutation({
mutationFn: (body: SiteCreate) => apiData<Site>("/sites", { method: "POST", body }),
onSuccess: inv,
});
}
export function useUpdateSite() {
const inv = useInvalidateSites();
return useMutation({
mutationFn: ({ id, body }: { id: string; body: SiteUpdate }) =>
apiData<Site>("/sites/{id}", { method: "PATCH", pathParams: { id }, body }),
onSuccess: inv,
});
}
export function useUpdateSiteAccount() {
const inv = useInvalidateSites();
return useMutation({
mutationFn: ({ id, body }: { id: string; body: SiteAccountUpdate }) =>
apiData<SiteAccount>("/site-accounts/{id}", { method: "PATCH", pathParams: { id }, body }),
onSuccess: inv,
});
}
export function useRemoveSiteAccount() {
const inv = useInvalidateSites();
return useMutation({
mutationFn: (id: string) => apiData<unknown>("/site-accounts/{id}", { method: "DELETE", pathParams: { id } }),
onSuccess: inv,
});
}