@ray-js/robot-data-stream 0.0.17-beta.5 → 0.0.17-beta.6

package/lib/mqtt/hooks/useStructuredMessage.d.ts

@@ -1,3 +1,4 @@
+import { MqttError } from '../promise';
 import { BaseResponse } from '../type/protocols/base';
 /**
  * 统一的 MQTT 消息发送 Hook
@@ -9,4 +10,4 @@ export declare const useStructuredMessage: () => {
 /**
  * 错误处理工具函数
  */
-export declare const handleMqttError: (error: unknown, defaultMessage: string) => Error;
+export declare const handleMqttError: (error: unknown, defaultMessage: string) => MqttError;

package/lib/mqtt/hooks/useStructuredMessage.js

@@ -5,7 +5,7 @@ import { useCallback, useEffect, useRef } from 'react';
 import { getBitValue, logger } from '../../utils';
 import { createSetCommonParams } from '../createCommonOptions';
 import { useMqtt } from '../mqttProvider';
-import { normalResolve } from '../promise';
+import { MqttError, normalResolve } from '../promise';
 // 常量定义
 const COMMUNICATION_CHANNELS = {
   MQTT: 'mqtt',
@@ -196,11 +196,18 @@ export const useStructuredMessage = () => {
  * 错误处理工具函数
  */
 export const handleMqttError = (error, defaultMessage) => {
-  if (error instanceof Error) {
+  var _errCode, _reqType;
+  // 已是本库错误则直接透传
+  if (error instanceof MqttError) {
     return error;
   }
-  if (typeof error === 'string') {
-    return new Error(error);
-  }
-  return new Error(defaultMessage);
+
+  // 统一包装为 MqttError，打上标记，便于全局 unhandledrejection 兜底时识别为本库错误
+  const message = error instanceof Error ? error.message : typeof error === 'string' ? error : defaultMessage;
+  const errCode = (_errCode = error === null || error === void 0 ? void 0 : error.errCode) !== null && _errCode !== void 0 ? _errCode : -1;
+  const reqType = (_reqType = error === null || error === void 0 ? void 0 : error.reqType) !== null && _reqType !== void 0 ? _reqType : '';
+  return new MqttError(message, {
+    errCode,
+    reqType
+  });
 };

package/lib/mqtt/mqttProvider.js

@@ -3,7 +3,7 @@ import { registerMQTTProtocolListener } from '@ray-js/ray';
 import { get, isFunction, isNil } from 'lodash-es';
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from 'react';
 import { emitter } from '../utils';
-import { setUnhandledRejectionHandler } from './promise';
+import { dispatchUnhandledRejection, setUnhandledRejectionHandler } from './promise';
 import { ProtocolEnum } from './type';
 import log4js from '@ray-js/log4js';
 
@@ -94,25 +94,27 @@ export function MqttProvider(_ref) {
 
   // 设置全局错误处理器（不依赖 window，适用于小程序环境）
   useEffect(() => {
-    if (onError) {
-      // 设置全局错误处理器
-      setUnhandledRejectionHandler(error => {
-        try {
-          onError(error);
-        } catch (handlerError) {
-          // 避免错误处理器本身抛出错误导致无限循环
-          console.error('Error in MQTT error handler:', handlerError);
-        }
-      });
-    } else {
-      // 如果没有提供错误处理器，设置默认处理器（记录警告）
-      setUnhandledRejectionHandler(error => {
-        console.warn(`[MQTT] Unhandled rejection for ${error.reqType}:`, error.message);
-      });
-    }
+    var _tyGlobal$onUnhandled;
+    // 注册处理器：业务方传了 onError 就用它，否则退化为警告日志
+    setUnhandledRejectionHandler(onError !== null && onError !== void 0 ? onError : error => {
+      console.warn(`[MQTT] Unhandled rejection for ${error.reqType}:`, error.message);
+    });
+
+    // 兜底：监听小程序全局未处理的 Promise rejection。
+    // 当业务方"即发即忘"地调用 query/request（未 catch）且失败时，rejection 会走到这里；
+    // dispatchUnhandledRejection 只转发本库产生的 MqttError 给上面注册的处理器（onError），
+    // 从而避免这类错误作为未处理异常继续向上冒泡，同时不会误吞无关的应用级 rejection。
+    const onGlobalUnhandledRejection = res => {
+      dispatchUnhandledRejection(res === null || res === void 0 ? void 0 : res.reason);
+    };
+    // 部分环境 / 旧类型定义未声明该 API，做类型收窄 + 运行时判空，避免非小程序环境（如测试）报错
+    const tyGlobal = typeof ty === 'undefined' ? undefined : ty;
+    tyGlobal === null || tyGlobal === void 0 || (_tyGlobal$onUnhandled = tyGlobal.onUnhandledRejection) === null || _tyGlobal$onUnhandled === void 0 || _tyGlobal$onUnhandled.call(tyGlobal, onGlobalUnhandledRejection);
 
-    // 清理函数：组件卸载时移除全局处理器
+    // 清理函数：组件卸载时移除全局处理器与监听
     return () => {
+      var _tyGlobal$offUnhandle;
+      tyGlobal === null || tyGlobal === void 0 || (_tyGlobal$offUnhandle = tyGlobal.offUnhandledRejection) === null || _tyGlobal$offUnhandle === void 0 || _tyGlobal$offUnhandle.call(tyGlobal, onGlobalUnhandledRejection);
       setUnhandledRejectionHandler(null);
     };
   }, [onError]);

package/lib/mqtt/promise.d.ts

@@ -24,6 +24,18 @@ export declare class MqttError extends Error {
         reqType: string;
     });
 }
+/**
+ * 判断是否为本库（MQTT 请求）产生的错误。
+ * 用于全局 unhandledrejection 兜底时，只处理本库错误，避免误吞/误报无关的应用级 rejection。
+ */
+export declare function isMqttError(error: unknown): error is MqttError;
+/**
+ * 分发一个未被业务方 catch 的 rejection。
+ * 仅当它是本库产生的 MQTT 错误、且已通过 setUnhandledRejectionHandler 注册处理器时，才转发给该处理器。
+ *
+ * @returns 是否已被本库处理（true 表示已转发给 onError，可视为"已消费"）
+ */
+export declare function dispatchUnhandledRejection(reason: unknown): boolean;
 /**
  * MQTT 响应消息类型（兼容 MQTT 响应格式）
  */

package/lib/mqtt/promise.js

@@ -51,6 +51,33 @@ export class MqttError extends Error {
   }
 }
 
+/**
+ * 判断是否为本库（MQTT 请求）产生的错误。
+ * 用于全局 unhandledrejection 兜底时，只处理本库错误，避免误吞/误报无关的应用级 rejection。
+ */
+export function isMqttError(error) {
+  return error instanceof MqttError || (error === null || error === void 0 ? void 0 : error.name) === 'MqttError';
+}
+
+/**
+ * 分发一个未被业务方 catch 的 rejection。
+ * 仅当它是本库产生的 MQTT 错误、且已通过 setUnhandledRejectionHandler 注册处理器时，才转发给该处理器。
+ *
+ * @returns 是否已被本库处理（true 表示已转发给 onError，可视为"已消费"）
+ */
+export function dispatchUnhandledRejection(reason) {
+  if (!isMqttError(reason) || !globalUnhandledRejectionHandler) {
+    return false;
+  }
+  try {
+    globalUnhandledRejectionHandler(reason);
+  } catch (handlerError) {
+    // 避免错误处理器本身抛出错误导致无限循环
+    console.error('Error in MQTT error handler:', handlerError);
+  }
+  return true;
+}
+
 /**
  * MQTT 响应消息类型（兼容 MQTT 响应格式）
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/robot-data-stream",
-  "version": "0.0.17-beta.5",
+  "version": "0.0.17-beta.6",
   "description": "扫地机P2P数据流标准化组件",
   "main": "lib/index",
   "files": [