@ray-js/robot-data-stream 0.0.17-beta.4 → 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/lib/mqtt/type/protocols/cruiseProtocol.d.ts

@@ -3,15 +3,15 @@ import type { BaseResponse } from './base';
 export type CruiseCmd = 'start' | 'pause' | 'resume' | 'stop';
 /** 巡航状态：idle 未巡航 / cruising 巡航中 / paused 已暂停 */
 export type CruiseStatus = 'idle' | 'cruising' | 'paused';
-/** 巡航类型：whole_house 全屋巡航 / select_room 定点巡航（按房间工作点） */
-export type CruiseType = 'whole_house' | 'select_room';
+/** 巡航类型：whole_house 全屋巡航 / spot 定点巡航（按净化点坐标） */
+export type CruiseType = 'whole_house' | 'spot';
 export interface SetCruiseData {
     /** start 开始 / pause 暂停 / resume 继续 / stop 结束 */
     cmd: CruiseCmd;
     /** 巡航类型，cmd 为 start 时必填 */
     cruiseType?: CruiseType;
-    /** select_room 时的房间 ID 列表；不传表示全部工作点 */
-    ids?: number[];
+    /** spot 定点巡航时的净化点坐标列表，格式 "x, y"；不传表示全部净化点 */
+    polygons?: string[];
     version?: string;
 }
 export interface RequestCruiseData {
@@ -23,12 +23,10 @@ export interface CruiseResponse extends BaseResponse {
     mapId: number;
     /** 巡航类型；idle 时可不携带 */
     cruiseType?: CruiseType;
-    /** select_room 时本次巡航的房间 ID 列表 */
-    ids?: number[];
-    /** 当前正在工作的房间 ID */
-    currentId?: number;
-    /** 当前工作点坐标 "x, y" */
-    polygon?: string;
+    /** spot 定点巡航时的净化点坐标列表，格式 "x, y" */
+    polygons?: string[];
+    /** 当前正在净化的坐标 "x, y" */
+    currentPolygon?: string;
 }
 export type TRequestCruise = (message?: RequestCruiseData) => Promise<CruiseResponse>;
 export type TSetCruise = (message: SetCruiseData) => Promise<CruiseResponse>;

package/lib/mqtt/type/protocols/purifierScheduleProtocol.d.ts

@@ -1,6 +1,12 @@
 import type { BaseResponse } from './base';
-/** 工作类型：select_room 选房净化 / whole_house 整屋净化 */
-export type PurifierWorkType = 'select_room' | 'whole_house';
+/**
+ * 工作类型：
+ * - select_room 选房净化（携带 ids）
+ * - whole_house 整屋净化
+ * - spot 定点净化
+ * - current_location 原地净化
+ */
+export type PurifierWorkType = 'select_room' | 'whole_house' | 'spot' | 'current_location';
 /** 风速档位，透传字符串，不限制具体取值（不同设备支持的档位不同） */
 export type PurifierFanMode = string;
 export interface PurifierScheduleItem {
@@ -10,9 +16,9 @@ export interface PurifierScheduleItem {
     cycle: number[];
     /** 执行时间 [时, 分]，24 小时制 */
     time: number[];
-    /** 房间 ID 列表；workTypes 为 whole_house 时为空数组 */
+    /** 房间 ID 列表；workTypes 为 whole_house / spot / current_location 时为空数组 */
     ids: number[];
-    /** 工作类型，与 ids 对齐；整屋时单元素 whole_house */
+    /** 工作类型，与 ids 对齐；非 select_room 时为单元素 */
     workTypes: PurifierWorkType[];
     /** 风速，与 ids 对齐（整屋时单元素） */
     fanModes: PurifierFanMode[];

package/package.json

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