@gct-paas/core 0.1.4-dev.9 → 0.1.5-dev.0

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

@@ -1,175 +1,199 @@
-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 };
+import { ErrorTypeEnum } from "../../enums/exceptionEnum.mjs";
+import { HTTP_STATUS_CODE } from "./error-handler.const.mjs";
+//#region src/modules/error-handler/error-strategy.ts
+/**
+* JavaScript 错误处理策略
+* 负责处理 JavaScript 运行时错误
+*
+* @export
+* @class JavaScriptErrorStrategy
+* @implements {IErrorHandlerStrategy}
+*/
+var JavaScriptErrorStrategy = class {
+	/**
+	* 处理 JavaScript 错误
+	*
+	* @param {IErrorInfo} errorInfo 错误信息
+	*/
+	handle(errorInfo) {
+		console.error(errorInfo);
+	}
+};
+/**
+* Vue 组件错误处理策略
+* 负责处理 Vue 组件相关错误
+*
+* @export
+* @class VueErrorStrategy
+* @implements {IErrorHandlerStrategy}
+*/
+var VueErrorStrategy = class {
+	/**
+	* 处理 Vue 组件错误
+	*
+	* @param {IErrorInfo} errorInfo 错误信息
+	*/
+	handle(errorInfo) {
+		console.error(errorInfo);
+	}
+};
+/**
+* Promise 错误处理策略
+* 负责处理未捕获的 Promise 异常，包括 HTTP 请求错误
+*
+* @export
+* @class PromiseErrorStrategy
+* @implements {IErrorHandlerStrategy}
+*/
+var PromiseErrorStrategy = class {
+	/**
+	* 处理 Promise 错误
+	*
+	* @param {IErrorInfo} errorInfo 错误信息
+	*/
+	handle(errorInfo) {
+		if (errorInfo.type === ErrorTypeEnum.AJAX) {
+			new HttpErrorStrategy().handle(errorInfo);
+			return;
+		}
+		console.error(errorInfo);
+	}
+};
+/**
+* HTTP 错误处理策略
+* 负责处理 HTTP 请求相关错误，包括网络错误和业务错误
+*
+* @export
+* @class HttpErrorStrategy
+* @implements {IErrorHandlerStrategy}
+*/
+var HttpErrorStrategy = class {
+	/**
+	* 处理 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}`);
+	}
+};
+/**
+* 错误处理策略工厂
+* 负责根据错误类型创建对应的处理策略
+*
+* @export
+* @class ErrorStrategyFactory
+*/
+var ErrorStrategyFactory = class {
+	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);
+	}
+};
+//#endregion
+export { ErrorStrategyFactory };

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

@@ -1,108 +1,122 @@
-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);
-  }
-}
+import { ErrorTypeEnum } from "../../enums/exceptionEnum.mjs";
+import { ErrorStrategyFactory } from "./error-strategy.mjs";
+//#region src/modules/error-handler/index.ts
+/**
+* 全局异常处理器
+* 负责捕获和处理各种类型的异常，包括 Vue 组件异常、JavaScript 异常、
+* 资源加载异常、Ajax 请求异常、Promise 异常等
+*
+* 采用策略模式和单例模式设计，支持扩展和配置
+*
+* @export
+* @class ErrorHandler
+*/
+var ErrorHandler = 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) {
+		ErrorStrategyFactory.getStrategy(errorInfo.type)?.handle(errorInfo);
+	}
+};
+/**
+* 设置全局错误处理器
+*
+* @author chitanda
+* @date 2025-08-20 13:08:23
+* @export
+* @param {App} app
+* @returns {*}  {Promise<void>}
+*/
 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);
-  });
+	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 };
+//#endregion
+export { ErrorHandler, setupErrorHandler };

package/es/modules/mqtt/constants/mqtt.const.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MQTT 默认连接选项
+ *
+ * @description 连接时未显式指定的选项将使用以下默认值
+ */
+export declare const MQTT_DEFAULT_CONNECT_OPTIONS: {
+    /** 心跳保活间隔（秒），0 表示禁用 */
+    readonly keepalive: 60;
+    /** 连接超时时间（毫秒） */
+    readonly connectTimeout: 30000;
+    /**
+     * 重连间隔（毫秒），由 mqtt.js 内置重连机制使用
+     * 设为 0 可禁用自动重连
+     */
+    readonly reconnectPeriod: 5000;
+    /** 是否清除会话，true 表示每次重连后订阅信息不保留 */
+    readonly clean: false;
+};
+/**
+ * MQTT 连接级事件名称常量
+ */
+export declare const MQTT_CLIENT_EVENT: {
+    /** 成功建立连接 */
+    readonly CONNECT: "connect";
+    /** 重连中 */
+    readonly RECONNECT: "reconnect";
+    /** 连接已断开 */
+    readonly DISCONNECT: "disconnect";
+    /** 发生错误 */
+    readonly ERROR: "error";
+    /** 收到消息 */
+    readonly MESSAGE: "message";
+};

package/es/modules/mqtt/constants/mqtt.const.mjs

@@ -0,0 +1,24 @@
+//#region src/modules/mqtt/constants/mqtt.const.ts
+/**
+* MQTT 默认连接选项
+*
+* @description 连接时未显式指定的选项将使用以下默认值
+*/
+var MQTT_DEFAULT_CONNECT_OPTIONS = {
+	keepalive: 60,
+	connectTimeout: 3e4,
+	reconnectPeriod: 5e3,
+	clean: false
+};
+/**
+* MQTT 连接级事件名称常量
+*/
+var MQTT_CLIENT_EVENT = {
+	CONNECT: "connect",
+	RECONNECT: "reconnect",
+	DISCONNECT: "disconnect",
+	ERROR: "error",
+	MESSAGE: "message"
+};
+//#endregion
+export { MQTT_CLIENT_EVENT, MQTT_DEFAULT_CONNECT_OPTIONS };