@fastybird/smart-panel-backend 0.1.0-alpha.5

package/dist/plugins/devices-home-assistant/services/helper-mapping-preview.service.js

@@ -0,0 +1,256 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelperMappingPreviewService = void 0;
+const common_1 = require("@nestjs/common");
+const extension_logger_service_1 = require("../../../common/logger/extension-logger.service");
+const devices_constants_1 = require("../../../modules/devices/devices.constants");
+const schema_utils_1 = require("../../../modules/devices/utils/schema.utils");
+const devices_home_assistant_constants_1 = require("../devices-home-assistant.constants");
+const devices_home_assistant_exceptions_1 = require("../devices-home-assistant.exceptions");
+const mappings_1 = require("../mappings");
+const helper_mapping_preview_model_1 = require("../models/helper-mapping-preview.model");
+const home_assistant_http_service_1 = require("./home-assistant.http.service");
+let HelperMappingPreviewService = class HelperMappingPreviewService {
+    constructor(homeAssistantHttpService, mappingLoaderService) {
+        this.homeAssistantHttpService = homeAssistantHttpService;
+        this.mappingLoaderService = mappingLoaderService;
+        this.logger = (0, extension_logger_service_1.createExtensionLogger)(devices_home_assistant_constants_1.DEVICES_HOME_ASSISTANT_PLUGIN_NAME, 'HelperMappingPreviewService');
+    }
+    async generatePreview(entityId, options) {
+        const helper = await this.homeAssistantHttpService.getDiscoveredHelper(entityId);
+        if (!helper) {
+            throw new devices_home_assistant_exceptions_1.DevicesHomeAssistantNotFoundException(`Home Assistant helper with entity_id ${entityId} not found`);
+        }
+        const warnings = [];
+        const domain = helper.domain;
+        const deviceClass = helper.state?.attributes?.device_class ?? null;
+        const mapping = this.mappingLoaderService.findMatchingMapping(domain, deviceClass, entityId);
+        const channelCategory = options?.channelCategory ?? mapping?.channel.category ?? devices_constants_1.ChannelCategory.GENERIC;
+        const deviceCategory = options?.deviceCategory ?? mapping?.deviceCategory ?? devices_constants_1.DeviceCategory.GENERIC;
+        const suggestedChannels = [];
+        if (domain === devices_home_assistant_constants_1.HomeAssistantDomain.CLIMATE) {
+            suggestedChannels.push(...this.generateClimateChannels(helper, entityId));
+        }
+        else if (mapping) {
+            const suggestedProperties = this.generatePropertiesFromMapping(helper, mapping, channelCategory, entityId);
+            suggestedChannels.push({
+                category: channelCategory,
+                name: helper.name,
+                confidence: 'medium',
+                suggestedProperties,
+            });
+        }
+        else {
+            suggestedChannels.push({
+                category: devices_constants_1.ChannelCategory.GENERIC,
+                name: helper.name,
+                confidence: 'low',
+                suggestedProperties: [
+                    {
+                        category: devices_constants_1.PropertyCategory.GENERIC,
+                        name: 'State',
+                        haAttribute: devices_home_assistant_constants_1.ENTITY_MAIN_STATE_ATTRIBUTE,
+                        dataType: devices_constants_1.DataTypeType.STRING,
+                        permissions: [devices_constants_1.PermissionType.READ_WRITE],
+                        unit: null,
+                        format: null,
+                        required: false,
+                        currentValue: helper.state?.state ?? null,
+                    },
+                ],
+            });
+            warnings.push({
+                type: 'no_mapping_rule',
+                message: `No specific mapping rule found for domain "${domain}"`,
+                suggestion: 'The helper will be mapped with generic properties',
+            });
+        }
+        const helperInfo = {
+            entityId: helper.entityId,
+            name: helper.name,
+            domain: helper.domain,
+        };
+        const suggestedDevice = {
+            category: deviceCategory,
+            name: helper.name,
+            confidence: mapping ? 'medium' : 'low',
+        };
+        const totalProperties = suggestedChannels.reduce((sum, ch) => sum + ch.suggestedProperties.length, 0);
+        const readyToAdopt = totalProperties > 0;
+        this.logger.log(`[HELPER MAPPING PREVIEW] Summary for helper "${helper.name}" (${entityId}): ` +
+            `domain=${domain}, channels=${suggestedChannels.length}, device=${deviceCategory}, ` +
+            `properties=${totalProperties}, ready_to_adopt=${readyToAdopt}`);
+        const preview = new helper_mapping_preview_model_1.HelperMappingPreviewModel();
+        preview.helper = helperInfo;
+        preview.suggestedDevice = suggestedDevice;
+        preview.suggestedChannel = suggestedChannels[0];
+        preview.suggestedChannels = suggestedChannels;
+        preview.warnings = warnings;
+        preview.readyToAdopt = readyToAdopt;
+        return preview;
+    }
+    generateClimateChannels(helper, _entityId) {
+        const channels = [];
+        const attributes = helper.state?.attributes ?? {};
+        if (attributes.current_temperature !== undefined) {
+            channels.push({
+                category: devices_constants_1.ChannelCategory.TEMPERATURE,
+                name: 'Temperature',
+                confidence: 'high',
+                suggestedProperties: [
+                    {
+                        category: devices_constants_1.PropertyCategory.TEMPERATURE,
+                        name: 'Temperature',
+                        haAttribute: 'current_temperature',
+                        dataType: devices_constants_1.DataTypeType.FLOAT,
+                        permissions: [devices_constants_1.PermissionType.READ_ONLY],
+                        unit: '°C',
+                        format: [0, 100],
+                        required: true,
+                        currentValue: attributes.current_temperature,
+                    },
+                ],
+            });
+        }
+        const thermostatProperties = [];
+        const hvacModes = attributes.hvac_modes;
+        thermostatProperties.push({
+            category: devices_constants_1.PropertyCategory.MODE,
+            name: 'Mode',
+            haAttribute: devices_home_assistant_constants_1.ENTITY_MAIN_STATE_ATTRIBUTE,
+            dataType: devices_constants_1.DataTypeType.ENUM,
+            permissions: [devices_constants_1.PermissionType.READ_WRITE],
+            unit: null,
+            format: hvacModes ?? ['off', 'heat', 'cool', 'auto'],
+            required: true,
+            currentValue: helper.state?.state ?? null,
+        });
+        const hvacAction = attributes.hvac_action;
+        const isActive = hvacAction ? ['heating', 'cooling', 'drying', 'fan'].includes(hvacAction) : false;
+        thermostatProperties.push({
+            category: devices_constants_1.PropertyCategory.ACTIVE,
+            name: 'Active',
+            haAttribute: 'hvac_action',
+            dataType: devices_constants_1.DataTypeType.BOOL,
+            permissions: [devices_constants_1.PermissionType.READ_ONLY],
+            unit: null,
+            format: null,
+            required: true,
+            currentValue: isActive,
+        });
+        channels.push({
+            category: devices_constants_1.ChannelCategory.THERMOSTAT,
+            name: 'Thermostat',
+            confidence: 'high',
+            suggestedProperties: thermostatProperties,
+        });
+        if (attributes.temperature !== undefined) {
+            const heaterProperties = [];
+            const isHeating = helper.state?.state !== 'off';
+            heaterProperties.push({
+                category: devices_constants_1.PropertyCategory.ON,
+                name: 'On',
+                haAttribute: devices_home_assistant_constants_1.ENTITY_MAIN_STATE_ATTRIBUTE,
+                dataType: devices_constants_1.DataTypeType.BOOL,
+                permissions: [devices_constants_1.PermissionType.READ_WRITE],
+                unit: null,
+                format: null,
+                required: true,
+                currentValue: isHeating,
+            });
+            heaterProperties.push({
+                category: devices_constants_1.PropertyCategory.TEMPERATURE,
+                name: 'Target Temperature',
+                haAttribute: 'temperature',
+                dataType: devices_constants_1.DataTypeType.FLOAT,
+                permissions: [devices_constants_1.PermissionType.READ_WRITE],
+                unit: '°C',
+                format: [attributes.min_temp ?? 0, attributes.max_temp ?? 100],
+                required: true,
+                currentValue: attributes.temperature,
+            });
+            heaterProperties.push({
+                category: devices_constants_1.PropertyCategory.STATUS,
+                name: 'Status',
+                haAttribute: 'hvac_action',
+                dataType: devices_constants_1.DataTypeType.BOOL,
+                permissions: [devices_constants_1.PermissionType.READ_ONLY],
+                unit: null,
+                format: null,
+                required: true,
+                currentValue: hvacAction === 'heating',
+            });
+            channels.push({
+                category: devices_constants_1.ChannelCategory.HEATER,
+                name: 'Heater',
+                confidence: 'medium',
+                suggestedProperties: heaterProperties,
+            });
+        }
+        return channels;
+    }
+    generatePropertiesFromMapping(helper, mapping, channelCategory, _entityId) {
+        const suggestedProperties = [];
+        for (const binding of mapping.propertyBindings) {
+            const propertyMetadata = (0, schema_utils_1.getPropertyMetadata)(channelCategory, binding.propertyCategory);
+            let currentValue = null;
+            if (binding.haAttribute === devices_home_assistant_constants_1.ENTITY_MAIN_STATE_ATTRIBUTE) {
+                currentValue = helper.state?.state ?? null;
+            }
+            else if (helper.state?.attributes) {
+                currentValue = helper.state.attributes[binding.haAttribute] ?? null;
+            }
+            suggestedProperties.push({
+                category: binding.propertyCategory,
+                name: this.propertyNameFromCategory(binding.propertyCategory),
+                haAttribute: binding.haAttribute,
+                dataType: propertyMetadata?.data_type ?? devices_constants_1.DataTypeType.STRING,
+                permissions: propertyMetadata?.permissions ?? [devices_constants_1.PermissionType.READ_ONLY],
+                unit: propertyMetadata?.unit ?? null,
+                format: this.getFormatFromState(helper.state?.attributes, binding.propertyCategory, helper.domain) ??
+                    propertyMetadata?.format ??
+                    null,
+                required: propertyMetadata?.required ?? false,
+                currentValue,
+            });
+        }
+        return suggestedProperties;
+    }
+    propertyNameFromCategory(category) {
+        return category.replace(/_/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+    }
+    getFormatFromState(attributes, propertyCategory, domain) {
+        if (!attributes) {
+            return null;
+        }
+        if (propertyCategory === devices_constants_1.PropertyCategory.MODE) {
+            if (domain === devices_home_assistant_constants_1.HomeAssistantDomain.CLIMATE) {
+                const hvacModes = attributes.hvac_modes;
+                if (Array.isArray(hvacModes) && hvacModes.length > 0) {
+                    return hvacModes;
+                }
+            }
+            const options = attributes.options;
+            if (Array.isArray(options) && options.length > 0) {
+                return options;
+            }
+        }
+        return null;
+    }
+};
+exports.HelperMappingPreviewService = HelperMappingPreviewService;
+exports.HelperMappingPreviewService = HelperMappingPreviewService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [home_assistant_http_service_1.HomeAssistantHttpService,
+        mappings_1.MappingLoaderService])
+], HelperMappingPreviewService);
+//# sourceMappingURL=helper-mapping-preview.service.js.map

package/dist/plugins/devices-home-assistant/services/helper-mapping-preview.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-mapping-preview.service.js","sourceRoot":"","sources":["../../../../src/plugins/devices-home-assistant/services/helper-mapping-preview.service.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices-home-assistant/services/home-assistant-config-validator.service.d.ts

@@ -0,0 +1,12 @@
+import { OnModuleInit } from '@nestjs/common';
+import type { IConfigValidationResult, IPluginConfigValidator } from '../../../modules/config/services/plugin-config-validator.service';
+import { PluginConfigValidatorService } from '../../../modules/config/services/plugin-config-validator.service';
+export declare class HomeAssistantConfigValidatorService implements IPluginConfigValidator, OnModuleInit {
+    private readonly pluginConfigValidator;
+    private readonly logger;
+    readonly pluginType = "devices-home-assistant-plugin";
+    constructor(pluginConfigValidator: PluginConfigValidatorService);
+    onModuleInit(): void;
+    validate(config: Record<string, unknown>): Promise<IConfigValidationResult>;
+    private tryConnect;
+}

package/dist/plugins/devices-home-assistant/services/home-assistant-config-validator.service.js

@@ -0,0 +1,102 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HomeAssistantConfigValidatorService = void 0;
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../../../common/logger");
+const plugin_config_validator_service_1 = require("../../../modules/config/services/plugin-config-validator.service");
+const devices_home_assistant_constants_1 = require("../devices-home-assistant.constants");
+let HomeAssistantConfigValidatorService = class HomeAssistantConfigValidatorService {
+    constructor(pluginConfigValidator) {
+        this.pluginConfigValidator = pluginConfigValidator;
+        this.logger = (0, logger_1.createExtensionLogger)(devices_home_assistant_constants_1.DEVICES_HOME_ASSISTANT_PLUGIN_NAME, 'ConfigValidator');
+        this.pluginType = devices_home_assistant_constants_1.DEVICES_HOME_ASSISTANT_PLUGIN_NAME;
+    }
+    onModuleInit() {
+        this.pluginConfigValidator.register(this);
+    }
+    async validate(config) {
+        const hostname = config['hostname'];
+        const apiKey = config['api_key'];
+        if (!hostname) {
+            return { valid: false, errors: [{ message: 'Hostname is required', field: 'hostname' }] };
+        }
+        if (!apiKey) {
+            return { valid: false, errors: [{ message: 'API key is required', field: 'api_key' }] };
+        }
+        const hasProtocol = hostname.startsWith('http://') || hostname.startsWith('https://');
+        const protocols = hasProtocol ? [''] : ['http://', 'https://'];
+        let lastError = null;
+        for (const protocol of protocols) {
+            const url = `${protocol}${hostname}/api/`;
+            try {
+                const result = await this.tryConnect(url, apiKey);
+                if (result) {
+                    return result;
+                }
+                return { valid: true };
+            }
+            catch (error) {
+                lastError = error;
+                if (lastError.name === 'AbortError' && protocols.length > 1) {
+                    continue;
+                }
+                break;
+            }
+        }
+        this.logger.error(`Connection test failed: ${lastError?.message}`);
+        if (lastError?.name === 'AbortError') {
+            return {
+                valid: false,
+                errors: [{ message: 'Connection timed out — check hostname and network', field: 'hostname' }],
+            };
+        }
+        return {
+            valid: false,
+            errors: [{ message: `Cannot connect to Home Assistant: ${lastError?.message}`, field: 'hostname' }],
+        };
+    }
+    async tryConnect(url, apiKey) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 10000);
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (response.ok) {
+                return null;
+            }
+            if (response.status === 401) {
+                return { valid: false, errors: [{ message: 'Invalid API key', field: 'api_key' }] };
+            }
+            return {
+                valid: false,
+                errors: [{ message: `Home Assistant returned status ${response.status}`, field: 'hostname' }],
+            };
+        }
+        catch (error) {
+            clearTimeout(timeout);
+            throw error;
+        }
+    }
+};
+exports.HomeAssistantConfigValidatorService = HomeAssistantConfigValidatorService;
+exports.HomeAssistantConfigValidatorService = HomeAssistantConfigValidatorService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [plugin_config_validator_service_1.PluginConfigValidatorService])
+], HomeAssistantConfigValidatorService);
+//# sourceMappingURL=home-assistant-config-validator.service.js.map

package/dist/plugins/devices-home-assistant/services/home-assistant-config-validator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-assistant-config-validator.service.js","sourceRoot":"","sources":["../../../../src/plugins/devices-home-assistant/services/home-assistant-config-validator.service.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices-home-assistant/services/home-assistant.http.service.d.ts

@@ -0,0 +1,44 @@
+import { ConfigService } from '../../../modules/config/services/config.service';
+import { ChannelsPropertiesService } from '../../../modules/devices/services/channels.properties.service';
+import { DeviceConnectivityService } from '../../../modules/devices/services/device-connectivity.service';
+import { DevicesService } from '../../../modules/devices/services/devices.service';
+import { MapperService } from '../mappers/mapper.service';
+import { HomeAssistantDiscoveredDeviceModel, HomeAssistantDiscoveredHelperModel, HomeAssistantStateModel } from '../models/home-assistant.model';
+import { VirtualPropertyService } from './virtual-property.service';
+export declare class HomeAssistantHttpService {
+    private readonly configService;
+    private readonly devicesService;
+    private readonly channelsPropertiesService;
+    private readonly homeAssistantMapperService;
+    private readonly deviceConnectivityService;
+    private readonly virtualPropertyService;
+    private readonly logger;
+    private pluginConfig;
+    constructor(configService: ConfigService, devicesService: DevicesService, channelsPropertiesService: ChannelsPropertiesService, homeAssistantMapperService: MapperService, deviceConnectivityService: DeviceConnectivityService, virtualPropertyService: VirtualPropertyService);
+    getDiscoveredDevice(id: string): Promise<HomeAssistantDiscoveredDeviceModel>;
+    getDiscoveredDevices(): Promise<HomeAssistantDiscoveredDeviceModel[]>;
+    getDiscoveredHelper(entityId: string): Promise<HomeAssistantDiscoveredHelperModel>;
+    getDiscoveredHelpers(): Promise<HomeAssistantDiscoveredHelperModel[]>;
+    getState(entityId: string): Promise<HomeAssistantStateModel>;
+    getStates(): Promise<HomeAssistantStateModel[]>;
+    loadStates(): Promise<void>;
+    syncDeviceStates(deviceId: string): Promise<void>;
+    markAllDevicesDisconnected(): Promise<void>;
+    markAllDevicesConnected(): Promise<void>;
+    private updateVirtualPropertyValues;
+    handleConfigurationUpdatedEvent(): void;
+    private get config();
+    private get enabled();
+    private get apiKey();
+    private get hostname();
+    private get baseUrl();
+    private ensureApiKey;
+    private toDiscoveredDeviceModel;
+    private toStateModel;
+    private fetchSingleHaDevice;
+    private fetchListHaDevices;
+    private fetchSingleHaState;
+    private fetchListHaStates;
+    private fetchListHaHelpers;
+    private toDiscoveredHelperModel;
+}