@vlian/framework 1.2.59 → 1.2.61

package/dist/core/router/validation/RouterConfigValidator.cjs

@@ -1,83 +1,2 @@
-/**
- * 路由配置验证器
- * 使用 Zod 进行配置验证，并提供友好的错误信息
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "RouterConfigValidator", {
-    enumerable: true,
-    get: function() {
-        return RouterConfigValidator;
-    }
-});
-const _ConfigValidator = require("../../config/ConfigValidator");
-const _logger = require("@vlian/logger");
-const _schema = require("./schema");
-let RouterConfigValidator = class RouterConfigValidator {
-    /**
-   * 验证路由配置
-   * 
-   * @param config - 要验证的路由配置
-   * @returns 验证后的路由配置
-   * @throws ConfigValidationError 如果配置验证失败
-   */ static validate(config) {
-        const result = (0, _schema.safeValidateRouterConfig)(config);
-        if (!result.success) {
-            // 构建友好的错误信息
-            const errorMessages = result.error.issues.map((issue)=>{
-                const path = issue.path.length > 0 ? issue.path.join('.') : 'root';
-                return `路由配置项 "${path}": ${issue.message}`;
-            });
-            const friendlyMessage = `路由配置验证失败:\n${errorMessages.join('\n')}`;
-            _logger.logger.error('路由配置验证失败', {
-                errors: result.error.issues,
-                config
-            });
-            throw new _ConfigValidator.ConfigValidationError(friendlyMessage, result.error);
-        }
-        return result.data;
-    }
-    /**
-   * 安全验证路由配置（不抛出异常）
-   * 
-   * @param config - 要验证的路由配置
-   * @returns 验证结果
-   */ static safeValidate(config) {
-        return (0, _schema.safeValidateRouterConfig)(config);
-    }
-    /**
-   * 验证路由配置并提供修复建议
-   * 
-   * @param config - 要验证的路由配置
-   * @returns 验证结果和修复建议
-   */ static validateWithSuggestions(config) {
-        const result = (0, _schema.safeValidateRouterConfig)(config);
-        if (!result.success) {
-            const suggestions = [];
-            result.error.issues.forEach((issue)=>{
-                const path = issue.path.join('.');
-                // 根据错误类型提供修复建议
-                if (issue.code === 'invalid_type') {
-                    const invalidTypeIssue = issue;
-                    suggestions.push(`配置项 "${path}" 类型错误: 期望 ${invalidTypeIssue.expected}，实际 ${invalidTypeIssue.received}`);
-                } else if (issue.code === 'too_small') {
-                    suggestions.push(`配置项 "${path}" 值太小: ${issue.message}`);
-                } else if (issue.code === 'too_big') {
-                    suggestions.push(`配置项 "${path}" 值太大: ${issue.message}`);
-                } else {
-                    suggestions.push(`配置项 "${path}": ${issue.message}`);
-                }
-            });
-            return {
-                success: false,
-                errors: result.error.issues,
-                suggestions
-            };
-        }
-        return {
-            success: true,
-            data: result.data
-        };
-    }
-};
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"RouterConfigValidator",{enumerable:true,get:function(){return RouterConfigValidator}});const _ConfigValidator=require("../../config/ConfigValidator");const _logger=require("@vlian/logger");const _schema=require("./schema");let RouterConfigValidator=class RouterConfigValidator{static validate(config){const result=(0,_schema.safeValidateRouterConfig)(config);if(!result.success){const errorMessages=result.error.issues.map(issue=>{const path=issue.path.length>0?issue.path.join("."):"root";return`路由配置项 "${path}": ${issue.message}`});const friendlyMessage=`路由配置验证失败:
+${errorMessages.join("\n")}`;_logger.logger.error("路由配置验证失败",{errors:result.error.issues,config});throw new _ConfigValidator.ConfigValidationError(friendlyMessage,result.error)}return result.data}static safeValidate(config){return(0,_schema.safeValidateRouterConfig)(config)}static validateWithSuggestions(config){const result=(0,_schema.safeValidateRouterConfig)(config);if(!result.success){const suggestions=[];result.error.issues.forEach(issue=>{const path=issue.path.join(".");if(issue.code==="invalid_type"){const invalidTypeIssue=issue;suggestions.push(`配置项 "${path}" 类型错误: 期望 ${invalidTypeIssue.expected}，实际 ${invalidTypeIssue.received}`)}else if(issue.code==="too_small"){suggestions.push(`配置项 "${path}" 值太小: ${issue.message}`)}else if(issue.code==="too_big"){suggestions.push(`配置项 "${path}" 值太大: ${issue.message}`)}else{suggestions.push(`配置项 "${path}": ${issue.message}`)}});return{success:false,errors:result.error.issues,suggestions}}return{success:true,data:result.data}}};

package/dist/core/router/validation/index.cjs

@@ -1,21 +1 @@
-/**
- * 路由配置验证模块入口
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./schema"), exports);
-_export_star(require("./RouterConfigValidator"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./schema"),exports);_export_star(require("./RouterConfigValidator"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}

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

@@ -1,159 +1 @@
-/**
- * 路由配置验证 Schema（使用 Zod）
- */ "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 componentImportSchema () {
-        return componentImportSchema;
-    },
-    get routeConfigSchema () {
-        return routeConfigSchema;
-    },
-    get routeItemHandleSchema () {
-        return routeItemHandleSchema;
-    },
-    get routerConfigSchema () {
-        return routerConfigSchema;
-    },
-    get safeValidateRouterConfig () {
-        return safeValidateRouterConfig;
-    },
-    get validateRouterConfig () {
-        return validateRouterConfig;
-    }
-});
-const _zod = require("zod");
-const routeItemHandleSchema = _zod.z.object({
-    title: _zod.z.string().min(1, '路由标题不能为空'),
-    i18nKey: _zod.z.string().optional(),
-    order: _zod.z.number().int('排序值必须是整数'),
-    icon: _zod.z.string().optional(),
-    hideInMenu: _zod.z.boolean().optional(),
-    hideFooter: _zod.z.boolean().optional(),
-    keepAlive: _zod.z.boolean().optional(),
-    needLogin: _zod.z.boolean().optional(),
-    roles: _zod.z.array(_zod.z.string()).optional(),
-    name: _zod.z.string().optional()
-}).passthrough(); // 允许其他自定义字段
-const componentImportSchema = _zod.z.union([
-    _zod.z.string().min(1, '组件路径不能为空'),
-    _zod.z.function(),
-    _zod.z.null()
-]);
-const routerOptionsSchema = _zod.z.object({
-    basename: _zod.z.string().optional(),
-    future: _zod.z.record(_zod.z.string(), _zod.z.union([
-        _zod.z.boolean(),
-        _zod.z.string(),
-        _zod.z.number()
-    ])).optional(),
-    hydrationData: _zod.z.unknown().optional(),
-    window: _zod.z.unknown().optional(),
-    initialEntries: _zod.z.array(_zod.z.string()).optional(),
-    initialIndex: _zod.z.number().int().nonnegative().optional()
-}).passthrough();
-const transformOptionsSchema = _zod.z.object({
-    pathValidation: _zod.z.object({
-        enablePathValidation: _zod.z.boolean().optional(),
-        allowedPathPrefixes: _zod.z.array(_zod.z.string().min(1)).optional(),
-        maxPathLength: _zod.z.number().int().positive().optional(),
-        allowAbsolutePaths: _zod.z.boolean().optional()
-    }).optional(),
-    performance: _zod.z.object({
-        enableCache: _zod.z.boolean().optional(),
-        cacheTTL: _zod.z.number().int().positive().optional(),
-        maxCacheSize: _zod.z.number().int().positive().optional(),
-        maxRecursionDepth: _zod.z.number().int().positive().optional(),
-        enableParallelProcessing: _zod.z.boolean().optional(),
-        parallelBatchSize: _zod.z.number().int().positive().optional()
-    }).optional(),
-    enableDebugLog: _zod.z.boolean().optional()
-}).passthrough();
-const routeConfigSchema = _zod.z.lazy(()=>_zod.z.object({
-        layout: componentImportSchema.optional().nullable(),
-        page: componentImportSchema.optional().nullable(),
-        loading: componentImportSchema.optional().nullable(),
-        error: componentImportSchema.optional().nullable(),
-        errors: componentImportSchema.optional().nullable(),
-        name: _zod.z.string().min(1, '路由名称不能为空'),
-        path: _zod.z.string().optional(),
-        isGroup: _zod.z.boolean().optional(),
-        enableRedirection: _zod.z.boolean().optional(),
-        handle: routeItemHandleSchema,
-        children: _zod.z.array(routeConfigSchema).optional()
-    }));
-const routerConfigSchema = _zod.z.object({
-    enabled: _zod.z.union([
-        _zod.z.boolean(),
-        _zod.z.literal('disabled')
-    ]).optional(),
-    routes: _zod.z.union([
-        _zod.z.array(routeConfigSchema),
-        _zod.z.function()
-    ]).optional(),
-    mode: _zod.z.enum([
-        'browser',
-        'hash',
-        'memory'
-    ]).optional(),
-    options: routerOptionsSchema.optional(),
-    pathResolve: _zod.z.object({
-        basePath: _zod.z.string().optional(),
-        pathAliases: _zod.z.record(_zod.z.string(), _zod.z.string()).optional()
-    }).optional(),
-    transformOptions: transformOptionsSchema.optional(),
-    preload: _zod.z.object({
-        strategy: _zod.z.enum([
-            'none',
-            'next-level',
-            'all',
-            'visible'
-        ]).optional(),
-        delay: _zod.z.number().int().positive().optional(),
-        priorityThreshold: _zod.z.number().int().nonnegative().optional(),
-        timeout: _zod.z.number().int().positive().optional()
-    }).optional(),
-    enableHydrateFallback: _zod.z.boolean().optional()
-}).superRefine((config, ctx)=>{
-    if (!Array.isArray(config.routes)) {
-        return;
-    }
-    const routeNameMap = new Map();
-    const walk = (routes, parentPath)=>{
-        routes.forEach((route, index)=>{
-            const currentPath = `${parentPath}[${index}]`;
-            const existingPath = routeNameMap.get(route.name);
-            if (existingPath) {
-                ctx.addIssue({
-                    code: _zod.z.ZodIssueCode.custom,
-                    path: [
-                        'routes',
-                        index,
-                        'name'
-                    ],
-                    message: `路由名称重复: "${route.name}"，首次定义位置 ${existingPath}`
-                });
-            } else {
-                routeNameMap.set(route.name, currentPath);
-            }
-            if (Array.isArray(route.children) && route.children.length > 0) {
-                walk(route.children, `${currentPath}.children`);
-            }
-        });
-    };
-    walk(config.routes, 'routes');
-});
-function validateRouterConfig(config) {
-    return routerConfigSchema.parse(config);
-}
-function safeValidateRouterConfig(config) {
-    return routerConfigSchema.safeParse(config);
-}
+"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 componentImportSchema(){return componentImportSchema},get routeConfigSchema(){return routeConfigSchema},get routeItemHandleSchema(){return routeItemHandleSchema},get routerConfigSchema(){return routerConfigSchema},get safeValidateRouterConfig(){return safeValidateRouterConfig},get validateRouterConfig(){return validateRouterConfig}});const _zod=require("zod");const routeItemHandleSchema=_zod.z.object({title:_zod.z.string().min(1,"路由标题不能为空"),i18nKey:_zod.z.string().optional(),order:_zod.z.number().int("排序值必须是整数"),icon:_zod.z.string().optional(),hideInMenu:_zod.z.boolean().optional(),hideFooter:_zod.z.boolean().optional(),keepAlive:_zod.z.boolean().optional(),needLogin:_zod.z.boolean().optional(),roles:_zod.z.array(_zod.z.string()).optional(),name:_zod.z.string().optional()}).passthrough();const componentImportSchema=_zod.z.union([_zod.z.string().min(1,"组件路径不能为空"),_zod.z.function(),_zod.z.null()]);const routerOptionsSchema=_zod.z.object({basename:_zod.z.string().optional(),future:_zod.z.record(_zod.z.string(),_zod.z.union([_zod.z.boolean(),_zod.z.string(),_zod.z.number()])).optional(),hydrationData:_zod.z.unknown().optional(),window:_zod.z.unknown().optional(),initialEntries:_zod.z.array(_zod.z.string()).optional(),initialIndex:_zod.z.number().int().nonnegative().optional()}).passthrough();const transformOptionsSchema=_zod.z.object({pathValidation:_zod.z.object({enablePathValidation:_zod.z.boolean().optional(),allowedPathPrefixes:_zod.z.array(_zod.z.string().min(1)).optional(),maxPathLength:_zod.z.number().int().positive().optional(),allowAbsolutePaths:_zod.z.boolean().optional()}).optional(),performance:_zod.z.object({enableCache:_zod.z.boolean().optional(),cacheTTL:_zod.z.number().int().positive().optional(),maxCacheSize:_zod.z.number().int().positive().optional(),maxRecursionDepth:_zod.z.number().int().positive().optional(),enableParallelProcessing:_zod.z.boolean().optional(),parallelBatchSize:_zod.z.number().int().positive().optional()}).optional(),enableDebugLog:_zod.z.boolean().optional()}).passthrough();const routeConfigSchema=_zod.z.lazy(()=>_zod.z.object({layout:componentImportSchema.optional().nullable(),page:componentImportSchema.optional().nullable(),loading:componentImportSchema.optional().nullable(),error:componentImportSchema.optional().nullable(),errors:componentImportSchema.optional().nullable(),name:_zod.z.string().min(1,"路由名称不能为空"),path:_zod.z.string().optional(),isGroup:_zod.z.boolean().optional(),enableRedirection:_zod.z.boolean().optional(),handle:routeItemHandleSchema,children:_zod.z.array(routeConfigSchema).optional()}));const routerConfigSchema=_zod.z.object({enabled:_zod.z.union([_zod.z.boolean(),_zod.z.literal("disabled")]).optional(),routes:_zod.z.union([_zod.z.array(routeConfigSchema),_zod.z.function()]).optional(),mode:_zod.z.enum(["browser","hash","memory"]).optional(),options:routerOptionsSchema.optional(),pathResolve:_zod.z.object({basePath:_zod.z.string().optional(),pathAliases:_zod.z.record(_zod.z.string(),_zod.z.string()).optional()}).optional(),transformOptions:transformOptionsSchema.optional(),preload:_zod.z.object({strategy:_zod.z.enum(["none","next-level","all","visible"]).optional(),delay:_zod.z.number().int().positive().optional(),priorityThreshold:_zod.z.number().int().nonnegative().optional(),timeout:_zod.z.number().int().positive().optional()}).optional(),enableHydrateFallback:_zod.z.boolean().optional()}).superRefine((config,ctx)=>{if(!Array.isArray(config.routes)){return}const routeNameMap=new Map;const walk=(routes,parentPath)=>{routes.forEach((route,index)=>{const currentPath=`${parentPath}[${index}]`;const existingPath=routeNameMap.get(route.name);if(existingPath){ctx.addIssue({code:_zod.z.ZodIssueCode.custom,path:["routes",index,"name"],message:`路由名称重复: "${route.name}"，首次定义位置 ${existingPath}`})}else{routeNameMap.set(route.name,currentPath)}if(Array.isArray(route.children)&&route.children.length>0){walk(route.children,`${currentPath}.children`)}})};walk(config.routes,"routes")});function validateRouterConfig(config){return routerConfigSchema.parse(config)}function safeValidateRouterConfig(config){return routerConfigSchema.safeParse(config)}

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

@@ -1,205 +1 @@
-/**
- * 路由版本管理器
- * 支持路由版本控制和迁移
- */ "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 _logger = require("@vlian/logger");
-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()
-        });
-        _logger.logger.debug(`路由版本已注册: ${version.version}`);
-    }
-    /**
-   * 注册版本迁移函数
-   * 
-   * @param fromVersion - 源版本
-   * @param toVersion - 目标版本
-   * @param migration - 迁移函数
-   */ registerMigration(fromVersion, toVersion, migration) {
-        const key = `${fromVersion}->${toVersion}`;
-        this.migrations.set(key, migration);
-        _logger.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.logger.info(`路由版本迁移完成: ${fromVersion} -> ${toVersion}`);
-            return migratedRoutes;
-        } catch (error) {
-            _logger.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 {
-                // 如果没有迁移函数，直接使用当前路由（可能不兼容）
-                _logger.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;
-}
+"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 _logger=require("@vlian/logger");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{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.logger.debug(`路由版本已注册: ${version.version}`)}registerMigration(fromVersion,toVersion,migration){const key=`${fromVersion}->${toVersion}`;this.migrations.set(key,migration);_logger.logger.debug(`路由版本迁移已注册: ${key}`)}checkCompatibility(version){const versionInfo=this.versions.get(version);if(!versionInfo){return false}if(versionInfo.compatible===false){return false}const currentMajor=parseInt(this.config.currentVersion.split(".")[0]);const targetMajor=parseInt(version.split(".")[0]);return currentMajor===targetMajor}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.logger.info(`路由版本迁移完成: ${fromVersion} -> ${toVersion}`);return migratedRoutes}catch(error){_logger.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});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.logger.warn(`缺少迁移函数: ${migrationKey}，跳过迁移`)}}return currentRoutes}getVersion(version){return this.versions.get(version)}getAllVersions(){return Array.from(this.versions.values())}getCurrentVersion(){return this.versions.get(this.config.currentVersion)}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}

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

@@ -1,20 +1 @@
-/**
- * 路由版本管理模块入口
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./RouteVersionManager"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./RouteVersionManager"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}