Files
UHD_Media_Tool/apps/web/app/api/parse.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

58 lines
2.4 KiB
TypeScript

import type { ApiErrorCode } from "@umt/contracts";
import type { z } from "zod";
import { ApiRequestError, apiFetch, type FetcherArg } from "~/lib/api.ts";
export { ApiRequestError };
/** 请求并用 contracts 的 zod schema 校验 data;失败抛 ApiRequestError(给 react-query 的 error 态) */
export async function apiParsed<S extends z.ZodType>(schema: S, path: string, arg?: FetcherArg): Promise<z.infer<S>> {
const r = await apiFetch<unknown>(path, arg);
if (!r.ok) throw new ApiRequestError(r.error.code, r.error.message);
const parsed = schema.safeParse(r.data);
if (!parsed.success) {
const issue = parsed.error.issues[0];
throw new ApiRequestError(
"internal" satisfies ApiErrorCode,
`响应格式不符合接口定义:${issue ? `${issue.path.join(".")} ${issue.message}` : "未知字段"}`,
);
}
return parsed.data;
}
/** 变更请求:返回 data,失败抛错(给 useMutation,由 onError 统一 toast) */
export async function apiMutate<T = unknown>(path: string, arg: FetcherArg = {}): Promise<T> {
const r = await apiFetch<T>(path, { method: "POST", ...arg });
if (!r.ok) throw new ApiRequestError(r.error.code, r.error.message);
return r.data;
}
export const errorCode = (err: unknown): string | null => (err instanceof ApiRequestError ? err.code : null);
/** 端点是否不存在(后端尚未提供) */
export const isMissingEndpoint = (err: unknown) => errorCode(err) === "not_found";
/** 查询字符串:去掉空值 */
export function cleanParams(p: Record<string, string | number | boolean | undefined | null>) {
const out: Record<string, string | number | boolean> = {};
for (const [k, v] of Object.entries(p)) if (v !== undefined && v !== null && v !== "") out[k] = v;
return out;
}
/** 小规模配置集合:跟随游标取齐,保留列表返回形状供选择器与本地分页共用。 */
export async function fetchAllCursorPages<P extends { items: unknown[]; nextCursor?: string | null }>(
fetchPage: (cursor?: string) => Promise<P>,
): Promise<P> {
const first = await fetchPage();
const items = [...first.items];
const seen = new Set<string>();
let cursor = first.nextCursor;
while (cursor) {
if (seen.has(cursor)) throw new ApiRequestError("internal", "分页游标重复,请重试");
seen.add(cursor);
const page = await fetchPage(cursor);
items.push(...page.items);
cursor = page.nextCursor;
}
return { ...first, items, nextCursor: null };
}