@gct-paas/core 0.1.4-dev.0 → 0.1.4-dev.10

package/es/modules/error-handler/error-handler.const.mjs

@@ -0,0 +1,18 @@
+const HTTP_STATUS_CODE = {
+  /** 未授权 */
+  UNAUTHORIZED: 401,
+  /** 禁止访问 */
+  FORBIDDEN: 403,
+  /** 资源未找到 */
+  NOT_FOUND: 404,
+  /** 内部服务器错误 */
+  INTERNAL_SERVER_ERROR: 500,
+  /** 网关错误 */
+  BAD_GATEWAY: 502,
+  /** 服务不可用 */
+  SERVICE_UNAVAILABLE: 503,
+  /** 网关超时 */
+  GATEWAY_TIMEOUT: 504
+};
+
+export { HTTP_STATUS_CODE };

package/es/modules/error-handler/error-handler.interface.d.ts

@@ -0,0 +1,51 @@
+import { ErrorTypeEnum } from '../../enums/exceptionEnum';
+/**
+ * 错误详细信息接口
+ * 定义了错误处理系统中基础错误信息的结构
+ *
+ * @interface IErrorInfo
+ */
+export interface IErrorInfo {
+    /** 错误类型 */
+    type: ErrorTypeEnum;
+    /** 错误消息 */
+    message: string;
+    /** 错误堆栈信息 */
+    stack?: string;
+    /** 错误发生的时间戳 */
+    timestamp: number;
+    /** 用户代理信息 */
+    userAgent?: string;
+}
+/**
+ * HTTP 错误信息接口
+ * 扩展基础错误信息，增加 HTTP 请求相关的错误详情
+ *
+ * @interface IHttpErrorInfo
+ */
+export interface IHttpErrorInfo extends IErrorInfo {
+    /** HTTP 状态码 */
+    status?: number;
+    /** HTTP 状态文本 */
+    statusText?: string;
+    /** 请求 URL */
+    requestUrl?: string;
+    /** 请求方法 */
+    requestMethod?: string;
+    /** 响应数据 */
+    responseData?: unknown;
+}
+/**
+ * 错误处理策略接口
+ * 定义不同类型错误的处理策略
+ *
+ * @interface IErrorHandlerStrategy
+ */
+export interface IErrorHandlerStrategy {
+    /**
+     * 处理错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+}

package/es/modules/error-handler/error-strategy.d.ts

@@ -0,0 +1,138 @@
+import { IErrorInfo, IErrorHandlerStrategy } from './error-handler.interface';
+import { ErrorTypeEnum } from '../../enums/exceptionEnum';
+/**
+ * JavaScript 错误处理策略
+ * 负责处理 JavaScript 运行时错误
+ *
+ * @export
+ * @class JavaScriptErrorStrategy
+ * @implements {IErrorHandlerStrategy}
+ */
+export declare class JavaScriptErrorStrategy implements IErrorHandlerStrategy {
+    /**
+     * 处理 JavaScript 错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+}
+/**
+ * Vue 组件错误处理策略
+ * 负责处理 Vue 组件相关错误
+ *
+ * @export
+ * @class VueErrorStrategy
+ * @implements {IErrorHandlerStrategy}
+ */
+export declare class VueErrorStrategy implements IErrorHandlerStrategy {
+    /**
+     * 处理 Vue 组件错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+}
+/**
+ * Promise 错误处理策略
+ * 负责处理未捕获的 Promise 异常，包括 HTTP 请求错误
+ *
+ * @export
+ * @class PromiseErrorStrategy
+ * @implements {IErrorHandlerStrategy}
+ */
+export declare class PromiseErrorStrategy implements IErrorHandlerStrategy {
+    /**
+     * 处理 Promise 错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+}
+/**
+ * HTTP 错误处理策略
+ * 负责处理 HTTP 请求相关错误，包括网络错误和业务错误
+ *
+ * @export
+ * @class HttpErrorStrategy
+ * @implements {IErrorHandlerStrategy}
+ */
+export declare class HttpErrorStrategy implements IErrorHandlerStrategy {
+    /**
+     * 处理 HTTP 错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+    /**
+     * 从错误消息中提取 HTTP 状态码
+     *
+     * @private
+     * @param {string} message 错误消息
+     * @return {number | null} HTTP 状态码，如果没有找到则返回 null
+     */
+    private _extractStatusCode;
+    /**
+     * 处理通用 HTTP 错误
+     *
+     * @private
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    private _handleGenericHttpError;
+    /**
+     * 处理未授权错误
+     *
+     * @private
+     */
+    private _handleUnauthorized;
+    /**
+     * 处理禁止访问错误
+     *
+     * @private
+     */
+    private _handleForbidden;
+    /**
+     * 处理资源未找到错误
+     *
+     * @private
+     */
+    private _handleNotFound;
+    /**
+     * 处理服务器错误
+     *
+     * @private
+     * @param {number} [status] HTTP 状态码
+     */
+    private _handleServerError;
+}
+/**
+ * 错误处理策略工厂
+ * 负责根据错误类型创建对应的处理策略
+ *
+ * @export
+ * @class ErrorStrategyFactory
+ */
+export declare class ErrorStrategyFactory {
+    private static _strategies;
+    /**
+     * 初始化策略工厂
+     *
+     * @static
+     */
+    static init(): void;
+    /**
+     * 获取错误处理策略
+     *
+     * @static
+     * @param {ErrorTypeEnum} type 错误类型
+     * @return {IErrorHandlerStrategy | undefined} 错误处理策略
+     */
+    static getStrategy(type: ErrorTypeEnum): IErrorHandlerStrategy | undefined;
+    /**
+     * 注册自定义错误处理策略
+     *
+     * @static
+     * @param {ErrorTypeEnum} type 错误类型
+     * @param {IErrorHandlerStrategy} strategy 错误处理策略
+     */
+    static registerStrategy(type: ErrorTypeEnum, strategy: IErrorHandlerStrategy): void;
+}

package/es/modules/error-handler/error-strategy.mjs

@@ -0,0 +1,175 @@
+import { HTTP_STATUS_CODE } from './error-handler.const.mjs';
+import { ErrorTypeEnum } from '../../enums/exceptionEnum.mjs';
+
+class JavaScriptErrorStrategy {
+  /**
+   * 处理 JavaScript 错误
+   *
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  handle(errorInfo) {
+    console.error(errorInfo);
+  }
+}
+class VueErrorStrategy {
+  /**
+   * 处理 Vue 组件错误
+   *
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  handle(errorInfo) {
+    console.error(errorInfo);
+  }
+}
+class PromiseErrorStrategy {
+  /**
+   * 处理 Promise 错误
+   *
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  handle(errorInfo) {
+    if (errorInfo.type === ErrorTypeEnum.AJAX) {
+      const httpStrategy = new HttpErrorStrategy();
+      httpStrategy.handle(errorInfo);
+      return;
+    }
+    console.error(errorInfo);
+  }
+}
+class HttpErrorStrategy {
+  /**
+   * 处理 HTTP 错误
+   *
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  handle(errorInfo) {
+    const status = this._extractStatusCode(errorInfo.message);
+    if (status) {
+      switch (status) {
+        case HTTP_STATUS_CODE.UNAUTHORIZED:
+          this._handleUnauthorized();
+          break;
+        case HTTP_STATUS_CODE.FORBIDDEN:
+          this._handleForbidden();
+          break;
+        case HTTP_STATUS_CODE.NOT_FOUND:
+          this._handleNotFound();
+          break;
+        case HTTP_STATUS_CODE.INTERNAL_SERVER_ERROR:
+        case HTTP_STATUS_CODE.BAD_GATEWAY:
+        case HTTP_STATUS_CODE.SERVICE_UNAVAILABLE:
+        case HTTP_STATUS_CODE.GATEWAY_TIMEOUT:
+          this._handleServerError(status);
+          break;
+        default:
+          this._handleGenericHttpError(errorInfo);
+          break;
+      }
+    } else {
+      this._handleGenericHttpError(errorInfo);
+    }
+  }
+  /**
+   * 从错误消息中提取 HTTP 状态码
+   *
+   * @private
+   * @param {string} message 错误消息
+   * @return {number | null} HTTP 状态码，如果没有找到则返回 null
+   */
+  _extractStatusCode(message) {
+    const statusMatch = message.match(
+      /HTTP\s+(\d{3})|Business\s+Error\s+\[(\d+)\]/
+    );
+    if (statusMatch) {
+      return parseInt(
+        statusMatch[1] || statusMatch[2],
+        10
+      );
+    }
+    return null;
+  }
+  /**
+   * 处理通用 HTTP 错误
+   *
+   * @private
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  _handleGenericHttpError(errorInfo) {
+    if (errorInfo.message.includes("Business Error")) {
+      console.debug("Handling business error:", errorInfo.message);
+    } else if (errorInfo.message.includes("Network")) {
+      console.debug("Handling network error:", errorInfo.message);
+    } else {
+      console.debug("Handling HTTP error:", errorInfo.message);
+    }
+  }
+  /**
+   * 处理未授权错误
+   *
+   * @private
+   */
+  _handleUnauthorized() {
+    console.warn("Unauthorized access, redirecting to login...");
+  }
+  /**
+   * 处理禁止访问错误
+   *
+   * @private
+   */
+  _handleForbidden() {
+    console.warn("Access forbidden");
+  }
+  /**
+   * 处理资源未找到错误
+   *
+   * @private
+   */
+  _handleNotFound() {
+    console.warn("Resource not found");
+  }
+  /**
+   * 处理服务器错误
+   *
+   * @private
+   * @param {number} [status] HTTP 状态码
+   */
+  _handleServerError(status) {
+    console.warn(`Server error: ${status}`);
+  }
+}
+class ErrorStrategyFactory {
+  static _strategies = /* @__PURE__ */ new Map();
+  /**
+   * 初始化策略工厂
+   *
+   * @static
+   */
+  static init() {
+    this.registerStrategy(ErrorTypeEnum.SCRIPT, new JavaScriptErrorStrategy());
+    this.registerStrategy(ErrorTypeEnum.VUE, new VueErrorStrategy());
+    this.registerStrategy(ErrorTypeEnum.PROMISE, new PromiseErrorStrategy());
+    this.registerStrategy(ErrorTypeEnum.AJAX, new HttpErrorStrategy());
+  }
+  /**
+   * 获取错误处理策略
+   *
+   * @static
+   * @param {ErrorTypeEnum} type 错误类型
+   * @return {IErrorHandlerStrategy | undefined} 错误处理策略
+   */
+  static getStrategy(type) {
+    return this._strategies.get(type);
+  }
+  /**
+   * 注册自定义错误处理策略
+   *
+   * @static
+   * @param {ErrorTypeEnum} type 错误类型
+   * @param {IErrorHandlerStrategy} strategy 错误处理策略
+   */
+  static registerStrategy(type, strategy) {
+    this._strategies.set(type, strategy);
+  }
+}
+
+export { ErrorStrategyFactory, HttpErrorStrategy, JavaScriptErrorStrategy, PromiseErrorStrategy, VueErrorStrategy };

package/es/modules/error-handler/index.d.ts

@@ -0,0 +1,78 @@
+import { IErrorInfo } from './error-handler.interface';
+import { ErrorTypeEnum } from '../../enums/exceptionEnum';
+import { App } from 'vue';
+/**
+ * 全局异常处理器
+ * 负责捕获和处理各种类型的异常，包括 Vue 组件异常、JavaScript 异常、
+ * 资源加载异常、Ajax 请求异常、Promise 异常等
+ *
+ * 采用策略模式和单例模式设计，支持扩展和配置
+ *
+ * @export
+ * @class ErrorHandler
+ */
+export declare class ErrorHandler {
+    private static _instance;
+    /**
+     * 私有构造函数，实现单例模式
+     *
+     * @private
+     */
+    private constructor();
+    /**
+     * 获取单例实例
+     *
+     * @static
+     * @return {ErrorHandler} 错误处理器实例
+     */
+    static getInstance(): ErrorHandler;
+    /**
+     * 初始化全局异常处理
+     * 设置全局异常监听器和处理策略
+     *
+     * @static
+     */
+    static init(): void;
+    /**
+     * 处理 Vue 组件异常
+     *
+     * @static
+     * @param {Error} error 错误对象
+     * @param {unknown} _vm Vue 组件实例
+     * @param {string} info 错误信息
+     */
+    static handleVueError(error: Error, _vm: unknown, info: string): void;
+    /**
+     * 手动报告错误
+     *
+     * @static
+     * @param {Error} error 错误对象
+     * @param {ErrorTypeEnum} [type=ErrorTypeEnum.SCRIPT] 错误类型
+     */
+    static reportError(error: Error, type?: ErrorTypeEnum): void;
+    /**
+     * 初始化错误处理策略
+     *
+     * @private
+     */
+    private _initializeStrategies;
+    /**
+     * 处理错误信息
+     *
+     * @private
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    private _processError;
+}
+/**
+ * 设置全局错误处理器
+ *
+ * @author chitanda
+ * @date 2025-08-20 13:08:23
+ * @export
+ * @param {App} app
+ * @returns {*}  {Promise<void>}
+ */
+export declare function setupErrorHandler(app: App): Promise<void>;
+export type { IErrorInfo };
+export { ErrorStrategyFactory } from './error-strategy';

package/es/modules/error-handler/index.mjs

@@ -0,0 +1,108 @@
+import { ErrorStrategyFactory } from './error-strategy.mjs';
+import { ErrorTypeEnum } from '../../enums/exceptionEnum.mjs';
+
+class ErrorHandler {
+  static _instance;
+  /**
+   * 私有构造函数，实现单例模式
+   *
+   * @private
+   */
+  constructor() {
+    this._initializeStrategies();
+  }
+  /**
+   * 获取单例实例
+   *
+   * @static
+   * @return {ErrorHandler} 错误处理器实例
+   */
+  static getInstance() {
+    if (!ErrorHandler._instance) {
+      ErrorHandler._instance = new ErrorHandler();
+    }
+    return ErrorHandler._instance;
+  }
+  /**
+   * 初始化全局异常处理
+   * 设置全局异常监听器和处理策略
+   *
+   * @static
+   */
+  static init() {
+    ErrorHandler.getInstance();
+  }
+  /**
+   * 处理 Vue 组件异常
+   *
+   * @static
+   * @param {Error} error 错误对象
+   * @param {unknown} _vm Vue 组件实例
+   * @param {string} info 错误信息
+   */
+  static handleVueError(error, _vm, info) {
+    const errorInfo = {
+      type: ErrorTypeEnum.VUE,
+      message: `Vue Error: ${error.message} | Info: ${info}`,
+      stack: error.stack,
+      timestamp: Date.now(),
+      userAgent: navigator.userAgent
+    };
+    this._instance._processError(errorInfo);
+  }
+  /**
+   * 手动报告错误
+   *
+   * @static
+   * @param {Error} error 错误对象
+   * @param {ErrorTypeEnum} [type=ErrorTypeEnum.SCRIPT] 错误类型
+   */
+  static reportError(error, type = ErrorTypeEnum.SCRIPT) {
+    const errorInfo = {
+      type,
+      message: error.message,
+      stack: error.stack,
+      timestamp: Date.now(),
+      userAgent: navigator.userAgent
+    };
+    this._instance._processError(errorInfo);
+  }
+  /**
+   * 初始化错误处理策略
+   *
+   * @private
+   */
+  _initializeStrategies() {
+    ErrorStrategyFactory.init();
+  }
+  /**
+   * 处理错误信息
+   *
+   * @private
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  _processError(errorInfo) {
+    const strategy = ErrorStrategyFactory.getStrategy(errorInfo.type);
+    strategy?.handle(errorInfo);
+  }
+}
+async function setupErrorHandler(app) {
+  ErrorHandler.init();
+  app.config.errorHandler = (error, vm, info) => {
+    ErrorHandler.handleVueError(error, vm, info);
+  };
+  app.config.warnHandler = (msg, _vm, trace) => {
+    console.warn(`Vue Warning: ${msg}`);
+    if (trace) {
+      console.warn("Trace:", trace);
+    }
+  };
+  window.addEventListener("error", (event) => {
+    ErrorHandler.reportError(new Error(event.message), ErrorTypeEnum.SCRIPT);
+  });
+  window.addEventListener("unhandledrejection", (event) => {
+    ErrorHandler.reportError(event.reason, ErrorTypeEnum.PROMISE);
+  });
+}
+
+export { ErrorHandler, ErrorStrategyFactory, setupErrorHandler };

package/es/modules/platform-config/constants/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 常量导出模块
+ */
+export * from './login.const';
+export * from './org.const';
+export * from './theme.const';
+export * from './watermark.const';

package/es/modules/platform-config/constants/login.const.d.ts

@@ -0,0 +1,15 @@
+import { LoginTypeEnum } from '../enums/login.enum';
+/** 系统登录方式的 key 数组 */
+export declare const SYSTEM_LOGIN_KEYS: LoginTypeEnum[];
+/** 第三方登录方式的 key 数组 */
+export declare const OTHER_LOGIN_KEYS: LoginTypeEnum[];
+/**
+ * 根据登录类型 key 获取登录选项配置
+ * @param keys - 登录类型 key 数组
+ * @returns 包含登录选项信息的数组
+ */
+export declare const getLoginTypeOptions: (keys: string[]) => {
+    id: string;
+    label: string;
+    value: string;
+}[];

package/es/modules/platform-config/constants/login.const.mjs

@@ -0,0 +1,50 @@
+import { LoginTypeEnum } from '../enums/login.enum.mjs';
+
+const LOGIN_TYPE_INFO = {
+  [LoginTypeEnum.ACCOUNT]: {
+    icon: "icon-a-Accountnumber",
+    color: "#0E81EC"
+  },
+  [LoginTypeEnum.DOMAIN_ACCOUNT]: {
+    icon: "icon-a-Domainaccount",
+    color: "#FFAB06"
+  },
+  [LoginTypeEnum.MOBILE]: {
+    icon: "icon-a-Cellphone",
+    color: "#6A70FE"
+  },
+  [LoginTypeEnum.DINGDING]: {
+    icon: "DingdingIcon"
+  },
+  [LoginTypeEnum.FEISHU]: {
+    icon: "FeishuIcon"
+  },
+  [LoginTypeEnum.QIYEWEIXIN]: {
+    icon: "QiyeweixinIcon"
+  }
+};
+const SYSTEM_LOGIN_KEYS = [
+  LoginTypeEnum.ACCOUNT,
+  LoginTypeEnum.DOMAIN_ACCOUNT,
+  LoginTypeEnum.MOBILE
+];
+const OTHER_LOGIN_KEYS = [
+  LoginTypeEnum.DINGDING,
+  LoginTypeEnum.FEISHU,
+  LoginTypeEnum.QIYEWEIXIN
+];
+const getLoginTypeOptions = (keys) => {
+  if (!keys) {
+    return [];
+  }
+  return keys.map((key) => {
+    return {
+      id: key,
+      label: key,
+      value: key,
+      ...LOGIN_TYPE_INFO[key]
+    };
+  });
+};
+
+export { OTHER_LOGIN_KEYS, SYSTEM_LOGIN_KEYS, getLoginTypeOptions };

package/es/modules/platform-config/constants/org.const.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 组织相关常量定义
+ */
+/** 关联字段配置列表 */
+export declare const RELATION_FIELDS: {
+    label: string;
+    value: string;
+    type: number;
+}[];

package/es/modules/platform-config/constants/org.const.mjs

@@ -0,0 +1,54 @@
+const RELATION_FIELDS = [
+  {
+    label: "extString0_",
+    value: "ext0",
+    type: 1
+  },
+  {
+    label: "extString1_",
+    value: "ext1",
+    type: 1
+  },
+  {
+    label: "extString2_",
+    value: "ext2",
+    type: 1
+  },
+  {
+    label: "extString3_",
+    value: "ext3",
+    type: 1
+  },
+  {
+    label: "extString4_",
+    value: "ext4",
+    type: 1
+  },
+  {
+    label: "extInt5_",
+    value: "ext5",
+    type: 0
+  },
+  {
+    label: "extInt6_",
+    value: "ext6",
+    type: 0
+  },
+  {
+    label: "extInt7_",
+    value: "ext7",
+    type: 0
+  },
+  {
+    label: "extInt8_",
+    value: "ext8",
+    type: 0
+  },
+  {
+    label: "extInt9_",
+    value: "ext9",
+    type: 0
+  }
+];
+
+export { RELATION_FIELDS };