Files
WebHooker/app/composables/useFragments.ts
T
翅膀 85c73d1122 fix(console): guard fragment saves by revision
Fragments share a group version with other configuration writes.
Submit the loaded revision and reload on conflict to preserve
concurrent edits.
2026-10-23 23:23:41 +08:00

95 lines
3.1 KiB
TypeScript

import type { NamedFragment } from "~/types";
export function useFragmentsApi() {
const { needLogin } = useAuthState();
const fragments = ref<NamedFragment[]>([]);
const loading = ref(false);
const saving = ref(false);
const error = ref("");
/** Group whose fragments are shown; responses for any other group are dropped. */
const shownGroupId = ref<string | null>(null);
/** Group whose fragments were last loaded (or saved) successfully. */
const loadedGroupId = ref<string | null>(null);
/** Server revision of the shown fragments, sent back to detect concurrent edits. */
let revision: string | undefined;
// Bumped by every load/save, so only the latest request may land.
let request = 0;
/**
* Whether a write may start for `groupId`: the shown list is that group's
* real fragments and nothing is loading or saving. Saving replaces a group's
* whole fragment list, so each write must build on the previous one.
*/
function readyFor(groupId: string): boolean {
return (
shownGroupId.value === groupId &&
loadedGroupId.value === groupId &&
!error.value &&
!loading.value &&
!saving.value
);
}
async function load(groupId: string): Promise<void> {
const mine = ++request;
if (shownGroupId.value !== groupId) {
fragments.value = [];
loadedGroupId.value = null;
revision = undefined;
}
shownGroupId.value = groupId;
loading.value = true;
error.value = "";
needLogin.value = false;
try {
const data = await apiFetch<{ fragments?: NamedFragment[]; revision?: string }>(
`/admin/api/groups/${encodeURIComponent(groupId)}/fragments`,
);
if (mine !== request) return;
fragments.value = data.fragments ?? [];
revision = data.revision;
loadedGroupId.value = groupId;
} catch (err) {
if (mine === request && !needLogin.value)
error.value = err instanceof Error ? err.message : String(err);
} finally {
if (mine === request) loading.value = false;
}
}
async function save(groupId: string, next: NamedFragment[]): Promise<void> {
saving.value = true;
let data: { fragments?: NamedFragment[]; revision?: string };
try {
data = await apiFetch<{ fragments?: NamedFragment[]; revision?: string }>(
`/admin/api/groups/${encodeURIComponent(groupId)}/fragments`,
{
method: "PUT",
body: JSON.stringify({
fragments: next,
revision: loadedGroupId.value === groupId ? revision : undefined,
}),
},
);
} catch (err) {
// Changed elsewhere meanwhile: reload so the next write builds on it.
if (isConflict(err) && shownGroupId.value === groupId) {
saving.value = false;
void load(groupId);
}
throw err;
} finally {
saving.value = false;
}
if (shownGroupId.value !== groupId) return;
request++;
loading.value = false;
error.value = "";
fragments.value = data.fragments ?? next;
revision = data.revision;
loadedGroupId.value = groupId;
}
return { fragments, loading, needLogin, error, readyFor, load, save };
}