@ray-js/robot-map 0.0.5-beta.6 → 0.0.5-beta.7

package/lib/RjsComponent/index.js

@@ -5,15 +5,14 @@ import "core-js/modules/esnext.iterator.map.js";
 import "core-js/modules/web.dom-collections.iterator.js";
 /* eslint-disable func-names */
 import Render from './index.rjs';
-import { MAP_API_METHODS, MAP_CALLBACK_METHODS } from '@ray-js/robot-map-sdk';
+import { MAP_CALLBACK_METHODS } from '@ray-js/robot-map-sdk';
 import { isEqual } from 'lodash-es';
 const componentOptions = {
   options: {
     pureDataPattern: /^init$/
   },
   data: {
-    initialized: false,
-    mapApi: null
+    initialized: false
   },
   properties: {
     containerId: {
@@ -129,7 +128,6 @@ const componentOptions = {
   lifetimes: {
     created() {
       this.render = new Render(this);
-      this.mapApi = null;
     },
     async ready() {
       const {
@@ -189,56 +187,26 @@ const componentOptions = {
   },
   pageLifetimes: {},
   methods: {
-    // 为 render 对象动态添加 API 代理方法
-    setupApiProxyMethods() {
-      const {
-        render
-      } = this;
-      if (!render) {
-        return;
-      }
-
-      // 如果已经设置过，不重复设置（使用标记避免重复执行）
-      if (render.__apiProxyMethodsSetup) {
-        return;
+    // 调用 RJS 层的 mapInstance 方法（异步，通过回调返回结果）
+    invokeMapApi(requestId, methodName, args) {
+      if (this.render) {
+        this.render.callMapInstanceMethodAsync(requestId, methodName, ...args);
       }
-      MAP_API_METHODS.forEach(methodName => {
-        // 为 this.render 添加代理方法，通过 callMapInstanceMethod 来间接调用
-        // 因为 render.mapInstance 在外部无法访问（封装的私有属性）
-        render[methodName] = function () {
-          for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-            args[_key] = arguments[_key];
-          }
-          return render.callMapInstanceMethod(methodName, ...args);
-        };
-      });
-
-      // 标记已设置，避免重复执行
-      render.__apiProxyMethodsSetup = true;
     },
-    // 创建MapApi对象，将rjs方法映射为API
-    createMapApi() {
-      if (!this.render) {
-        return null;
-      }
-      const mapApi = {};
-      MAP_API_METHODS.forEach(methodName => {
-        // 将方法绑定到 this.render，这样调用时会通过 render 代理到 mapInstance
-        if (typeof this.render[methodName] === 'function') {
-          mapApi[methodName] = this.render[methodName].bind(this.render);
-        }
+    // 接收 RJS 层的 API 调用结果回调
+    onApiResponse(requestId, result, error) {
+      this.triggerEvent('onApiResponse', {
+        requestId,
+        result,
+        error
       });
-      return mapApi;
     },
     // 处理rjs回调事件
     onInitialized() {
-      // 确保代理方法已设置（防止时序问题）
-      this.setupApiProxyMethods();
-      this.mapApi = this.createMapApi();
-      this.setData({
-        mapApi: this.mapApi
+      // 传递组件实例，让 TS 层可以通过 instance.invokeMapApi() 调用方法
+      this.triggerEvent('onInitialized', {
+        instance: this
       });
-      this.triggerEvent('onInitialized', this.mapApi);
     }
   }
 };
@@ -246,8 +214,8 @@ const componentOptions = {
 // 动态添加所有 MAP_CALLBACK_METHODS 中定义的回调方法
 MAP_CALLBACK_METHODS.forEach(methodName => {
   componentOptions.methods[methodName] = function () {
-    for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-      args[_key2] = arguments[_key2];
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
     }
     this.triggerEvent(methodName, ...args);
   };

package/lib/RjsComponent/index.rjs

@@ -1,4 +1,4 @@
-import { MapApplication, MAP_API_METHODS, MAP_CALLBACK_METHODS } from "@ray-js/robot-map-sdk/rjs";
+import { MapApplication, MAP_CALLBACK_METHODS } from "@ray-js/robot-map-sdk/rjs";
 import { decodeMap, decodeMapStructured, decodePath } from '@ray-js/robot-protocol'
 
 export default Render({
@@ -140,11 +140,22 @@ export default Render({
 
   // 通用的 API 调用方法，用于代理所有 mapInstance 上的方法
   // 因为外部无法直接访问 this.mapInstance，所以提供这个方法来间接调用
-  callMapInstanceMethod(methodName, ...args) {
+  // 注意：RJS 层无法直接 return 值给 JS 层，需要通过 callMethod 回调
+  callMapInstanceMethodAsync(requestId, methodName, ...args) {
+    let result = null
+    let error = null
+
     if (this.mapInstance && typeof this.mapInstance[methodName] === 'function') {
-      return this.mapInstance[methodName](...args)
+      try {
+        result = this.mapInstance[methodName](...args)
+      } catch (e) {
+        error = e?.message || String(e)
+      }
+    } else {
+      error = `Method ${methodName} not available on mapInstance`
     }
-    console.warn(`Method ${methodName} not available on mapInstance`)
-    return null
+
+    // 通过 callMethod 将结果回调给 JS 层
+    this.callMethod('onApiResponse', requestId, result, error)
   }
 })

package/lib/RjsRobotMap.js

@@ -1,6 +1,5 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
-import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 const _excluded = ["map", "path", "roomProperties", "forbiddenSweepZones", "forbiddenMopZones", "cleanZones", "virtualWalls", "spots", "wayPoints", "detectedObjects", "customElements", "config", "runtime", "onMapReady"];
 import "core-js/modules/esnext.iterator.constructor.js";
 import "core-js/modules/esnext.iterator.for-each.js";
@@ -8,18 +7,13 @@ import "core-js/modules/esnext.iterator.map.js";
 import "core-js/modules/esnext.iterator.reduce.js";
 import "core-js/modules/web.dom-collections.iterator.js";
 import React, { useCallback, useEffect, useRef, useMemo } from 'react';
-import { MAP_CALLBACK_METHODS } from '@ray-js/robot-map-sdk';
+import { MAP_CALLBACK_METHODS, MAP_API_METHODS } from '@ray-js/robot-map-sdk';
 import { nanoid } from 'nanoid/non-secure';
 import RjsComponent from './RjsComponent';
 import { robotMapDefaultProps } from './props';
 
-// 回调名到事件名的映射
-const CALLBACK_TO_EVENT_MAP = _objectSpread({
-  onInitialized: 'onInitialized'
-}, MAP_CALLBACK_METHODS.reduce((acc, methodName) => {
-  acc[methodName] = methodName;
-  return acc;
-}, {}));
+// 存储待处理的请求：requestId -> { resolve, reject }
+
 const RjsRobotMap = _ref => {
   let {
       map,
@@ -40,6 +34,10 @@ const RjsRobotMap = _ref => {
     callbacks = _objectWithoutProperties(_ref, _excluded);
   const componentRef = useRef(null);
   const callbacksRef = useRef(callbacks);
+  // 存储小程序组件实例的引用
+  const instanceRef = useRef(null);
+  // 存储待处理的 API 请求
+  const pendingRequestsRef = useRef(new Map());
   // 为每个组件实例生成唯一的 containerId
   const containerId = useRef("robot-map-container-".concat(nanoid())).current;
 
@@ -48,29 +46,86 @@ const RjsRobotMap = _ref => {
     callbacksRef.current = callbacks;
   });
 
-  // 事件分发函数 - 这个函数是稳定的，不会随渲染变化
+  // 事件分发函数
   const eventDispatcher = useCallback(function (eventName) {
-    const propName = CALLBACK_TO_EVENT_MAP[eventName];
-    if (propName && callbacksRef.current[propName]) {
-      for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
-        args[_key - 1] = arguments[_key];
+    var _callbacksRef$current, _callbacksRef$current2;
+    for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+      args[_key - 1] = arguments[_key];
+    }
+    (_callbacksRef$current = (_callbacksRef$current2 = callbacksRef.current)[eventName]) === null || _callbacksRef$current === void 0 || _callbacksRef$current.call(_callbacksRef$current2, ...args);
+  }, []);
+
+  // 在 TS 层创建 mapApi，每个方法返回 Promise
+  const createMapApi = useCallback(() => {
+    const mapApi = MAP_API_METHODS.reduce((acc, methodName) => {
+      acc[methodName] = function () {
+        for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+          args[_key2] = arguments[_key2];
+        }
+        return new Promise((resolve, reject) => {
+          const instance = instanceRef.current;
+          if (!instance) {
+            reject(new Error('Map instance not available'));
+            return;
+          }
+
+          // 生成唯一的请求 ID
+          const requestId = nanoid();
+
+          // 存储 resolve/reject，等待回调
+          pendingRequestsRef.current.set(requestId, {
+            resolve,
+            reject
+          });
+
+          // 调用组件实例的方法，通知 RJS 层执行
+          instance.invokeMapApi(requestId, methodName, args);
+        });
+      };
+      return acc;
+    }, {});
+    return mapApi;
+  }, []);
+
+  // 处理 API 响应事件
+  const handleApiResponse = useCallback(event => {
+    const {
+      requestId,
+      result,
+      error
+    } = event.detail || {};
+    const pending = pendingRequestsRef.current.get(requestId);
+    if (pending) {
+      pendingRequestsRef.current.delete(requestId);
+      if (error) {
+        pending.reject(new Error(error));
+      } else {
+        pending.resolve(result);
       }
-      // 调用最新的prop回调
-      callbacksRef.current[propName](...args);
     }
   }, []);
 
   // 处理初始化完成事件
   const handleInitialized = useCallback(event => {
-    const api = event.detail;
-    onMapReady === null || onMapReady === void 0 || onMapReady(api);
-    eventDispatcher('onInitialized', api);
-  }, [onMapReady, eventDispatcher]);
+    const {
+      instance
+    } = event.detail || {};
+    if (instance) {
+      // 保存组件实例引用
+      instanceRef.current = instance;
+
+      // 创建 mapApi
+      const mapApi = createMapApi();
+      onMapReady === null || onMapReady === void 0 || onMapReady(mapApi);
+      eventDispatcher('onInitialized', mapApi);
+    }
+  }, [onMapReady, eventDispatcher, createMapApi]);
 
   // 动态生成所有回调处理函数的绑定属性
   const eventBindings = useMemo(() => {
     const bindings = {
-      bindonInitialized: handleInitialized
+      bindonInitialized: handleInitialized,
+      bindonApiResponse: handleApiResponse
     };
 
     // 为 MAP_CALLBACK_METHODS 中的每个方法创建绑定
@@ -80,7 +135,7 @@ const RjsRobotMap = _ref => {
       };
     });
     return bindings;
-  }, [handleInitialized, eventDispatcher]);
+  }, [handleInitialized, handleApiResponse, eventDispatcher]);
   return /*#__PURE__*/React.createElement(RjsComponent, _extends({
     ref: componentRef,
     map: map,

package/lib/RobotMap.js

@@ -13,7 +13,6 @@ import { createWebviewContext, WebView } from '@ray-js/ray';
 import { MAP_API_METHODS, MAP_CALLBACK_METHODS } from '@ray-js/robot-map-sdk';
 import { nanoid } from 'nanoid/non-secure';
 import { robotMapDefaultProps } from './props';
-
 // 回调名到事件名的映射
 const CALLBACK_TO_EVENT_MAP = _objectSpread({
   onInitialized: 'onInitialized'

package/lib/index.d.ts

@@ -1,3 +1,4 @@
 export { RobotMap } from './RobotMap';
 export { RjsRobotMap } from './RjsRobotMap';
+export type { MapApi } from './types';
 export * from '@ray-js/robot-map-sdk';

package/lib/index.js

@@ -1,3 +1,7 @@
 export { RobotMap } from './RobotMap';
 export { RjsRobotMap } from './RjsRobotMap';
+
+// 先导出我们的类型定义（覆盖 MapApi 为 Promise 版本）
+
+// 然后导出 SDK 的其他内容（MapApi 会被我们的定义覆盖）
 export * from '@ray-js/robot-map-sdk';

package/lib/props.d.ts

@@ -1,4 +1,5 @@
-import { DeepPartialAppConfig, DeepPartialRuntimeConfig, MapApi, RoomProperty, ZoneParam, VirtualWallParam, DetectedObjectParam, CustomElementParam, MapState, PathState, Point, RoomData, SpotParam, WayPointParam } from '@ray-js/robot-map-sdk';
+import { DeepPartialAppConfig, DeepPartialRuntimeConfig, RoomProperty, ZoneParam, VirtualWallParam, DetectedObjectParam, CustomElementParam, MapState, PathState, Point, RoomData, SpotParam, WayPointParam } from '@ray-js/robot-map-sdk';
+import { MapApi } from './types';
 /**
  * 机器人地图组件属性接口
  *
@@ -102,7 +103,7 @@ export interface RobotMapProps {
      * @description.en Callback when the map is initialized and the API is ready
      * @description.zh 当地图组件初始化完成并且所有API功能可用时触发的回调函数。
      * @description.en Callback function triggered when the map component is initialized and all API functions are available.
-     * @param mapApi - 可供使用的地图 API 函数对象 / Available map API functions object
+     * @param mapApi - 可供使用的地图 API 函数对象，所有方法返回 Promise / Available map API functions object, all methods return Promise
      */
     onMapReady?: (mapApi: MapApi) => void;
     /**

package/lib/types.d.ts

@@ -0,0 +1,8 @@
+import { MapApi as OriginalMapApi } from '@ray-js/robot-map-sdk';
+/**
+ * MapApi 类型定义（所有方法返回 Promise）
+ * MapApi type definition (all methods return Promise)
+ */
+export type MapApi = {
+    [K in keyof OriginalMapApi]: OriginalMapApi[K] extends (...args: infer Args) => infer Return ? (...args: Args) => Promise<Return> : OriginalMapApi[K];
+};

package/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/robot-map",
-  "version": "0.0.5-beta.6",
+  "version": "0.0.5-beta.7",
   "description": "机器人地图组件",
   "main": "lib/index",
   "files": [
@@ -33,7 +33,7 @@
     "@ray-js/ray": "^1.7.39"
   },
   "dependencies": {
-    "@ray-js/robot-map-sdk": "0.0.4-beta.4",
+    "@ray-js/robot-map-sdk": "0.0.4-beta.5",
     "clsx": "^1.2.1",
     "nanoid": "^5.1.6"
   },