@vlian/framework 1.0.0

package/dist/utils/csrf.js

@@ -0,0 +1,144 @@
+/**
+ * CSRF 防护工具
+ * 提供 CSRF Token 的生成、存储和验证功能
+ */ /**
+ * CSRF Token 存储接口
+ */ 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;
+}
+/**
+ * 默认 Token 存储（使用 Cookie）
+ */ let CookieTokenStorage = class CookieTokenStorage {
+    getToken() {
+        if (typeof document === 'undefined') {
+            return null;
+        }
+        const cookies = document.cookie.split(';');
+        for (const cookie of cookies){
+            const [name, value] = cookie.trim().split('=');
+            if (name === this.cookieName) {
+                return decodeURIComponent(value);
+            }
+        }
+        return null;
+    }
+    setToken(token) {
+        if (typeof document === 'undefined') {
+            return;
+        }
+        // 设置 Cookie（HttpOnly 由服务端设置，这里只设置客户端可访问的）
+        document.cookie = `${this.cookieName}=${encodeURIComponent(token)}; path=/; SameSite=Strict`;
+    }
+    clearToken() {
+        if (typeof document === 'undefined') {
+            return;
+        }
+        document.cookie = `${this.cookieName}=; path=/; expires=Thu, 01 Jan 1970 00:00:00 GMT`;
+    }
+    constructor(cookieName = 'csrf-token'){
+        _define_property(this, "cookieName", void 0);
+        this.cookieName = cookieName;
+    }
+};
+/**
+ * 内存 Token 存储（用于 SSR 或测试）
+ */ let MemoryTokenStorage = class MemoryTokenStorage {
+    getToken() {
+        return this.token;
+    }
+    setToken(token) {
+        this.token = token;
+    }
+    clearToken() {
+        this.token = null;
+    }
+    constructor(){
+        _define_property(this, "token", null);
+    }
+};
+/**
+ * CSRF Token 管理器
+ */ export class CSRFTokenManager {
+    /**
+   * 获取 CSRF Token
+   */ async getToken() {
+        if (this.getTokenFn) {
+            try {
+                return await Promise.resolve(this.getTokenFn());
+            } catch (error) {
+                console.warn('CSRF Token 获取失败:', error);
+                return null;
+            }
+        }
+        // 从存储中获取
+        return this.storage.getToken();
+    }
+    /**
+   * 设置 CSRF Token
+   */ setToken(token) {
+        this.storage.setToken(token);
+    }
+    /**
+   * 验证 CSRF Token
+   */ async validateToken(token) {
+        if (this.validateTokenFn) {
+            try {
+                return await Promise.resolve(this.validateTokenFn(token));
+            } catch (error) {
+                console.warn('CSRF Token 验证失败:', error);
+                return false;
+            }
+        }
+        // 默认验证：检查存储中的 Token 是否匹配
+        const storedToken = this.storage.getToken();
+        return storedToken !== null && storedToken === token;
+    }
+    /**
+   * 清除 CSRF Token
+   */ clearToken() {
+        this.storage.clearToken();
+    }
+    /**
+   * 获取请求头名称
+   */ getHeaderName() {
+        return this.headerName;
+    }
+    constructor(config){
+        _define_property(this, "storage", void 0);
+        _define_property(this, "headerName", void 0);
+        _define_property(this, "cookieName", void 0);
+        _define_property(this, "getTokenFn", void 0);
+        _define_property(this, "validateTokenFn", void 0);
+        this.headerName = config?.headerName ?? 'X-CSRF-Token';
+        this.cookieName = config?.cookieName ?? 'csrf-token';
+        this.storage = config?.storage ?? (typeof document !== 'undefined' ? new CookieTokenStorage(this.cookieName) : new MemoryTokenStorage());
+        this.getTokenFn = config?.getToken;
+        this.validateTokenFn = config?.validateToken;
+    }
+}
+/**
+ * 全局 CSRF Token 管理器实例
+ */ let globalCSRFManager = null;
+/**
+ * 初始化 CSRF Token 管理器
+ */ export function initCSRFManager(config) {
+    globalCSRFManager = new CSRFTokenManager(config);
+    return globalCSRFManager;
+}
+/**
+ * 获取全局 CSRF Token 管理器
+ */ export function getCSRFManager() {
+    return globalCSRFManager;
+}
+
+//# sourceMappingURL=csrf.js.map

package/dist/utils/csrf.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/csrf.ts"],"sourcesContent":["/**\n * CSRF 防护工具\n * 提供 CSRF Token 的生成、存储和验证功能\n */\n\n/**\n * CSRF Token 存储接口\n */\nexport interface CSRFTokenStorage {\n  /**\n   * 获取 Token\n   */\n  getToken(): string | null;\n  /**\n   * 设置 Token\n   */\n  setToken(token: string): void;\n  /**\n   * 清除 Token\n   */\n  clearToken(): void;\n}\n\n/**\n * 默认 Token 存储（使用 Cookie）\n */\nclass CookieTokenStorage implements CSRFTokenStorage {\n  private cookieName: string;\n\n  constructor(cookieName: string = 'csrf-token') {\n    this.cookieName = cookieName;\n  }\n\n  getToken(): string | null {\n    if (typeof document === 'undefined') {\n      return null;\n    }\n\n    const cookies = document.cookie.split(';');\n    for (const cookie of cookies) {\n      const [name, value] = cookie.trim().split('=');\n      if (name === this.cookieName) {\n        return decodeURIComponent(value);\n      }\n    }\n    return null;\n  }\n\n  setToken(token: string): void {\n    if (typeof document === 'undefined') {\n      return;\n    }\n\n    // 设置 Cookie（HttpOnly 由服务端设置，这里只设置客户端可访问的）\n    document.cookie = `${this.cookieName}=${encodeURIComponent(token)}; path=/; SameSite=Strict`;\n  }\n\n  clearToken(): void {\n    if (typeof document === 'undefined') {\n      return;\n    }\n\n    document.cookie = `${this.cookieName}=; path=/; expires=Thu, 01 Jan 1970 00:00:00 GMT`;\n  }\n}\n\n/**\n * 内存 Token 存储（用于 SSR 或测试）\n */\nclass MemoryTokenStorage implements CSRFTokenStorage {\n  private token: string | null = null;\n\n  getToken(): string | null {\n    return this.token;\n  }\n\n  setToken(token: string): void {\n    this.token = token;\n  }\n\n  clearToken(): void {\n    this.token = null;\n  }\n}\n\n/**\n * CSRF Token 管理器\n */\nexport class CSRFTokenManager {\n  private storage: CSRFTokenStorage;\n  private headerName: string;\n  private cookieName: string;\n  private getTokenFn?: () => string | Promise<string>;\n  private validateTokenFn?: (token: string) => boolean | Promise<boolean>;\n\n  constructor(config?: {\n    storage?: CSRFTokenStorage;\n    headerName?: string;\n    cookieName?: string;\n    getToken?: () => string | Promise<string>;\n    validateToken?: (token: string) => boolean | Promise<boolean>;\n  }) {\n    this.headerName = config?.headerName ?? 'X-CSRF-Token';\n    this.cookieName = config?.cookieName ?? 'csrf-token';\n    this.storage = config?.storage ?? (typeof document !== 'undefined' \n      ? new CookieTokenStorage(this.cookieName)\n      : new MemoryTokenStorage());\n    this.getTokenFn = config?.getToken;\n    this.validateTokenFn = config?.validateToken;\n  }\n\n  /**\n   * 获取 CSRF Token\n   */\n  async getToken(): Promise<string | null> {\n    if (this.getTokenFn) {\n      try {\n        return await Promise.resolve(this.getTokenFn());\n      } catch (error) {\n        console.warn('CSRF Token 获取失败:', error);\n        return null;\n      }\n    }\n\n    // 从存储中获取\n    return this.storage.getToken();\n  }\n\n  /**\n   * 设置 CSRF Token\n   */\n  setToken(token: string): void {\n    this.storage.setToken(token);\n  }\n\n  /**\n   * 验证 CSRF Token\n   */\n  async validateToken(token: string): Promise<boolean> {\n    if (this.validateTokenFn) {\n      try {\n        return await Promise.resolve(this.validateTokenFn(token));\n      } catch (error) {\n        console.warn('CSRF Token 验证失败:', error);\n        return false;\n      }\n    }\n\n    // 默认验证：检查存储中的 Token 是否匹配\n    const storedToken = this.storage.getToken();\n    return storedToken !== null && storedToken === token;\n  }\n\n  /**\n   * 清除 CSRF Token\n   */\n  clearToken(): void {\n    this.storage.clearToken();\n  }\n\n  /**\n   * 获取请求头名称\n   */\n  getHeaderName(): string {\n    return this.headerName;\n  }\n}\n\n/**\n * 全局 CSRF Token 管理器实例\n */\nlet globalCSRFManager: CSRFTokenManager | null = null;\n\n/**\n * 初始化 CSRF Token 管理器\n */\nexport function initCSRFManager(config?: {\n  storage?: CSRFTokenStorage;\n  headerName?: string;\n  cookieName?: string;\n  getToken?: () => string | Promise<string>;\n  validateToken?: (token: string) => boolean | Promise<boolean>;\n}): CSRFTokenManager {\n  globalCSRFManager = new CSRFTokenManager(config);\n  return globalCSRFManager;\n}\n\n/**\n * 获取全局 CSRF Token 管理器\n */\nexport function getCSRFManager(): CSRFTokenManager | null {\n  return globalCSRFManager;\n}\n"],"names":["CookieTokenStorage","getToken","document","cookies","cookie","split","name","value","trim","cookieName","decodeURIComponent","setToken","token","encodeURIComponent","clearToken","MemoryTokenStorage","CSRFTokenManager","getTokenFn","Promise","resolve","error","console","warn","storage","validateToken","validateTokenFn","storedToken","getHeaderName","headerName","config","globalCSRFManager","initCSRFManager","getCSRFManager"],"mappings":"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"}

package/dist/utils/errors/ErrorCodes.cjs

@@ -0,0 +1,97 @@
+/**
+ * 错误码定义
+ * 提供统一的错误码和错误信息映射
+ */ /**
+ * 错误码枚举
+ */ "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 ErrorCode () {
+        return ErrorCode;
+    },
+    get ErrorMessages () {
+        return ErrorMessages;
+    },
+    get getErrorMessage () {
+        return getErrorMessage;
+    },
+    get getUserFriendlyMessage () {
+        return getUserFriendlyMessage;
+    }
+});
+var ErrorCode = /*#__PURE__*/ function(ErrorCode) {
+    // 框架启动错误 (1000-1999)
+    ErrorCode[ErrorCode["CONTAINER_NOT_FOUND"] = 1001] = "CONTAINER_NOT_FOUND";
+    ErrorCode[ErrorCode["STARTUP_FAILED"] = 1002] = "STARTUP_FAILED";
+    ErrorCode[ErrorCode["INITIALIZATION_FAILED"] = 1003] = "INITIALIZATION_FAILED";
+    // 配置错误 (2000-2999)
+    ErrorCode[ErrorCode["CONFIG_LOAD_FAILED"] = 2001] = "CONFIG_LOAD_FAILED";
+    ErrorCode[ErrorCode["CONFIG_VALIDATION_FAILED"] = 2002] = "CONFIG_VALIDATION_FAILED";
+    ErrorCode[ErrorCode["CONFIG_FILE_NOT_FOUND"] = 2003] = "CONFIG_FILE_NOT_FOUND";
+    // 插件错误 (3000-3999)
+    ErrorCode[ErrorCode["PLUGIN_REGISTER_FAILED"] = 3001] = "PLUGIN_REGISTER_FAILED";
+    ErrorCode[ErrorCode["PLUGIN_EXECUTION_FAILED"] = 3002] = "PLUGIN_EXECUTION_FAILED";
+    ErrorCode[ErrorCode["PLUGIN_PERMISSION_DENIED"] = 3003] = "PLUGIN_PERMISSION_DENIED";
+    // 状态管理错误 (4000-4999)
+    ErrorCode[ErrorCode["STATE_MANAGER_NOT_INITIALIZED"] = 4001] = "STATE_MANAGER_NOT_INITIALIZED";
+    ErrorCode[ErrorCode["STATE_INSTANCE_NOT_FOUND"] = 4002] = "STATE_INSTANCE_NOT_FOUND";
+    ErrorCode[ErrorCode["STATE_SCOPE_NOT_FOUND"] = 4003] = "STATE_SCOPE_NOT_FOUND";
+    // 存储错误 (5000-5999)
+    ErrorCode[ErrorCode["STORAGE_INITIALIZATION_FAILED"] = 5001] = "STORAGE_INITIALIZATION_FAILED";
+    ErrorCode[ErrorCode["STORAGE_OPERATION_FAILED"] = 5002] = "STORAGE_OPERATION_FAILED";
+    // 网络错误 (6000-6999)
+    ErrorCode[ErrorCode["NETWORK_ERROR"] = 6001] = "NETWORK_ERROR";
+    ErrorCode[ErrorCode["NETWORK_TIMEOUT"] = 6002] = "NETWORK_TIMEOUT";
+    // 未知错误 (9999)
+    ErrorCode[ErrorCode["UNKNOWN_ERROR"] = 9999] = "UNKNOWN_ERROR";
+    return ErrorCode;
+}({});
+const ErrorMessages = {
+    [1001]: '未找到挂载容器，请确保页面中存在 id="root" 的元素或通过 container 选项指定容器',
+    [1002]: '框架启动失败',
+    [1003]: '初始化失败',
+    [2001]: '配置加载失败',
+    [2002]: '配置验证失败',
+    [2003]: '配置文件未找到',
+    [3001]: '插件注册失败',
+    [3002]: '插件执行失败',
+    [3003]: '插件权限不足',
+    [4001]: '状态管理器未初始化',
+    [4002]: '状态实例未找到',
+    [4003]: '状态作用域未找到',
+    [5001]: '存储初始化失败',
+    [5002]: '存储操作失败',
+    [6001]: '网络错误',
+    [6002]: '网络请求超时',
+    [9999]: '未知错误'
+};
+function getErrorMessage(code) {
+    return ErrorMessages[code] || ErrorMessages[9999];
+}
+function getUserFriendlyMessage(code, details) {
+    const baseMessage = getErrorMessage(code);
+    if (details) {
+        return `${baseMessage}: ${details}`;
+    }
+    // 根据错误码提供修复建议
+    const suggestions = {
+        [1001]: '请检查HTML中是否存在id="root"的元素，或通过container选项指定容器',
+        [2002]: '请检查配置文件格式是否正确，参考文档进行配置',
+        [3003]: '请检查插件权限配置，确保插件有足够的权限'
+    };
+    const suggestion = suggestions[code];
+    if (suggestion) {
+        return `${baseMessage}\n建议: ${suggestion}`;
+    }
+    return baseMessage;
+}
+
+//# sourceMappingURL=ErrorCodes.js.map

package/dist/utils/errors/ErrorCodes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/errors/ErrorCodes.ts"],"sourcesContent":["/**\n * 错误码定义\n * 提供统一的错误码和错误信息映射\n */\n\n/**\n * 错误码枚举\n */\nexport enum ErrorCode {\n  // 框架启动错误 (1000-1999)\n  CONTAINER_NOT_FOUND = 1001,\n  STARTUP_FAILED = 1002,\n  INITIALIZATION_FAILED = 1003,\n\n  // 配置错误 (2000-2999)\n  CONFIG_LOAD_FAILED = 2001,\n  CONFIG_VALIDATION_FAILED = 2002,\n  CONFIG_FILE_NOT_FOUND = 2003,\n\n  // 插件错误 (3000-3999)\n  PLUGIN_REGISTER_FAILED = 3001,\n  PLUGIN_EXECUTION_FAILED = 3002,\n  PLUGIN_PERMISSION_DENIED = 3003,\n\n  // 状态管理错误 (4000-4999)\n  STATE_MANAGER_NOT_INITIALIZED = 4001,\n  STATE_INSTANCE_NOT_FOUND = 4002,\n  STATE_SCOPE_NOT_FOUND = 4003,\n\n  // 存储错误 (5000-5999)\n  STORAGE_INITIALIZATION_FAILED = 5001,\n  STORAGE_OPERATION_FAILED = 5002,\n\n  // 网络错误 (6000-6999)\n  NETWORK_ERROR = 6001,\n  NETWORK_TIMEOUT = 6002,\n\n  // 未知错误 (9999)\n  UNKNOWN_ERROR = 9999,\n}\n\n/**\n * 错误信息映射\n */\nexport const ErrorMessages: Record<ErrorCode, string> = {\n  [ErrorCode.CONTAINER_NOT_FOUND]: '未找到挂载容器，请确保页面中存在 id=\"root\" 的元素或通过 container 选项指定容器',\n  [ErrorCode.STARTUP_FAILED]: '框架启动失败',\n  [ErrorCode.INITIALIZATION_FAILED]: '初始化失败',\n\n  [ErrorCode.CONFIG_LOAD_FAILED]: '配置加载失败',\n  [ErrorCode.CONFIG_VALIDATION_FAILED]: '配置验证失败',\n  [ErrorCode.CONFIG_FILE_NOT_FOUND]: '配置文件未找到',\n\n  [ErrorCode.PLUGIN_REGISTER_FAILED]: '插件注册失败',\n  [ErrorCode.PLUGIN_EXECUTION_FAILED]: '插件执行失败',\n  [ErrorCode.PLUGIN_PERMISSION_DENIED]: '插件权限不足',\n\n  [ErrorCode.STATE_MANAGER_NOT_INITIALIZED]: '状态管理器未初始化',\n  [ErrorCode.STATE_INSTANCE_NOT_FOUND]: '状态实例未找到',\n  [ErrorCode.STATE_SCOPE_NOT_FOUND]: '状态作用域未找到',\n\n  [ErrorCode.STORAGE_INITIALIZATION_FAILED]: '存储初始化失败',\n  [ErrorCode.STORAGE_OPERATION_FAILED]: '存储操作失败',\n\n  [ErrorCode.NETWORK_ERROR]: '网络错误',\n  [ErrorCode.NETWORK_TIMEOUT]: '网络请求超时',\n\n  [ErrorCode.UNKNOWN_ERROR]: '未知错误',\n};\n\n/**\n * 获取错误信息\n * \n * @param code - 错误码\n * @returns 错误信息\n */\nexport function getErrorMessage(code: ErrorCode): string {\n  return ErrorMessages[code] || ErrorMessages[ErrorCode.UNKNOWN_ERROR];\n}\n\n/**\n * 获取用户友好的错误提示\n * \n * @param code - 错误码\n * @param details - 详细信息\n * @returns 用户友好的错误提示\n */\nexport function getUserFriendlyMessage(code: ErrorCode, details?: string): string {\n  const baseMessage = getErrorMessage(code);\n  \n  if (details) {\n    return `${baseMessage}: ${details}`;\n  }\n\n  // 根据错误码提供修复建议\n  const suggestions: Partial<Record<ErrorCode, string>> = {\n    [ErrorCode.CONTAINER_NOT_FOUND]: '请检查HTML中是否存在id=\"root\"的元素，或通过container选项指定容器',\n    [ErrorCode.CONFIG_VALIDATION_FAILED]: '请检查配置文件格式是否正确，参考文档进行配置',\n    [ErrorCode.PLUGIN_PERMISSION_DENIED]: '请检查插件权限配置，确保插件有足够的权限',\n  };\n\n  const suggestion = suggestions[code];\n  if (suggestion) {\n    return `${baseMessage}\\n建议: ${suggestion}`;\n  }\n\n  return baseMessage;\n}\n"],"names":["ErrorCode","ErrorMessages","getErrorMessage","getUserFriendlyMessage","code","details","baseMessage","suggestions","suggestion"],"mappings":"AAAA;;;CAGC,GAED;;CAEC;;;;;;;;;;;QACWA;eAAAA;;QAoCCC;eAAAA;;QAgCGC;eAAAA;;QAWAC;eAAAA;;;AA/ET,IAAA,AAAKH,mCAAAA;IACV,qBAAqB;;;;IAKrB,mBAAmB;;;;IAKnB,mBAAmB;;;;IAKnB,qBAAqB;;;;IAKrB,mBAAmB;;;IAInB,mBAAmB;;;IAInB,cAAc;;WA7BJA;;AAoCL,MAAMC,gBAA2C;IACtD,MAA+B,EAAE;IACjC,MAA0B,EAAE;IAC5B,MAAiC,EAAE;IAEnC,MAA8B,EAAE;IAChC,MAAoC,EAAE;IACtC,MAAiC,EAAE;IAEnC,MAAkC,EAAE;IACpC,MAAmC,EAAE;IACrC,MAAoC,EAAE;IAEtC,MAAyC,EAAE;IAC3C,MAAoC,EAAE;IACtC,MAAiC,EAAE;IAEnC,MAAyC,EAAE;IAC3C,MAAoC,EAAE;IAEtC,MAAyB,EAAE;IAC3B,MAA2B,EAAE;IAE7B,MAAyB,EAAE;AAC7B;AAQO,SAASC,gBAAgBE,IAAe;IAC7C,OAAOH,aAAa,CAACG,KAAK,IAAIH,aAAa,MAAyB;AACtE;AASO,SAASE,uBAAuBC,IAAe,EAAEC,OAAgB;IACtE,MAAMC,cAAcJ,gBAAgBE;IAEpC,IAAIC,SAAS;QACX,OAAO,GAAGC,YAAY,EAAE,EAAED,SAAS;IACrC;IAEA,cAAc;IACd,MAAME,cAAkD;QACtD,MAA+B,EAAE;QACjC,MAAoC,EAAE;QACtC,MAAoC,EAAE;IACxC;IAEA,MAAMC,aAAaD,WAAW,CAACH,KAAK;IACpC,IAAII,YAAY;QACd,OAAO,GAAGF,YAAY,MAAM,EAAEE,YAAY;IAC5C;IAEA,OAAOF;AACT"}

package/dist/utils/errors/ErrorCodes.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 错误码定义
+ * 提供统一的错误码和错误信息映射
+ */
+/**
+ * 错误码枚举
+ */
+export declare enum ErrorCode {
+    CONTAINER_NOT_FOUND = 1001,
+    STARTUP_FAILED = 1002,
+    INITIALIZATION_FAILED = 1003,
+    CONFIG_LOAD_FAILED = 2001,
+    CONFIG_VALIDATION_FAILED = 2002,
+    CONFIG_FILE_NOT_FOUND = 2003,
+    PLUGIN_REGISTER_FAILED = 3001,
+    PLUGIN_EXECUTION_FAILED = 3002,
+    PLUGIN_PERMISSION_DENIED = 3003,
+    STATE_MANAGER_NOT_INITIALIZED = 4001,
+    STATE_INSTANCE_NOT_FOUND = 4002,
+    STATE_SCOPE_NOT_FOUND = 4003,
+    STORAGE_INITIALIZATION_FAILED = 5001,
+    STORAGE_OPERATION_FAILED = 5002,
+    NETWORK_ERROR = 6001,
+    NETWORK_TIMEOUT = 6002,
+    UNKNOWN_ERROR = 9999
+}
+/**
+ * 错误信息映射
+ */
+export declare const ErrorMessages: Record<ErrorCode, string>;
+/**
+ * 获取错误信息
+ *
+ * @param code - 错误码
+ * @returns 错误信息
+ */
+export declare function getErrorMessage(code: ErrorCode): string;
+/**
+ * 获取用户友好的错误提示
+ *
+ * @param code - 错误码
+ * @param details - 详细信息
+ * @returns 用户友好的错误提示
+ */
+export declare function getUserFriendlyMessage(code: ErrorCode, details?: string): string;
+//# sourceMappingURL=ErrorCodes.d.ts.map

package/dist/utils/errors/ErrorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCodes.d.ts","sourceRoot":"","sources":["../../../src/utils/errors/ErrorCodes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,SAAS;IAEnB,mBAAmB,OAAO;IAC1B,cAAc,OAAO;IACrB,qBAAqB,OAAO;IAG5B,kBAAkB,OAAO;IACzB,wBAAwB,OAAO;IAC/B,qBAAqB,OAAO;IAG5B,sBAAsB,OAAO;IAC7B,uBAAuB,OAAO;IAC9B,wBAAwB,OAAO;IAG/B,6BAA6B,OAAO;IACpC,wBAAwB,OAAO;IAC/B,qBAAqB,OAAO;IAG5B,6BAA6B,OAAO;IACpC,wBAAwB,OAAO;IAG/B,aAAa,OAAO;IACpB,eAAe,OAAO;IAGtB,aAAa,OAAO;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAwBnD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBhF"}

package/dist/utils/errors/ErrorCodes.js

@@ -0,0 +1,86 @@
+/**
+ * 错误码定义
+ * 提供统一的错误码和错误信息映射
+ */ /**
+ * 错误码枚举
+ */ export var ErrorCode = /*#__PURE__*/ function(ErrorCode) {
+    // 框架启动错误 (1000-1999)
+    ErrorCode[ErrorCode["CONTAINER_NOT_FOUND"] = 1001] = "CONTAINER_NOT_FOUND";
+    ErrorCode[ErrorCode["STARTUP_FAILED"] = 1002] = "STARTUP_FAILED";
+    ErrorCode[ErrorCode["INITIALIZATION_FAILED"] = 1003] = "INITIALIZATION_FAILED";
+    // 配置错误 (2000-2999)
+    ErrorCode[ErrorCode["CONFIG_LOAD_FAILED"] = 2001] = "CONFIG_LOAD_FAILED";
+    ErrorCode[ErrorCode["CONFIG_VALIDATION_FAILED"] = 2002] = "CONFIG_VALIDATION_FAILED";
+    ErrorCode[ErrorCode["CONFIG_FILE_NOT_FOUND"] = 2003] = "CONFIG_FILE_NOT_FOUND";
+    // 插件错误 (3000-3999)
+    ErrorCode[ErrorCode["PLUGIN_REGISTER_FAILED"] = 3001] = "PLUGIN_REGISTER_FAILED";
+    ErrorCode[ErrorCode["PLUGIN_EXECUTION_FAILED"] = 3002] = "PLUGIN_EXECUTION_FAILED";
+    ErrorCode[ErrorCode["PLUGIN_PERMISSION_DENIED"] = 3003] = "PLUGIN_PERMISSION_DENIED";
+    // 状态管理错误 (4000-4999)
+    ErrorCode[ErrorCode["STATE_MANAGER_NOT_INITIALIZED"] = 4001] = "STATE_MANAGER_NOT_INITIALIZED";
+    ErrorCode[ErrorCode["STATE_INSTANCE_NOT_FOUND"] = 4002] = "STATE_INSTANCE_NOT_FOUND";
+    ErrorCode[ErrorCode["STATE_SCOPE_NOT_FOUND"] = 4003] = "STATE_SCOPE_NOT_FOUND";
+    // 存储错误 (5000-5999)
+    ErrorCode[ErrorCode["STORAGE_INITIALIZATION_FAILED"] = 5001] = "STORAGE_INITIALIZATION_FAILED";
+    ErrorCode[ErrorCode["STORAGE_OPERATION_FAILED"] = 5002] = "STORAGE_OPERATION_FAILED";
+    // 网络错误 (6000-6999)
+    ErrorCode[ErrorCode["NETWORK_ERROR"] = 6001] = "NETWORK_ERROR";
+    ErrorCode[ErrorCode["NETWORK_TIMEOUT"] = 6002] = "NETWORK_TIMEOUT";
+    // 未知错误 (9999)
+    ErrorCode[ErrorCode["UNKNOWN_ERROR"] = 9999] = "UNKNOWN_ERROR";
+    return ErrorCode;
+}({});
+/**
+ * 错误信息映射
+ */ export const ErrorMessages = {
+    [1001]: '未找到挂载容器，请确保页面中存在 id="root" 的元素或通过 container 选项指定容器',
+    [1002]: '框架启动失败',
+    [1003]: '初始化失败',
+    [2001]: '配置加载失败',
+    [2002]: '配置验证失败',
+    [2003]: '配置文件未找到',
+    [3001]: '插件注册失败',
+    [3002]: '插件执行失败',
+    [3003]: '插件权限不足',
+    [4001]: '状态管理器未初始化',
+    [4002]: '状态实例未找到',
+    [4003]: '状态作用域未找到',
+    [5001]: '存储初始化失败',
+    [5002]: '存储操作失败',
+    [6001]: '网络错误',
+    [6002]: '网络请求超时',
+    [9999]: '未知错误'
+};
+/**
+ * 获取错误信息
+ * 
+ * @param code - 错误码
+ * @returns 错误信息
+ */ export function getErrorMessage(code) {
+    return ErrorMessages[code] || ErrorMessages[9999];
+}
+/**
+ * 获取用户友好的错误提示
+ * 
+ * @param code - 错误码
+ * @param details - 详细信息
+ * @returns 用户友好的错误提示
+ */ export function getUserFriendlyMessage(code, details) {
+    const baseMessage = getErrorMessage(code);
+    if (details) {
+        return `${baseMessage}: ${details}`;
+    }
+    // 根据错误码提供修复建议
+    const suggestions = {
+        [1001]: '请检查HTML中是否存在id="root"的元素，或通过container选项指定容器',
+        [2002]: '请检查配置文件格式是否正确，参考文档进行配置',
+        [3003]: '请检查插件权限配置，确保插件有足够的权限'
+    };
+    const suggestion = suggestions[code];
+    if (suggestion) {
+        return `${baseMessage}\n建议: ${suggestion}`;
+    }
+    return baseMessage;
+}
+
+//# sourceMappingURL=ErrorCodes.js.map

package/dist/utils/errors/ErrorCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/errors/ErrorCodes.ts"],"sourcesContent":["/**\n * 错误码定义\n * 提供统一的错误码和错误信息映射\n */\n\n/**\n * 错误码枚举\n */\nexport enum ErrorCode {\n  // 框架启动错误 (1000-1999)\n  CONTAINER_NOT_FOUND = 1001,\n  STARTUP_FAILED = 1002,\n  INITIALIZATION_FAILED = 1003,\n\n  // 配置错误 (2000-2999)\n  CONFIG_LOAD_FAILED = 2001,\n  CONFIG_VALIDATION_FAILED = 2002,\n  CONFIG_FILE_NOT_FOUND = 2003,\n\n  // 插件错误 (3000-3999)\n  PLUGIN_REGISTER_FAILED = 3001,\n  PLUGIN_EXECUTION_FAILED = 3002,\n  PLUGIN_PERMISSION_DENIED = 3003,\n\n  // 状态管理错误 (4000-4999)\n  STATE_MANAGER_NOT_INITIALIZED = 4001,\n  STATE_INSTANCE_NOT_FOUND = 4002,\n  STATE_SCOPE_NOT_FOUND = 4003,\n\n  // 存储错误 (5000-5999)\n  STORAGE_INITIALIZATION_FAILED = 5001,\n  STORAGE_OPERATION_FAILED = 5002,\n\n  // 网络错误 (6000-6999)\n  NETWORK_ERROR = 6001,\n  NETWORK_TIMEOUT = 6002,\n\n  // 未知错误 (9999)\n  UNKNOWN_ERROR = 9999,\n}\n\n/**\n * 错误信息映射\n */\nexport const ErrorMessages: Record<ErrorCode, string> = {\n  [ErrorCode.CONTAINER_NOT_FOUND]: '未找到挂载容器，请确保页面中存在 id=\"root\" 的元素或通过 container 选项指定容器',\n  [ErrorCode.STARTUP_FAILED]: '框架启动失败',\n  [ErrorCode.INITIALIZATION_FAILED]: '初始化失败',\n\n  [ErrorCode.CONFIG_LOAD_FAILED]: '配置加载失败',\n  [ErrorCode.CONFIG_VALIDATION_FAILED]: '配置验证失败',\n  [ErrorCode.CONFIG_FILE_NOT_FOUND]: '配置文件未找到',\n\n  [ErrorCode.PLUGIN_REGISTER_FAILED]: '插件注册失败',\n  [ErrorCode.PLUGIN_EXECUTION_FAILED]: '插件执行失败',\n  [ErrorCode.PLUGIN_PERMISSION_DENIED]: '插件权限不足',\n\n  [ErrorCode.STATE_MANAGER_NOT_INITIALIZED]: '状态管理器未初始化',\n  [ErrorCode.STATE_INSTANCE_NOT_FOUND]: '状态实例未找到',\n  [ErrorCode.STATE_SCOPE_NOT_FOUND]: '状态作用域未找到',\n\n  [ErrorCode.STORAGE_INITIALIZATION_FAILED]: '存储初始化失败',\n  [ErrorCode.STORAGE_OPERATION_FAILED]: '存储操作失败',\n\n  [ErrorCode.NETWORK_ERROR]: '网络错误',\n  [ErrorCode.NETWORK_TIMEOUT]: '网络请求超时',\n\n  [ErrorCode.UNKNOWN_ERROR]: '未知错误',\n};\n\n/**\n * 获取错误信息\n * \n * @param code - 错误码\n * @returns 错误信息\n */\nexport function getErrorMessage(code: ErrorCode): string {\n  return ErrorMessages[code] || ErrorMessages[ErrorCode.UNKNOWN_ERROR];\n}\n\n/**\n * 获取用户友好的错误提示\n * \n * @param code - 错误码\n * @param details - 详细信息\n * @returns 用户友好的错误提示\n */\nexport function getUserFriendlyMessage(code: ErrorCode, details?: string): string {\n  const baseMessage = getErrorMessage(code);\n  \n  if (details) {\n    return `${baseMessage}: ${details}`;\n  }\n\n  // 根据错误码提供修复建议\n  const suggestions: Partial<Record<ErrorCode, string>> = {\n    [ErrorCode.CONTAINER_NOT_FOUND]: '请检查HTML中是否存在id=\"root\"的元素，或通过container选项指定容器',\n    [ErrorCode.CONFIG_VALIDATION_FAILED]: '请检查配置文件格式是否正确，参考文档进行配置',\n    [ErrorCode.PLUGIN_PERMISSION_DENIED]: '请检查插件权限配置，确保插件有足够的权限',\n  };\n\n  const suggestion = suggestions[code];\n  if (suggestion) {\n    return `${baseMessage}\\n建议: ${suggestion}`;\n  }\n\n  return baseMessage;\n}\n"],"names":["ErrorCode","ErrorMessages","getErrorMessage","code","getUserFriendlyMessage","details","baseMessage","suggestions","suggestion"],"mappings":"AAAA;;;CAGC,GAED;;CAEC,GACD,OAAO,IAAA,AAAKA,mCAAAA;IACV,qBAAqB;;;;IAKrB,mBAAmB;;;;IAKnB,mBAAmB;;;;IAKnB,qBAAqB;;;;IAKrB,mBAAmB;;;IAInB,mBAAmB;;;IAInB,cAAc;;WA7BJA;MA+BX;AAED;;CAEC,GACD,OAAO,MAAMC,gBAA2C;IACtD,MAA+B,EAAE;IACjC,MAA0B,EAAE;IAC5B,MAAiC,EAAE;IAEnC,MAA8B,EAAE;IAChC,MAAoC,EAAE;IACtC,MAAiC,EAAE;IAEnC,MAAkC,EAAE;IACpC,MAAmC,EAAE;IACrC,MAAoC,EAAE;IAEtC,MAAyC,EAAE;IAC3C,MAAoC,EAAE;IACtC,MAAiC,EAAE;IAEnC,MAAyC,EAAE;IAC3C,MAAoC,EAAE;IAEtC,MAAyB,EAAE;IAC3B,MAA2B,EAAE;IAE7B,MAAyB,EAAE;AAC7B,EAAE;AAEF;;;;;CAKC,GACD,OAAO,SAASC,gBAAgBC,IAAe;IAC7C,OAAOF,aAAa,CAACE,KAAK,IAAIF,aAAa,MAAyB;AACtE;AAEA;;;;;;CAMC,GACD,OAAO,SAASG,uBAAuBD,IAAe,EAAEE,OAAgB;IACtE,MAAMC,cAAcJ,gBAAgBC;IAEpC,IAAIE,SAAS;QACX,OAAO,GAAGC,YAAY,EAAE,EAAED,SAAS;IACrC;IAEA,cAAc;IACd,MAAME,cAAkD;QACtD,MAA+B,EAAE;QACjC,MAAoC,EAAE;QACtC,MAAoC,EAAE;IACxC;IAEA,MAAMC,aAAaD,WAAW,CAACJ,KAAK;IACpC,IAAIK,YAAY;QACd,OAAO,GAAGF,YAAY,MAAM,EAAEE,YAAY;IAC5C;IAEA,OAAOF;AACT"}