import { keepPreviousData, useMutation, useQuery, useQueryClient } from "@tanstack/react-query"; import { AcquisitionSlot, cursorPage, PreferenceSuppression, RuleAtom, type RuleAtomCreate, type RuleAtomUpdate, RuleDefaults, RuleGroup, type RuleGroupCreate, type RuleGroupKind, RuleGroupRevisionList, type RuleGroupSource, type RuleGroupUpdate, RuleKeywordList, type RuleLayer, RuleParseResult, type RulePreviewRequest, RulePreviewResult, Subscription, } from "@umt/contracts"; import { api } from "~/lib/api.ts"; import { getParsed, parseOrThrow } from "./library.ts"; import { fetchAllCursorPages } from "./parse.ts"; // 规则(W9-D,docs/runbook/rules.md):规则组 = 收录过滤条件 + 偏好标签合一;自定义条件;三套默认链;抑制记录。 // 写入给 ruleString(优先)或 layers;PATCH 带 expectedRevision,不匹配 409。 export const ruleKeys = { all: ["rules"] as const, groups: (f: RuleGroupFilters) => ["rules", "groups", f] as const, group: (id: string) => ["rules", "group", id] as const, revisions: (id: string) => ["rules", "revisions", id] as const, keywords: ["rules", "keywords"] as const, atoms: ["rules", "atoms"] as const, defaults: ["rules", "defaults"] as const, suppressions: ["rules", "suppressions"] as const, refs: ["rules", "refs"] as const, }; export type RuleGroupFilters = { kind?: RuleGroupKind; source?: RuleGroupSource; enabled?: "true" | "false"; includeDeleted?: "true"; q?: string; }; const GroupPage = cursorPage(RuleGroup); const AtomPage = cursorPage(RuleAtom); const SupPage = cursorPage(PreferenceSuppression); export function useRuleGroups(filters: RuleGroupFilters = {}) { return useQuery({ queryKey: ruleKeys.groups(filters), queryFn: ({ signal }) => fetchAllCursorPages((cursor) => getParsed(GroupPage, "/rules", { ...filters, limit: 200, cursor }, signal)), placeholderData: keepPreviousData, }); } export function useRuleGroupRevisions(id: string | null | undefined) { return useQuery({ queryKey: ruleKeys.revisions(id ?? ""), enabled: !!id, queryFn: async ({ signal }) => (await getParsed(RuleGroupRevisionList, `/rules/${id}/revisions`, undefined, signal)).items, }); } export function useRuleKeywords() { return useQuery({ queryKey: ruleKeys.keywords, queryFn: async ({ signal }) => (await getParsed(RuleKeywordList, "/rules/keywords", undefined, signal)).items, staleTime: 60_000, }); } export function useRuleAtoms() { return useQuery({ queryKey: ruleKeys.atoms, queryFn: ({ signal }) => fetchAllCursorPages((cursor) => getParsed(AtomPage, "/rules/atoms", { limit: 200, cursor }, signal)), }); } export function useRuleDefaults() { return useQuery({ queryKey: ruleKeys.defaults, queryFn: ({ signal }) => getParsed(RuleDefaults, "/rules/defaults", undefined, signal), }); } export function useRuleSuppressions() { return useQuery({ queryKey: ruleKeys.suppressions, queryFn: ({ signal }) => fetchAllCursorPages((cursor) => getParsed(SupPage, "/rules/suppressions", { limit: 200, cursor }, signal)), }); } export type RuleRefs = { /** 规则组 id → 引用它的订阅(params.ruleGroupIds 或私有组) */ subscriptions: Map; /** 规则组 id → 引用它的收录版本 */ slots: Map; }; const SubPage = cursorPage(Subscription); const SlotPage = cursorPage(AcquisitionSlot); /** 引用关系:列表接口不带引用计数,前端从订阅与收录版本反查(各取前 200 条) */ export function useRuleRefs() { return useQuery({ queryKey: ruleKeys.refs, queryFn: async ({ signal }): Promise => { const [subs, slots] = await Promise.all([ getParsed(SubPage, "/subscriptions", { limit: 200 }, signal), getParsed(SlotPage, "/acquisition-slots", { limit: 200 }, signal), ]); const subscriptions = new Map(); for (const s of subs.items) { const ids = Array.isArray(s.params?.ruleGroupIds) ? (s.params.ruleGroupIds as string[]) : []; const title = (s as { mediaEntityTitle?: string | null }).mediaEntityTitle ?? s.titleQuery ?? `订阅 ${s.id.slice(0, 8)}`; for (const id of ids) subscriptions.set(id, [...(subscriptions.get(id) ?? []), { id: s.id, title }]); } const slotRefs = new Map(); for (const sl of slots.items) for (const id of sl.ruleGroupIds ?? []) slotRefs.set(id, [...(slotRefs.get(id) ?? []), { id: sl.id, name: sl.name }]); return { subscriptions, slots: slotRefs }; }, staleTime: 30_000, }); } /** 规则串 → 层(实时解析;错误带位置与相近名) */ export function parseRuleString(ruleString: string) { return api .post("/rules/parse", { ruleString }) .then((d) => parseOrThrow(RuleParseResult, d, "/rules/parse")); } export function usePreviewRuleGroup() { return useMutation({ mutationFn: ({ id, ...body }: RulePreviewRequest & { id: string }) => api.post(`/rules/${id}/preview`, body).then((d) => parseOrThrow(RulePreviewResult, d, "/rules/preview")), }); } function useInvalidate() { const qc = useQueryClient(); return () => { void qc.invalidateQueries({ queryKey: ruleKeys.all }); // 旧偏好标签页与订阅/收录版本的规则组显示同源 void qc.invalidateQueries({ queryKey: ["preferences"] }); }; } const parseGroup = (d: unknown) => parseOrThrow(RuleGroup, d, "/rules"); export function useCreateRuleGroup() { const done = useInvalidate(); return useMutation({ mutationFn: (body: RuleGroupCreate) => api.post("/rules", body).then(parseGroup), onSuccess: done, }); } /** 编辑 / 停用(enabled=false 写抑制记录)/ 重新启用;带 expectedRevision 防覆盖 */ export function useUpdateRuleGroup() { const done = useInvalidate(); return useMutation({ mutationFn: ({ id, ...body }: RuleGroupUpdate & { id: string }) => api.patch(`/rules/${id}`, body).then(parseGroup), onSettled: done, }); } /** 删除:标记删除并写抑制记录;被收录版本/订阅引用时 409 */ export function useDeleteRuleGroup() { const done = useInvalidate(); return useMutation({ mutationFn: (id: string) => api.del(`/rules/${id}`), onSuccess: done, }); } export function useSaveRuleDefaults() { const done = useInvalidate(); return useMutation({ mutationFn: (body: RuleDefaults) => api.put("/rules/defaults", body).then((d) => parseOrThrow(RuleDefaults, d, "/rules/defaults")), onSuccess: done, }); } const parseAtom = (d: unknown) => parseOrThrow(RuleAtom, d, "/rules/atoms"); export function useCreateRuleAtom() { const done = useInvalidate(); return useMutation({ mutationFn: (body: RuleAtomCreate) => api.post("/rules/atoms", body).then(parseAtom), onSuccess: done, }); } export function useUpdateRuleAtom() { const done = useInvalidate(); return useMutation({ mutationFn: ({ id, ...body }: RuleAtomUpdate & { id: string }) => api.patch(`/rules/atoms/${id}`, body).then(parseAtom), onSuccess: done, }); } export function useDeleteRuleAtom() { const done = useInvalidate(); return useMutation({ mutationFn: (id: string) => api.del(`/rules/atoms/${id}`), onSuccess: done, }); } /** 解除抑制:之后 Agent 可以再次提出同一规则(仍需审批) */ export function useLiftRuleSuppression() { const done = useInvalidate(); return useMutation({ mutationFn: (v: { id: string; reason?: string }) => api .patch(`/rules/suppressions/${v.id}`, { active: false, reason: v.reason }) .then((d) => parseOrThrow(PreferenceSuppression, d, "/rules/suppressions")), onSuccess: done, }); } export type { RuleLayer };