@flowgram-vue/history-storage 0.2.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+Copyright (c) 2026 Crayon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,311 @@
+'use strict';
+
+var core = require('@flowgram-vue/core');
+var inversify = require('inversify');
+var utils = require('@flowgram-vue/utils');
+var history = require('@flowgram-vue/history');
+var Dexie = require('dexie');
+var lodashEs = require('lodash-es');
+var vue = require('vue');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var Dexie__default = /*#__PURE__*/_interopDefault(Dexie);
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var HistoryDatabase = class extends Dexie__default.default {
+  constructor(databaseName = "ide-history-storage") {
+    super(databaseName);
+    this.resourceStorageLimit = 100;
+    this.version(1).stores({
+      history: "++id, &uuid, resourceURI",
+      operation: "++id, &uuid, historyId, uri, resourceURI"
+    });
+  }
+  /**
+   * 某个uri下所有的history记录
+   * @param resourceURI 资源uri
+   * @returns
+   */
+  allHistoryByResourceURI(resourceURI) {
+    return this.history.where({ resourceURI }).toArray();
+  }
+  /**
+   * 根据uuid获取历史
+   * @param uuid
+   * @returns
+   */
+  getHistoryByUUID(uuid) {
+    return this.history.get({ uuid });
+  }
+  /**
+   * 某个uri下所有的operation记录
+   * @param resourceURI 资源uri
+   * @returns
+   */
+  allOperationByResourceURI(resourceURI) {
+    return this.operation.where({ resourceURI }).toArray();
+  }
+  /**
+   * 添加历史记录
+   * @param history 历史记录
+   * @param operations 操作记录
+   * @returns
+   */
+  addHistoryRecord(history, operations) {
+    return this.transaction("rw", this.history, this.operation, async () => {
+      const count = await this.history.where({ resourceURI: history.resourceURI }).count();
+      if (count >= this.resourceStorageLimit) {
+        const limit = count - this.resourceStorageLimit;
+        const items = await this.history.where({ resourceURI: history.resourceURI }).limit(limit).toArray();
+        const ids = items.map((i) => i.id);
+        const uuid = items.map((i) => i.uuid);
+        await Promise.all([
+          this.history.bulkDelete(ids),
+          ...uuid.map(async (uuid2) => {
+            await this.operation.where({ historyId: uuid2 }).delete();
+          })
+        ]);
+      }
+      return Promise.all([this.history.add(history), this.operation.bulkAdd(operations)]);
+    });
+  }
+  /**
+   * 更新历史记录
+   * @param historyRecord
+   * @returns
+   */
+  async updateHistoryByUUID(uuid, historyRecord) {
+    const history = await this.getHistoryByUUID(uuid);
+    if (!history) {
+      console.warn("no history record found");
+      return;
+    }
+    return this.history.update(history.id, historyRecord);
+  }
+  /**
+   * 添加操作记录
+   * @param record 操作记录
+   * @returns
+   */
+  addOperationRecord(record) {
+    return this.operation.add(record);
+  }
+  /**
+   * 更新操作记录
+   * @param record 操作记录
+   * @returns
+   */
+  async updateOperationRecord(record) {
+    const op = await this.operation.where({ uuid: record.uuid }).first();
+    if (!op) {
+      console.warn("no operation record found");
+      return;
+    }
+    return this.operation.put({
+      id: op.id,
+      ...record
+    });
+  }
+  /**
+   * 重置数据库
+   * @returns
+   */
+  reset() {
+    return this.transaction("rw", this.history, this.operation, async () => {
+      await Promise.all(this.tables.map((table) => table.clear()));
+    });
+  }
+  /**
+   * 清空某个资源下所有的数据
+   * @param resourceURI
+   * @returns
+   */
+  resetByResourceURI(resourceURI) {
+    return this.transaction("rw", this.history, this.operation, async () => {
+      await Promise.all(this.tables.map((table) => table.where({ resourceURI }).delete()));
+    });
+  }
+};
+
+// src/history-storage-manager.ts
+exports.HistoryStorageManager = class HistoryStorageManager {
+  constructor() {
+    this._toDispose = new utils.DisposableCollection();
+  }
+  /**
+   * 初始化
+   * @param ctx
+   */
+  onInit(_ctx, opts) {
+    this.db = new HistoryDatabase(opts?.databaseName);
+    if (opts?.resourceStorageLimit) {
+      this.db.resourceStorageLimit = opts.resourceStorageLimit;
+    }
+    this._toDispose.push(
+      this.historyManager.historyStack.onChange((event) => {
+        if (event.type === history.HistoryStackChangeType.ADD) {
+          const [history, operations] = this.historyItemToRecord(event.service, event.value);
+          this.db.addHistoryRecord(history, operations).catch(console.error);
+        }
+        if ([history.HistoryStackChangeType.ADD_OPERATION, history.HistoryStackChangeType.UPDATE_OPERATION].includes(
+          event.type
+        )) {
+          const {
+            service,
+            value: { historyItem }
+          } = event;
+          this.db.updateHistoryByUUID(historyItem.id, {
+            resourceJSON: service.getSnapshot() || ""
+          }).catch(console.error);
+        }
+        if (event.type === history.HistoryStackChangeType.ADD_OPERATION) {
+          const operationRecord = this.historyOperationToRecord(
+            event.value.historyItem,
+            event.value.operation
+          );
+          this.db.addOperationRecord(operationRecord).catch(console.error);
+        }
+        if (event.type === history.HistoryStackChangeType.UPDATE_OPERATION) {
+          const operationRecord = this.historyOperationToRecord(
+            event.value.historyItem,
+            event.value.operation
+          );
+          this.db.updateOperationRecord(operationRecord).catch(console.error);
+        }
+      })
+    );
+  }
+  /**
+   * 内存历史转数据表记录
+   * @param historyItem
+   * @returns
+   */
+  historyItemToRecord(historyService, historyItem) {
+    const operations = historyItem.operations.map(
+      (op) => this.historyOperationToRecord(historyItem, op)
+    );
+    return [
+      {
+        uuid: historyItem.id,
+        timestamp: historyItem.timestamp,
+        type: historyItem.type,
+        resourceURI: historyItem.uri?.toString() || "",
+        resourceJSON: historyService.getSnapshot() || ""
+      },
+      operations
+    ];
+  }
+  /**
+   * 内存操作转数据表操作
+   * @param historyItem
+   * @param op
+   * @returns
+   */
+  historyOperationToRecord(historyItem, op) {
+    return {
+      uuid: op.id,
+      type: op.type,
+      timestamp: op.timestamp,
+      label: op.label || "",
+      uri: op?.uri?.toString() || "",
+      resourceURI: historyItem.uri?.toString() || "",
+      description: op.description || "",
+      value: JSON.stringify(op.value),
+      historyId: historyItem.id
+    };
+  }
+  /**
+   * 销毁
+   */
+  dispose() {
+    this._toDispose.dispose();
+  }
+};
+__decorateClass([
+  inversify.inject(history.HistoryManager)
+], exports.HistoryStorageManager.prototype, "historyManager", 2);
+exports.HistoryStorageManager = __decorateClass([
+  inversify.injectable()
+], exports.HistoryStorageManager);
+var HistoryStorageContainerModule = new inversify.ContainerModule((bind) => {
+  bind(exports.HistoryStorageManager).toSelf().inSingletonScope();
+});
+
+// src/create-history-storage-plugin.ts
+var createHistoryStoragePlugin = core.definePluginCreator({
+  onBind: ({ bind, rebind }) => {
+  },
+  onInit(ctx, opts) {
+    const historyStorageManager = ctx.get(exports.HistoryStorageManager);
+    historyStorageManager.onInit(ctx, opts);
+  },
+  onDispose(ctx) {
+    const historyStorageManager = ctx.get(exports.HistoryStorageManager);
+    historyStorageManager.dispose();
+  },
+  containerModules: [HistoryStorageContainerModule]
+});
+function useStorageHistoryItems(historyStorageManager, resourceURI) {
+  const state = vue.reactive({
+    items: []
+  });
+  vue.watchEffect((onCleanup) => {
+    const uri = vue.toValue(resourceURI);
+    const observable = Dexie.liveQuery(async () => {
+      const [historyItems, operations] = await Promise.all([
+        historyStorageManager.db.allHistoryByResourceURI(uri),
+        historyStorageManager.db.allOperationByResourceURI(uri)
+      ]);
+      const grouped = lodashEs.groupBy(
+        operations.map((o) => ({
+          id: o.uuid,
+          timestamp: o.timestamp,
+          type: o.type,
+          label: o.label,
+          description: o.description,
+          value: o.value ? JSON.parse(o.value) : void 0,
+          uri: o.uri,
+          historyId: o.historyId
+        })),
+        "historyId"
+      );
+      return historyItems.sort((a, b) => b.id - a.id).map(
+        (historyItem) => ({
+          id: historyItem.uuid,
+          type: historyItem.type,
+          timestamp: historyItem.timestamp,
+          operations: grouped[historyItem.uuid] || [],
+          time: history.HistoryStack.dateFormat(historyItem.timestamp),
+          uri: historyItem.resourceURI
+        })
+      );
+    });
+    const subscription = observable.subscribe({
+      next: (value) => {
+        state.items = value || [];
+      },
+      error: (err) => {
+        console.error(err);
+      }
+    });
+    onCleanup(() => subscription.unsubscribe());
+  });
+  return state;
+}
+
+exports.HistoryDatabase = HistoryDatabase;
+exports.HistoryStorageContainerModule = HistoryStorageContainerModule;
+exports.createHistoryStoragePlugin = createHistoryStoragePlugin;
+exports.useStorageHistoryItems = useStorageHistoryItems;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/history-database.ts","../src/history-storage-manager.ts","../src/history-storage-container-module.ts","../src/create-history-storage-plugin.ts","../src/use-storage-hisotry-items.ts"],"names":["Dexie","uuid","HistoryStorageManager","DisposableCollection","HistoryStackChangeType","inject","HistoryManager","injectable","ContainerModule","definePluginCreator","reactive","watchEffect","toValue","liveQuery","groupBy","HistoryStack"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n */\n\nimport Dexie, { type Table } from 'dexie';\n\nimport { HistoryOperationRecord, HistoryRecord } from './types';\n\n/**\n * 历史数据库\n */\nexport class HistoryDatabase extends Dexie {\n  readonly history: Table<HistoryRecord>;\n\n  readonly operation: Table<HistoryOperationRecord>;\n\n  resourceStorageLimit: number = 100;\n\n  constructor(databaseName: string = 'ide-history-storage') {\n    super(databaseName);\n    this.version(1).stores({\n      history: '++id, &uuid, resourceURI',\n      operation: '++id, &uuid, historyId, uri, resourceURI',\n    });\n  }\n\n  /**\n   * 某个uri下所有的history记录\n   * @param resourceURI 资源uri\n   * @returns\n   */\n  allHistoryByResourceURI(resourceURI: string) {\n    return this.history.where({ resourceURI }).toArray();\n  }\n\n  /**\n   * 根据uuid获取历史\n   * @param uuid\n   * @returns\n   */\n  getHistoryByUUID(uuid: string) {\n    return this.history.get({ uuid });\n  }\n\n  /**\n   * 某个uri下所有的operation记录\n   * @param resourceURI 资源uri\n   * @returns\n   */\n  allOperationByResourceURI(resourceURI: string) {\n    return this.operation.where({ resourceURI }).toArray();\n  }\n\n  /**\n   * 添加历史记录\n   * @param history 历史记录\n   * @param operations 操作记录\n   * @returns\n   */\n  addHistoryRecord(history: HistoryRecord, operations: HistoryOperationRecord[]) {\n    return this.transaction('rw', this.history, this.operation, async () => {\n      const count = await this.history.where({ resourceURI: history.resourceURI }).count();\n      if (count >= this.resourceStorageLimit) {\n        const limit = count - this.resourceStorageLimit;\n        const items = await this.history\n          .where({ resourceURI: history.resourceURI })\n          .limit(limit)\n          .toArray();\n        const ids = items.map(i => i.id);\n        const uuid = items.map(i => i.uuid);\n        await Promise.all([\n          this.history.bulkDelete(ids),\n          ...uuid.map(async uuid => {\n            await this.operation.where({ historyId: uuid }).delete();\n          }),\n        ]);\n      }\n\n      return Promise.all([this.history.add(history), this.operation.bulkAdd(operations)]);\n    });\n  }\n\n  /**\n   * 更新历史记录\n   * @param historyRecord\n   * @returns\n   */\n  async updateHistoryByUUID(uuid: string, historyRecord: Partial<HistoryRecord>) {\n    const history = await this.getHistoryByUUID(uuid);\n    if (!history) {\n      console.warn('no history record found');\n      return;\n    }\n    return this.history.update(history.id, historyRecord);\n  }\n\n  /**\n   * 添加操作记录\n   * @param record 操作记录\n   * @returns\n   */\n  addOperationRecord(record: HistoryOperationRecord) {\n    return this.operation.add(record);\n  }\n\n  /**\n   * 更新操作记录\n   * @param record 操作记录\n   * @returns\n   */\n  async updateOperationRecord(record: HistoryOperationRecord) {\n    const op = await this.operation.where({ uuid: record.uuid }).first();\n    if (!op) {\n      console.warn('no operation record found');\n      return;\n    }\n    return this.operation.put({\n      id: op.id,\n      ...record,\n    });\n  }\n\n  /**\n   * 重置数据库\n   * @returns\n   */\n  reset() {\n    return this.transaction('rw', this.history, this.operation, async () => {\n      await Promise.all(this.tables.map(table => table.clear()));\n    });\n  }\n\n  /**\n   * 清空某个资源下所有的数据\n   * @param resourceURI\n   * @returns\n   */\n  resetByResourceURI(resourceURI: string) {\n    return this.transaction('rw', this.history, this.operation, async () => {\n      await Promise.all(this.tables.map(table => table.where({ resourceURI }).delete()));\n    });\n  }\n}\n","/**\n * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n */\n\nimport { inject, injectable } from 'inversify';\nimport { DisposableCollection } from '@flowgram-vue/utils';\nimport {\n  HistoryItem,\n  HistoryManager,\n  HistoryOperation,\n  HistoryStackChangeType,\n  HistoryService,\n  HistoryStackAddOperationEvent,\n  HistoryStackUpdateOperationEvent,\n} from '@flowgram-vue/history';\nimport { PluginContext } from '@flowgram-vue/core';\n\nimport { HistoryOperationRecord, HistoryRecord, HistoryStoragePluginOptions } from './types';\nimport { HistoryDatabase } from './history-database';\n\n/**\n * 历史存储管理\n */\n@injectable()\nexport class HistoryStorageManager {\n  private _toDispose = new DisposableCollection();\n\n  db: HistoryDatabase;\n\n  @inject(HistoryManager)\n  protected historyManager: HistoryManager;\n\n  /**\n   * 初始化\n   * @param ctx\n   */\n  onInit(_ctx: PluginContext, opts: HistoryStoragePluginOptions) {\n    this.db = new HistoryDatabase(opts?.databaseName);\n\n    if (opts?.resourceStorageLimit) {\n      this.db.resourceStorageLimit = opts.resourceStorageLimit;\n    }\n\n    this._toDispose.push(\n      this.historyManager.historyStack.onChange(event => {\n        if (event.type === HistoryStackChangeType.ADD) {\n          const [history, operations] = this.historyItemToRecord(event.service, event.value);\n          this.db.addHistoryRecord(history, operations).catch(console.error);\n        }\n\n        // operation merge的时候需要更新snapshot\n        if (\n          [HistoryStackChangeType.ADD_OPERATION, HistoryStackChangeType.UPDATE_OPERATION].includes(\n            event.type,\n          )\n        ) {\n          const {\n            service,\n            value: { historyItem },\n          } = event as HistoryStackAddOperationEvent | HistoryStackUpdateOperationEvent;\n          // 更新快照\n          this.db\n            .updateHistoryByUUID(historyItem.id, {\n              resourceJSON: service.getSnapshot() || '',\n            })\n            .catch(console.error);\n        }\n\n        if (event.type === HistoryStackChangeType.ADD_OPERATION) {\n          const operationRecord: HistoryOperationRecord = this.historyOperationToRecord(\n            event.value.historyItem,\n            event.value.operation,\n          );\n          this.db.addOperationRecord(operationRecord).catch(console.error);\n        }\n        if (event.type === HistoryStackChangeType.UPDATE_OPERATION) {\n          const operationRecord: HistoryOperationRecord = this.historyOperationToRecord(\n            event.value.historyItem,\n            event.value.operation,\n          );\n          this.db.updateOperationRecord(operationRecord).catch(console.error);\n        }\n      }),\n    );\n  }\n\n  /**\n   * 内存历史转数据表记录\n   * @param historyItem\n   * @returns\n   */\n  historyItemToRecord(\n    historyService: HistoryService,\n    historyItem: HistoryItem,\n  ): [HistoryRecord, HistoryOperationRecord[]] {\n    const operations = historyItem.operations.map(op =>\n      this.historyOperationToRecord(historyItem, op),\n    );\n\n    return [\n      {\n        uuid: historyItem.id,\n        timestamp: historyItem.timestamp,\n        type: historyItem.type,\n        resourceURI: historyItem.uri?.toString() || '',\n        resourceJSON: historyService.getSnapshot() || '',\n      },\n      operations,\n    ];\n  }\n\n  /**\n   * 内存操作转数据表操作\n   * @param historyItem\n   * @param op\n   * @returns\n   */\n  historyOperationToRecord(historyItem: HistoryItem, op: HistoryOperation): HistoryOperationRecord {\n    return {\n      uuid: op.id,\n      type: op.type,\n      timestamp: op.timestamp,\n      label: op.label || '',\n      uri: op?.uri?.toString() || '',\n      resourceURI: historyItem.uri?.toString() || '',\n      description: op.description || '',\n      value: JSON.stringify(op.value),\n      historyId: historyItem.id,\n    };\n  }\n\n  /**\n   * 销毁\n   */\n  dispose() {\n    this._toDispose.dispose();\n  }\n}\n","/**\n * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n */\n\nimport { ContainerModule } from 'inversify';\n\nimport { HistoryStorageManager } from './history-storage-manager';\n\nexport const HistoryStorageContainerModule = new ContainerModule(bind => {\n  bind(HistoryStorageManager).toSelf().inSingletonScope();\n});\n","/**\n * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n */\n\nimport { definePluginCreator } from '@flowgram-vue/core';\n\nimport { HistoryStoragePluginOptions } from './types';\nimport { HistoryStorageManager } from './history-storage-manager';\nimport { HistoryStorageContainerModule } from './history-storage-container-module';\n\nexport const createHistoryStoragePlugin = definePluginCreator<HistoryStoragePluginOptions>({\n  onBind: ({ bind, rebind }) => {},\n  onInit(ctx, opts): void {\n    const historyStorageManager = ctx.get<HistoryStorageManager>(HistoryStorageManager);\n    historyStorageManager.onInit(ctx, opts);\n  },\n  onDispose(ctx) {\n    const historyStorageManager = ctx.get<HistoryStorageManager>(HistoryStorageManager);\n    historyStorageManager.dispose();\n  },\n  containerModules: [HistoryStorageContainerModule],\n});\n","/**\n * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n */\n\nimport { liveQuery } from 'dexie';\nimport { groupBy } from 'lodash-es';\nimport { reactive, toValue, watchEffect } from 'vue';\nimport type { MaybeRefOrGetter } from 'vue';\nimport { HistoryItem, HistoryOperation, HistoryStack } from '@flowgram-vue/history';\n\nimport { HistoryStorageManager } from './history-storage-manager';\n\nexport function useStorageHistoryItems(\n  historyStorageManager: HistoryStorageManager,\n  resourceURI: MaybeRefOrGetter<string>\n): {\n  items: HistoryItem[];\n} {\n  const state = reactive<{ items: HistoryItem[] }>({\n    items: [],\n  });\n\n  watchEffect((onCleanup) => {\n    const uri = toValue(resourceURI);\n    const observable = liveQuery(async () => {\n      const [historyItems, operations] = await Promise.all([\n        historyStorageManager.db.allHistoryByResourceURI(uri),\n        historyStorageManager.db.allOperationByResourceURI(uri),\n      ]);\n\n      const grouped = groupBy<HistoryOperation>(\n        operations.map((o) => ({\n          id: o.uuid,\n          timestamp: o.timestamp,\n          type: o.type,\n          label: o.label,\n          description: o.description,\n          value: o.value ? JSON.parse(o.value) : undefined,\n          uri: o.uri,\n          historyId: o.historyId,\n        })),\n        'historyId'\n      );\n      return historyItems\n        .sort((a, b) => (b.id as number) - (a.id as number))\n        .map(\n          (historyItem) =>\n            ({\n              id: historyItem.uuid,\n              type: historyItem.type,\n              timestamp: historyItem.timestamp,\n              operations: grouped[historyItem.uuid] || [],\n              time: HistoryStack.dateFormat(historyItem.timestamp),\n              uri: historyItem.resourceURI,\n            }) as HistoryItem\n        );\n    });\n\n    const subscription = observable.subscribe({\n      next: (value) => {\n        state.items = value || [];\n      },\n      error: (err) => {\n        console.error(err);\n      },\n    });\n\n    onCleanup(() => subscription.unsubscribe());\n  });\n\n  return state;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,213 @@
+import * as _flowgram_vue_core from '@flowgram-vue/core';
+import { PluginContext } from '@flowgram-vue/core';
+import { MaybeRefOrGetter } from 'vue';
+import { HistoryManager, HistoryService, HistoryItem, HistoryOperation } from '@flowgram-vue/history';
+import * as dexie from 'dexie';
+import dexie__default, { Table } from 'dexie';
+import { ContainerModule } from 'inversify';
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+interface HistoryRecord {
+    /**
+     * 自增id
+     */
+    id?: number;
+    /**
+     * 唯一标识
+     */
+    uuid: string;
+    /**
+     * 类型 如 push undo redo
+     */
+    type: string;
+    /**
+     * 时间戳
+     */
+    timestamp: number;
+    /**
+     * 资源uri
+     */
+    resourceURI: string;
+    /**
+     * 资源json
+     */
+    resourceJSON: unknown;
+}
+interface HistoryOperationRecord {
+    /**
+     * 自增id
+     */
+    id?: number;
+    /**
+     * 唯一标识
+     */
+    uuid: string;
+    /**
+     * 历史记录唯一标志，记录的uuid
+     */
+    historyId: string;
+    /**
+     * 类型，如 addFromNode deleteFromNode
+     */
+    type: string;
+    /**
+     * 操作值，不同类型不同，json字符串
+     */
+    value: string;
+    /**
+     * uri操作对象uri，如某个node的uri
+     */
+    uri: string;
+    /**
+     * 操作资源uri，如某个流程的uri
+     */
+    resourceURI: string;
+    /**
+     * 操作显示标题
+     */
+    label: string;
+    /**
+     * 操作显示描述
+     */
+    description: string;
+    /**
+     * 时间戳
+     */
+    timestamp: number;
+}
+/**
+ * 插件配置
+ */
+interface HistoryStoragePluginOptions {
+    /**
+     * 数据库名称
+     */
+    databaseName?: string;
+    /**
+     * 每个资源最大历史记录数量
+     */
+    resourceStorageLimit?: number;
+}
+
+declare const createHistoryStoragePlugin: _flowgram_vue_core.PluginCreator<HistoryStoragePluginOptions>;
+
+/**
+ * 历史数据库
+ */
+declare class HistoryDatabase extends dexie__default {
+    readonly history: Table<HistoryRecord>;
+    readonly operation: Table<HistoryOperationRecord>;
+    resourceStorageLimit: number;
+    constructor(databaseName?: string);
+    /**
+     * 某个uri下所有的history记录
+     * @param resourceURI 资源uri
+     * @returns
+     */
+    allHistoryByResourceURI(resourceURI: string): dexie.PromiseExtended<HistoryRecord[]>;
+    /**
+     * 根据uuid获取历史
+     * @param uuid
+     * @returns
+     */
+    getHistoryByUUID(uuid: string): dexie.PromiseExtended<HistoryRecord | undefined>;
+    /**
+     * 某个uri下所有的operation记录
+     * @param resourceURI 资源uri
+     * @returns
+     */
+    allOperationByResourceURI(resourceURI: string): dexie.PromiseExtended<HistoryOperationRecord[]>;
+    /**
+     * 添加历史记录
+     * @param history 历史记录
+     * @param operations 操作记录
+     * @returns
+     */
+    addHistoryRecord(history: HistoryRecord, operations: HistoryOperationRecord[]): dexie.PromiseExtended<[any, any]>;
+    /**
+     * 更新历史记录
+     * @param historyRecord
+     * @returns
+     */
+    updateHistoryByUUID(uuid: string, historyRecord: Partial<HistoryRecord>): Promise<number | undefined>;
+    /**
+     * 添加操作记录
+     * @param record 操作记录
+     * @returns
+     */
+    addOperationRecord(record: HistoryOperationRecord): dexie.PromiseExtended<any>;
+    /**
+     * 更新操作记录
+     * @param record 操作记录
+     * @returns
+     */
+    updateOperationRecord(record: HistoryOperationRecord): Promise<any>;
+    /**
+     * 重置数据库
+     * @returns
+     */
+    reset(): dexie.PromiseExtended<void>;
+    /**
+     * 清空某个资源下所有的数据
+     * @param resourceURI
+     * @returns
+     */
+    resetByResourceURI(resourceURI: string): dexie.PromiseExtended<void>;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * 历史存储管理
+ */
+declare class HistoryStorageManager {
+    private _toDispose;
+    db: HistoryDatabase;
+    protected historyManager: HistoryManager;
+    /**
+     * 初始化
+     * @param ctx
+     */
+    onInit(_ctx: PluginContext, opts: HistoryStoragePluginOptions): void;
+    /**
+     * 内存历史转数据表记录
+     * @param historyItem
+     * @returns
+     */
+    historyItemToRecord(historyService: HistoryService, historyItem: HistoryItem): [HistoryRecord, HistoryOperationRecord[]];
+    /**
+     * 内存操作转数据表操作
+     * @param historyItem
+     * @param op
+     * @returns
+     */
+    historyOperationToRecord(historyItem: HistoryItem, op: HistoryOperation): HistoryOperationRecord;
+    /**
+     * 销毁
+     */
+    dispose(): void;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare function useStorageHistoryItems(historyStorageManager: HistoryStorageManager, resourceURI: MaybeRefOrGetter<string>): {
+    items: HistoryItem[];
+};
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare const HistoryStorageContainerModule: ContainerModule;
+
+export { HistoryDatabase, type HistoryOperationRecord, type HistoryRecord, HistoryStorageContainerModule, HistoryStorageManager, type HistoryStoragePluginOptions, createHistoryStoragePlugin, useStorageHistoryItems };