@arronqzy/react-blueprint 1.0.22 → 1.0.24

package/README.md

@@ -104,6 +104,19 @@ useBlueprintPageLifecycle({
 | `BlueprintPanelToolbar` | 库、保存、同步、调试按钮 |
 | `BlueprintExecutionLogPanel` | 执行日志 |
 
+## 本地存储
+
+蓝图库、执行日志、接口集合存在 IndexedDB，函数最后一个参数都是 `nameSpace`：
+
+| 数据 | 函数 |
+|------|------|
+| 蓝图库 | `listBlueprintLibrary` / `getBlueprintLibraryRecord` / `putBlueprintLibraryRecord` / `deleteBlueprintLibraryRecord` / `clearBlueprintLibrary` |
+| 执行日志 | `listExecutionRunRecords` / `getExecutionRunRecord` / `putExecutionRunRecord` / `deleteExecutionRunRecord` / `clearAllExecutionRunRecords` / `purgeExecutionRunsOlderThan` / `trimExecutionRunRecordsToMax` / `downloadExecutionRunExport` |
+| 执行日志保留策略 | `readExecutionLogSettings` / `writeExecutionLogSettings` / `DEFAULT_EXECUTION_LOG_SETTINGS` |
+| 接口集合 | `listApiCollectionRecords` / `deleteApiCollection` / `clearApiCollections`（同时更新内存中的接口列表） |
+
+这一层不负责通知已挂载的视图面板。宿主清理数据请用 `@arronqzy/abuilder` / `@arronqzy/abuilder-vue` 导出的同名函数，删除蓝图库后面板会自动刷新。
+
 ## 依赖
 
 `@arronqzy/blueprint-dsl`、`@arronqzy/i18n`、`@arronqzy/react-rx-store`、`@arronqzy/ui`、`@xyflow/react`。

package/index.ts

@@ -22,12 +22,19 @@ export type {
 } from "./src/hooks/useBlueprintDebugSession";
 export {
   listExecutionRunRecords,
+  getExecutionRunRecord,
   putExecutionRunRecord,
+  deleteExecutionRunRecord,
   purgeExecutionRunsOlderThan,
   clearAllExecutionRunRecords,
   trimExecutionRunRecordsToMax,
   downloadExecutionRunExport,
 } from "./src/library/execution-log-db";
+export {
+  DEFAULT_EXECUTION_LOG_SETTINGS,
+  readExecutionLogSettings,
+  writeExecutionLogSettings,
+} from "./src/library/execution-log-settings";
 export type { UseBlueprintPageLifecycleOptions } from "./src/hooks/useBlueprintPageLifecycle";
 export { useBlueprintPageLifecycle } from "./src/hooks/useBlueprintPageLifecycle";
 export { stopAllClockSchedules } from "@arronqzy/blueprint-dsl";
@@ -49,16 +56,24 @@ export {
   getApiCollectionById,
   getApiCollectionListItems,
   upsertApiCollectionFromJson,
+  putApiCollection,
   removeApiCollection,
+  deleteApiCollection,
+  clearApiCollections,
   subscribeApiCollections,
   useApiCollections,
   useApiCollectionListItems,
 } from "./src/library/api-collection-store";
+export type {
+  UpsertApiCollectionInput,
+  UpsertApiCollectionResult,
+} from "./src/library/api-collection-store";
 export {
   listApiCollectionRecords,
   getApiCollectionRecord,
   putApiCollectionRecord,
   deleteApiCollectionRecord,
+  clearApiCollectionRecords,
 } from "./src/library/api-collection-db";
 export { BlueprintLibrarySelect } from "./src/components/BlueprintLibrarySelect";
 export type { BlueprintLibrarySelectProps } from "./src/components/BlueprintLibrarySelect";
@@ -87,6 +102,7 @@ export {
   parseBlueprintImportFile,
 } from "./src/library/blueprint-io";
 export {
+  clearBlueprintLibrary,
   deleteBlueprintLibraryRecord,
   getBlueprintLibraryRecord,
   listBlueprintLibrary,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arronqzy/react-blueprint",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "description": "",
   "files": [
     "index.ts",
@@ -18,9 +18,9 @@
     "dayjs": "^1.11.13",
     "react-dom": "^19",
     "@xyflow/react": "^12.9.3",
-    "@arronqzy/blueprint-dsl": "1.0.17",
     "@arronqzy/react-rx-store": "1.1.8",
     "@arronqzy/ui": "1.0.10",
+    "@arronqzy/blueprint-dsl": "1.0.17",
     "@arronqzy/i18n": "0.1.17"
   },
   "devDependencies": {
@@ -34,8 +34,8 @@
     "eslint": "^8.57.0",
     "typescript": "^5.5.4",
     "vite": "^5.1.4",
-    "@arronqzy/tailwind": "1.0.2",
     "@arronqzy/eslint-config": "0.0.0",
+    "@arronqzy/tailwind": "1.0.2",
     "@arronqzy/typescript-config": "1.0.0"
   },
   "keywords": [],

package/src/library/api-collection-db.ts

@@ -96,3 +96,7 @@ export async function deleteApiCollectionRecord(
     nameSpace
   );
 }
+
+export async function clearApiCollectionRecords(nameSpace?: string | null): Promise<void> {
+  await runTransaction<undefined>("readwrite", (store) => store.clear(), nameSpace);
+}

package/src/library/api-collection-store.ts

@@ -6,9 +6,11 @@ import {
   type ApiCollectionDocument,
   type ApiCollectionListItem,
   type ApiCollectionRecord,
+  normalizeAppNameSpace,
 } from "@arronqzy/blueprint-dsl";
 
 import {
+  clearApiCollectionRecords,
   deleteApiCollectionRecord,
   listApiCollectionRecords,
   putApiCollectionRecord,
@@ -68,18 +70,48 @@ export type UpsertApiCollectionInput = {
   persistLocal: boolean;
   /** 未写 document.name 时用文件名 */
   fallbackName?: string;
+  /** 省略时写入当前已 hydrate 的 nameSpace */
+  nameSpace?: string | null;
 };
 
 export type UpsertApiCollectionResult =
   | { ok: true; record: ApiCollectionRecord }
   | { ok: false; error: string };
 
+function isCurrentNameSpace(nameSpace?: string | null): boolean {
+  return normalizeAppNameSpace(nameSpace) === normalizeAppNameSpace(nameSpaceRef);
+}
+
+/** 写入接口集合；persistLocal 时落 IndexedDB，同一 nameSpace 下刷新内存列表 */
+export async function putApiCollection(
+  record: ApiCollectionRecord,
+  nameSpace?: string | null
+): Promise<ApiCollectionRecord> {
+  if (record.persistLocal) {
+    await putApiCollectionRecord(record, nameSpace);
+  } else if (isCurrentNameSpace(nameSpace)) {
+    const existing = records.find((item) => item.id === record.id);
+    if (existing?.persistLocal) {
+      await deleteApiCollectionRecord(record.id, nameSpace);
+    }
+  }
+  if (isCurrentNameSpace(nameSpace)) {
+    const next = records.filter((item) => item.id !== record.id);
+    next.push(record);
+    records = sortRecords(next);
+    emit();
+  }
+  return record;
+}
+
 export async function upsertApiCollectionFromJson(
   input: UpsertApiCollectionInput
 ): Promise<UpsertApiCollectionResult> {
   const parsed = parseApiCollectionJson(input.rawJson);
   if (!parsed.ok) return parsed;
 
+  const targetNameSpace =
+    input.nameSpace !== undefined ? input.nameSpace : nameSpaceRef;
   const document: ApiCollectionDocument = {
     ...parsed.document,
     name:
@@ -88,11 +120,18 @@ export async function upsertApiCollectionFromJson(
       parsed.document.name,
   };
   const now = Date.now();
-  const existing = input.id
+  const existingInMemory = input.id
     ? records.find((item) => item.id === input.id) ?? null
     : null;
+  const existingPersisted =
+    input.id && !isCurrentNameSpace(targetNameSpace)
+      ? await listApiCollectionRecords(targetNameSpace).then(
+          (list) => list.find((item) => item.id === input.id) ?? null
+        )
+      : null;
+  const existing = existingInMemory ?? existingPersisted;
   const record: ApiCollectionRecord = {
-    id: existing?.id ?? createApiCollectionId(),
+    id: existing?.id ?? input.id ?? createApiCollectionId(),
     name: document.name,
     persistLocal: input.persistLocal,
     document,
@@ -101,16 +140,7 @@ export async function upsertApiCollectionFromJson(
     updatedAt: now,
   };
 
-  if (record.persistLocal) {
-    await putApiCollectionRecord(record, nameSpaceRef);
-  } else if (existing?.persistLocal) {
-    await deleteApiCollectionRecord(record.id, nameSpaceRef);
-  }
-
-  const next = records.filter((item) => item.id !== record.id);
-  next.push(record);
-  records = sortRecords(next);
-  emit();
+  await putApiCollection(record, targetNameSpace);
   return { ok: true, record };
 }
 
@@ -127,6 +157,30 @@ export async function removeApiCollection(id: string): Promise<void> {
   emit();
 }
 
+/** 按 nameSpace 删除接口集合；若该 nameSpace 正在被编辑器使用，内存列表同步移除 */
+export async function deleteApiCollection(
+  id: string,
+  nameSpace?: string | null
+): Promise<void> {
+  await deleteApiCollectionRecord(id, nameSpace);
+  if (!isCurrentNameSpace(nameSpace)) return;
+  records = records.filter((item) => item.id !== id);
+  emit();
+}
+
+/** 清空该 nameSpace 下的接口集合（含仅存内存的集合），返回删除数量 */
+export async function clearApiCollections(nameSpace?: string | null): Promise<number> {
+  const persisted = await listApiCollectionRecords(nameSpace);
+  await clearApiCollectionRecords(nameSpace);
+  const removedIds = new Set(persisted.map((item) => item.id));
+  if (isCurrentNameSpace(nameSpace)) {
+    records.forEach((item) => removedIds.add(item.id));
+    records = [];
+    emit();
+  }
+  return removedIds.size;
+}
+
 export function useApiCollections(): ApiCollectionRecord[] {
   const [list, setList] = useState<ApiCollectionRecord[]>(() => records);
   useEffect(() => subscribeApiCollections(() => setList([...records])), []);

package/src/library/blueprint-library-db.ts

@@ -124,3 +124,10 @@ export async function deleteBlueprintLibraryRecord(
 ): Promise<void> {
   await runTransaction<undefined>("readwrite", (store) => store.delete(id), nameSpace);
 }
+
+/** 清空该 nameSpace 下的蓝图库，返回删除数量 */
+export async function clearBlueprintLibrary(nameSpace?: string | null): Promise<number> {
+  const count = await runTransaction<number>("readonly", (store) => store.count(), nameSpace);
+  await runTransaction<undefined>("readwrite", (store) => store.clear(), nameSpace);
+  return count;
+}