@ray-js/api 1.5.0-beta.11 → 1.5.0

package/lib/cloud/recipe/star.d.ts

@@ -0,0 +1,131 @@
+/**
+ * GetRecipeCollectionListQuery - 获取食谱收藏列表查询条件
+ */
+type GetRecipeCollectionListQuery = {
+    pageNo?: number;
+    pageSize?: number;
+};
+/**
+ * GetRecipeCollectionListParams - 获取食谱收藏列表请求参数
+ */
+type GetRecipeCollectionListParams = {
+    query: GetRecipeCollectionListQuery;
+    devId: string;
+};
+/**
+ * RecipeInfo - 食谱信息
+ */
+type RecipeInfo = {
+    id: number;
+    mainImg: string;
+    lang: number;
+    langDesc: string;
+    desc: string;
+    cookType: number;
+    extInfo: string;
+    sourceType: number;
+    isMainShow: number;
+    isShowControl: number;
+    isControl: number;
+    name: string;
+    easyLevel: string;
+    easyLevelDesc: string;
+    taste: string;
+    tasteDesc: string;
+    foodType: string;
+    foodTypeDesc: string;
+    gmtCreate: number;
+    gmtModified: number;
+};
+/**
+ * GetRecipeCollectionListResult - 获取食谱收藏列表返回结果
+ */
+type GetRecipeCollectionListResult = {
+    totalCount: number;
+    pageNo: number;
+    pageSize: number;
+    hasNext: boolean;
+    data: RecipeInfo[];
+};
+/**
+ * GetRecipeCollectionListResponse - 获取食谱收藏列表响应
+ */
+type GetRecipeCollectionListResponse = GetRecipeCollectionListResult;
+/**
+ * 获取食谱收藏列表
+ * @param {GetRecipeCollectionListParams} params - 获取食谱收藏列表请求参数
+ * @returns {Promise<GetRecipeCollectionListResponse>} - 获取食谱收藏列表响应的 Promise
+ */
+export declare const getRecipeCollectionList: (params: GetRecipeCollectionListParams) => Promise<GetRecipeCollectionListResponse>;
+/**
+ * AddRecipeToFavoritesParams - 添加食谱收藏参数
+ */
+type AddRecipeToFavoritesParams = {
+    menuId: number;
+    devId: string;
+};
+/**
+ * AddRecipeToFavoritesResponse - 添加食谱收藏响应
+ */
+type AddRecipeToFavoritesResponse = boolean;
+/**
+ * 添加食谱收藏
+ * @param {AddRecipeToFavoritesParams} params - 添加食谱收藏参数
+ * @returns {Promise<AddRecipeToFavoritesResponse>} - 添加食谱收藏结果的 Promise
+ */
+export declare const addRecipeToFavorites: (params: AddRecipeToFavoritesParams) => Promise<AddRecipeToFavoritesResponse>;
+/**
+ * RemoveRecipeFromFavoritesParams - 取消食谱收藏参数
+ */
+type RemoveRecipeFromFavoritesParams = {
+    menuId: number;
+    devId: string;
+};
+/**
+ * RemoveRecipeFromFavoritesResponse - 取消食谱收藏响应
+ */
+type RemoveRecipeFromFavoritesResponse = boolean;
+/**
+ * 取消食谱收藏
+ * @param {RemoveRecipeFromFavoritesParams} params - 取消食谱收藏参数
+ * @returns {Promise<RemoveRecipeFromFavoritesResponse>} - 取消食谱收藏结果的 Promise
+ */
+export declare const removeRecipeFromFavorites: (params: RemoveRecipeFromFavoritesParams) => Promise<RemoveRecipeFromFavoritesResponse>;
+/**
+ * CheckRecipeIsStarredParams - 查询食谱是否收藏参数
+ */
+type CheckRecipeIsStarredParams = {
+    menuId: number;
+    devId: string;
+};
+/**
+ * CheckRecipeIsStarredResponse - 查询食谱是否收藏响应
+ */
+type CheckRecipeIsStarredResponse = {
+    isStar: boolean;
+};
+/**
+ * 查询食谱是否收藏
+ * @param {CheckRecipeIsStarredParams} params - 查询食谱是否收藏参数
+ * @returns {Promise<CheckRecipeIsStarredResponse>} - 查询食谱是否收藏结果的 Promise
+ */
+export declare const checkRecipeIsStarred: (params: CheckRecipeIsStarredParams) => Promise<CheckRecipeIsStarredResponse>;
+/**
+ * GetRecipeStarCountParams - 查询食谱收藏数量参数
+ */
+type GetRecipeStarCountParams = {
+    devId: string;
+};
+/**
+ * GetRecipeStarCountResponse - 查询食谱收藏数量响应
+ */
+type GetRecipeStarCountResponse = {
+    count: number;
+};
+/**
+ * 查询用户已收藏的食谱数量
+ * @param {GetRecipeStarCountParams} params - 查询食谱收藏数量参数
+ * @returns {Promise<GetRecipeStarCountResponse>} - 查询食谱收藏数量结果的 Promise
+ */
+export declare const getRecipeStarCount: (params: GetRecipeStarCountParams) => Promise<GetRecipeStarCountResponse>;
+export {};

package/lib/cloud/recipe/star.js

@@ -0,0 +1,151 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+const _excluded = ["query"];
+import { THING } from '../../constants';
+import requestCloud from '../../requestCloud';
+// #region 获取食谱收藏列表
+
+/**
+ * GetRecipeCollectionListQuery - 获取食谱收藏列表查询条件
+ */
+
+/**
+ * GetRecipeCollectionListParams - 获取食谱收藏列表请求参数
+ */
+
+/**
+ * RecipeInfo - 食谱信息
+ */
+
+/**
+ * GetRecipeCollectionListResult - 获取食谱收藏列表返回结果
+ */
+
+/**
+ * GetRecipeCollectionListResponse - 获取食谱收藏列表响应
+ */
+
+/**
+ * 获取食谱收藏列表
+ * @param {GetRecipeCollectionListParams} params - 获取食谱收藏列表请求参数
+ * @returns {Promise<GetRecipeCollectionListResponse>} - 获取食谱收藏列表响应的 Promise
+ */
+export const getRecipeCollectionList = params => {
+  const {
+      query
+    } = params,
+    rest = _objectWithoutProperties(params, _excluded);
+  return requestCloud({
+    api: "".concat(THING, ".m.menu.star.list"),
+    version: '2.0',
+    data: _objectSpread({
+      queryJson: JSON.stringify(query)
+    }, rest)
+  });
+};
+
+// #endregion
+
+// #region 添加食谱收藏
+
+/**
+ * AddRecipeToFavoritesParams - 添加食谱收藏参数
+ */
+
+/**
+ * AddRecipeToFavoritesResponse - 添加食谱收藏响应
+ */
+
+// 返回结果，是否添加成功
+
+/**
+ * 添加食谱收藏
+ * @param {AddRecipeToFavoritesParams} params - 添加食谱收藏参数
+ * @returns {Promise<AddRecipeToFavoritesResponse>} - 添加食谱收藏结果的 Promise
+ */
+export const addRecipeToFavorites = params => {
+  return requestCloud({
+    api: "".concat(THING, ".m.menu.star.add"),
+    version: '1.0',
+    data: params
+  });
+};
+
+// #endregion
+
+// #region 取消食谱收藏
+
+/**
+ * RemoveRecipeFromFavoritesParams - 取消食谱收藏参数
+ */
+
+/**
+ * RemoveRecipeFromFavoritesResponse - 取消食谱收藏响应
+ */
+
+// 返回结果，是否取消成功
+
+/**
+ * 取消食谱收藏
+ * @param {RemoveRecipeFromFavoritesParams} params - 取消食谱收藏参数
+ * @returns {Promise<RemoveRecipeFromFavoritesResponse>} - 取消食谱收藏结果的 Promise
+ */
+export const removeRecipeFromFavorites = params => {
+  return requestCloud({
+    api: "".concat(THING, ".m.menu.star.delete"),
+    version: '1.0',
+    data: params
+  });
+};
+
+// #endregion
+
+// #region 食谱是否收藏
+
+/**
+ * CheckRecipeIsStarredParams - 查询食谱是否收藏参数
+ */
+
+/**
+ * CheckRecipeIsStarredResponse - 查询食谱是否收藏响应
+ */
+
+/**
+ * 查询食谱是否收藏
+ * @param {CheckRecipeIsStarredParams} params - 查询食谱是否收藏参数
+ * @returns {Promise<CheckRecipeIsStarredResponse>} - 查询食谱是否收藏结果的 Promise
+ */
+export const checkRecipeIsStarred = params => {
+  return requestCloud({
+    api: "".concat(THING, ".m.menu.star.check"),
+    version: '1.0',
+    data: params
+  });
+};
+
+// #endregion
+
+// #region 食谱收藏数量
+
+/**
+ * GetRecipeStarCountParams - 查询食谱收藏数量参数
+ */
+
+/**
+ * GetRecipeStarCountResponse - 查询食谱收藏数量响应
+ */
+
+/**
+ * 查询用户已收藏的食谱数量
+ * @param {GetRecipeStarCountParams} params - 查询食谱收藏数量参数
+ * @returns {Promise<GetRecipeStarCountResponse>} - 查询食谱收藏数量结果的 Promise
+ */
+export const getRecipeStarCount = params => {
+  return requestCloud({
+    api: "".concat(THING, ".m.menu.star.count"),
+    version: '1.0',
+    data: params
+  });
+};
+
+// #endregion

package/lib/cloud/recipe/star.md

@@ -0,0 +1,196 @@
+## getRecipeCollectionList
+
+获取食谱收藏列表。
+
+### 引入
+
+> @ray-js/ray^1.5.0 以上版本可使用
+
+```js
+import { getRecipeCollectionList } from '@ray-js/ray'
+```
+
+**参数**
+
+**GetRecipeCollectionListParams params**
+
+封装了获取食谱收藏列表的查询条件和设备 ID。
+
+**参数属性 GetRecipeCollectionListParams**
+
+| 属性  | 类型                           | 默认值 | 必填 | 说明     |
+| ----- | ------------------------------ | ------ | ---- | -------- |
+| query | `GetRecipeCollectionListQuery` |        | 是   | 查询条件 |
+| devId | `string`                       |        | 是   | 设备 ID  |
+
+**函数定义示例**
+
+```typescript
+/**
+ * 获取食谱收藏列表
+ * @param {GetRecipeCollectionListParams} params - 获取食谱收藏列表请求参数
+ * @returns {Promise<GetRecipeCollectionListResponse>} - 获取食谱收藏列表响应的 Promise 对象
+ */
+export const getRecipeCollectionList: (
+  params: GetRecipeCollectionListParams
+) => Promise<GetRecipeCollectionListResponse>
+```
+
+---
+
+## addRecipeToFavorites
+
+添加食谱收藏。
+
+### 引入
+
+> @ray-js/ray^1.5.0 以上版本可使用
+
+```js
+import { addRecipeToFavorites } from '@ray-js/ray'
+```
+
+**参数**
+
+**AddRecipeToFavoritesParams params**
+
+封装了食谱 ID 和设备 ID。
+
+**参数属性 AddRecipeToFavoritesParams**
+
+| 属性   | 类型     | 默认值 | 必填 | 说明    |
+| ------ | -------- | ------ | ---- | ------- |
+| menuId | `number` |        | 是   | 食谱 ID |
+| devId  | `string` |        | 是   | 设备 ID |
+
+**函数定义示例**
+
+```typescript
+/**
+ * 添加食谱收藏
+ * @param {AddRecipeToFavoritesParams} params - 添加食谱收藏参数
+ * @returns {Promise<AddRecipeToFavoritesResponse>} - 添加食谱收藏结果的 Promise 对象
+ */
+export const addRecipeToFavorites: (
+  params: AddRecipeToFavoritesParams
+) => Promise<AddRecipeToFavoritesResponse>
+```
+
+---
+
+## removeRecipeFromFavorites
+
+取消食谱收藏。
+
+### 引入
+
+> @ray-js/ray^1.5.0 以上版本可使用
+
+```js
+import { removeRecipeFromFavorites } from '@ray-js/ray'
+```
+
+**参数**
+
+**RemoveRecipeFromFavoritesParams params**
+
+封装了食谱 ID 和设备 ID。
+
+**参数属性 RemoveRecipeFromFavoritesParams**
+
+| 属性   | 类型     | 默认值 | 必填 | 说明    |
+| ------ | -------- | ------ | ---- | ------- |
+| menuId | `number` |        | 是   | 食谱 ID |
+| devId  | `string` |        | 是   | 设备 ID |
+
+**函数定义示例**
+
+```typescript
+/**
+ * 取消食谱收藏
+ * @param {RemoveRecipeFromFavoritesParams} params - 取消食谱收藏参数
+ * @returns {Promise<RemoveRecipeFromFavoritesResponse>} - 取消食谱收藏结果的 Promise 对象
+ */
+export const removeRecipeFromFavorites: (
+  params: RemoveRecipeFromFavoritesParams
+) => Promise<RemoveRecipeFromFavoritesResponse>
+```
+
+---
+
+## checkRecipeIsStarred
+
+查询食谱是否收藏。
+
+### 引入
+
+> @ray-js/ray^1.5.0 以上版本可使用
+
+```js
+import { checkRecipeIsStarred } from '@ray-js/ray'
+```
+
+**参数**
+
+**CheckRecipeIsStarredParams params**
+
+封装了食谱 ID 和设备 ID。
+
+**参数属性 CheckRecipeIsStarredParams**
+
+| 属性   | 类型     | 默认值 | 必填 | 说明    |
+| ------ | -------- | ------ | ---- | ------- |
+| menuId | `number` |        | 是   | 食谱 ID |
+| devId  | `string` |        | 是   | 设备 ID |
+
+**函数定义示例**
+
+```typescript
+/**
+ * 查询食谱是否收藏
+ * @param {CheckRecipeIsStarredParams} params - 查询食谱是否收藏参数
+ * @returns {Promise<CheckRecipeIsStarredResponse>} - 查询食谱是否收藏结果的 Promise 对象
+ */
+export const checkRecipeIsStarred: (
+  params: CheckRecipeIsStarredParams
+) => Promise<CheckRecipeIsStarredResponse>
+```
+
+---
+
+## getRecipeStarCount
+
+查询用户已收藏的食谱数量。
+
+### 引入
+
+> @ray-js/ray^1.5.0 以上版本可使用
+
+```js
+import { getRecipeStarCount } from '@ray-js/ray'
+```
+
+**参数**
+
+**GetRecipeStarCountParams params**
+
+封装了设备 ID。
+
+**参数属性 GetRecipeStarCountParams**
+
+| 属性  | 类型     | 默认值 | 必填 | 说明    |
+| ----- | -------- | ------ | ---- | ------- |
+| devId | `string` |        | 是   | 设备 ID |
+
+**函数定义示例**
+
+```typescript
+/**
+ * 查询用户已收藏的食谱数量
+ * @param {GetRecipeStarCountParams} params - 查询食谱收藏数量参数
+ * @returns {Promise<GetRecipeStarCountResponse>} - 查询食谱收藏数量结果的 Promise 对象
+ */
+export const getRecipeStarCount: (
+  params: GetRecipeStarCountParams
+) => Promise<GetRecipeStarCountResponse>
+```

package/lib/cloud/recipe/types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 多语言信息
+ */
+declare type LangInfo = {
+    lang: string;
+    name: string;
+};

package/lib/cloud/remoteGroup.d.ts

@@ -0,0 +1,10 @@
+import { IGetZigbeeLocalGroupDeviceList, IGetZigbeeLocalGroupRelation } from './interface';
+/**
+ * 获取 Zigbee 遥控器群组 localId 列表
+ */
+declare const getZigbeeLocalGroupRelation: (params: IGetZigbeeLocalGroupRelation) => Promise<string>;
+/**
+ * 获取可以加入 Zigbee 遥控器群组的设备列表
+ */
+declare const getZigbeeLocalGroupDeviceList: (params: IGetZigbeeLocalGroupDeviceList) => Promise<string>;
+export { getZigbeeLocalGroupRelation, getZigbeeLocalGroupDeviceList };

package/lib/cloud/remoteGroup.js

@@ -0,0 +1,31 @@
+// 遥控器群组接口
+import { requestCloud } from '../';
+import { THING } from '../constants';
+/**
+ * 获取 Zigbee 遥控器群组 localId 列表
+ */
+const getZigbeeLocalGroupRelation = params => {
+  return requestCloud({
+    api: "".concat(THING, ".p.remote.local.relation.get"),
+    version: '1.0',
+    data: {
+      devId: params.devId,
+      type: 0
+    }
+  });
+};
+
+/**
+ * 获取可以加入 Zigbee 遥控器群组的设备列表
+ */
+const getZigbeeLocalGroupDeviceList = params => {
+  return requestCloud({
+    api: "".concat(THING, ".m.device.group.dev.list"),
+    version: '1.0',
+    data: params,
+    extData: {
+      gid: params.homeId
+    }
+  });
+};
+export { getZigbeeLocalGroupRelation, getZigbeeLocalGroupDeviceList };

package/lib/constants.js

@@ -1,3 +1,3 @@
 import { decode } from 'base64-browser';
-const THING = decode('dHV5YQ==');
+const THING = decode('dHV5YQ=='); // => 'tuya'
 export { THING };

package/lib/errorCode.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    NATIVE_ROUTER_ERROR_ENVIRONMENT: number;
+};
+export default _default;

package/lib/errorCode.js

@@ -0,0 +1,3 @@
+export default {
+  NATIVE_ROUTER_ERROR_ENVIRONMENT: 40016
+};

package/lib/getCdnUrl/index.d.ts

@@ -1,2 +1,2 @@
-export default function getCdnUrl(path: string): string;
-export declare function getCdnUrlAsync(path: string): Promise<string>;
+export default function getCdnUrl(path: string, cdnMap?: Record<string, string>, region?: string): string;
+export declare function getCdnUrlAsync(path: string, cdnMap?: Record<string, string>, region?: string): Promise<string>;

package/lib/getCdnUrl/index.js

@@ -1,8 +1,7 @@
 export default function getCdnUrl(path) {
-  // 暂未实现获取cdn方法，将直接返回path
   return path;
 }
-export function getCdnUrlAsync(path) {
+export async function getCdnUrlAsync(path) {
   // 暂未实现获取cdn方法，将直接返回path
   return Promise.resolve(path);
 }

package/lib/getCdnUrl/index.wechat.d.ts

@@ -1,2 +1,2 @@
-export default function getCdnUrl(path: string): string;
-export declare function getCdnUrlAsync(path: string): Promise<string>;
+export default function getCdnUrl(path: string, cdnMap?: Record<string, string>, region?: string): string;
+export declare function getCdnUrlAsync(path: string, cdnMap?: Record<string, string>, region?: string): Promise<string>;

package/lib/getCdnUrl/index.wechat.js

@@ -1,8 +1,7 @@
 export default function getCdnUrl(path) {
-  // 暂未实现获取cdn方法，将直接返回path
   return path;
 }
-export function getCdnUrlAsync(path) {
+export async function getCdnUrlAsync(path) {
   // 暂未实现获取cdn方法，将直接返回path
   return Promise.resolve(path);
 }

package/lib/index.d.ts

@@ -35,5 +35,6 @@ export * from './openGroupCreate';
 /**
  * 新增跳转Native路由
  * 1.4.23 openSceneCreate/openSceneEdit
+ * 1.4.32 openCreateScene/openEditScene/openGuideScene/openAppScan/openConfigDevice/openUniversalCreateScene
  */
 export * from './nativeRouters';

package/lib/index.js

@@ -39,5 +39,6 @@ export * from './openGroupCreate';
 /**
  * 新增跳转Native路由
  * 1.4.23 openSceneCreate/openSceneEdit
+ * 1.4.32 openCreateScene/openEditScene/openGuideScene/openAppScan/openConfigDevice/openUniversalCreateScene
  */
 export * from './nativeRouters';

package/lib/nativeRouters/common.d.ts

@@ -0,0 +1,15 @@
+export type ICommon = {
+    success?: () => void;
+    fail?: (err?: {
+        errorMsg: string;
+        errorCode: string | number;
+        innerError: {
+            errorCode: string | number;
+            errorMsg: string;
+        };
+    }) => void;
+    complete?: () => void;
+} & {
+    [key: string]: string | boolean | number;
+};
+export declare function nativeRouter<T extends ICommon>(uri: string, params?: T): Promise<void>;

package/lib/nativeRouters/common.js

@@ -0,0 +1,38 @@
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+const _excluded = ["success", "fail", "complete"];
+import { stringifyUrl } from '../utils';
+import ErrorCode from '../errorCode';
+export function nativeRouter(uri, params) {
+  const _ref = params || {},
+    {
+      success,
+      fail,
+      complete
+    } = _ref,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  return new Promise((resolve, reject) => {
+    ty.router({
+      url: stringifyUrl({
+        url: uri,
+        query: rest
+      }),
+      success() {
+        success === null || success === void 0 || success();
+        resolve();
+      },
+      fail(err) {
+        if (+err.errorCode === ErrorCode.NATIVE_ROUTER_ERROR_ENVIRONMENT) {
+          const errMsg = 'Cannot use in this environment. Please use real device preview.';
+          console.warn(errMsg);
+          // 该环境不可使用，请使用真机预览和线上包
+          err.errorMsg = errMsg;
+        }
+        fail === null || fail === void 0 || fail(err);
+        reject(err);
+      },
+      complete() {
+        complete === null || complete === void 0 || complete();
+      }
+    });
+  });
+}