@arronqzy/vue-view 0.1.24 → 0.1.25

package/src/panel/library/abuilder-storage.ts

@@ -1,10 +1,22 @@
+import { normalizeAppNameSpace } from "@arronqzy/blueprint-dsl";
 import {
   clearAllExecutionRunRecords,
-  clearApiCollections,
+  clearApiCollections as clearApiCollectionsRaw,
   clearBlueprintLibrary as clearBlueprintLibraryRecords,
+  deleteApiCollection as deleteApiCollectionRaw,
   deleteBlueprintLibraryRecord as deleteBlueprintLibraryRecordRaw,
+  putApiCollection as putApiCollectionRaw,
+  putBlueprintLibraryRecord as putBlueprintLibraryRecordRaw,
+  putExecutionRunRecord as putExecutionRunRecordRaw,
+  upsertApiCollectionFromJson as upsertApiCollectionFromJsonRaw,
+  type BlueprintLibraryRecord,
+  type ExecutionRunRecord,
+  type UpsertApiCollectionInput,
+  type UpsertApiCollectionResult,
 } from "@arronqzy/vue-blueprint";
+import type { ApiCollectionRecord } from "@arronqzy/blueprint-dsl";
 import { broadcastBlueprintLibraryChanged } from "./blueprint-library-sync";
+import { AbuilderEvents, emitAbuilderEvent } from "./event-subscription";
 import { clearWorkspaceProjects } from "./workspace-storage";
 
 export {
@@ -19,17 +31,36 @@ export {
   readExecutionLogSettings,
   writeExecutionLogSettings,
   listApiCollectionRecords,
-  deleteApiCollection,
-  clearApiCollections,
 } from "@arronqzy/vue-blueprint";
 export type {
   BlueprintLibraryListItem,
   BlueprintLibraryRecord,
   ExecutionRunRecord,
   ExecutionLogSettings,
+  UpsertApiCollectionInput,
+  UpsertApiCollectionResult,
 } from "@arronqzy/vue-blueprint";
 export type { ApiCollectionRecord } from "@arronqzy/blueprint-dsl";
 
+function resolvedNameSpace(nameSpace?: string | null): string | null {
+  return normalizeAppNameSpace(nameSpace) || null;
+}
+
+/** 写入 / 覆盖蓝图库记录；已挂载的编辑器会刷新蓝图库列表 */
+export async function putBlueprintLibraryRecord(
+  record: BlueprintLibraryRecord,
+  nameSpace?: string | null
+): Promise<BlueprintLibraryRecord> {
+  const saved = await putBlueprintLibraryRecordRaw(record, nameSpace);
+  broadcastBlueprintLibraryChanged(nameSpace);
+  emitAbuilderEvent(AbuilderEvents.blueprintLibraryChanged, {
+    nameSpace: resolvedNameSpace(nameSpace),
+    action: "put",
+    ids: [saved.id],
+  });
+  return saved;
+}
+
 /** 删除蓝图库中的一条蓝图；已挂载的编辑器会刷新蓝图库列表 */
 export async function deleteBlueprintLibraryRecord(
   id: string,
@@ -37,12 +68,79 @@ export async function deleteBlueprintLibraryRecord(
 ): Promise<void> {
   await deleteBlueprintLibraryRecordRaw(id, nameSpace);
   broadcastBlueprintLibraryChanged(nameSpace);
+  emitAbuilderEvent(AbuilderEvents.blueprintLibraryChanged, {
+    nameSpace: resolvedNameSpace(nameSpace),
+    action: "delete",
+    ids: [id],
+  });
 }
 
 /** 清空该 nameSpace 下的蓝图库，返回删除数量；已挂载的编辑器会刷新蓝图库列表 */
 export async function clearBlueprintLibrary(nameSpace?: string | null): Promise<number> {
   const count = await clearBlueprintLibraryRecords(nameSpace);
   broadcastBlueprintLibraryChanged(nameSpace);
+  emitAbuilderEvent(AbuilderEvents.blueprintLibraryChanged, {
+    nameSpace: resolvedNameSpace(nameSpace),
+    action: "clear",
+  });
+  return count;
+}
+
+/** 写入一条蓝图执行日志 */
+export async function putExecutionRunRecord(
+  record: ExecutionRunRecord,
+  nameSpace?: string | null
+): Promise<ExecutionRunRecord> {
+  return putExecutionRunRecordRaw(record, nameSpace);
+}
+
+/** 写入接口集合；persistLocal 时落 IndexedDB，并同步已挂载编辑器的内存列表 */
+export async function putApiCollection(
+  record: ApiCollectionRecord,
+  nameSpace?: string | null
+): Promise<ApiCollectionRecord> {
+  const saved = await putApiCollectionRaw(record, nameSpace);
+  emitAbuilderEvent(AbuilderEvents.apiCollectionChanged, {
+    nameSpace: resolvedNameSpace(nameSpace),
+    action: "put",
+    ids: [saved.id],
+  });
+  return saved;
+}
+
+/** 从 JSON 文本 upsert 接口集合；可传 nameSpace */
+export async function upsertApiCollectionFromJson(
+  input: UpsertApiCollectionInput
+): Promise<UpsertApiCollectionResult> {
+  const result = await upsertApiCollectionFromJsonRaw(input);
+  if (result.ok) {
+    emitAbuilderEvent(AbuilderEvents.apiCollectionChanged, {
+      nameSpace: resolvedNameSpace(input.nameSpace),
+      action: "put",
+      ids: [result.record.id],
+    });
+  }
+  return result;
+}
+
+export async function deleteApiCollection(
+  id: string,
+  nameSpace?: string | null
+): Promise<void> {
+  await deleteApiCollectionRaw(id, nameSpace);
+  emitAbuilderEvent(AbuilderEvents.apiCollectionChanged, {
+    nameSpace: resolvedNameSpace(nameSpace),
+    action: "delete",
+    ids: [id],
+  });
+}
+
+export async function clearApiCollections(nameSpace?: string | null): Promise<number> {
+  const count = await clearApiCollectionsRaw(nameSpace);
+  emitAbuilderEvent(AbuilderEvents.apiCollectionChanged, {
+    nameSpace: resolvedNameSpace(nameSpace),
+    action: "clear",
+  });
   return count;
 }
 

package/src/panel/library/abuilder-view-handle.ts

@@ -0,0 +1,100 @@
+import { normalizeAppNameSpace } from "@arronqzy/blueprint-dsl";
+import type { WorkspaceProjectRecord } from "./workspace-project-db";
+
+/** 已挂载编辑面板的命令式句柄（也可通过 `ref` 拿到） */
+export type AbuilderViewHandle = {
+  /** 当前 nameSpace */
+  getNameSpace: () => string | null;
+  /** 导出当前编辑器中的完整工作区；尚无关联 id 时返回 null */
+  getCurrentWorkspace: () => WorkspaceProjectRecord | null;
+  /** 按 id 从 IndexedDB 打开，或直接应用完整记录 */
+  openWorkspace: (idOrRecord: string | WorkspaceProjectRecord) => Promise<void>;
+  /** 创建新工作区并写入 IndexedDB，发出 workspace:add */
+  createWorkspace: () => Promise<{ name: string; id: string }>;
+  /** 保存当前工作区到 IndexedDB，发出 workspace:sync；无 active 时等同创建 */
+  saveWorkspace: () => Promise<{ name: string; id: string }>;
+  /** 同步当前工作区到 IndexedDB，发出 workspace:sync */
+  syncWorkspace: () => Promise<string>;
+};
+
+const handles = new Set<AbuilderViewHandle>();
+
+export function registerAbuilderViewHandle(handle: AbuilderViewHandle): () => void {
+  handles.add(handle);
+  return () => {
+    handles.delete(handle);
+  };
+}
+
+function findHandle(nameSpace?: string | null): AbuilderViewHandle | null {
+  if (handles.size === 0) return null;
+  if (nameSpace === undefined) {
+    return handles.values().next().value ?? null;
+  }
+  const wanted = normalizeAppNameSpace(nameSpace);
+  for (const handle of handles) {
+    if (normalizeAppNameSpace(handle.getNameSpace()) === wanted) return handle;
+  }
+  return null;
+}
+
+/**
+ * 读取当前已挂载编辑器中的工作区快照。
+ * 同页多个实例时请传入 `nameSpace`；未挂载或尚无 active 工作区时返回 null。
+ */
+export function getCurrentWorkspace(
+  nameSpace?: string | null
+): WorkspaceProjectRecord | null {
+  return findHandle(nameSpace)?.getCurrentWorkspace() ?? null;
+}
+
+/**
+ * 命令式打开工作区（不 remount）。
+ * 同页多个实例时请传入 `nameSpace`。
+ */
+export async function openWorkspace(
+  idOrRecord: string | WorkspaceProjectRecord,
+  nameSpace?: string | null
+): Promise<void> {
+  const handle = findHandle(nameSpace);
+  if (!handle) {
+    throw new Error(
+      "No mounted Abuilder panel. Pass initialWorkspace or mount <App> first."
+    );
+  }
+  await handle.openWorkspace(idOrRecord);
+}
+
+export async function createWorkspace(
+  nameSpace?: string | null
+): Promise<{ name: string; id: string }> {
+  const handle = findHandle(nameSpace);
+  if (!handle) {
+    throw new Error(
+      "No mounted Abuilder panel. Pass initialWorkspace or mount <App> first."
+    );
+  }
+  return handle.createWorkspace();
+}
+
+export async function saveWorkspace(
+  nameSpace?: string | null
+): Promise<{ name: string; id: string }> {
+  const handle = findHandle(nameSpace);
+  if (!handle) {
+    throw new Error(
+      "No mounted Abuilder panel. Pass initialWorkspace or mount <App> first."
+    );
+  }
+  return handle.saveWorkspace();
+}
+
+export async function syncWorkspace(nameSpace?: string | null): Promise<string> {
+  const handle = findHandle(nameSpace);
+  if (!handle) {
+    throw new Error(
+      "No mounted Abuilder panel. Pass initialWorkspace or mount <App> first."
+    );
+  }
+  return handle.syncWorkspace();
+}