99 lines
4.8 KiB
TypeScript
99 lines
4.8 KiB
TypeScript
/**
|
|
* 工作区和画布目录的应用模型与CRUD辅助。这里保存路由/目录元数据约定，
|
|
* 不拥有画布内容、ProjectEngine或本地history；服务响应更强schema校验由相应调用路径负责。
|
|
*/
|
|
import type { Profile } from "./api";
|
|
|
|
/** 工作区目录项，slug可用于路由，role供UI显示/能力提示，最终权限仍由服务端决定。 */
|
|
export type Workspace = { id: string; slug?: string; name: string; role?: "admin" | "editor" | "viewer" };
|
|
/** 画布目录记录：id与workspace是真实身份，parent_board_id/frame_id表示旧子图入口关系。
|
|
* version是material元数据版本，不能自动当作canonical canvas版本或本地rootRevision。 */
|
|
export type Board = {
|
|
id: string;
|
|
workspace_id: string;
|
|
slug?: string;
|
|
kind: "board";
|
|
title: string;
|
|
version: number;
|
|
content?: { schema_version: number };
|
|
description?: string;
|
|
parent_board_id?: string;
|
|
frame_id?: string;
|
|
};
|
|
/** 路由可用id或slug，空item/ref返回false；匹配本身不证明账户有访问权限。 */
|
|
export function matchesRef(item: { id: string; slug?: string } | null | undefined, ref: string | undefined) { return Boolean(item && ref && (item.id === ref || item.slug === ref)); }
|
|
/** 创建时空白标题回退值，与重命名必须非空的校验不同。 */
|
|
export const DEFAULT_BOARD_TITLE = "未命名图谱";
|
|
|
|
/** 分别编码workspace和board路径段，demo只追加明确查询开关。 */
|
|
export function boardHref(workspace: string, board: string, demo = false) {
|
|
return `/dashboard/${encodeURIComponent(workspace)}/${encodeURIComponent(board)}${demo ? "?demo=1" : ""}`;
|
|
}
|
|
/** 注入通用API能力，不在该库固定fetch、凭证或错误展示。 */
|
|
type Request = <T>(path: string, options?: RequestInit) => Promise<T>;
|
|
|
|
/** 并行读profile和工作区目录，兼容直接数组与{items}外壳；仅返回数据，不选择当前工作区。 */
|
|
export async function loadWorkspaceHome(
|
|
request: Request,
|
|
signal?: AbortSignal,
|
|
) {
|
|
// 任一读取拒绝则整体拒绝，Promise.all 不会自动取消另一请求；共同 signal 由宿主管理。
|
|
const [profile, result] = await Promise.all([
|
|
request<Profile>("profile", { signal }),
|
|
request<Workspace[] | { items: Workspace[] }>("workspaces", { signal }),
|
|
]);
|
|
return {
|
|
profile,
|
|
workspaces: Array.isArray(result) ? result : result.items || [],
|
|
};
|
|
}
|
|
|
|
/** 无workspaceId时先创建个人空间并回调宿主，再创建schema1旧画布目录项。
|
|
* 两个POST不是一笔原子事务，后一步失败不会自动删除已创建空间；标题trim后允许默认名。 */
|
|
export async function createBoard(
|
|
request: Request,
|
|
title: string,
|
|
workspaceId: string,
|
|
onWorkspaceCreated: (workspace: Workspace) => void,
|
|
) {
|
|
let id = workspaceId;
|
|
if (!id) {
|
|
const workspace = await request<Workspace>("workspaces", {
|
|
method: "POST",
|
|
body: JSON.stringify({ name: "个人空间" }),
|
|
});
|
|
id = workspace.id;
|
|
// 回调在创建画布前同步执行；回调抛错也会阻止后续 POST，但已创建的空间仍存在。
|
|
onWorkspaceCreated(workspace);
|
|
}
|
|
const name = title.trim() || DEFAULT_BOARD_TITLE;
|
|
// 创建响应可缺workspace_id时补用本次目标id，返回已确定的标题供界面更新目录。
|
|
const result = await request<{ id: string; workspace_id: string; kind: "board"; version: number; slug?: string }>("workspaces/" + id + "/materials", {
|
|
method: "POST",
|
|
body: JSON.stringify({
|
|
kind: "board",
|
|
title: name,
|
|
content: { schema_version: 1 },
|
|
}),
|
|
});
|
|
return { ...result, workspace_id: result.workspace_id || id, title: name };
|
|
}
|
|
|
|
|
|
/** trim并限制标题UTF-8字节≤300，先读取匹配的board，再用If-Match条件PATCH元数据。
|
|
* PATCH保留现有description/content；返回version按接口+1约定推导，不解析PATCH回执验证该版本。 */
|
|
export async function renameBoard(request: Request, workspaceId: string, boardId: string, title: string): Promise<Board> {
|
|
const name = title.trim();
|
|
if (!name || new TextEncoder().encode(name).length > 300) throw new Error("invalid_title");
|
|
const path = `workspaces/${encodeURIComponent(workspaceId)}/materials/${encodeURIComponent(boardId)}`;
|
|
// 校验读取的kind/id或slug/workspace，避免路由引用指向另一空间记录时误写。
|
|
const current = await request<Board>(path);
|
|
if (current.kind !== "board" || !matchesRef(current, boardId) || current.workspace_id !== workspaceId) throw new Error("invalid_reference");
|
|
await request(path, {
|
|
method: "PATCH",
|
|
headers: { "If-Match": `"${current.version}"` },
|
|
body: JSON.stringify({ title: name, description: current.description || "", content: current.content || { schema_version: 1 } }),
|
|
});
|
|
return { ...current, title: name, version: current.version + 1 };
|
|
}
|