@fastybird/smart-panel-backend 1.1.0-alpha.3 → 1.1.0-alpha.31

package/dist/modules/devices/services/channel-input-occurrences.service.js

@@ -0,0 +1,163 @@
+"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.ChannelInputOccurrencesService = void 0;
+const crypto_1 = require("crypto");
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const extension_logger_service_1 = require("../../../common/logger/extension-logger.service");
+const devices_constants_1 = require("../devices.constants");
+const devices_exceptions_1 = require("../devices.exceptions");
+const channel_input_deduplication_service_1 = require("./channel-input-deduplication.service");
+const channels_properties_service_1 = require("./channels.properties.service");
+const channels_service_1 = require("./channels.service");
+const devices_service_1 = require("./devices.service");
+let ChannelInputOccurrencesService = class ChannelInputOccurrencesService {
+    constructor(devicesService, channelsService, channelsPropertiesService, deduplicationService, eventEmitter) {
+        this.devicesService = devicesService;
+        this.channelsService = channelsService;
+        this.channelsPropertiesService = channelsPropertiesService;
+        this.deduplicationService = deduplicationService;
+        this.eventEmitter = eventEmitter;
+        this.logger = (0, extension_logger_service_1.createExtensionLogger)(devices_constants_1.DEVICES_MODULE_NAME, 'ChannelInputOccurrencesService');
+    }
+    async ingestOccurrence(dto) {
+        return this.publishOccurrence(dto);
+    }
+    async publishOccurrence(dto) {
+        const device = await this.devicesService.findOne(dto.deviceId);
+        if (!device) {
+            throw new devices_exceptions_1.DevicesNotFoundException(`Device with ID ${dto.deviceId} was not found.`);
+        }
+        if (!device.enabled) {
+            this.logger.warn(`[OCCURRENCE DROPPED] Device ${device.id} is disabled. Occurrence dropped.`);
+            return null;
+        }
+        const channel = await this.channelsService.findOne(dto.channelId);
+        if (!channel) {
+            throw new devices_exceptions_1.DevicesNotFoundException(`Channel with ID ${dto.channelId} was not found.`);
+        }
+        const channelDeviceId = typeof channel.device === 'string' ? channel.device : channel.device?.id;
+        if (channelDeviceId !== dto.deviceId) {
+            throw new devices_exceptions_1.DevicesValidationException(`Channel ${dto.channelId} does not belong to device ${dto.deviceId}.`);
+        }
+        const property = await this.channelsPropertiesService.findOne(dto.propertyId);
+        if (!property) {
+            throw new devices_exceptions_1.DevicesNotFoundException(`Property with ID ${dto.propertyId} was not found.`);
+        }
+        const propertyChannelId = typeof property.channel === 'string' ? property.channel : property.channel?.id;
+        if (propertyChannelId !== dto.channelId) {
+            throw new devices_exceptions_1.DevicesValidationException(`Property ${dto.propertyId} does not belong to channel ${dto.channelId}.`);
+        }
+        const hasInputPermission = property.permissions.some((p) => [devices_constants_1.PermissionType.EVENT_ONLY, devices_constants_1.PermissionType.READ_ONLY].includes(p));
+        if (!hasInputPermission) {
+            throw new devices_exceptions_1.DevicesValidationException(`Property ${property.id} does not permit input occurrences (permissions: ${property.permissions.join(',')}).`);
+        }
+        const isInputChannel = [devices_constants_1.ChannelCategory.BUTTON, devices_constants_1.ChannelCategory.BINARY_INPUT, devices_constants_1.ChannelCategory.ANALOG_INPUT].includes(channel.category) ||
+            property.permissions.includes(devices_constants_1.PermissionType.EVENT_ONLY);
+        if (!isInputChannel) {
+            throw new devices_exceptions_1.DevicesValidationException(`Channel ${channel.id} is not an input channel and property ${property.id} does not have EVENT_ONLY permission.`);
+        }
+        if (property.dataType === devices_constants_1.DataTypeType.ENUM && Array.isArray(property.format) && property.format.length > 0) {
+            const allowedValues = property.format.map((val) => String(val));
+            if (!allowedValues.includes(String(dto.event))) {
+                throw new devices_exceptions_1.DevicesValidationException(`Event '${dto.event}' is not supported for property ${property.id}. Allowed values: ${allowedValues.join(', ')}.`);
+            }
+        }
+        if (this.deduplicationService.isDuplicate(device.id, channel.id, dto.sourceOccurrenceId, property.id, dto.event, dto.nativeEventType)) {
+            this.logger.debug(`[OCCURRENCE DROPPED] Duplicate redelivery detected for device=${device.id} channel=${channel.id} property=${property.id} event=${dto.event} sourceOccurrenceId=${dto.sourceOccurrenceId}`);
+            return null;
+        }
+        const occurrence = {
+            id: (0, crypto_1.randomUUID)(),
+            deviceId: device.id,
+            channelId: channel.id,
+            propertyId: property.id,
+            deviceCategory: device.category,
+            channelCategory: channel.category,
+            propertyCategory: property.category,
+            event: dto.event,
+            timestamp: new Date().toISOString(),
+            sourceTimestamp: dto.sourceTimestamp,
+            sourceOccurrenceId: dto.sourceOccurrenceId,
+            nativeEventType: dto.nativeEventType,
+            data: dto.data,
+            integration: device.type,
+            endpoint: device.identifier ?? null,
+        };
+        this.eventEmitter.emit(devices_constants_1.EventType.CHANNEL_INPUT_OCCURRENCE, occurrence);
+        return occurrence;
+    }
+    subscribe(listener) {
+        const reportError = (error) => {
+            const err = error;
+            this.logger.error(`Error in occurrence subscriber callback: ${err.message}`, {
+                message: err.message,
+                stack: err.stack,
+            });
+        };
+        const handler = (payload) => {
+            try {
+                void Promise.resolve(listener(payload)).catch(reportError);
+            }
+            catch (error) {
+                reportError(error);
+            }
+        };
+        this.eventEmitter.on(devices_constants_1.EventType.CHANNEL_INPUT_OCCURRENCE, handler);
+        return () => {
+            this.eventEmitter.off(devices_constants_1.EventType.CHANNEL_INPUT_OCCURRENCE, handler);
+        };
+    }
+    async getInputCapabilities(channelId) {
+        const channel = await this.channelsService.findOne(channelId);
+        if (!channel) {
+            return null;
+        }
+        const deviceId = typeof channel.device === 'string' ? channel.device : channel.device?.id;
+        const properties = (channel.properties ?? []).filter((prop) => prop.permissions.some((p) => [devices_constants_1.PermissionType.EVENT_ONLY, devices_constants_1.PermissionType.READ_ONLY].includes(p)));
+        const isInputChannel = [devices_constants_1.ChannelCategory.BUTTON, devices_constants_1.ChannelCategory.BINARY_INPUT, devices_constants_1.ChannelCategory.ANALOG_INPUT].includes(channel.category) ||
+            properties.some((p) => p.permissions.includes(devices_constants_1.PermissionType.EVENT_ONLY));
+        const supportedEvents = new Set();
+        for (const prop of properties) {
+            if (prop.dataType === devices_constants_1.DataTypeType.ENUM && Array.isArray(prop.format)) {
+                for (const item of prop.format) {
+                    supportedEvents.add(String(item));
+                }
+            }
+        }
+        const propertyModels = properties.map((prop) => ({
+            id: prop.id,
+            category: prop.category,
+            permissions: prop.permissions,
+            data_type: prop.dataType,
+            format: Array.isArray(prop.format) ? prop.format : null,
+        }));
+        return {
+            channel_id: channel.id,
+            device_id: deviceId ?? '',
+            category: channel.category,
+            is_input: isInputChannel,
+            supported_events: Array.from(supportedEvents),
+            properties: propertyModels,
+        };
+    }
+};
+exports.ChannelInputOccurrencesService = ChannelInputOccurrencesService;
+exports.ChannelInputOccurrencesService = ChannelInputOccurrencesService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [devices_service_1.DevicesService,
+        channels_service_1.ChannelsService,
+        channels_properties_service_1.ChannelsPropertiesService,
+        channel_input_deduplication_service_1.ChannelInputDeduplicationService,
+        event_emitter_1.EventEmitter2])
+], ChannelInputOccurrencesService);
+//# sourceMappingURL=channel-input-occurrences.service.js.map

package/dist/modules/devices/services/channel-input-occurrences.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-input-occurrences.service.js","sourceRoot":"","sources":["../../../../src/modules/devices/services/channel-input-occurrences.service.ts"],"names":[],"mappings":"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"}

package/dist/modules/devices/services/channels.properties.service.d.ts

@@ -1,13 +1,18 @@
 import { DataSource, EntityManager, Repository } from 'typeorm';
+import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
 import { EventEmitter2 } from '@nestjs/event-emitter';
 import { type StorageBackendBinding } from '../../storage/services/storage.service';
 import { ChannelCategory, DataTypeType, DeviceCategory, PermissionType, PropertyCategory } from '../devices.constants';
 import { CreateChannelPropertyDto } from '../dto/create-channel-property.dto';
 import { UpdateChannelPropertyDto } from '../dto/update-channel-property.dto';
 import { ChannelPropertyEntity } from '../entities/devices.entity';
-import { type PropertyValueState } from '../models/property-value-state.model';
+import { PropertyValueState } from '../models/property-value-state.model';
 import { ChannelsPropertiesTypeMapperService } from './channels.properties-type-mapper.service';
+import { CommandLatencyTraceCollectorService } from './command-latency-trace-collector.service';
 import { DeviceStructureLockService } from './device-structure-lock.service';
+import { PropertyCommandWindowHandle, PropertyCommandWindowService } from './property-command-window.service';
+import { PropertyMetadataService } from './property-metadata.service';
+import { PropertyStateCoordinatorService } from './property-state-coordinator.service';
 import { PropertyValueSourceRegistryService } from './property-value-source.registry.service';
 import { PropertyValueService } from './property-value.service';
 export interface BoundedChannelProperties {
@@ -73,6 +78,7 @@ export interface VisiblePropertySearchSummaryPage {
     total: number;
 }
 export interface ChannelPropertyUpdateOptions {
+    skipUnchangedMetadata?: boolean;
     strictValuePersistence?: boolean;
     storageBinding?: StorageBackendBinding;
     comparePersistedValue?: boolean;
@@ -80,29 +86,52 @@ export interface ChannelPropertyUpdateOptions {
     beforeValuePersistence?: () => Promise<void>;
     valueTimestamp?: Date;
     resolveValueTimestamp?: () => Date;
+    commandOrigin?: {
+        readonly handle: PropertyCommandWindowHandle;
+        readonly baseline: PropertyValueState;
+    };
 }
-export declare class ChannelsPropertiesService {
+export declare class ChannelsPropertiesService implements OnModuleInit, OnModuleDestroy {
     private readonly repository;
     private readonly propertiesMapperService;
     private readonly propertyValueService;
     private readonly valueSourceRegistry;
     private readonly structureLock;
+    private readonly propertyStateCoordinator;
+    private readonly propertyCommandWindowService;
     private readonly dataSource;
     private readonly eventEmitter;
+    private readonly commandLatencyTraceCollector;
+    private readonly propertyMetadata?;
     private readonly logger;
     private static readonly VISIBLE_READABLE_STATE_CANDIDATE_MAX_LIMIT;
-    constructor(repository: Repository<ChannelPropertyEntity>, propertiesMapperService: ChannelsPropertiesTypeMapperService, propertyValueService: PropertyValueService, valueSourceRegistry: PropertyValueSourceRegistryService, structureLock: DeviceStructureLockService, dataSource: DataSource, eventEmitter: EventEmitter2);
+    private commandWindowCleanupTimer;
+    constructor(repository: Repository<ChannelPropertyEntity>, propertiesMapperService: ChannelsPropertiesTypeMapperService, propertyValueService: PropertyValueService, valueSourceRegistry: PropertyValueSourceRegistryService, structureLock: DeviceStructureLockService, propertyStateCoordinator: PropertyStateCoordinatorService, propertyCommandWindowService: PropertyCommandWindowService, dataSource: DataSource, eventEmitter: EventEmitter2, commandLatencyTraceCollector?: CommandLatencyTraceCollectorService, propertyMetadata?: PropertyMetadataService);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
     findAll<TProperty extends ChannelPropertyEntity>(channelId?: string | string[], type?: string): Promise<TProperty[]>;
     findBoundedForChannels(channelIds: string[], perChannelLimit: number, strictValues?: boolean, propertyCategories?: string[]): Promise<BoundedChannelProperties>;
     findWritableCandidates(limit: number, offset?: number): Promise<WritablePropertyCandidates>;
     findVisibleReadableStateCandidates(input: VisibleReadableStateCandidatesInput): Promise<VisibleReadableStateCandidates>;
     searchVisibleSummaryPage(input: VisiblePropertySearchSummaryInput): Promise<VisiblePropertySearchSummaryPage>;
     private buildSearchPermissionFilter;
+    exists(id: string, channelId?: string): Promise<boolean>;
     findOne<TProperty extends ChannelPropertyEntity>(id: string, channelId?: string, type?: string): Promise<TProperty | null>;
     findOneBy<TProperty extends ChannelPropertyEntity>(column: 'id' | 'category' | 'identifier' | 'name', value: string | number | boolean, channelId?: string, type?: string): Promise<TProperty | null>;
     create<TProperty extends ChannelPropertyEntity, TCreateDTO extends CreateChannelPropertyDto>(channelId: string, createDto: TCreateDTO): Promise<TProperty>;
     update<TProperty extends ChannelPropertyEntity, TUpdateDTO extends UpdateChannelPropertyDto>(id: string, updateDto: TUpdateDTO, options?: ChannelPropertyUpdateOptions): Promise<TProperty>;
+    private updateInternal;
+    private publishValueSet;
+    private updateValueOnly;
+    private commitWindowedProviderValue;
+    private commitCommandOriginValue;
+    private recoverExpiredCommandWindows;
     remove(id: string, manager?: EntityManager): Promise<void>;
     getOneOrThrow(id: string): Promise<ChannelPropertyEntity>;
+    private hasEntityFieldChanges;
+    private isValueOnlyUpdate;
+    private getValueOnlyMapping;
+    private findOneForValueUpdate;
+    private snapshotValueState;
     private validateDto;
 }