@vlian/framework 1.0.0

package/dist/core/config/ConfigLoader.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 配置文件加载模块
+ * 支持从JSON/YAML文件加载配置
+ * 优化：支持环境变量配置、配置热更新
+ */
+import type { StartOptions } from '../types';
+/**
+ * 配置文件格式
+ */
+export declare enum ConfigFileFormat {
+    JSON = "json",
+    YAML = "yaml"
+}
+/**
+ * 配置文件加载选项
+ */
+export interface ConfigFileLoadOptions {
+    /**
+     * 配置文件路径
+     */
+    path?: string;
+    /**
+     * 配置文件格式
+     */
+    format?: ConfigFileFormat;
+    /**
+     * 是否必需（如果为false，文件不存在时不报错）
+     */
+    required?: boolean;
+    /**
+     * 默认配置（文件不存在时使用）
+     */
+    defaultConfig?: Partial<StartOptions>;
+}
+/**
+ * 配置加载器
+ */
+export declare class ConfigLoader {
+    /**
+     * 从JSON文件加载配置
+     *
+     * @param path - 文件路径
+     * @returns 配置对象
+     */
+    static loadFromJSON(path: string): Promise<Partial<StartOptions>>;
+    /**
+     * 从YAML文件加载配置
+     *
+     * @param path - 文件路径
+     * @returns 配置对象
+     */
+    static loadFromYAML(path: string): Promise<Partial<StartOptions>>;
+    /**
+     * 从文件加载配置
+     *
+     * @param options - 加载选项
+     * @returns 配置对象
+     */
+    static loadFromFile(options: ConfigFileLoadOptions): Promise<Partial<StartOptions>>;
+    /**
+     * 合并配置（深度合并）
+     *
+     * @param base - 基础配置
+     * @param override - 覆盖配置
+     * @returns 合并后的配置
+     */
+    static mergeConfig(base: Partial<StartOptions>, override: Partial<StartOptions>): Partial<StartOptions>;
+    /**
+     * 从多个源加载并合并配置
+     *
+     * @param sources - 配置源列表（按优先级从低到高）
+     * @returns 合并后的配置
+     */
+    static loadFromMultipleSources(sources: Array<Partial<StartOptions> | ConfigFileLoadOptions>): Promise<Partial<StartOptions>>;
+    /**
+     * 从环境变量加载配置
+     *
+     * 支持以下环境变量格式：
+     * - FRAMEWORK_LOGGER_LEVEL=DEBUG
+     * - FRAMEWORK_SHOW_SPLASH_SCREEN=always
+     * - FRAMEWORK_MIN_SPLASH_SCREEN_TIME=1000
+     *
+     * @param prefix - 环境变量前缀，默认为 'FRAMEWORK_'
+     * @returns 配置对象
+     */
+    static loadFromEnv(prefix?: string): Partial<StartOptions>;
+    /**
+     * 从多个源加载配置（包括环境变量）
+     *
+     * 优先级（从低到高）：
+     * 1. 默认配置
+     * 2. 配置文件
+     * 3. 环境变量
+     * 4. 代码配置
+     *
+     * @param sources - 配置源列表
+     * @param includeEnv - 是否包含环境变量，默认为 true
+     * @param envPrefix - 环境变量前缀，默认为 'FRAMEWORK_'
+     * @returns 合并后的配置
+     */
+    static loadFromAllSources(sources: Array<Partial<StartOptions> | ConfigFileLoadOptions>, includeEnv?: boolean, envPrefix?: string): Promise<Partial<StartOptions>>;
+}
+//# sourceMappingURL=ConfigLoader.d.ts.map

package/dist/core/config/ConfigLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigLoader.d.ts","sourceRoot":"","sources":["../../../src/core/config/ConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;WACU,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAyBvE;;;;;OAKG;WACU,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAuCvE;;;;;OAKG;WACU,YAAY,CACvB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAyCjC;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAChB,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,EAC3B,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC;IAiCxB;;;;;OAKG;WACU,uBAAuB,CAClC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,qBAAqB,CAAC,GAC5D,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAiBjC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,GAAE,MAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IA6CxE;;;;;;;;;;;;;OAaG;WACU,kBAAkB,CAC7B,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,qBAAqB,CAAC,EAC7D,UAAU,GAAE,OAAc,EAC1B,SAAS,GAAE,MAAqB,GAC/B,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;CAclC"}

package/dist/core/config/ConfigLoader.js

@@ -0,0 +1,229 @@
+/**
+ * 配置文件加载模块
+ * 支持从JSON/YAML文件加载配置
+ * 优化：支持环境变量配置、配置热更新
+ */ import { logger } from "../../utils";
+/**
+ * 配置文件格式
+ */ export var ConfigFileFormat = /*#__PURE__*/ function(ConfigFileFormat) {
+    ConfigFileFormat["JSON"] = "json";
+    ConfigFileFormat["YAML"] = "yaml";
+    return ConfigFileFormat;
+}({});
+/**
+ * 配置加载器
+ */ export class ConfigLoader {
+    /**
+   * 从JSON文件加载配置
+   * 
+   * @param path - 文件路径
+   * @returns 配置对象
+   */ static async loadFromJSON(path) {
+        try {
+            // 在浏览器环境中，需要通过网络请求加载
+            if (typeof window !== 'undefined') {
+                const response = await fetch(path);
+                if (!response.ok) {
+                    throw new Error(`无法加载配置文件: ${path} (${response.status})`);
+                }
+                return await response.json();
+            }
+            // 在Node.js环境中，使用fs模块
+            if (typeof require !== 'undefined') {
+                const fs = require('fs');
+                const content = fs.readFileSync(path, 'utf-8');
+                return JSON.parse(content);
+            }
+            throw new Error('不支持的环境：无法加载配置文件');
+        } catch (error) {
+            logger.error(`加载JSON配置文件失败: ${path}`, error);
+            throw error;
+        }
+    }
+    /**
+   * 从YAML文件加载配置
+   * 
+   * @param path - 文件路径
+   * @returns 配置对象
+   */ static async loadFromYAML(path) {
+        try {
+            // 在浏览器环境中，需要通过网络请求加载
+            if (typeof window !== 'undefined') {
+                const response = await fetch(path);
+                if (!response.ok) {
+                    throw new Error(`无法加载配置文件: ${path} (${response.status})`);
+                }
+                const text = await response.text();
+                // 需要YAML解析库，这里假设有yaml库
+                // 如果没有，可以提示用户安装
+                if (typeof window.YAML !== 'undefined') {
+                    return window.YAML.parse(text);
+                }
+                // 降级：尝试作为JSON解析（如果YAML格式简单）
+                try {
+                    return JSON.parse(text);
+                } catch  {
+                    throw new Error('需要YAML解析库，请安装 yaml 包');
+                }
+            }
+            // 在Node.js环境中，使用fs模块和yaml库
+            if (typeof require !== 'undefined') {
+                const fs = require('fs');
+                const yaml = require('yaml');
+                const content = fs.readFileSync(path, 'utf-8');
+                return yaml.parse(content);
+            }
+            throw new Error('不支持的环境：无法加载配置文件');
+        } catch (error) {
+            logger.error(`加载YAML配置文件失败: ${path}`, error);
+            throw error;
+        }
+    }
+    /**
+   * 从文件加载配置
+   * 
+   * @param options - 加载选项
+   * @returns 配置对象
+   */ static async loadFromFile(options) {
+        const { path, format = "json", required = false, defaultConfig = {} } = options;
+        if (!path) {
+            if (required) {
+                throw new Error('配置文件路径未指定');
+            }
+            return defaultConfig;
+        }
+        try {
+            let config;
+            switch(format){
+                case "json":
+                    config = await this.loadFromJSON(path);
+                    break;
+                case "yaml":
+                    config = await this.loadFromYAML(path);
+                    break;
+                default:
+                    throw new Error(`不支持的配置文件格式: ${format}`);
+            }
+            logger.info(`成功加载配置文件: ${path}`);
+            return config;
+        } catch (error) {
+            if (required) {
+                throw error;
+            }
+            logger.warn(`配置文件加载失败，使用默认配置: ${path}`, error);
+            return defaultConfig;
+        }
+    }
+    /**
+   * 合并配置（深度合并）
+   * 
+   * @param base - 基础配置
+   * @param override - 覆盖配置
+   * @returns 合并后的配置
+   */ static mergeConfig(base, override) {
+        const merged = {
+            ...base
+        };
+        for(const key in override){
+            if (!Object.prototype.hasOwnProperty.call(override, key)) {
+                continue;
+            }
+            const baseValue = merged[key];
+            const overrideValue = override[key];
+            if (baseValue && overrideValue && typeof baseValue === 'object' && typeof overrideValue === 'object' && !Array.isArray(baseValue) && !Array.isArray(overrideValue)) {
+                // 深度合并对象
+                merged[key] = this.mergeConfig(baseValue, overrideValue);
+            } else {
+                // 直接覆盖
+                merged[key] = overrideValue;
+            }
+        }
+        return merged;
+    }
+    /**
+   * 从多个源加载并合并配置
+   * 
+   * @param sources - 配置源列表（按优先级从低到高）
+   * @returns 合并后的配置
+   */ static async loadFromMultipleSources(sources) {
+        let merged = {};
+        for (const source of sources){
+            if ('path' in source && 'format' in source) {
+                // 配置文件
+                const fileConfig = await this.loadFromFile(source);
+                merged = this.mergeConfig(merged, fileConfig);
+            } else if (!('path' in source) && !('format' in source)) {
+                // 配置对象
+                merged = this.mergeConfig(merged, source);
+            }
+        }
+        return merged;
+    }
+    /**
+   * 从环境变量加载配置
+   * 
+   * 支持以下环境变量格式：
+   * - FRAMEWORK_LOGGER_LEVEL=DEBUG
+   * - FRAMEWORK_SHOW_SPLASH_SCREEN=always
+   * - FRAMEWORK_MIN_SPLASH_SCREEN_TIME=1000
+   * 
+   * @param prefix - 环境变量前缀，默认为 'FRAMEWORK_'
+   * @returns 配置对象
+   */ static loadFromEnv(prefix = 'FRAMEWORK_') {
+        const config = {};
+        if (typeof process === 'undefined' || !process.env) {
+            return config;
+        }
+        // 遍历所有环境变量
+        for (const [key, value] of Object.entries(process.env)){
+            if (!key.startsWith(prefix)) {
+                continue;
+            }
+            // 移除前缀并转换为驼峰命名
+            const configKey = key.slice(prefix.length).toLowerCase().split('_').map((part, index)=>index === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)).join('');
+            // 尝试解析值
+            let parsedValue = value;
+            if (value === 'true' || value === 'false') {
+                parsedValue = value === 'true';
+            } else if (!isNaN(Number(value))) {
+                parsedValue = Number(value);
+            } else if (value?.startsWith('{') || value?.startsWith('[')) {
+                try {
+                    parsedValue = JSON.parse(value);
+                } catch  {
+                // 解析失败，使用原始值
+                }
+            }
+            // 设置配置值
+            config[configKey] = parsedValue;
+        }
+        logger.debug('从环境变量加载配置:', config);
+        return config;
+    }
+    /**
+   * 从多个源加载配置（包括环境变量）
+   * 
+   * 优先级（从低到高）：
+   * 1. 默认配置
+   * 2. 配置文件
+   * 3. 环境变量
+   * 4. 代码配置
+   * 
+   * @param sources - 配置源列表
+   * @param includeEnv - 是否包含环境变量，默认为 true
+   * @param envPrefix - 环境变量前缀，默认为 'FRAMEWORK_'
+   * @returns 合并后的配置
+   */ static async loadFromAllSources(sources, includeEnv = true, envPrefix = 'FRAMEWORK_') {
+        let merged = {};
+        // 1. 加载配置文件
+        merged = await this.loadFromMultipleSources(sources);
+        // 2. 加载环境变量（优先级高于配置文件）
+        if (includeEnv) {
+            const envConfig = this.loadFromEnv(envPrefix);
+            merged = this.mergeConfig(merged, envConfig);
+        }
+        return merged;
+    }
+}
+
+//# sourceMappingURL=ConfigLoader.js.map

package/dist/core/config/ConfigLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/config/ConfigLoader.ts"],"sourcesContent":["/**\n * 配置文件加载模块\n * 支持从JSON/YAML文件加载配置\n * 优化：支持环境变量配置、配置热更新\n */\n\nimport { logger } from '../../utils';\nimport type { StartOptions } from '../types';\n\n/**\n * 配置文件格式\n */\nexport enum ConfigFileFormat {\n  JSON = 'json',\n  YAML = 'yaml',\n}\n\n/**\n * 配置文件加载选项\n */\nexport interface ConfigFileLoadOptions {\n  /**\n   * 配置文件路径\n   */\n  path?: string;\n\n  /**\n   * 配置文件格式\n   */\n  format?: ConfigFileFormat;\n\n  /**\n   * 是否必需（如果为false，文件不存在时不报错）\n   */\n  required?: boolean;\n\n  /**\n   * 默认配置（文件不存在时使用）\n   */\n  defaultConfig?: Partial<StartOptions>;\n}\n\n/**\n * 配置加载器\n */\nexport class ConfigLoader {\n  /**\n   * 从JSON文件加载配置\n   * \n   * @param path - 文件路径\n   * @returns 配置对象\n   */\n  static async loadFromJSON(path: string): Promise<Partial<StartOptions>> {\n    try {\n      // 在浏览器环境中，需要通过网络请求加载\n      if (typeof window !== 'undefined') {\n        const response = await fetch(path);\n        if (!response.ok) {\n          throw new Error(`无法加载配置文件: ${path} (${response.status})`);\n        }\n        return await response.json();\n      }\n\n      // 在Node.js环境中，使用fs模块\n      if (typeof require !== 'undefined') {\n        const fs = require('fs');\n        const content = fs.readFileSync(path, 'utf-8');\n        return JSON.parse(content);\n      }\n\n      throw new Error('不支持的环境：无法加载配置文件');\n    } catch (error) {\n      logger.error(`加载JSON配置文件失败: ${path}`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * 从YAML文件加载配置\n   * \n   * @param path - 文件路径\n   * @returns 配置对象\n   */\n  static async loadFromYAML(path: string): Promise<Partial<StartOptions>> {\n    try {\n      // 在浏览器环境中，需要通过网络请求加载\n      if (typeof window !== 'undefined') {\n        const response = await fetch(path);\n        if (!response.ok) {\n          throw new Error(`无法加载配置文件: ${path} (${response.status})`);\n        }\n        const text = await response.text();\n        \n        // 需要YAML解析库，这里假设有yaml库\n        // 如果没有，可以提示用户安装\n        if (typeof (window as any).YAML !== 'undefined') {\n          return (window as any).YAML.parse(text);\n        }\n        \n        // 降级：尝试作为JSON解析（如果YAML格式简单）\n        try {\n          return JSON.parse(text);\n        } catch {\n          throw new Error('需要YAML解析库，请安装 yaml 包');\n        }\n      }\n\n      // 在Node.js环境中，使用fs模块和yaml库\n      if (typeof require !== 'undefined') {\n        const fs = require('fs');\n        const yaml = require('yaml');\n        const content = fs.readFileSync(path, 'utf-8');\n        return yaml.parse(content);\n      }\n\n      throw new Error('不支持的环境：无法加载配置文件');\n    } catch (error) {\n      logger.error(`加载YAML配置文件失败: ${path}`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * 从文件加载配置\n   * \n   * @param options - 加载选项\n   * @returns 配置对象\n   */\n  static async loadFromFile(\n    options: ConfigFileLoadOptions\n  ): Promise<Partial<StartOptions>> {\n    const {\n      path,\n      format = ConfigFileFormat.JSON,\n      required = false,\n      defaultConfig = {},\n    } = options;\n\n    if (!path) {\n      if (required) {\n        throw new Error('配置文件路径未指定');\n      }\n      return defaultConfig;\n    }\n\n    try {\n      let config: Partial<StartOptions>;\n\n      switch (format) {\n        case ConfigFileFormat.JSON:\n          config = await this.loadFromJSON(path);\n          break;\n        case ConfigFileFormat.YAML:\n          config = await this.loadFromYAML(path);\n          break;\n        default:\n          throw new Error(`不支持的配置文件格式: ${format}`);\n      }\n\n      logger.info(`成功加载配置文件: ${path}`);\n      return config;\n    } catch (error) {\n      if (required) {\n        throw error;\n      }\n\n      logger.warn(`配置文件加载失败，使用默认配置: ${path}`, error);\n      return defaultConfig;\n    }\n  }\n\n  /**\n   * 合并配置（深度合并）\n   * \n   * @param base - 基础配置\n   * @param override - 覆盖配置\n   * @returns 合并后的配置\n   */\n  static mergeConfig(\n    base: Partial<StartOptions>,\n    override: Partial<StartOptions>\n  ): Partial<StartOptions> {\n    const merged = { ...base };\n\n    for (const key in override) {\n      if (!Object.prototype.hasOwnProperty.call(override, key)) {\n        continue;\n      }\n\n      const baseValue = (merged as Record<string, unknown>)[key];\n      const overrideValue = (override as Record<string, unknown>)[key];\n\n      if (\n        baseValue &&\n        overrideValue &&\n        typeof baseValue === 'object' &&\n        typeof overrideValue === 'object' &&\n        !Array.isArray(baseValue) &&\n        !Array.isArray(overrideValue)\n      ) {\n        // 深度合并对象\n        (merged as Record<string, unknown>)[key] = this.mergeConfig(\n          baseValue as Partial<StartOptions>,\n          overrideValue as Partial<StartOptions>\n        );\n      } else {\n        // 直接覆盖\n        (merged as Record<string, unknown>)[key] = overrideValue;\n      }\n    }\n\n    return merged;\n  }\n\n  /**\n   * 从多个源加载并合并配置\n   * \n   * @param sources - 配置源列表（按优先级从低到高）\n   * @returns 合并后的配置\n   */\n  static async loadFromMultipleSources(\n    sources: Array<Partial<StartOptions> | ConfigFileLoadOptions>\n  ): Promise<Partial<StartOptions>> {\n    let merged: Partial<StartOptions> = {};\n\n    for (const source of sources) {\n      if ('path' in source && 'format' in source) {\n        // 配置文件\n        const fileConfig = await this.loadFromFile(source);\n        merged = this.mergeConfig(merged, fileConfig);\n      } else if (!('path' in source) && !('format' in source)) {\n        // 配置对象\n        merged = this.mergeConfig(merged, source as Partial<StartOptions>);\n      }\n    }\n\n    return merged;\n  }\n\n  /**\n   * 从环境变量加载配置\n   * \n   * 支持以下环境变量格式：\n   * - FRAMEWORK_LOGGER_LEVEL=DEBUG\n   * - FRAMEWORK_SHOW_SPLASH_SCREEN=always\n   * - FRAMEWORK_MIN_SPLASH_SCREEN_TIME=1000\n   * \n   * @param prefix - 环境变量前缀，默认为 'FRAMEWORK_'\n   * @returns 配置对象\n   */\n  static loadFromEnv(prefix: string = 'FRAMEWORK_'): Partial<StartOptions> {\n    const config: Partial<StartOptions> = {};\n\n    if (typeof process === 'undefined' || !process.env) {\n      return config;\n    }\n\n    // 遍历所有环境变量\n    for (const [key, value] of Object.entries(process.env)) {\n      if (!key.startsWith(prefix)) {\n        continue;\n      }\n\n      // 移除前缀并转换为驼峰命名\n      const configKey = key\n        .slice(prefix.length)\n        .toLowerCase()\n        .split('_')\n        .map((part, index) => \n          index === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)\n        )\n        .join('');\n\n      // 尝试解析值\n      let parsedValue: unknown = value;\n      if (value === 'true' || value === 'false') {\n        parsedValue = value === 'true';\n      } else if (!isNaN(Number(value))) {\n        parsedValue = Number(value);\n      } else if (value?.startsWith('{') || value?.startsWith('[')) {\n        try {\n          parsedValue = JSON.parse(value);\n        } catch {\n          // 解析失败，使用原始值\n        }\n      }\n\n      // 设置配置值\n      (config as any)[configKey] = parsedValue;\n    }\n\n    logger.debug('从环境变量加载配置:', config);\n    return config;\n  }\n\n  /**\n   * 从多个源加载配置（包括环境变量）\n   * \n   * 优先级（从低到高）：\n   * 1. 默认配置\n   * 2. 配置文件\n   * 3. 环境变量\n   * 4. 代码配置\n   * \n   * @param sources - 配置源列表\n   * @param includeEnv - 是否包含环境变量，默认为 true\n   * @param envPrefix - 环境变量前缀，默认为 'FRAMEWORK_'\n   * @returns 合并后的配置\n   */\n  static async loadFromAllSources(\n    sources: Array<Partial<StartOptions> | ConfigFileLoadOptions>,\n    includeEnv: boolean = true,\n    envPrefix: string = 'FRAMEWORK_'\n  ): Promise<Partial<StartOptions>> {\n    let merged: Partial<StartOptions> = {};\n\n    // 1. 加载配置文件\n    merged = await this.loadFromMultipleSources(sources);\n\n    // 2. 加载环境变量（优先级高于配置文件）\n    if (includeEnv) {\n      const envConfig = this.loadFromEnv(envPrefix);\n      merged = this.mergeConfig(merged, envConfig);\n    }\n\n    return merged;\n  }\n}\n"],"names":["logger","ConfigFileFormat","ConfigLoader","loadFromJSON","path","window","response","fetch","ok","Error","status","json","require","fs","content","readFileSync","JSON","parse","error","loadFromYAML","text","YAML","yaml","loadFromFile","options","format","required","defaultConfig","config","info","warn","mergeConfig","base","override","merged","key","Object","prototype","hasOwnProperty","call","baseValue","overrideValue","Array","isArray","loadFromMultipleSources","sources","source","fileConfig","loadFromEnv","prefix","process","env","value","entries","startsWith","configKey","slice","length","toLowerCase","split","map","part","index","charAt","toUpperCase","join","parsedValue","isNaN","Number","debug","loadFromAllSources","includeEnv","envPrefix","envConfig"],"mappings":"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"}

package/dist/core/config/ConfigValidator.cjs

@@ -0,0 +1,135 @@
+/**
+ * 配置验证模块
+ * 使用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 ConfigValidationError () {
+        return ConfigValidationError;
+    },
+    get ConfigValidator () {
+        return ConfigValidator;
+    }
+});
+const _zod = require("zod");
+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 ConfigValidationError = class ConfigValidationError extends Error {
+    constructor(message, errors){
+        super(message), _define_property(this, "errors", void 0), this.errors = errors;
+        this.name = 'ConfigValidationError';
+    }
+};
+let ConfigValidator = class ConfigValidator {
+    /**
+   * 验证配置
+   * 
+   * @param config - 要验证的配置
+   * @param schema - Zod模式
+   * @returns 验证后的配置
+   * @throws ConfigValidationError 如果配置验证失败
+   */ static validate(config, schema) {
+        const result = schema.safeParse(config);
+        if (!result.success) {
+            throw new ConfigValidationError('配置验证失败', result.error);
+        }
+        return result.data;
+    }
+    /**
+   * 安全验证配置（不抛出异常）
+   * 
+   * @param config - 要验证的配置
+   * @param schema - Zod模式
+   * @returns 验证结果
+   */ static safeValidate(config, schema) {
+        const result = schema.safeParse(config);
+        if (result.success) {
+            return {
+                success: true,
+                data: result.data
+            };
+        }
+        return {
+            success: false,
+            error: result.error
+        };
+    }
+    /**
+   * 创建StartOptions的部分验证模式
+   * 注意：这是一个基础模式，可以根据需要扩展
+   */ static createStartOptionsSchema() {
+        return _zod.z.object({
+            loggerLevel: _zod.z.enum([
+                'DEBUG',
+                'INFO',
+                'WARN',
+                'ERROR'
+            ]).optional(),
+            showSplashScreen: _zod.z.enum([
+                'auto',
+                'always',
+                'never',
+                'first-time-only'
+            ]).optional(),
+            minSplashScreenTime: _zod.z.number().positive().optional(),
+            security: _zod.z.object({
+                enableXSSProtection: _zod.z.boolean().optional(),
+                validateConfig: _zod.z.boolean().optional(),
+                sanitizeUserInput: _zod.z.boolean().optional(),
+                csp: _zod.z.object({
+                    defaultSrc: _zod.z.array(_zod.z.string()).optional(),
+                    scriptSrc: _zod.z.array(_zod.z.string()).optional(),
+                    styleSrc: _zod.z.array(_zod.z.string()).optional(),
+                    imgSrc: _zod.z.array(_zod.z.string()).optional(),
+                    connectSrc: _zod.z.array(_zod.z.string()).optional(),
+                    fontSrc: _zod.z.array(_zod.z.string()).optional(),
+                    frameSrc: _zod.z.array(_zod.z.string()).optional(),
+                    allowUnsafeInline: _zod.z.boolean().optional(),
+                    allowUnsafeEval: _zod.z.boolean().optional()
+                }).optional()
+            }).optional()
+        }).passthrough(); // passthrough允许其他字段通过
+    }
+    /**
+   * 验证配置并提供友好的错误信息
+   * 
+   * @param config - 要验证的配置
+   * @param schema - Zod模式
+   * @returns 验证后的配置
+   * @throws ConfigValidationError 如果配置验证失败，包含详细的错误信息
+   */ static validateWithFriendlyErrors(config, schema) {
+        const result = schema.safeParse(config);
+        if (!result.success) {
+            // 构建友好的错误信息
+            // 注意：ZodError 使用 issues 属性，不是 errors
+            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')}`;
+            throw new ConfigValidationError(friendlyMessage, result.error);
+        }
+        return result.data;
+    }
+};
+
+//# sourceMappingURL=ConfigValidator.js.map

package/dist/core/config/ConfigValidator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/config/ConfigValidator.ts"],"sourcesContent":["/**\n * 配置验证模块\n * 使用Zod进行配置验证\n */\n\nimport { z } from 'zod';\n\n/**\n * 配置验证错误\n */\nexport class ConfigValidationError extends Error {\n  constructor(\n    message: string,\n    public readonly errors: z.ZodError\n  ) {\n    super(message);\n    this.name = 'ConfigValidationError';\n  }\n}\n\n/**\n * 配置验证器\n */\nexport class ConfigValidator {\n  /**\n   * 验证配置\n   * \n   * @param config - 要验证的配置\n   * @param schema - Zod模式\n   * @returns 验证后的配置\n   * @throws ConfigValidationError 如果配置验证失败\n   */\n  static validate<T>(\n    config: unknown,\n    schema: z.ZodSchema<T>\n  ): T {\n    const result = schema.safeParse(config);\n\n    if (!result.success) {\n      throw new ConfigValidationError(\n        '配置验证失败',\n        result.error\n      );\n    }\n\n    return result.data;\n  }\n\n  /**\n   * 安全验证配置（不抛出异常）\n   * \n   * @param config - 要验证的配置\n   * @param schema - Zod模式\n   * @returns 验证结果\n   */\n  static safeValidate<T>(\n    config: unknown,\n    schema: z.ZodSchema<T>\n  ): { success: true; data: T } | { success: false; error: z.ZodError } {\n    const result = schema.safeParse(config);\n\n    if (result.success) {\n      return { success: true, data: result.data };\n    }\n\n    return { success: false, error: result.error };\n  }\n\n  /**\n   * 创建StartOptions的部分验证模式\n   * 注意：这是一个基础模式，可以根据需要扩展\n   */\n  static createStartOptionsSchema() {\n    return z.object({\n      loggerLevel: z.enum(['DEBUG', 'INFO', 'WARN', 'ERROR']).optional(),\n      showSplashScreen: z.enum(['auto', 'always', 'never', 'first-time-only']).optional(),\n      minSplashScreenTime: z.number().positive().optional(),\n      security: z.object({\n        enableXSSProtection: z.boolean().optional(),\n        validateConfig: z.boolean().optional(),\n        sanitizeUserInput: z.boolean().optional(),\n        csp: z.object({\n          defaultSrc: z.array(z.string()).optional(),\n          scriptSrc: z.array(z.string()).optional(),\n          styleSrc: z.array(z.string()).optional(),\n          imgSrc: z.array(z.string()).optional(),\n          connectSrc: z.array(z.string()).optional(),\n          fontSrc: z.array(z.string()).optional(),\n          frameSrc: z.array(z.string()).optional(),\n          allowUnsafeInline: z.boolean().optional(),\n          allowUnsafeEval: z.boolean().optional(),\n        }).optional(),\n      }).optional(),\n    }).passthrough(); // passthrough允许其他字段通过\n  }\n\n  /**\n   * 验证配置并提供友好的错误信息\n   * \n   * @param config - 要验证的配置\n   * @param schema - Zod模式\n   * @returns 验证后的配置\n   * @throws ConfigValidationError 如果配置验证失败，包含详细的错误信息\n   */\n  static validateWithFriendlyErrors<T>(\n    config: unknown,\n    schema: z.ZodSchema<T>\n  ): T {\n    const result = schema.safeParse(config);\n\n    if (!result.success) {\n      // 构建友好的错误信息\n      // 注意：ZodError 使用 issues 属性，不是 errors\n      const errorMessages = result.error.issues.map((issue: z.ZodIssue) => {\n        const path = issue.path.length > 0 ? issue.path.join('.') : 'root';\n        return `配置项 \"${path}\": ${issue.message}`;\n      });\n\n      const friendlyMessage = `配置验证失败:\\n${errorMessages.join('\\n')}`;\n\n      throw new ConfigValidationError(friendlyMessage, result.error);\n    }\n\n    return result.data;\n  }\n}\n"],"names":["ConfigValidationError","ConfigValidator","Error","message","errors","name","validate","config","schema","result","safeParse","success","error","data","safeValidate","createStartOptionsSchema","z","object","loggerLevel","enum","optional","showSplashScreen","minSplashScreenTime","number","positive","security","enableXSSProtection","boolean","validateConfig","sanitizeUserInput","csp","defaultSrc","array","string","scriptSrc","styleSrc","imgSrc","connectSrc","fontSrc","frameSrc","allowUnsafeInline","allowUnsafeEval","passthrough","validateWithFriendlyErrors","errorMessages","issues","map","issue","path","length","join","friendlyMessage"],"mappings":"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"}

package/dist/core/config/ConfigValidator.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 配置验证模块
+ * 使用Zod进行配置验证
+ */
+import { z } from 'zod';
+/**
+ * 配置验证错误
+ */
+export declare class ConfigValidationError extends Error {
+    readonly errors: z.ZodError;
+    constructor(message: string, errors: z.ZodError);
+}
+/**
+ * 配置验证器
+ */
+export declare class ConfigValidator {
+    /**
+     * 验证配置
+     *
+     * @param config - 要验证的配置
+     * @param schema - Zod模式
+     * @returns 验证后的配置
+     * @throws ConfigValidationError 如果配置验证失败
+     */
+    static validate<T>(config: unknown, schema: z.ZodSchema<T>): T;
+    /**
+     * 安全验证配置（不抛出异常）
+     *
+     * @param config - 要验证的配置
+     * @param schema - Zod模式
+     * @returns 验证结果
+     */
+    static safeValidate<T>(config: unknown, schema: z.ZodSchema<T>): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: z.ZodError;
+    };
+    /**
+     * 创建StartOptions的部分验证模式
+     * 注意：这是一个基础模式，可以根据需要扩展
+     */
+    static createStartOptionsSchema(): z.ZodObject<{
+        loggerLevel: z.ZodOptional<z.ZodEnum<{
+            DEBUG: "DEBUG";
+            INFO: "INFO";
+            WARN: "WARN";
+            ERROR: "ERROR";
+        }>>;
+        showSplashScreen: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            always: "always";
+            never: "never";
+            "first-time-only": "first-time-only";
+        }>>;
+        minSplashScreenTime: z.ZodOptional<z.ZodNumber>;
+        security: z.ZodOptional<z.ZodObject<{
+            enableXSSProtection: z.ZodOptional<z.ZodBoolean>;
+            validateConfig: z.ZodOptional<z.ZodBoolean>;
+            sanitizeUserInput: z.ZodOptional<z.ZodBoolean>;
+            csp: z.ZodOptional<z.ZodObject<{
+                defaultSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                scriptSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                styleSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imgSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                connectSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                fontSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                frameSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                allowUnsafeInline: z.ZodOptional<z.ZodBoolean>;
+                allowUnsafeEval: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$loose>;
+    /**
+     * 验证配置并提供友好的错误信息
+     *
+     * @param config - 要验证的配置
+     * @param schema - Zod模式
+     * @returns 验证后的配置
+     * @throws ConfigValidationError 如果配置验证失败，包含详细的错误信息
+     */
+    static validateWithFriendlyErrors<T>(config: unknown, schema: z.ZodSchema<T>): T;
+}
+//# sourceMappingURL=ConfigValidator.d.ts.map

package/dist/core/config/ConfigValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigValidator.d.ts","sourceRoot":"","sources":["../../../src/core/config/ConfigValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,MAAM,EAAE,CAAC,CAAC,QAAQ;gBADlC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,CAAC,CAAC,QAAQ;CAKrC;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EACf,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GACrB,CAAC;IAaJ;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EACnB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GACrB;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;KAAE;IAUrE;;;OAGG;IACH,MAAM,CAAC,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwB/B;;;;;;;OAOG;IACH,MAAM,CAAC,0BAA0B,CAAC,CAAC,EACjC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GACrB,CAAC;CAkBL"}