matterbridge-ha-roborock 3.0.0

package/src/platform-config.ts

@@ -0,0 +1,109 @@
+export interface RoborockPlatformConfig {
+  /** Home Assistant base URL, e.g. http://10.10.10.215:8123 */
+  haUrl: string;
+
+  /** Home Assistant Long-Lived Access Token */
+  haToken: string;
+
+  /** Matter 运行模式：server（推荐 Apple Home）或 matter */
+  matterMode?: 'server' | 'matter';
+
+  /** 只允许注册的 vacuum entity_id 列表 */
+  deviceWhitelist?: string[];
+
+  /** 禁止注册的 vacuum entity_id 列表 */
+  deviceBlacklist?: string[];
+
+  /** 轮询间隔（毫秒） */
+  pollInterval?: number;
+
+  /** 是否开启 debug 日志 */
+  debug?: boolean;
+
+  /** 
+   * 电池电量传感器映射
+   * key: vacuum entity_id
+   * value: 对应的电池传感器 entity_id
+   * 例如: { "vacuum.dreame_vacuum_r2254": "sensor.dreame_vacuum_r2254_battery_level" }
+   */
+  batterySensorMap?: Record<string, string>;
+
+  /**
+   * 充电状态传感器映射
+   * key: vacuum entity_id
+   * value: 对应的充电状态传感器 entity_id
+   * 例如: { "vacuum.dreame_vacuum_r2254": "binary_sensor.dreame_vacuum_r2254_charging_state" }
+   */
+  chargingSensorMap?: Record<string, string>;
+
+  /**
+   * 清洁模式选择器映射
+   * key: vacuum entity_id
+   * value: 对应的清洁模式选择器 entity_id
+   * 例如: { "vacuum.dreame_vacuum_r2254": "select.dreame_vacuum_r2254_cleaning_mode" }
+   */
+  cleaningModeEntityMap?: Record<string, string>;
+
+  /**
+   * 错误传感器映射
+   * key: vacuum entity_id
+   * value: 对应的错误传感器 entity_id
+   * 例如: { "vacuum.dreame_vacuum_r2254": "sensor.dreame_vacuum_r2254_error" }
+   */
+  errorSensorMap?: Record<string, string>;
+}
+
+export function validateConfig(config: any): RoborockPlatformConfig {
+  if (!config || typeof config !== 'object') {
+    throw new Error('Config must be an object');
+  }
+
+  if (!config.haUrl) {
+    throw new Error('haUrl is required');
+  }
+
+  if (!config.haToken) {
+    throw new Error('haToken is required');
+  }
+
+  // 去掉 haUrl 末尾的 /
+  config.haUrl = String(config.haUrl).replace(/\/$/, '');
+
+  // 默认轮询 30 秒
+  if (!config.pollInterval || typeof config.pollInterval !== 'number') {
+    config.pollInterval = 30000;
+  }
+
+  // Apple Home 兼容性最好：server
+  if (!config.matterMode) {
+    config.matterMode = 'server';
+  }
+
+  // 规范化 whitelist / blacklist
+  if (config.deviceWhitelist && !Array.isArray(config.deviceWhitelist)) {
+    throw new Error('deviceWhitelist must be an array of strings');
+  }
+
+  if (config.deviceBlacklist && !Array.isArray(config.deviceBlacklist)) {
+    throw new Error('deviceBlacklist must be an array of strings');
+  }
+
+  // 验证传感器映射
+  if (config.batterySensorMap && typeof config.batterySensorMap !== 'object') {
+    throw new Error('batterySensorMap must be an object');
+  }
+
+  if (config.chargingSensorMap && typeof config.chargingSensorMap !== 'object') {
+    throw new Error('chargingSensorMap must be an object');
+  }
+
+  if (config.cleaningModeEntityMap && typeof config.cleaningModeEntityMap !== 'object') {
+    throw new Error('cleaningModeEntityMap must be an object');
+  }
+
+  if (config.errorSensorMap && typeof config.errorSensorMap !== 'object') {
+    throw new Error('errorSensorMap must be an object');
+  }
+
+  return config as RoborockPlatformConfig;
+}