@gct-paas/core 0.1.4-dev.11 → 0.1.4-dev.13

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.mjs

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

package/es/modules/mqtt/enums/mqtt-status.enum.mjs

@@ -1,10 +1,24 @@
-var MqttConnectionStatus = /* @__PURE__ */ ((MqttConnectionStatus2) => {
-  MqttConnectionStatus2["CONNECTING"] = "connecting";
-  MqttConnectionStatus2["CONNECTED"] = "connected";
-  MqttConnectionStatus2["DISCONNECTING"] = "disconnecting";
-  MqttConnectionStatus2["DISCONNECTED"] = "disconnected";
-  MqttConnectionStatus2["RECONNECTING"] = "reconnecting";
-  return MqttConnectionStatus2;
-})(MqttConnectionStatus || {});
-
+//#region src/modules/mqtt/enums/mqtt-status.enum.ts
+/**
+* MQTT 连接状态枚举
+*
+* @description 描述 MQTT 客户端当前的连接生命周期状态
+*
+* @export
+* @enum {string}
+*/
+var MqttConnectionStatus = /* @__PURE__ */ function(MqttConnectionStatus) {
+	/** 正在连接中 */
+	MqttConnectionStatus["CONNECTING"] = "connecting";
+	/** 已成功连接 */
+	MqttConnectionStatus["CONNECTED"] = "connected";
+	/** 正在断开连接中 */
+	MqttConnectionStatus["DISCONNECTING"] = "disconnecting";
+	/** 已断开连接 */
+	MqttConnectionStatus["DISCONNECTED"] = "disconnected";
+	/** 正在重连中 */
+	MqttConnectionStatus["RECONNECTING"] = "reconnecting";
+	return MqttConnectionStatus;
+}({});
+//#endregion
 export { MqttConnectionStatus };

package/es/modules/mqtt/index.mjs

@@ -0,0 +1,4 @@
+import "./constants/mqtt.const.mjs";
+import "./enums/mqtt-status.enum.mjs";
+import "./mqtt-client.mjs";
+import "./mqtt-manager.mjs";