nayota-show-sdk 1.3.65 → 1.3.66

package/api/deviceClass.js

@@ -10,6 +10,10 @@ function shouldUseIot(action) {
  * @file 设备类型api
  * @module 设备类型接口
  * @category 设备管理
+ * @import
+ * import { deviceClass } from 'nayota-show-sdk'
+ * const { list, create, getOne, updateOne, deleteOne, deleteMany, getDeviceOffline, onlineRate } = deviceClass
+ * list({ page: 1, limit: 10 })
  * @categoryOrder 2
  */
 
@@ -209,6 +213,48 @@ export function getDeviceOffline(data) {
   })
 }
 
+/**
+ * 获取设备类型在线率
+ * @param {Object} query - 查询参数
+ * @param {number} query.year - 统计年份，例如 2026
+ * @param {number} [query.month] - 统计月份，1-12；不传表示查询整年
+ * @param {string} [query.creator] - 所属用户ID
+ * @param {Array<string>|string} [query.deviceClasses] - 设备类型ID列表，也兼容逗号分隔字符串
+ * @returns {number} code - 返回码，0表示成功
+ * @returns {Object} data - 在线率统计结果
+ * @returns {number} data.year - 统计年份
+ * @returns {number|null} data.month - 统计月份；查询全年时为 null
+ * @returns {number} data.startTime - 统计开始时间戳
+ * @returns {number} data.endTime - 统计结束时间戳
+ * @returns {Object} data.summary - 所有设备类型汇总在线率
+ * @returns {number} data.summary.onlineDuration - 汇总在线时长，单位毫秒
+ * @returns {number} data.summary.offlineDuration - 汇总离线时长，单位毫秒
+ * @returns {number} data.summary.totalDuration - 汇总总时长，单位毫秒
+ * @returns {number} data.summary.onlineRate - 汇总在线率，0-1
+ * @returns {number} data.summary.onlineRatePercent - 汇总在线率百分比
+ * @returns {Array<Object>} data.items - 各设备类型在线率列表
+ * @returns {string} data.items[].deviceClass - 设备类型ID
+ * @returns {string} data.items[].deviceClassName - 设备类型名称
+ * @returns {number} data.items[].alarmTotal - 参与统计的在离线 alarm 数量
+ * @returns {Object} data.items[].summary - 当前设备类型在线率汇总
+ * @returns {number} data.items[].summary.onlineDuration - 在线时长，单位毫秒
+ * @returns {number} data.items[].summary.offlineDuration - 离线时长，单位毫秒
+ * @returns {number} data.items[].summary.totalDuration - 总时长，单位毫秒
+ * @returns {number} data.items[].summary.onlineRate - 在线率，0-1
+ * @returns {number} data.items[].summary.onlineRatePercent - 在线率百分比
+ */
+export function onlineRate(query) {
+  if (shouldUseIot('onlineRate')) {
+    return executeIotModuleAction(MODULE_NAME, 'onlineRate', query)
+  }
+
+  return requestShow({
+    url: '/device-classes/online-rate',
+    method: 'get',
+    params: query
+  })
+}
+
 export default {
   list,
   create,
@@ -216,5 +262,6 @@ export default {
   deleteOne,
   deleteMany,
   getOne,
-  getDeviceOffline
+  getDeviceOffline,
+  onlineRate
 }

package/index.test.js

@@ -1,27 +1,38 @@
-import sdk from './index'
+let modules
+beforeAll(() => {
+  jest.mock('./__mocks__/requireContext')
 
-describe('nayota-show-sdk exports', () => {
-  test('exposes config entry and core API modules', () => {
-    expect(sdk).toBeDefined()
-    expect(typeof sdk.config).toBe('function')
-    expect(typeof sdk.on).toBe('function')
-
-    expect(sdk.area).toBeDefined()
-    expect(typeof sdk.area.list).toBe('function')
-
-    expect(sdk.areaClass).toBeDefined()
-    expect(typeof sdk.areaClass.getOne).toBe('function')
-
-    expect(sdk.components).toBeDefined()
-    expect(typeof sdk.components.create).toBe('function')
+  modules = require('./index.js')
+})
 
-    expect(sdk.departs).toBeDefined()
-    expect(typeof sdk.departs.updateOne).toBe('function')
+// Test the modules object
+describe('modules', () => {
+  test('should have the correct structure', () => {
+    expect(modules).toBeDefined()
+    expect(typeof modules).toBe('object')
+    expect(Object.keys(modules)).toHaveLength(17) // Assuming there is only one module in the littleTool directory
 
-    expect(sdk.devices).toBeDefined()
-    expect(typeof sdk.devices.easyList).toBe('function')
+    // Test the structure of the module
+    // const module = modules['api'] // Assuming the module name is 'api'
+    // expect(module).toBeDefined()
+    // expect(typeof module).toBe('object')
+    // expect(Object.keys(module)).toHaveLength(13) // Assuming there are 13 sub-modules in the api directory
 
-    expect(sdk.deviceClass).toBeDefined()
-    expect(typeof sdk.deviceClass.deleteOne).toBe('function')
+    // // Test the structure of each sub-module
+    // expect(module['alarms']).toBeDefined()
+    // expect(module['checkReduces']).toBeDefined()
+    // expect(module['user']).toBeDefined()
+    // expect(module['httpDrives']).toBeDefined()
+    // expect(module['hardwares']).toBeDefined()
+    // expect(module['checks']).toBeDefined()
+    // expect(module['cloudHardwares']).toBeDefined()
+    // expect(module['loraSlaves']).toBeDefined()
+    // expect(module['lorawanDevices']).toBeDefined()
+    // expect(module['nbiotDrives']).toBeDefined()
+    // expect(module['nbm2mDevices']).toBeDefined()
+    // expect(module['netDrives']).toBeDefined()
+    // expect(module['netMqttDevices']).toBeDefined()
+    // // 添加alarms list请求的测试
+    // expect(module['alarms']['list']).toBeDefined()
   })
 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nayota-show-sdk",
-  "version": "1.3.65",
+  "version": "1.3.66",
   "description": "nayota-show-server rest-api",
   "type": "module",
   "main": "index.js",

package/http-config-iot.test.js

@@ -1,95 +0,0 @@
-import httpConfigIot from './utils/http-config-iot'
-
-jest.mock('axios', () => {
-  const create = jest.fn(() => {
-    const instance = jest.fn()
-    instance.interceptors = {
-      request: { use: jest.fn() },
-      response: { use: jest.fn() }
-    }
-    return instance
-  })
-
-  return {
-    __esModule: true,
-    default: {
-      create,
-      defaults: {
-        headers: {
-          common: {}
-        }
-      }
-    }
-  }
-})
-
-describe('httpConfigIot', () => {
-  test('normalizes iot success code 200 into legacy success code 0', () => {
-    const http = httpConfigIot()
-    const responseInterceptor = http.interceptors.response.use.mock.calls[0][0]
-
-    expect(
-      responseInterceptor({
-        status: 200,
-        headers: {},
-        data: {
-          code: 200,
-          data: {
-            id: 'space-1'
-          }
-        }
-      })
-    ).toEqual({
-      code: 0,
-      data: {
-        id: 'space-1'
-      }
-    })
-  })
-
-  test('normalizes any 2xx iot code into legacy success code 0', () => {
-    const http = httpConfigIot()
-    const responseInterceptor = http.interceptors.response.use.mock.calls[0][0]
-
-    expect(
-      responseInterceptor({
-        status: 201,
-        headers: {},
-        data: {
-          code: 201,
-          data: {
-            id: 'space-2'
-          }
-        }
-      })
-    ).toEqual({
-      code: 0,
-      data: {
-        id: 'space-2'
-      }
-    })
-  })
-
-  test('accepts string based 2xx iot codes as legacy success too', () => {
-    const http = httpConfigIot()
-    const responseInterceptor = http.interceptors.response.use.mock.calls[0][0]
-
-    expect(
-      responseInterceptor({
-        status: 204,
-        headers: {},
-        data: {
-          code: '204',
-          data: {
-            id: 'space-3'
-          }
-        }
-      })
-    ).toEqual({
-      code: 0,
-      data: {
-        id: 'space-3'
-      }
-    })
-  })
-})

package/iot-adapter-helpers.test.js

@@ -1,59 +0,0 @@
-import { buildLegacyListResponse } from './utils/iot-adapter-helpers'
-
-describe('iot adapter helpers', () => {
-  test('wraps list responses as code + data.total/data.rows', () => {
-    const result = buildLegacyListResponse({
-      total: 1,
-      items: [
-        {
-          id: 'type-1',
-          name: '风速仪'
-        }
-      ]
-    })
-
-    expect(result).toEqual({
-      code: 0,
-      data: {
-        total: 1,
-        rows: [
-          {
-            id: 'type-1',
-            _id: 'type-1',
-            name: '风速仪'
-          }
-        ]
-      }
-    })
-  })
-
-  test('unwraps nested iot data.items responses before mapping to legacy rows', () => {
-    const result = buildLegacyListResponse({
-      code: 0,
-      success: true,
-      data: {
-        total: 1,
-        items: [
-          {
-            id: 'depart-1',
-            name: '研发园B区'
-          }
-        ]
-      }
-    })
-
-    expect(result).toEqual({
-      code: 0,
-      data: {
-        total: 1,
-        rows: [
-          {
-            id: 'depart-1',
-            _id: 'depart-1',
-            name: '研发园B区'
-          }
-        ]
-      }
-    })
-  })
-})

package/iot-module-specs.test.js

@@ -1,72 +0,0 @@
-import { iotModuleSpecs } from './utils/iot-module-specs'
-
-describe('iot module specs', () => {
-  test('devices.easyList unwraps nested data.rows payloads', () => {
-    const response = iotModuleSpecs.devices.operations.easyList.fromResponse({
-      code: 0,
-      success: true,
-      data: {
-        total: 2,
-        rows: [
-          {
-            id: 'device-1',
-            name: '风速仪'
-          },
-          {
-            id: 'device-2',
-            name: '温湿度传感器'
-          }
-        ]
-      }
-    })
-
-    expect(response).toEqual({
-      code: 0,
-      data: {
-        total: 2,
-        rows: [
-          {
-            id: 'device-1',
-            _id: 'device-1',
-            name: '风速仪'
-          },
-          {
-            id: 'device-2',
-            _id: 'device-2',
-            name: '温湿度传感器'
-          }
-        ]
-      }
-    })
-  })
-
-  test('devices.easyList also supports nested data.items payloads', () => {
-    const response = iotModuleSpecs.devices.operations.easyList.fromResponse({
-      code: 0,
-      success: true,
-      data: {
-        total: 1,
-        items: [
-          {
-            id: 'device-3',
-            name: '层级设备'
-          }
-        ]
-      }
-    })
-
-    expect(response).toEqual({
-      code: 0,
-      data: {
-        total: 1,
-        rows: [
-          {
-            id: 'device-3',
-            _id: 'device-3',
-            name: '层级设备'
-          }
-        ]
-      }
-    })
-  })
-})