@vlian/framework 1.0.0

package/dist/core/router/validation/schema.js

@@ -0,0 +1,81 @@
+/**
+ * 路由配置验证 Schema（使用 Zod）
+ */ import { z } from "zod";
+/**
+ * RouteItemHandle Schema
+ */ export const routeItemHandleSchema = z.object({
+    title: z.string().min(1, '路由标题不能为空'),
+    i18nKey: z.string().optional(),
+    order: z.number().int('排序值必须是整数'),
+    icon: z.string().optional(),
+    hideInMenu: z.boolean().optional(),
+    hideFooter: z.boolean().optional(),
+    keepAlive: z.boolean().optional(),
+    needLogin: z.boolean().optional(),
+    roles: z.array(z.string()).optional(),
+    name: z.string().optional()
+}).passthrough(); // 允许其他自定义字段
+/**
+ * ComponentImport Schema
+ * 可以是字符串路径或函数
+ */ export const componentImportSchema = z.union([
+    z.string().min(1, '组件路径不能为空'),
+    z.function(),
+    z.null()
+]);
+/**
+ * RouteConfig Schema
+ */ export const routeConfigSchema = z.lazy(()=>z.object({
+        layout: componentImportSchema.optional().nullable(),
+        page: componentImportSchema.optional().nullable(),
+        loading: componentImportSchema.optional().nullable(),
+        errors: componentImportSchema.optional().nullable(),
+        name: z.string().min(1, '路由名称不能为空'),
+        path: z.string().optional(),
+        isGroup: z.boolean().optional(),
+        enableRedirection: z.boolean().optional(),
+        handle: routeItemHandleSchema,
+        children: z.array(routeConfigSchema).optional()
+    }));
+/**
+ * RouterConfig Schema
+ */ export const routerConfigSchema = z.object({
+    enabled: z.union([
+        z.boolean(),
+        z.literal('disabled')
+    ]).optional(),
+    routes: z.union([
+        z.array(routeConfigSchema),
+        z.function()
+    ]).optional(),
+    mode: z.enum([
+        'browser',
+        'hash',
+        'memory'
+    ]).optional(),
+    options: z.any().optional(),
+    pathResolve: z.object({
+        basePath: z.string().optional(),
+        pathAliases: z.record(z.string(), z.string()).optional()
+    }).optional(),
+    transformOptions: z.any().optional()
+});
+/**
+ * 验证路由配置
+ * 
+ * @param config - 要验证的路由配置
+ * @returns 验证后的路由配置
+ * @throws z.ZodError 如果配置验证失败
+ */ export function validateRouterConfig(config) {
+    return routerConfigSchema.parse(config);
+}
+/**
+ * 安全验证路由配置（不抛出异常）
+ * 
+ * @param config - 要验证的路由配置
+ * @returns 验证结果
+ */ export function safeValidateRouterConfig(config) {
+    return routerConfigSchema.safeParse(config);
+}
+
+//# sourceMappingURL=schema.js.map

package/dist/core/router/validation/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/router/validation/schema.ts"],"sourcesContent":["/**\n * 路由配置验证 Schema（使用 Zod）\n */\n\nimport { z } from 'zod';\n\n/**\n * RouteItemHandle Schema\n */\nexport const routeItemHandleSchema = z.object({\n  title: z.string().min(1, '路由标题不能为空'),\n  i18nKey: z.string().optional(),\n  order: z.number().int('排序值必须是整数'),\n  icon: z.string().optional(),\n  hideInMenu: z.boolean().optional(),\n  hideFooter: z.boolean().optional(),\n  keepAlive: z.boolean().optional(),\n  needLogin: z.boolean().optional(),\n  roles: z.array(z.string()).optional(),\n  name: z.string().optional(),\n}).passthrough(); // 允许其他自定义字段\n\n/**\n * ComponentImport Schema\n * 可以是字符串路径或函数\n */\nexport const componentImportSchema = z.union([\n  z.string().min(1, '组件路径不能为空'),\n  z.function(),\n  z.null(),\n]);\n\n/**\n * RouteConfig Schema\n */\nexport const routeConfigSchema: z.ZodType<any> = z.lazy(() =>\n  z.object({\n    layout: componentImportSchema.optional().nullable(),\n    page: componentImportSchema.optional().nullable(),\n    loading: componentImportSchema.optional().nullable(),\n    errors: componentImportSchema.optional().nullable(),\n    name: z.string().min(1, '路由名称不能为空'),\n    path: z.string().optional(),\n    isGroup: z.boolean().optional(),\n    enableRedirection: z.boolean().optional(),\n    handle: routeItemHandleSchema,\n    children: z.array(routeConfigSchema).optional(),\n  })\n);\n\n/**\n * RouterConfig Schema\n */\nexport const routerConfigSchema = z.object({\n  enabled: z.union([z.boolean(), z.literal('disabled')]).optional(),\n  routes: z\n    .union([\n      z.array(routeConfigSchema),\n      z.function(),\n    ])\n    .optional(),\n  mode: z.enum(['browser', 'hash', 'memory']).optional(),\n  options: z.any().optional(), // react-router-dom 的选项类型较复杂，使用 any\n  pathResolve: z\n    .object({\n      basePath: z.string().optional(),\n      pathAliases: z.record(z.string(), z.string()).optional(),\n    })\n    .optional(),\n  transformOptions: z.any().optional(), // TransformOptions 类型较复杂，使用 any\n});\n\n/**\n * 验证路由配置\n * \n * @param config - 要验证的路由配置\n * @returns 验证后的路由配置\n * @throws z.ZodError 如果配置验证失败\n */\nexport function validateRouterConfig(config: unknown) {\n  return routerConfigSchema.parse(config);\n}\n\n/**\n * 安全验证路由配置（不抛出异常）\n * \n * @param config - 要验证的路由配置\n * @returns 验证结果\n */\nexport function safeValidateRouterConfig(config: unknown) {\n  return routerConfigSchema.safeParse(config);\n}\n"],"names":["z","routeItemHandleSchema","object","title","string","min","i18nKey","optional","order","number","int","icon","hideInMenu","boolean","hideFooter","keepAlive","needLogin","roles","array","name","passthrough","componentImportSchema","union","function","null","routeConfigSchema","lazy","layout","nullable","page","loading","errors","path","isGroup","enableRedirection","handle","children","routerConfigSchema","enabled","literal","routes","mode","enum","options","any","pathResolve","basePath","pathAliases","record","transformOptions","validateRouterConfig","config","parse","safeValidateRouterConfig","safeParse"],"mappings":"AAAA;;CAEC,GAED,SAASA,CAAC,QAAQ,MAAM;AAExB;;CAEC,GACD,OAAO,MAAMC,wBAAwBD,EAAEE,MAAM,CAAC;IAC5CC,OAAOH,EAAEI,MAAM,GAAGC,GAAG,CAAC,GAAG;IACzBC,SAASN,EAAEI,MAAM,GAAGG,QAAQ;IAC5BC,OAAOR,EAAES,MAAM,GAAGC,GAAG,CAAC;IACtBC,MAAMX,EAAEI,MAAM,GAAGG,QAAQ;IACzBK,YAAYZ,EAAEa,OAAO,GAAGN,QAAQ;IAChCO,YAAYd,EAAEa,OAAO,GAAGN,QAAQ;IAChCQ,WAAWf,EAAEa,OAAO,GAAGN,QAAQ;IAC/BS,WAAWhB,EAAEa,OAAO,GAAGN,QAAQ;IAC/BU,OAAOjB,EAAEkB,KAAK,CAAClB,EAAEI,MAAM,IAAIG,QAAQ;IACnCY,MAAMnB,EAAEI,MAAM,GAAGG,QAAQ;AAC3B,GAAGa,WAAW,GAAG,CAAC,YAAY;AAE9B;;;CAGC,GACD,OAAO,MAAMC,wBAAwBrB,EAAEsB,KAAK,CAAC;IAC3CtB,EAAEI,MAAM,GAAGC,GAAG,CAAC,GAAG;IAClBL,EAAEuB,QAAQ;IACVvB,EAAEwB,IAAI;CACP,EAAE;AAEH;;CAEC,GACD,OAAO,MAAMC,oBAAoCzB,EAAE0B,IAAI,CAAC,IACtD1B,EAAEE,MAAM,CAAC;QACPyB,QAAQN,sBAAsBd,QAAQ,GAAGqB,QAAQ;QACjDC,MAAMR,sBAAsBd,QAAQ,GAAGqB,QAAQ;QAC/CE,SAAST,sBAAsBd,QAAQ,GAAGqB,QAAQ;QAClDG,QAAQV,sBAAsBd,QAAQ,GAAGqB,QAAQ;QACjDT,MAAMnB,EAAEI,MAAM,GAAGC,GAAG,CAAC,GAAG;QACxB2B,MAAMhC,EAAEI,MAAM,GAAGG,QAAQ;QACzB0B,SAASjC,EAAEa,OAAO,GAAGN,QAAQ;QAC7B2B,mBAAmBlC,EAAEa,OAAO,GAAGN,QAAQ;QACvC4B,QAAQlC;QACRmC,UAAUpC,EAAEkB,KAAK,CAACO,mBAAmBlB,QAAQ;IAC/C,IACA;AAEF;;CAEC,GACD,OAAO,MAAM8B,qBAAqBrC,EAAEE,MAAM,CAAC;IACzCoC,SAAStC,EAAEsB,KAAK,CAAC;QAACtB,EAAEa,OAAO;QAAIb,EAAEuC,OAAO,CAAC;KAAY,EAAEhC,QAAQ;IAC/DiC,QAAQxC,EACLsB,KAAK,CAAC;QACLtB,EAAEkB,KAAK,CAACO;QACRzB,EAAEuB,QAAQ;KACX,EACAhB,QAAQ;IACXkC,MAAMzC,EAAE0C,IAAI,CAAC;QAAC;QAAW;QAAQ;KAAS,EAAEnC,QAAQ;IACpDoC,SAAS3C,EAAE4C,GAAG,GAAGrC,QAAQ;IACzBsC,aAAa7C,EACVE,MAAM,CAAC;QACN4C,UAAU9C,EAAEI,MAAM,GAAGG,QAAQ;QAC7BwC,aAAa/C,EAAEgD,MAAM,CAAChD,EAAEI,MAAM,IAAIJ,EAAEI,MAAM,IAAIG,QAAQ;IACxD,GACCA,QAAQ;IACX0C,kBAAkBjD,EAAE4C,GAAG,GAAGrC,QAAQ;AACpC,GAAG;AAEH;;;;;;CAMC,GACD,OAAO,SAAS2C,qBAAqBC,MAAe;IAClD,OAAOd,mBAAmBe,KAAK,CAACD;AAClC;AAEA;;;;;CAKC,GACD,OAAO,SAASE,yBAAyBF,MAAe;IACtD,OAAOd,mBAAmBiB,SAAS,CAACH;AACtC"}

package/dist/core/router/version/RouteVersionManager.cjs

@@ -0,0 +1,207 @@
+/**
+ * 路由版本管理器
+ * 支持路由版本控制和迁移
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get RouteVersionManager () {
+        return RouteVersionManager;
+    },
+    get getRouteVersionManager () {
+        return getRouteVersionManager;
+    }
+});
+const _utils = require("../../../utils");
+const _errors = require("../errors");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+let RouteVersionManager = class RouteVersionManager {
+    /**
+   * 注册路由版本
+   * 
+   * @param version - 版本信息
+   */ registerVersion(version) {
+        // 验证版本号格式（简单的语义化版本检查）
+        if (!/^\d+\.\d+\.\d+/.test(version.version)) {
+            throw new Error(`无效的版本号格式: ${version.version}`);
+        }
+        this.versions.set(version.version, {
+            ...version,
+            createdAt: version.createdAt || Date.now()
+        });
+        _utils.logger.debug(`路由版本已注册: ${version.version}`);
+    }
+    /**
+   * 注册版本迁移函数
+   * 
+   * @param fromVersion - 源版本
+   * @param toVersion - 目标版本
+   * @param migration - 迁移函数
+   */ registerMigration(fromVersion, toVersion, migration) {
+        const key = `${fromVersion}->${toVersion}`;
+        this.migrations.set(key, migration);
+        _utils.logger.debug(`路由版本迁移已注册: ${key}`);
+    }
+    /**
+   * 检查版本兼容性
+   * 
+   * @param version - 要检查的版本
+   * @returns 是否兼容
+   */ checkCompatibility(version) {
+        const versionInfo = this.versions.get(version);
+        if (!versionInfo) {
+            return false;
+        }
+        // 如果明确标记为不兼容，返回 false
+        if (versionInfo.compatible === false) {
+            return false;
+        }
+        // 简单的版本兼容性检查（主版本号相同）
+        const currentMajor = parseInt(this.config.currentVersion.split('.')[0]);
+        const targetMajor = parseInt(version.split('.')[0]);
+        return currentMajor === targetMajor;
+    }
+    /**
+   * 迁移路由配置
+   * 
+   * @param fromVersion - 源版本
+   * @param toVersion - 目标版本
+   * @param routes - 路由配置
+   * @returns 迁移后的路由配置
+   */ async migrate(fromVersion, toVersion, routes) {
+        if (fromVersion === toVersion) {
+            return routes;
+        }
+        const migrationKey = `${fromVersion}->${toVersion}`;
+        const migration = this.migrations.get(migrationKey);
+        if (!migration) {
+            // 如果没有直接迁移，尝试逐步迁移
+            return this.migrateStepwise(fromVersion, toVersion, routes);
+        }
+        try {
+            const migratedRoutes = await migration(fromVersion, toVersion, routes);
+            _utils.logger.info(`路由版本迁移完成: ${fromVersion} -> ${toVersion}`);
+            return migratedRoutes;
+        } catch (error) {
+            _utils.logger.error(`路由版本迁移失败: ${fromVersion} -> ${toVersion}`, error);
+            const errorContext = {
+                fromVersion,
+                toVersion
+            };
+            if (error instanceof Error) {
+                errorContext.originalError = error;
+            }
+            throw new _errors.RouterError(`路由版本迁移失败: ${fromVersion} -> ${toVersion}`, _errors.RouterErrorCode.ROUTE_TRANSFORM_FAILED, undefined, error instanceof Error ? error : undefined, errorContext);
+        }
+    }
+    /**
+   * 逐步迁移（通过中间版本）
+   */ async migrateStepwise(fromVersion, toVersion, routes) {
+        // 获取所有版本并按版本号排序
+        const allVersions = Array.from(this.versions.keys()).sort((a, b)=>{
+            const aParts = a.split('.').map(Number);
+            const bParts = b.split('.').map(Number);
+            for(let i = 0; i < 3; i++){
+                if (aParts[i] !== bParts[i]) {
+                    return aParts[i] - bParts[i];
+                }
+            }
+            return 0;
+        });
+        // 找到从 fromVersion 到 toVersion 的路径
+        const fromIndex = allVersions.indexOf(fromVersion);
+        const toIndex = allVersions.indexOf(toVersion);
+        if (fromIndex === -1 || toIndex === -1) {
+            throw new Error(`无法找到版本迁移路径: ${fromVersion} -> ${toVersion}`);
+        }
+        let currentRoutes = routes;
+        const step = fromIndex < toIndex ? 1 : -1;
+        for(let i = fromIndex; i !== toIndex; i += step){
+            const currentVersion = allVersions[i];
+            const nextVersion = allVersions[i + step];
+            const migrationKey = `${currentVersion}->${nextVersion}`;
+            const migration = this.migrations.get(migrationKey);
+            if (migration) {
+                currentRoutes = await migration(currentVersion, nextVersion, currentRoutes);
+            } else {
+                // 如果没有迁移函数，直接使用当前路由（可能不兼容）
+                _utils.logger.warn(`缺少迁移函数: ${migrationKey}，跳过迁移`);
+            }
+        }
+        return currentRoutes;
+    }
+    /**
+   * 获取版本信息
+   * 
+   * @param version - 版本号
+   * @returns 版本信息，如果不存在返回 undefined
+   */ getVersion(version) {
+        return this.versions.get(version);
+    }
+    /**
+   * 获取所有版本
+   * 
+   * @returns 版本信息数组
+   */ getAllVersions() {
+        return Array.from(this.versions.values());
+    }
+    /**
+   * 获取当前版本
+   * 
+   * @returns 当前版本信息
+   */ getCurrentVersion() {
+        return this.versions.get(this.config.currentVersion);
+    }
+    /**
+   * 回滚到指定版本
+   * 
+   * @param version - 目标版本
+   * @param routes - 当前路由配置
+   * @returns 回滚后的路由配置
+   */ async rollback(version, routes) {
+        return this.migrate(this.config.currentVersion, version, routes);
+    }
+    constructor(config){
+        _define_property(this, "versions", new Map());
+        _define_property(this, "migrations", new Map());
+        _define_property(this, "config", void 0);
+        this.config = {
+            enableVersionCheck: config.enableVersionCheck ?? true,
+            enableAutoMigration: config.enableAutoMigration ?? false,
+            currentVersion: config.currentVersion
+        };
+    }
+};
+/**
+ * 获取路由版本管理器单例
+ */ let versionManagerInstance = null;
+function getRouteVersionManager(config) {
+    if (!versionManagerInstance && config) {
+        versionManagerInstance = new RouteVersionManager(config);
+    }
+    if (!versionManagerInstance) {
+        throw new Error('路由版本管理器未初始化，请先提供配置');
+    }
+    return versionManagerInstance;
+}
+
+//# sourceMappingURL=RouteVersionManager.js.map

package/dist/core/router/version/RouteVersionManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/router/version/RouteVersionManager.ts"],"sourcesContent":["/**\n * 路由版本管理器\n * 支持路由版本控制和迁移\n */\n\nimport { logger } from '../../../utils';\nimport type { RouteConfig } from '../types';\nimport { RouterError, RouterErrorCode } from '../errors';\n\n/**\n * 路由版本信息\n */\nexport interface RouteVersion {\n  /**\n   * 版本号（语义化版本，如 \"1.0.0\"）\n   */\n  version: string;\n\n  /**\n   * 路由配置\n   */\n  routes: RouteConfig[];\n\n  /**\n   * 创建时间\n   */\n  createdAt: number;\n\n  /**\n   * 描述\n   */\n  description?: string;\n\n  /**\n   * 是否兼容旧版本\n   */\n  compatible?: boolean;\n}\n\n/**\n * 版本迁移函数\n */\nexport type VersionMigration = (\n  fromVersion: string,\n  toVersion: string,\n  routes: RouteConfig[]\n) => RouteConfig[] | Promise<RouteConfig[]>;\n\n/**\n * 路由版本管理器配置\n */\nexport interface RouteVersionManagerConfig {\n  /**\n   * 当前版本\n   */\n  currentVersion: string;\n\n  /**\n   * 是否启用版本检查\n   * @default true\n   */\n  enableVersionCheck?: boolean;\n\n  /**\n   * 是否启用自动迁移\n   * @default false\n   */\n  enableAutoMigration?: boolean;\n}\n\n/**\n * 路由版本管理器\n */\nexport class RouteVersionManager {\n  private versions: Map<string, RouteVersion> = new Map();\n  private migrations: Map<string, VersionMigration> = new Map();\n  private config: Required<RouteVersionManagerConfig>;\n\n  constructor(config: RouteVersionManagerConfig) {\n    this.config = {\n      enableVersionCheck: config.enableVersionCheck ?? true,\n      enableAutoMigration: config.enableAutoMigration ?? false,\n      currentVersion: config.currentVersion,\n    };\n  }\n\n  /**\n   * 注册路由版本\n   * \n   * @param version - 版本信息\n   */\n  registerVersion(version: RouteVersion): void {\n    // 验证版本号格式（简单的语义化版本检查）\n    if (!/^\\d+\\.\\d+\\.\\d+/.test(version.version)) {\n      throw new Error(`无效的版本号格式: ${version.version}`);\n    }\n\n    this.versions.set(version.version, {\n      ...version,\n      createdAt: version.createdAt || Date.now(),\n    });\n\n    logger.debug(`路由版本已注册: ${version.version}`);\n  }\n\n  /**\n   * 注册版本迁移函数\n   * \n   * @param fromVersion - 源版本\n   * @param toVersion - 目标版本\n   * @param migration - 迁移函数\n   */\n  registerMigration(\n    fromVersion: string,\n    toVersion: string,\n    migration: VersionMigration\n  ): void {\n    const key = `${fromVersion}->${toVersion}`;\n    this.migrations.set(key, migration);\n    logger.debug(`路由版本迁移已注册: ${key}`);\n  }\n\n  /**\n   * 检查版本兼容性\n   * \n   * @param version - 要检查的版本\n   * @returns 是否兼容\n   */\n  checkCompatibility(version: string): boolean {\n    const versionInfo = this.versions.get(version);\n    if (!versionInfo) {\n      return false;\n    }\n\n    // 如果明确标记为不兼容，返回 false\n    if (versionInfo.compatible === false) {\n      return false;\n    }\n\n    // 简单的版本兼容性检查（主版本号相同）\n    const currentMajor = parseInt(this.config.currentVersion.split('.')[0]);\n    const targetMajor = parseInt(version.split('.')[0]);\n\n    return currentMajor === targetMajor;\n  }\n\n  /**\n   * 迁移路由配置\n   * \n   * @param fromVersion - 源版本\n   * @param toVersion - 目标版本\n   * @param routes - 路由配置\n   * @returns 迁移后的路由配置\n   */\n  async migrate(\n    fromVersion: string,\n    toVersion: string,\n    routes: RouteConfig[]\n  ): Promise<RouteConfig[]> {\n    if (fromVersion === toVersion) {\n      return routes;\n    }\n\n    const migrationKey = `${fromVersion}->${toVersion}`;\n    const migration = this.migrations.get(migrationKey);\n\n    if (!migration) {\n      // 如果没有直接迁移，尝试逐步迁移\n      return this.migrateStepwise(fromVersion, toVersion, routes);\n    }\n\n    try {\n      const migratedRoutes = await migration(fromVersion, toVersion, routes);\n      logger.info(`路由版本迁移完成: ${fromVersion} -> ${toVersion}`);\n      return migratedRoutes;\n    } catch (error) {\n      logger.error(`路由版本迁移失败: ${fromVersion} -> ${toVersion}`, error);\n      const errorContext: Record<string, unknown> = { fromVersion, toVersion };\n      if (error instanceof Error) {\n        errorContext.originalError = error;\n      }\n      throw new RouterError(\n        `路由版本迁移失败: ${fromVersion} -> ${toVersion}`,\n        RouterErrorCode.ROUTE_TRANSFORM_FAILED,\n        undefined,\n        error instanceof Error ? error : undefined,\n        errorContext\n      );\n    }\n  }\n\n  /**\n   * 逐步迁移（通过中间版本）\n   */\n  private async migrateStepwise(\n    fromVersion: string,\n    toVersion: string,\n    routes: RouteConfig[]\n  ): Promise<RouteConfig[]> {\n    // 获取所有版本并按版本号排序\n    const allVersions = Array.from(this.versions.keys()).sort((a, b) => {\n      const aParts = a.split('.').map(Number);\n      const bParts = b.split('.').map(Number);\n      for (let i = 0; i < 3; i++) {\n        if (aParts[i] !== bParts[i]) {\n          return aParts[i] - bParts[i];\n        }\n      }\n      return 0;\n    });\n\n    // 找到从 fromVersion 到 toVersion 的路径\n    const fromIndex = allVersions.indexOf(fromVersion);\n    const toIndex = allVersions.indexOf(toVersion);\n\n    if (fromIndex === -1 || toIndex === -1) {\n      throw new Error(`无法找到版本迁移路径: ${fromVersion} -> ${toVersion}`);\n    }\n\n    let currentRoutes = routes;\n    const step = fromIndex < toIndex ? 1 : -1;\n\n    for (let i = fromIndex; i !== toIndex; i += step) {\n      const currentVersion = allVersions[i];\n      const nextVersion = allVersions[i + step];\n      const migrationKey = `${currentVersion}->${nextVersion}`;\n      const migration = this.migrations.get(migrationKey);\n\n      if (migration) {\n        currentRoutes = await migration(currentVersion, nextVersion, currentRoutes);\n      } else {\n        // 如果没有迁移函数，直接使用当前路由（可能不兼容）\n        logger.warn(`缺少迁移函数: ${migrationKey}，跳过迁移`);\n      }\n    }\n\n    return currentRoutes;\n  }\n\n  /**\n   * 获取版本信息\n   * \n   * @param version - 版本号\n   * @returns 版本信息，如果不存在返回 undefined\n   */\n  getVersion(version: string): RouteVersion | undefined {\n    return this.versions.get(version);\n  }\n\n  /**\n   * 获取所有版本\n   * \n   * @returns 版本信息数组\n   */\n  getAllVersions(): RouteVersion[] {\n    return Array.from(this.versions.values());\n  }\n\n  /**\n   * 获取当前版本\n   * \n   * @returns 当前版本信息\n   */\n  getCurrentVersion(): RouteVersion | undefined {\n    return this.versions.get(this.config.currentVersion);\n  }\n\n  /**\n   * 回滚到指定版本\n   * \n   * @param version - 目标版本\n   * @param routes - 当前路由配置\n   * @returns 回滚后的路由配置\n   */\n  async rollback(version: string, routes: RouteConfig[]): Promise<RouteConfig[]> {\n    return this.migrate(this.config.currentVersion, version, routes);\n  }\n}\n\n/**\n * 获取路由版本管理器单例\n */\nlet versionManagerInstance: RouteVersionManager | null = null;\n\nexport function getRouteVersionManager(\n  config?: RouteVersionManagerConfig\n): RouteVersionManager {\n  if (!versionManagerInstance && config) {\n    versionManagerInstance = new RouteVersionManager(config);\n  }\n  if (!versionManagerInstance) {\n    throw new Error('路由版本管理器未初始化，请先提供配置');\n  }\n  return versionManagerInstance;\n}\n"],"names":["RouteVersionManager","getRouteVersionManager","registerVersion","version","test","Error","versions","set","createdAt","Date","now","logger","debug","registerMigration","fromVersion","toVersion","migration","key","migrations","checkCompatibility","versionInfo","get","compatible","currentMajor","parseInt","config","currentVersion","split","targetMajor","migrate","routes","migrationKey","migrateStepwise","migratedRoutes","info","error","errorContext","originalError","RouterError","RouterErrorCode","ROUTE_TRANSFORM_FAILED","undefined","allVersions","Array","from","keys","sort","a","b","aParts","map","Number","bParts","i","fromIndex","indexOf","toIndex","currentRoutes","step","nextVersion","warn","getVersion","getAllVersions","values","getCurrentVersion","rollback","Map","enableVersionCheck","enableAutoMigration","versionManagerInstance"],"mappings":"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"}

package/dist/core/router/version/RouteVersionManager.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 路由版本管理器
+ * 支持路由版本控制和迁移
+ */
+import type { RouteConfig } from '../types';
+/**
+ * 路由版本信息
+ */
+export interface RouteVersion {
+    /**
+     * 版本号（语义化版本，如 "1.0.0"）
+     */
+    version: string;
+    /**
+     * 路由配置
+     */
+    routes: RouteConfig[];
+    /**
+     * 创建时间
+     */
+    createdAt: number;
+    /**
+     * 描述
+     */
+    description?: string;
+    /**
+     * 是否兼容旧版本
+     */
+    compatible?: boolean;
+}
+/**
+ * 版本迁移函数
+ */
+export type VersionMigration = (fromVersion: string, toVersion: string, routes: RouteConfig[]) => RouteConfig[] | Promise<RouteConfig[]>;
+/**
+ * 路由版本管理器配置
+ */
+export interface RouteVersionManagerConfig {
+    /**
+     * 当前版本
+     */
+    currentVersion: string;
+    /**
+     * 是否启用版本检查
+     * @default true
+     */
+    enableVersionCheck?: boolean;
+    /**
+     * 是否启用自动迁移
+     * @default false
+     */
+    enableAutoMigration?: boolean;
+}
+/**
+ * 路由版本管理器
+ */
+export declare class RouteVersionManager {
+    private versions;
+    private migrations;
+    private config;
+    constructor(config: RouteVersionManagerConfig);
+    /**
+     * 注册路由版本
+     *
+     * @param version - 版本信息
+     */
+    registerVersion(version: RouteVersion): void;
+    /**
+     * 注册版本迁移函数
+     *
+     * @param fromVersion - 源版本
+     * @param toVersion - 目标版本
+     * @param migration - 迁移函数
+     */
+    registerMigration(fromVersion: string, toVersion: string, migration: VersionMigration): void;
+    /**
+     * 检查版本兼容性
+     *
+     * @param version - 要检查的版本
+     * @returns 是否兼容
+     */
+    checkCompatibility(version: string): boolean;
+    /**
+     * 迁移路由配置
+     *
+     * @param fromVersion - 源版本
+     * @param toVersion - 目标版本
+     * @param routes - 路由配置
+     * @returns 迁移后的路由配置
+     */
+    migrate(fromVersion: string, toVersion: string, routes: RouteConfig[]): Promise<RouteConfig[]>;
+    /**
+     * 逐步迁移（通过中间版本）
+     */
+    private migrateStepwise;
+    /**
+     * 获取版本信息
+     *
+     * @param version - 版本号
+     * @returns 版本信息，如果不存在返回 undefined
+     */
+    getVersion(version: string): RouteVersion | undefined;
+    /**
+     * 获取所有版本
+     *
+     * @returns 版本信息数组
+     */
+    getAllVersions(): RouteVersion[];
+    /**
+     * 获取当前版本
+     *
+     * @returns 当前版本信息
+     */
+    getCurrentVersion(): RouteVersion | undefined;
+    /**
+     * 回滚到指定版本
+     *
+     * @param version - 目标版本
+     * @param routes - 当前路由配置
+     * @returns 回滚后的路由配置
+     */
+    rollback(version: string, routes: RouteConfig[]): Promise<RouteConfig[]>;
+}
+export declare function getRouteVersionManager(config?: RouteVersionManagerConfig): RouteVersionManager;
+//# sourceMappingURL=RouteVersionManager.d.ts.map

package/dist/core/router/version/RouteVersionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteVersionManager.d.ts","sourceRoot":"","sources":["../../../../src/core/router/version/RouteVersionManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,KAClB,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,MAAM,CAAsC;gBAExC,MAAM,EAAE,yBAAyB;IAQ7C;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAc5C;;;;;;OAMG;IACH,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,gBAAgB,GAC1B,IAAI;IAMP;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAkB5C;;;;;;;OAOG;IACG,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IAiCzB;;OAEG;YACW,eAAe;IA6C7B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIrD;;;;OAIG;IACH,cAAc,IAAI,YAAY,EAAE;IAIhC;;;;OAIG;IACH,iBAAiB,IAAI,YAAY,GAAG,SAAS;IAI7C;;;;;;OAMG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAG/E;AAOD,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,yBAAyB,GACjC,mBAAmB,CAQrB"}

package/dist/core/router/version/RouteVersionManager.js

@@ -0,0 +1,191 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 路由版本管理器
+ * 支持路由版本控制和迁移
+ */ import { logger } from "../../../utils";
+import { RouterError, RouterErrorCode } from "../errors";
+/**
+ * 路由版本管理器
+ */ export class RouteVersionManager {
+    /**
+   * 注册路由版本
+   * 
+   * @param version - 版本信息
+   */ registerVersion(version) {
+        // 验证版本号格式（简单的语义化版本检查）
+        if (!/^\d+\.\d+\.\d+/.test(version.version)) {
+            throw new Error(`无效的版本号格式: ${version.version}`);
+        }
+        this.versions.set(version.version, {
+            ...version,
+            createdAt: version.createdAt || Date.now()
+        });
+        logger.debug(`路由版本已注册: ${version.version}`);
+    }
+    /**
+   * 注册版本迁移函数
+   * 
+   * @param fromVersion - 源版本
+   * @param toVersion - 目标版本
+   * @param migration - 迁移函数
+   */ registerMigration(fromVersion, toVersion, migration) {
+        const key = `${fromVersion}->${toVersion}`;
+        this.migrations.set(key, migration);
+        logger.debug(`路由版本迁移已注册: ${key}`);
+    }
+    /**
+   * 检查版本兼容性
+   * 
+   * @param version - 要检查的版本
+   * @returns 是否兼容
+   */ checkCompatibility(version) {
+        const versionInfo = this.versions.get(version);
+        if (!versionInfo) {
+            return false;
+        }
+        // 如果明确标记为不兼容，返回 false
+        if (versionInfo.compatible === false) {
+            return false;
+        }
+        // 简单的版本兼容性检查（主版本号相同）
+        const currentMajor = parseInt(this.config.currentVersion.split('.')[0]);
+        const targetMajor = parseInt(version.split('.')[0]);
+        return currentMajor === targetMajor;
+    }
+    /**
+   * 迁移路由配置
+   * 
+   * @param fromVersion - 源版本
+   * @param toVersion - 目标版本
+   * @param routes - 路由配置
+   * @returns 迁移后的路由配置
+   */ async migrate(fromVersion, toVersion, routes) {
+        if (fromVersion === toVersion) {
+            return routes;
+        }
+        const migrationKey = `${fromVersion}->${toVersion}`;
+        const migration = this.migrations.get(migrationKey);
+        if (!migration) {
+            // 如果没有直接迁移，尝试逐步迁移
+            return this.migrateStepwise(fromVersion, toVersion, routes);
+        }
+        try {
+            const migratedRoutes = await migration(fromVersion, toVersion, routes);
+            logger.info(`路由版本迁移完成: ${fromVersion} -> ${toVersion}`);
+            return migratedRoutes;
+        } catch (error) {
+            logger.error(`路由版本迁移失败: ${fromVersion} -> ${toVersion}`, error);
+            const errorContext = {
+                fromVersion,
+                toVersion
+            };
+            if (error instanceof Error) {
+                errorContext.originalError = error;
+            }
+            throw new RouterError(`路由版本迁移失败: ${fromVersion} -> ${toVersion}`, RouterErrorCode.ROUTE_TRANSFORM_FAILED, undefined, error instanceof Error ? error : undefined, errorContext);
+        }
+    }
+    /**
+   * 逐步迁移（通过中间版本）
+   */ async migrateStepwise(fromVersion, toVersion, routes) {
+        // 获取所有版本并按版本号排序
+        const allVersions = Array.from(this.versions.keys()).sort((a, b)=>{
+            const aParts = a.split('.').map(Number);
+            const bParts = b.split('.').map(Number);
+            for(let i = 0; i < 3; i++){
+                if (aParts[i] !== bParts[i]) {
+                    return aParts[i] - bParts[i];
+                }
+            }
+            return 0;
+        });
+        // 找到从 fromVersion 到 toVersion 的路径
+        const fromIndex = allVersions.indexOf(fromVersion);
+        const toIndex = allVersions.indexOf(toVersion);
+        if (fromIndex === -1 || toIndex === -1) {
+            throw new Error(`无法找到版本迁移路径: ${fromVersion} -> ${toVersion}`);
+        }
+        let currentRoutes = routes;
+        const step = fromIndex < toIndex ? 1 : -1;
+        for(let i = fromIndex; i !== toIndex; i += step){
+            const currentVersion = allVersions[i];
+            const nextVersion = allVersions[i + step];
+            const migrationKey = `${currentVersion}->${nextVersion}`;
+            const migration = this.migrations.get(migrationKey);
+            if (migration) {
+                currentRoutes = await migration(currentVersion, nextVersion, currentRoutes);
+            } else {
+                // 如果没有迁移函数，直接使用当前路由（可能不兼容）
+                logger.warn(`缺少迁移函数: ${migrationKey}，跳过迁移`);
+            }
+        }
+        return currentRoutes;
+    }
+    /**
+   * 获取版本信息
+   * 
+   * @param version - 版本号
+   * @returns 版本信息，如果不存在返回 undefined
+   */ getVersion(version) {
+        return this.versions.get(version);
+    }
+    /**
+   * 获取所有版本
+   * 
+   * @returns 版本信息数组
+   */ getAllVersions() {
+        return Array.from(this.versions.values());
+    }
+    /**
+   * 获取当前版本
+   * 
+   * @returns 当前版本信息
+   */ getCurrentVersion() {
+        return this.versions.get(this.config.currentVersion);
+    }
+    /**
+   * 回滚到指定版本
+   * 
+   * @param version - 目标版本
+   * @param routes - 当前路由配置
+   * @returns 回滚后的路由配置
+   */ async rollback(version, routes) {
+        return this.migrate(this.config.currentVersion, version, routes);
+    }
+    constructor(config){
+        _define_property(this, "versions", new Map());
+        _define_property(this, "migrations", new Map());
+        _define_property(this, "config", void 0);
+        this.config = {
+            enableVersionCheck: config.enableVersionCheck ?? true,
+            enableAutoMigration: config.enableAutoMigration ?? false,
+            currentVersion: config.currentVersion
+        };
+    }
+}
+/**
+ * 获取路由版本管理器单例
+ */ let versionManagerInstance = null;
+export function getRouteVersionManager(config) {
+    if (!versionManagerInstance && config) {
+        versionManagerInstance = new RouteVersionManager(config);
+    }
+    if (!versionManagerInstance) {
+        throw new Error('路由版本管理器未初始化，请先提供配置');
+    }
+    return versionManagerInstance;
+}
+
+//# sourceMappingURL=RouteVersionManager.js.map