@tachybase/module-backup 1.5.0 → 1.6.0

package/dist/node_modules/cron-parser/package.json

@@ -1 +1 @@
-{"name":"cron-parser","version":"4.9.0","description":"Node.js library for parsing crontab instructions","main":"lib/parser.js","types":"types/index.d.ts","typesVersions":{"<4.1":{"*":["types/ts3/*"]}},"directories":{"test":"test"},"scripts":{"test:tsd":"tsd","test:unit":"TZ=UTC tap ./test/*.js","test:cover":"TZ=UTC tap --coverage-report=html ./test/*.js","lint":"eslint .","lint:fix":"eslint --fix .","test":"npm run lint && npm run test:unit && npm run test:tsd"},"repository":{"type":"git","url":"https://github.com/harrisiirak/cron-parser.git"},"keywords":["cron","crontab","parser"],"author":"Harri Siirak","contributors":["Nicholas Clawson","Daniel Prentis <daniel@salsitasoft.com>","Renault John Lecoultre","Richard Astbury <richard.astbury@gmail.com>","Meaglin Wasabi <Meaglin.wasabi@gmail.com>","Mike Kusold <hello@mikekusold.com>","Alex Kit <alex.kit@atmajs.com>","Santiago Gimeno <santiago.gimeno@gmail.com>","Daniel <darc.tec@gmail.com>","Christian Steininger <christian.steininger.cs@gmail.com>","Mykola Piskovyi <m.piskovyi@gmail.com>","Brian Vaughn <brian.david.vaughn@gmail.com>","Nicholas Clawson <nickclaw@gmail.com>","Yasuhiroki <yasuhiroki.duck@gmail.com>","Nicholas Clawson <nickclaw@gmail.com>","Brendan Warkentin <faazshift@gmail.com>","Charlie Fish <fishcharlie.code@gmail.com>","Ian Graves <ian+diskimage@iangrav.es>","Andy Thompson <me@andytson.com>","Regev Brody <regevbr@gmail.com>"],"license":"MIT","dependencies":{"luxon":"^3.2.1"},"devDependencies":{"eslint":"^8.27.0","sinon":"^15.0.1","tap":"^16.3.3","tsd":"^0.26.0"},"engines":{"node":">=12.0.0"},"browser":{"fs":false},"tap":{"check-coverage":false},"tsd":{"directory":"test","compilerOptions":{"lib":["es2017","dom"]}},"files":["lib","types","LICENSE","README.md"],"_lastModified":"2025-11-11T06:40:15.959Z"}
+{"name":"cron-parser","version":"4.9.0","description":"Node.js library for parsing crontab instructions","main":"lib/parser.js","types":"types/index.d.ts","typesVersions":{"<4.1":{"*":["types/ts3/*"]}},"directories":{"test":"test"},"scripts":{"test:tsd":"tsd","test:unit":"TZ=UTC tap ./test/*.js","test:cover":"TZ=UTC tap --coverage-report=html ./test/*.js","lint":"eslint .","lint:fix":"eslint --fix .","test":"npm run lint && npm run test:unit && npm run test:tsd"},"repository":{"type":"git","url":"https://github.com/harrisiirak/cron-parser.git"},"keywords":["cron","crontab","parser"],"author":"Harri Siirak","contributors":["Nicholas Clawson","Daniel Prentis <daniel@salsitasoft.com>","Renault John Lecoultre","Richard Astbury <richard.astbury@gmail.com>","Meaglin Wasabi <Meaglin.wasabi@gmail.com>","Mike Kusold <hello@mikekusold.com>","Alex Kit <alex.kit@atmajs.com>","Santiago Gimeno <santiago.gimeno@gmail.com>","Daniel <darc.tec@gmail.com>","Christian Steininger <christian.steininger.cs@gmail.com>","Mykola Piskovyi <m.piskovyi@gmail.com>","Brian Vaughn <brian.david.vaughn@gmail.com>","Nicholas Clawson <nickclaw@gmail.com>","Yasuhiroki <yasuhiroki.duck@gmail.com>","Nicholas Clawson <nickclaw@gmail.com>","Brendan Warkentin <faazshift@gmail.com>","Charlie Fish <fishcharlie.code@gmail.com>","Ian Graves <ian+diskimage@iangrav.es>","Andy Thompson <me@andytson.com>","Regev Brody <regevbr@gmail.com>"],"license":"MIT","dependencies":{"luxon":"^3.2.1"},"devDependencies":{"eslint":"^8.27.0","sinon":"^15.0.1","tap":"^16.3.3","tsd":"^0.26.0"},"engines":{"node":">=12.0.0"},"browser":{"fs":false},"tap":{"check-coverage":false},"tsd":{"directory":"test","compilerOptions":{"lib":["es2017","dom"]}},"files":["lib","types","LICENSE","README.md"],"_lastModified":"2025-11-20T08:10:25.628Z"}

package/dist/node_modules/semver/package.json

@@ -1 +1 @@
-{"name":"semver","version":"7.7.2","description":"The semantic version parser used by npm.","main":"index.js","scripts":{"test":"tap","snap":"tap","lint":"npm run eslint","postlint":"template-oss-check","lintfix":"npm run eslint -- --fix","posttest":"npm run lint","template-oss-apply":"template-oss-apply --force","eslint":"eslint \"**/*.{js,cjs,ts,mjs,jsx,tsx}\""},"devDependencies":{"@npmcli/eslint-config":"^5.0.0","@npmcli/template-oss":"4.24.3","benchmark":"^2.1.4","tap":"^16.0.0"},"license":"ISC","repository":{"type":"git","url":"git+https://github.com/npm/node-semver.git"},"bin":{"semver":"bin/semver.js"},"files":["bin/","lib/","classes/","functions/","internal/","ranges/","index.js","preload.js","range.bnf"],"tap":{"timeout":30,"coverage-map":"map.js","nyc-arg":["--exclude","tap-snapshots/**"]},"engines":{"node":">=10"},"author":"GitHub Inc.","templateOSS":{"//@npmcli/template-oss":"This file is partially managed by @npmcli/template-oss. Edits may be overwritten.","version":"4.24.3","engines":">=10","distPaths":["classes/","functions/","internal/","ranges/","index.js","preload.js","range.bnf"],"allowPaths":["/classes/","/functions/","/internal/","/ranges/","/index.js","/preload.js","/range.bnf","/benchmarks"],"publish":"true"},"_lastModified":"2025-11-11T06:40:15.330Z"}
+{"name":"semver","version":"7.7.2","description":"The semantic version parser used by npm.","main":"index.js","scripts":{"test":"tap","snap":"tap","lint":"npm run eslint","postlint":"template-oss-check","lintfix":"npm run eslint -- --fix","posttest":"npm run lint","template-oss-apply":"template-oss-apply --force","eslint":"eslint \"**/*.{js,cjs,ts,mjs,jsx,tsx}\""},"devDependencies":{"@npmcli/eslint-config":"^5.0.0","@npmcli/template-oss":"4.24.3","benchmark":"^2.1.4","tap":"^16.0.0"},"license":"ISC","repository":{"type":"git","url":"git+https://github.com/npm/node-semver.git"},"bin":{"semver":"bin/semver.js"},"files":["bin/","lib/","classes/","functions/","internal/","ranges/","index.js","preload.js","range.bnf"],"tap":{"timeout":30,"coverage-map":"map.js","nyc-arg":["--exclude","tap-snapshots/**"]},"engines":{"node":">=10"},"author":"GitHub Inc.","templateOSS":{"//@npmcli/template-oss":"This file is partially managed by @npmcli/template-oss. Edits may be overwritten.","version":"4.24.3","engines":">=10","distPaths":["classes/","functions/","internal/","ranges/","index.js","preload.js","range.bnf"],"allowPaths":["/classes/","/functions/","/internal/","/ranges/","/index.js","/preload.js","/range.bnf","/benchmarks"],"publish":"true"},"_lastModified":"2025-11-20T08:10:24.966Z"}

package/dist/node_modules/yauzl/package.json

@@ -1 +1 @@
-{"name":"yauzl","version":"3.2.0","description":"yet another unzip library for node","engines":{"node":">=12"},"main":"index.js","scripts":{"test":"node test/test.js"},"repository":{"type":"git","url":"git+https://github.com/thejoshwolfe/yauzl.git"},"keywords":["unzip","zip","stream","archive","file"],"author":"Josh Wolfe <thejoshwolfe@gmail.com>","license":"MIT","bugs":{"url":"https://github.com/thejoshwolfe/yauzl/issues"},"homepage":"https://github.com/thejoshwolfe/yauzl","dependencies":{"buffer-crc32":"~0.2.3","pend":"~1.2.0"},"devDependencies":{"bl":"^6.0.11"},"files":["fd-slicer.js","index.js"],"_lastModified":"2025-11-11T06:40:15.529Z"}
+{"name":"yauzl","version":"3.2.0","description":"yet another unzip library for node","engines":{"node":">=12"},"main":"index.js","scripts":{"test":"node test/test.js"},"repository":{"type":"git","url":"git+https://github.com/thejoshwolfe/yauzl.git"},"keywords":["unzip","zip","stream","archive","file"],"author":"Josh Wolfe <thejoshwolfe@gmail.com>","license":"MIT","bugs":{"url":"https://github.com/thejoshwolfe/yauzl/issues"},"homepage":"https://github.com/thejoshwolfe/yauzl","dependencies":{"buffer-crc32":"~0.2.3","pend":"~1.2.0"},"devDependencies":{"bl":"^6.0.11"},"files":["fd-slicer.js","index.js"],"_lastModified":"2025-11-20T08:10:25.158Z"}

package/dist/server/dumper.d.ts

@@ -1,9 +1,11 @@
 import { DumpRulesGroupType } from '@tego/server';
 import { AppMigrator } from './app-migrator';
+import { ProgressTracker } from './progress-tracker';
 type DumpOptions = {
     groups: Set<DumpRulesGroupType>;
     fileName?: string;
     appName?: string;
+    userId?: number;
 };
 type BackUpStatusOk = {
     name: string;
@@ -15,6 +17,8 @@ type BackUpStatusDoing = {
     name: string;
     inProgress: true;
     status: 'in_progress';
+    progress?: number;
+    currentStep?: string;
 };
 type BackUpStatusError = {
     name: string;
@@ -24,6 +28,8 @@ type BackUpStatusError = {
 export declare class Dumper extends AppMigrator {
     static dumpTasks: Map<string, Promise<any>>;
     direction: "dump";
+    private get progressManager();
+    private _progressManager?;
     sqlContent: {
         [key: string]: {
             sql: string | string[];
@@ -31,7 +37,7 @@ export declare class Dumper extends AppMigrator {
         };
     };
     static getTaskPromise(taskId: string): Promise<any> | undefined;
-    static getFileStatus(filePath: string): Promise<BackUpStatusOk | BackUpStatusDoing | BackUpStatusError>;
+    static getFileStatus(filePath: string, appName?: string): Promise<BackUpStatusOk | BackUpStatusDoing | BackUpStatusError>;
     static generateFileName(): string;
     writeSQLContent(key: string, data: {
         sql: string | string[];
@@ -65,13 +71,13 @@ export declare class Dumper extends AppMigrator {
         filePath: string;
         dirname: string;
     }>;
-    dumpDb(options: DumpOptions): Promise<void>;
+    dumpDb(options: DumpOptions, progressTracker?: ProgressTracker): Promise<void>;
     hasSqlContent(): boolean;
     dumpMeta(additionalMeta?: object): Promise<void>;
     dumpCollection(options: {
         name: string;
     }): Promise<void>;
-    packDumpedDir(fileName: string, appName?: string): Promise<{
+    packDumpedDir(fileName: string, appName?: string, progressTracker?: ProgressTracker): Promise<{
         filePath: string;
         dirname: string;
     }>;

package/dist/server/dumper.js

@@ -42,6 +42,7 @@ var import_dayjs = __toESM(require("dayjs"));
 var import_lodash = __toESM(require("lodash"));
 var import_app_migrator = require("./app-migrator");
 var import_field_value_writer = require("./field-value-writer");
+var import_progress_tracker = require("./progress-tracker");
 var import_utils = require("./utils");
 const finished = import_node_util.default.promisify(import_node_stream.default.finished);
 const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
@@ -50,13 +51,24 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
     this.direction = "dump";
     this.sqlContent = {};
   }
+  get progressManager() {
+    if (!this._progressManager) {
+      this._progressManager = new import_progress_tracker.ProgressManager(
+        (appName) => this.backUpStorageDir(appName),
+        this.workDir,
+        this.app
+      );
+    }
+    return this._progressManager;
+  }
   static getTaskPromise(taskId) {
     return this.dumpTasks.get(taskId);
   }
-  static async getFileStatus(filePath) {
+  static async getFileStatus(filePath, appName) {
     const lockFile = filePath + ".lock";
+    const progressFile = filePath + ".progress";
     const fileName = import_node_path.default.basename(filePath);
-    return import_node_fs.default.promises.stat(lockFile).then((lockFileStat) => {
+    return import_node_fs.default.promises.stat(lockFile).then(async (lockFileStat) => {
       if (lockFileStat.isFile()) {
         if (lockFileStat.ctime.getTime() < Date.now() - 2 * 60 * 60 * 1e3) {
           return {
@@ -65,10 +77,18 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
             status: "error"
           };
         } else {
+          let progress = null;
+          try {
+            const progressContent = await import_promises.default.readFile(progressFile, "utf8");
+            progress = JSON.parse(progressContent);
+          } catch (error) {
+          }
           return {
             name: fileName,
             inProgress: true,
-            status: "in_progress"
+            status: "in_progress",
+            progress: progress == null ? void 0 : progress.percent,
+            currentStep: progress == null ? void 0 : progress.currentStep
           };
         }
       } else {
@@ -193,6 +213,7 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
   async cleanLockFile(fileName, appName) {
     const filePath = this.lockFilePath(fileName, appName);
     await import_promises.default.unlink(filePath);
+    await this.progressManager.cleanProgressFile(fileName, appName);
   }
   async getLockFile(appName) {
     const backupFileName = _Dumper.generateFileName();
@@ -203,7 +224,8 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
     await this.dump({
       groups: options.groups,
       fileName: options.fileName,
-      appName: options.appName
+      appName: options.appName,
+      userId: options.userId
     });
   }
   async dumpableCollectionsGroupByGroup() {
@@ -212,9 +234,14 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
   async dump(options) {
     const dumpingGroups = options.groups;
     dumpingGroups.add("required");
+    const backupFileName = options.fileName || _Dumper.generateFileName();
+    const progressTracker = this.progressManager.createProgressTracker(backupFileName, options.appName, options.userId);
+    await progressTracker.update(0, "Preparing...");
     const delayCollections = /* @__PURE__ */ new Set();
     const dumpedCollections = await this.getCollectionsByDataTypes(dumpingGroups);
-    for (const collectionName of dumpedCollections) {
+    const totalCollections = dumpedCollections.length;
+    for (let i = 0; i < dumpedCollections.length; i++) {
+      const collectionName = dumpedCollections[i];
       const collection = this.app.db.getCollection(collectionName);
       if (import_lodash.default.get(collection.options, "dumpRules.delayRestore")) {
         delayCollections.add(collectionName);
@@ -222,26 +249,44 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
       await this.dumpCollection({
         name: collectionName
       });
+      const progress = progressTracker.getCollectionProgress(i, totalCollections);
+      await progressTracker.update(progress, `Dumping collection: ${collectionName} (${i + 1}/${totalCollections})`);
     }
+    await progressTracker.update(70, "Dumping metadata...");
     await this.dumpMeta({
       dumpableCollectionsGroupByGroup: import_lodash.default.pick(await this.dumpableCollectionsGroupByGroup(), [...dumpingGroups]),
       dumpedGroups: [...dumpingGroups],
       delayCollections: [...delayCollections]
     });
-    await this.dumpDb(options);
-    const backupFileName = options.fileName || _Dumper.generateFileName();
-    const filePath = await this.packDumpedDir(backupFileName, options.appName);
+    await progressTracker.update(75, "Dumping metadata...");
+    await progressTracker.update(80, "Dumping database content...");
+    await this.dumpDb(options, progressTracker);
+    await progressTracker.update(90, "Packing backup file...");
+    const filePath = await this.packDumpedDir(backupFileName, options.appName, progressTracker);
     await this.clearWorkDir();
+    await progressTracker.update(100, "Completed");
+    await this.progressManager.cleanProgressFile(backupFileName, options.appName);
     return filePath;
   }
-  async dumpDb(options) {
+  async dumpDb(options, progressTracker) {
     var _a;
-    for (const collection of this.app.db.collections.values()) {
+    const collections = Array.from(this.app.db.collections.values());
+    const totalCollections = collections.length;
+    let processedCollections = 0;
+    for (const collection of collections) {
       const collectionOnDumpOption = (_a = this.app.db.collectionFactory.collectionTypes.get(
         collection.constructor
       )) == null ? void 0 : _a.onDump;
       if (collectionOnDumpOption) {
         await collectionOnDumpOption(this, collection);
+        processedCollections++;
+        if (progressTracker && totalCollections > 0) {
+          const progress = progressTracker.getDbContentProgress(processedCollections, totalCollections);
+          await progressTracker.update(
+            progress,
+            `Dumping database content... (${processedCollections}/${totalCollections})`
+          );
+        }
       }
     }
     if (this.hasSqlContent()) {
@@ -257,6 +302,9 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
         "utf8"
       );
     }
+    if (progressTracker) {
+      await progressTracker.update(88, "Dumping database content...");
+    }
   }
   hasSqlContent() {
     return Object.keys(this.sqlContent).length > 0;
@@ -375,7 +423,7 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
     }
     await import_promises.default.writeFile(import_node_path.default.resolve(collectionDataDir, "meta"), JSON.stringify(meta), "utf8");
   }
-  async packDumpedDir(fileName, appName) {
+  async packDumpedDir(fileName, appName, progressTracker) {
     const dirname = this.backUpStorageDir(appName);
     await import_promises.default.mkdir(dirname, { recursive: true });
     const filePath = import_node_path.default.resolve(dirname, fileName);
@@ -383,13 +431,22 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
     const archive = (0, import_archiver.default)("zip", {
       zlib: { level: 9 }
     });
+    let cleanupProgress = null;
+    if (progressTracker) {
+      cleanupProgress = this.progressManager.setupPackingProgress(archive, progressTracker);
+    }
+    const app = this.app;
     const onClose = new Promise((resolve, reject) => {
-      output.on("close", function() {
-        console.log("dumped file size: " + (0, import_utils.humanFileSize)(archive.pointer(), true));
+      output.on("close", () => {
+        if (app == null ? void 0 : app.logger) {
+          app.logger.info(`Backup file created: ${(0, import_utils.humanFileSize)(archive.pointer(), true)}`);
+        }
+        if (cleanupProgress) {
+          cleanupProgress();
+        }
         resolve(true);
       });
-      output.on("end", function() {
-        console.log("Data has been drained");
+      output.on("end", () => {
       });
       archive.on("warning", function(err) {
         if (err.code === "ENOENT") {
@@ -398,6 +455,9 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
         }
       });
       archive.on("error", function(err) {
+        if (cleanupProgress) {
+          cleanupProgress();
+        }
         reject(err);
       });
     });
@@ -405,6 +465,9 @@ const _Dumper = class _Dumper extends import_app_migrator.AppMigrator {
     archive.directory(this.workDir, false);
     await archive.finalize();
     await onClose;
+    if (progressTracker) {
+      await progressTracker.update(99, "Packing backup file...");
+    }
     return {
       filePath,
       dirname

package/dist/server/progress-tracker.d.ts

@@ -0,0 +1,76 @@
+import { Application } from '@tego/server';
+import archiver from 'archiver';
+/**
+ * 进度信息类型
+ */
+export type ProgressInfo = {
+    percent: number;
+    currentStep: string;
+};
+/**
+ * 进度跟踪器接口
+ */
+export interface ProgressTracker {
+    /**
+     * 更新进度
+     */
+    update(percent: number, currentStep: string): Promise<void>;
+    /**
+     * 计算集合备份阶段的进度 (5-70%)
+     */
+    getCollectionProgress(currentIndex: number, totalCollections: number): number;
+    /**
+     * 计算数据库内容备份阶段的进度 (80-88%)
+     */
+    getDbContentProgress(processedCollections: number, totalCollections: number): number;
+}
+/**
+ * 进度管理器类，负责管理备份过程中的进度文件
+ */
+export declare class ProgressManager {
+    private backupStorageDir;
+    private workDir;
+    private app?;
+    private static wsUnavailableWarned;
+    constructor(backupStorageDir: (appName?: string) => string, workDir: string, app?: Application);
+    /**
+     * 获取进度文件路径（静态方法，用于不需要实例的场景）
+     */
+    static getProgressFilePath(filePath: string): string;
+    /**
+     * 获取进度文件路径
+     */
+    private progressFilePath;
+    /**
+     * 通过 WebSocket 推送进度更新
+     * @param fileName 备份文件名
+     * @param progress 进度信息
+     * @param userId 用户ID（可选，如果未提供则不会推送，适用于自动备份场景）
+     * @param appName 应用名称
+     */
+    private pushProgressViaWebSocket;
+    /**
+     * 写入进度信息
+     */
+    writeProgress(fileName: string, progress: ProgressInfo, appName?: string, userId?: number): Promise<void>;
+    /**
+     * 读取进度信息
+     */
+    readProgress(fileName: string, appName?: string): Promise<ProgressInfo | null>;
+    /**
+     * 清理进度文件
+     */
+    cleanProgressFile(fileName: string, appName: string): Promise<void>;
+    /**
+     * 创建进度跟踪器
+     */
+    createProgressTracker(backupFileName: string, appName?: string, userId?: number): ProgressTracker;
+    /**
+     * 统计目录中的文件总数
+     */
+    private countFiles;
+    /**
+     * 设置打包阶段的进度更新
+     */
+    setupPackingProgress(archive: archiver.Archiver, progressTracker: ProgressTracker): () => void;
+}

package/dist/server/progress-tracker.js

@@ -0,0 +1,286 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var progress_tracker_exports = {};
+__export(progress_tracker_exports, {
+  ProgressManager: () => ProgressManager
+});
+module.exports = __toCommonJS(progress_tracker_exports);
+var import_promises = __toESM(require("node:fs/promises"));
+var import_node_path = __toESM(require("node:path"));
+var import_server = require("@tego/server");
+const _ProgressManager = class _ProgressManager {
+  constructor(backupStorageDir, workDir, app) {
+    this.backupStorageDir = backupStorageDir;
+    this.workDir = workDir;
+    this.app = app;
+  }
+  /**
+   * 获取进度文件路径（静态方法，用于不需要实例的场景）
+   */
+  static getProgressFilePath(filePath) {
+    return filePath + ".progress";
+  }
+  /**
+   * 获取进度文件路径
+   */
+  progressFilePath(fileName, appName) {
+    const progressFile = fileName + ".progress";
+    const dirname = this.backupStorageDir(appName);
+    return import_node_path.default.resolve(dirname, progressFile);
+  }
+  /**
+   * 通过 WebSocket 推送进度更新
+   * @param fileName 备份文件名
+   * @param progress 进度信息
+   * @param userId 用户ID（可选，如果未提供则不会推送，适用于自动备份场景）
+   * @param appName 应用名称
+   */
+  pushProgressViaWebSocket(fileName, progress, userId, appName) {
+    var _a, _b, _c, _d, _e;
+    if (!this.app) {
+      return;
+    }
+    if (!userId || userId <= 0) {
+      if ((_a = this.app) == null ? void 0 : _a.logger) {
+        this.app.logger.debug(`[ProgressManager] Skipping WebSocket push for ${fileName}: no userId`);
+      }
+      return;
+    }
+    try {
+      const gateway = import_server.Gateway.getInstance();
+      const ws = gateway["wsServer"];
+      if (!ws) {
+        if (!_ProgressManager.wsUnavailableWarned) {
+          _ProgressManager.wsUnavailableWarned = true;
+          if ((_b = this.app) == null ? void 0 : _b.logger) {
+            this.app.logger.warn(
+              "[ProgressManager] WebSocket server not available (this is normal in worker threads, progress will be saved to file only)"
+            );
+          }
+        }
+        return;
+      }
+      const finalAppName = appName || this.app.name;
+      const tagPrefix = `app:${finalAppName}`;
+      const tagValue = `${userId}`;
+      const expectedTag = `${tagPrefix}#${tagValue}`;
+      if ((_c = this.app) == null ? void 0 : _c.logger) {
+        const matchingConnections = Array.from(ws.webSocketClients.values()).filter((client) => {
+          var _a2, _b2;
+          return (_b2 = (_a2 = client.tags) == null ? void 0 : _a2.has) == null ? void 0 : _b2.call(_a2, expectedTag);
+        });
+        this.app.logger.debug(
+          `[ProgressManager] Sending backup progress via WebSocket: fileName=${fileName}, userId=${userId}, appName=${finalAppName}, tag=${expectedTag}, progress=${progress.percent}%, matchingConnections=${matchingConnections.length}`
+        );
+        if (matchingConnections.length === 0) {
+          const allTags = Array.from(ws.webSocketClients.values()).flatMap((client) => Array.from(client.tags || [])).filter((tag) => typeof tag === "string" && tag.startsWith("app:"));
+          this.app.logger.warn(
+            `[ProgressManager] No matching connections found for tag ${expectedTag}. Available tags: ${allTags.join(", ")}`
+          );
+        }
+      }
+      try {
+        ws.sendToConnectionsByTag(tagPrefix, tagValue, {
+          type: "backup:progress",
+          payload: {
+            fileName,
+            progress
+          }
+        });
+      } catch (sendError) {
+        if ((_d = this.app) == null ? void 0 : _d.logger) {
+          this.app.logger.error(
+            `[ProgressManager] Failed to send WebSocket message: tagPrefix=${tagPrefix}, tagValue=${tagValue}, error=`,
+            sendError
+          );
+        }
+        throw sendError;
+      }
+    } catch (error) {
+      if ((_e = this.app) == null ? void 0 : _e.logger) {
+        this.app.logger.warn(`[ProgressManager] WebSocket push error for ${fileName} (userId=${userId}):`, error);
+      } else {
+        console.error(`[ProgressManager] WebSocket push error for ${fileName} (userId=${userId}):`, error);
+      }
+    }
+  }
+  /**
+   * 写入进度信息
+   */
+  async writeProgress(fileName, progress, appName, userId) {
+    const filePath = this.progressFilePath(fileName, appName);
+    await import_promises.default.writeFile(filePath, JSON.stringify(progress), "utf8");
+    this.pushProgressViaWebSocket(fileName, progress, userId, appName);
+  }
+  /**
+   * 读取进度信息
+   */
+  async readProgress(fileName, appName) {
+    const filePath = this.progressFilePath(fileName, appName);
+    try {
+      const content = await import_promises.default.readFile(filePath, "utf8");
+      return JSON.parse(content);
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        return null;
+      }
+      throw error;
+    }
+  }
+  /**
+   * 清理进度文件
+   */
+  async cleanProgressFile(fileName, appName) {
+    const filePath = this.progressFilePath(fileName, appName);
+    try {
+      await import_promises.default.unlink(filePath);
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    }
+  }
+  /**
+   * 创建进度跟踪器
+   */
+  createProgressTracker(backupFileName, appName, userId) {
+    return {
+      /**
+       * 更新进度
+       */
+      update: async (percent, currentStep) => {
+        await this.writeProgress(backupFileName, { percent, currentStep }, appName, userId);
+      },
+      /**
+       * 计算集合备份阶段的进度 (5-70%)
+       */
+      getCollectionProgress: (currentIndex, totalCollections) => {
+        return 5 + Math.floor((currentIndex + 1) / totalCollections * 65);
+      },
+      /**
+       * 计算数据库内容备份阶段的进度 (80-88%)
+       */
+      getDbContentProgress: (processedCollections, totalCollections) => {
+        if (totalCollections === 0) return 80;
+        return 80 + Math.floor(processedCollections / totalCollections * 8);
+      }
+    };
+  }
+  /**
+   * 统计目录中的文件总数
+   */
+  async countFiles(dir) {
+    let count = 0;
+    try {
+      const entries = await import_promises.default.readdir(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = import_node_path.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          count += await this.countFiles(fullPath);
+        } else {
+          count++;
+        }
+      }
+    } catch (error) {
+    }
+    return count;
+  }
+  /**
+   * 设置打包阶段的进度更新
+   */
+  setupPackingProgress(archive, progressTracker) {
+    let processedEntries = 0;
+    let totalEntries = 0;
+    let startTime = Date.now();
+    let progressInterval = null;
+    let currentProgress = 90;
+    let isFinished = false;
+    this.countFiles(this.workDir).then((count) => {
+      totalEntries = count || 1;
+    }).catch(() => {
+      totalEntries = 1;
+    });
+    archive.on("entry", () => {
+      processedEntries++;
+    });
+    const handleFinish = async () => {
+      var _a;
+      if (isFinished) {
+        return;
+      }
+      isFinished = true;
+      if (progressInterval) {
+        clearInterval(progressInterval);
+        progressInterval = null;
+      }
+      try {
+        await progressTracker.update(99, "Packing backup file...");
+      } catch (error) {
+        if ((_a = this.app) == null ? void 0 : _a.logger) {
+          this.app.logger.warn("[ProgressManager] Failed to update progress after packing:", error);
+        }
+      }
+    };
+    archive.on("end", handleFinish);
+    archive.on("finish", handleFinish);
+    progressInterval = setInterval(async () => {
+      if (isFinished) {
+        if (progressInterval) {
+          clearInterval(progressInterval);
+          progressInterval = null;
+        }
+        return;
+      }
+      const elapsed = Date.now() - startTime;
+      if (processedEntries > 0 && totalEntries > 0) {
+        const fileBasedProgress = 90 + Math.floor(processedEntries / totalEntries * 9);
+        const timeBasedProgress = Math.min(90 + Math.floor(elapsed / 6e4 * 9), 99);
+        currentProgress = Math.max(currentProgress, Math.min(fileBasedProgress, timeBasedProgress, 99));
+      } else {
+        currentProgress = Math.min(90 + Math.floor(elapsed / 6e4 * 9), 99);
+      }
+      if (currentProgress < 99) {
+        await progressTracker.update(currentProgress, "Packing backup file...");
+      }
+    }, 300);
+    return () => {
+      isFinished = true;
+      if (progressInterval) {
+        clearInterval(progressInterval);
+        progressInterval = null;
+      }
+    };
+  }
+};
+// 静态标志，用于避免重复警告 WebSocket 不可用（在 worker 线程中很常见）
+_ProgressManager.wsUnavailableWarned = false;
+let ProgressManager = _ProgressManager;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ProgressManager
+});