@arronqzy/react-blueprint 1.0.22 → 1.0.23

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";
@@ -50,15 +57,22 @@ export {
   getApiCollectionListItems,
   upsertApiCollectionFromJson,
   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 +101,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.23",
   "description": "",
   "files": [
     "index.ts",
@@ -19,9 +19,9 @@
     "react-dom": "^19",
     "@xyflow/react": "^12.9.3",
     "@arronqzy/blueprint-dsl": "1.0.17",
+    "@arronqzy/i18n": "0.1.17",
     "@arronqzy/react-rx-store": "1.1.8",
-    "@arronqzy/ui": "1.0.10",
-    "@arronqzy/i18n": "0.1.17"
+    "@arronqzy/ui": "1.0.10"
   },
   "devDependencies": {
     "@types/react": "^19.0.1",

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,
@@ -127,6 +129,34 @@ export async function removeApiCollection(id: string): Promise<void> {
   emit();
 }
 
+function isCurrentNameSpace(nameSpace?: string | null): boolean {
+  return normalizeAppNameSpace(nameSpace) === normalizeAppNameSpace(nameSpaceRef);
+}
+
+/** 按 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;
+}