@fastybird/smart-panel-backend 1.1.0-alpha.63 → 1.1.0-alpha.65

package/dist/plugins/devices-virtual/services/virtual-dew-point-config.service.js

@@ -0,0 +1,193 @@
+"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.VirtualDewPointConfigService = void 0;
+const typeorm_1 = require("typeorm");
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const devices_constants_1 = require("../../../modules/devices/devices.constants");
+const devices_exceptions_1 = require("../../../modules/devices/devices.exceptions");
+const devices_entity_1 = require("../../../modules/devices/entities/devices.entity");
+const device_structure_lock_service_1 = require("../../../modules/devices/services/device-structure-lock.service");
+const devices_virtual_entity_1 = require("../entities/devices-virtual.entity");
+const virtual_dew_point_entity_1 = require("../entities/virtual-dew-point.entity");
+const virtual_producer_entity_1 = require("../entities/virtual-producer.entity");
+const virtual_transform_entity_1 = require("../entities/virtual-transform.entity");
+const dew_point_response_model_1 = require("../models/dew-point-response.model");
+const virtual_dependency_graph_service_1 = require("./virtual-dependency-graph.service");
+const virtual_dew_point_contract_utils_1 = require("./virtual-dew-point-contract.utils");
+const virtual_dew_point_runtime_service_1 = require("./virtual-dew-point-runtime.service");
+const virtual_dew_point_utils_1 = require("./virtual-dew-point.utils");
+const virtual_measurement_metadata_utils_1 = require("./virtual-measurement-metadata.utils");
+let VirtualDewPointConfigService = class VirtualDewPointConfigService {
+    constructor(dataSource, lock, graph, runtime, events) {
+        this.dataSource = dataSource;
+        this.lock = lock;
+        this.graph = graph;
+        this.runtime = runtime;
+        this.events = events;
+    }
+    async get(outputPropertyId) {
+        const config = await this.dataSource.manager.findOneBy(virtual_dew_point_entity_1.VirtualDewPointConfigEntity, { outputPropertyId });
+        if (!config)
+            throw new common_1.NotFoundException('Dew point configuration does not exist.');
+        const sources = await this.dataSource.manager.findBy(virtual_dew_point_entity_1.VirtualDewPointSourceEntity, { outputPropertyId });
+        return this.describe(config, sources, await this.graph.revision());
+    }
+    async configure(id, dto, preview = false) {
+        return this.lock.runExclusive(async () => {
+            if (preview) {
+                const result = await this.prepare(this.dataSource.manager, id, dto);
+                return this.describe(result.config, result.sources, await this.graph.revision(), false, await this.runtime.inspect(result.config, result.output, result.sources));
+            }
+            const result = await this.graph.withStructuralWrite(async (manager) => {
+                const prepared = await this.prepare(manager, id, dto, undefined, true);
+                await manager.save(prepared.config);
+                await manager.save(prepared.sources);
+                return prepared;
+            }, dto.expectedGraphRevision);
+            this.runtime.activate(result.output, result.config.revision);
+            result.output.unit = '°C';
+            result.output.measurementQuantity = 'dew_point';
+            this.events.emit(devices_constants_1.EventType.CHANNEL_PROPERTY_UPDATED, result.output);
+            return this.get(id);
+        });
+    }
+    async prepare(manager, id, dto, draftOutput, writing = false) {
+        if (dto.schemaVersion !== 1 ||
+            dto.formulaVersion !== virtual_dew_point_utils_1.DEW_POINT_FORMULA ||
+            !Number.isInteger(dto.maximumAgeSeconds) ||
+            dto.maximumAgeSeconds < 1 ||
+            dto.maximumAgeSeconds > 86400 ||
+            !Number.isInteger(dto.maximumSkewSeconds) ||
+            dto.maximumSkewSeconds < 0 ||
+            dto.maximumSkewSeconds > 3600 ||
+            ((writing || dto.expectedGraphRevision !== undefined) &&
+                (!Number.isSafeInteger(dto.expectedGraphRevision) ||
+                    dto.expectedGraphRevision + (writing ? 1 : 0) !== (await this.graph.revision(manager)))) ||
+            dto.sources?.length !== 2 ||
+            virtual_dew_point_utils_1.DEW_POINT_ROLES.some((role) => dto.sources.filter((s) => s.role === role).length !== 1))
+            throw new devices_exceptions_1.DevicesValidationException('Invalid dedicated dew point policy, roles or graph revision.');
+        const output = draftOutput ??
+            (await manager.findOne(devices_virtual_entity_1.VirtualChannelPropertyEntity, {
+                where: { id },
+                relations: ['channel', 'channel.device'],
+            }));
+        if (!(0, virtual_dew_point_contract_utils_1.dewPointOutputContract)(output) ||
+            (await manager.existsBy(virtual_transform_entity_1.VirtualTransformConfigEntity, { outputPropertyId: id })) ||
+            (await manager.existsBy(virtual_producer_entity_1.VirtualAggregateConfigEntity, { outputPropertyId: id })))
+            throw new devices_exceptions_1.DevicesValidationException('Dew point requires an unclaimed read-only generic derived output.');
+        const previous = await manager.findOneBy(virtual_dew_point_entity_1.VirtualDewPointConfigEntity, { outputPropertyId: id });
+        if (!Number.isInteger(dto.expectedRevision) || dto.expectedRevision !== (previous?.revision ?? 0))
+            throw new devices_exceptions_1.DevicesValidationException('Producer revision changed; reload and retry.');
+        const config = manager.create(virtual_dew_point_entity_1.VirtualDewPointConfigEntity, {
+            outputPropertyId: id,
+            schemaVersion: 1,
+            formulaVersion: virtual_dew_point_utils_1.DEW_POINT_FORMULA,
+            maximumAgeSeconds: dto.maximumAgeSeconds,
+            maximumSkewSeconds: dto.maximumSkewSeconds,
+            revision: (previous?.revision ?? 0) + 1,
+            configuredAt: new Date(),
+        });
+        const sources = [];
+        for (const role of virtual_dew_point_utils_1.DEW_POINT_ROLES) {
+            const sourceId = dto.sources.find((s) => s.role === role).sourcePropertyId;
+            if (sourceId === undefined)
+                throw new devices_exceptions_1.DevicesValidationException('Both explicit source identities are required.');
+            const old = await manager.findOneBy(virtual_dew_point_entity_1.VirtualDewPointSourceEntity, { outputPropertyId: id, role });
+            if (sourceId === null) {
+                if (!old || old.sourcePropertyId !== null)
+                    throw new devices_exceptions_1.DevicesValidationException('Only an existing missing binding may retain null.');
+                sources.push(old);
+                continue;
+            }
+            const source = await manager.findOne(devices_entity_1.ChannelPropertyEntity, {
+                where: { id: sourceId },
+                relations: ['channel', 'channel.device'],
+            });
+            if (source)
+                await (0, virtual_measurement_metadata_utils_1.hydrateMeasurementContract)(manager, source);
+            if (!sourceId || !(0, virtual_dew_point_contract_utils_1.dewPointSourceContract)(source, role))
+                throw new devices_exceptions_1.DevicesValidationException(`Incompatible ${role} source.`);
+            sources.push(manager.create(virtual_dew_point_entity_1.VirtualDewPointSourceEntity, {
+                outputPropertyId: id,
+                role,
+                sourcePropertyId: source.id,
+                sourcePropertyIdentity: source.id,
+                quantity: role === 'dry_bulb' ? 'temperature' : 'humidity',
+                unit: role === 'dry_bulb' ? '°C' : '%',
+                domain: (0, virtual_dew_point_utils_1.dewPointInputDomain)(role),
+                contractFingerprint: (0, virtual_dew_point_contract_utils_1.dewPointSourceFingerprint)(source),
+            }));
+        }
+        if (sources[0].sourcePropertyIdentity === sources[1].sourcePropertyIdentity)
+            throw new devices_exceptions_1.DevicesValidationException('Dew point sources must be distinct.');
+        await this.graph.validateReplacement(manager, [id], sources
+            .filter((s) => !!s.sourcePropertyId)
+            .map((s) => ({ outputPropertyId: id, sourcePropertyId: s.sourcePropertyId })));
+        return { config, sources, output };
+    }
+    async persist(manager, prepared) {
+        await manager.save(prepared.config);
+        await manager.save(prepared.sources);
+    }
+    activate(prepared) {
+        prepared.output.unit = '°C';
+        prepared.output.measurementQuantity = 'dew_point';
+        this.runtime.activate(prepared.output, prepared.config.revision);
+    }
+    inspect(prepared) {
+        return this.runtime.inspect(prepared.config, prepared.output, prepared.sources);
+    }
+    describe(config, sources, revision, live = true, inspected) {
+        const diagnostic = live ? this.runtime.readDiagnostics(config.outputPropertyId) : inspected;
+        return Object.assign(new dew_point_response_model_1.VirtualDewPointModel(), {
+            output_property: config.outputPropertyId,
+            schema_version: 1,
+            formula_version: config.formulaVersion,
+            revision: config.revision,
+            graph_revision: revision,
+            maximum_age_seconds: config.maximumAgeSeconds,
+            maximum_skew_seconds: config.maximumSkewSeconds,
+            quantity: 'dew_point',
+            unit: '°C',
+            current_value: live ? (diagnostic?.value ?? null) : null,
+            quality: live ? (diagnostic?.quality ?? 'unavailable') : 'unavailable',
+            errors: diagnostic && (diagnostic.errors.length || (live && diagnostic.quality === 'good'))
+                ? diagnostic.errors
+                : [live ? 'awaiting_fresh_inputs' : 'awaiting_fresh_inputs_after_save'],
+            expires_at: diagnostic?.expiresAt?.toISOString() ?? null,
+            sources: sources.map((s) => ({
+                role: s.role,
+                source_property: s.sourcePropertyId,
+                source_identity: s.sourcePropertyIdentity,
+                contract_fingerprint: s.contractFingerprint,
+                domain: s.domain,
+                quantity: s.quantity,
+                unit: s.unit,
+                current_value: diagnostic?.sources[s.role]?.value ?? null,
+                sampled_at: diagnostic?.sources[s.role]?.sampledAt ?? null,
+                age_seconds: diagnostic?.sources[s.role]?.ageSeconds ?? null,
+                errors: diagnostic?.sources[s.role]?.errors ?? [s.sourcePropertyId ? 'awaiting_fresh_input' : 'missing'],
+            })),
+        });
+    }
+};
+exports.VirtualDewPointConfigService = VirtualDewPointConfigService;
+exports.VirtualDewPointConfigService = VirtualDewPointConfigService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource,
+        device_structure_lock_service_1.DeviceStructureLockService,
+        virtual_dependency_graph_service_1.VirtualDependencyGraphService,
+        virtual_dew_point_runtime_service_1.VirtualDewPointRuntimeService,
+        event_emitter_1.EventEmitter2])
+], VirtualDewPointConfigService);
+//# sourceMappingURL=virtual-dew-point-config.service.js.map

package/dist/plugins/devices-virtual/services/virtual-dew-point-config.service.js.map

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

package/dist/plugins/devices-virtual/services/virtual-dew-point-contract.utils.d.ts

@@ -0,0 +1,5 @@
+import { ChannelPropertyEntity } from '../../../modules/devices/entities/devices.entity';
+import { DewPointRole } from './virtual-dew-point.utils';
+export declare function dewPointSourceContract(property: ChannelPropertyEntity, role: DewPointRole): boolean;
+export declare function dewPointOutputContract(property: ChannelPropertyEntity): boolean;
+export declare function dewPointSourceFingerprint(property: ChannelPropertyEntity): string;

package/dist/plugins/devices-virtual/services/virtual-dew-point-contract.utils.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dewPointSourceContract = dewPointSourceContract;
+exports.dewPointOutputContract = dewPointOutputContract;
+exports.dewPointSourceFingerprint = dewPointSourceFingerprint;
+const node_crypto_1 = require("node:crypto");
+const devices_constants_1 = require("../../../modules/devices/devices.constants");
+const property_metadata_utils_1 = require("../../../modules/devices/utils/property-metadata.utils");
+const devices_virtual_entity_1 = require("../entities/devices-virtual.entity");
+function dewPointSourceContract(property, role) {
+    const channel = property?.channel;
+    const device = channel?.device;
+    const temperature = role === 'dry_bulb';
+    return (!!device &&
+        channel.category === (temperature ? devices_constants_1.ChannelCategory.TEMPERATURE : devices_constants_1.ChannelCategory.HUMIDITY) &&
+        property.category === (temperature ? devices_constants_1.PropertyCategory.TEMPERATURE : devices_constants_1.PropertyCategory.HUMIDITY) &&
+        (!property.measurementQuantity ||
+            property.measurementQuantity ===
+                String(property.category)) &&
+        (0, property_metadata_utils_1.resolvePropertyUnit)(property) === (temperature ? '°C' : '%') &&
+        [
+            devices_constants_1.DataTypeType.FLOAT,
+            devices_constants_1.DataTypeType.CHAR,
+            devices_constants_1.DataTypeType.UCHAR,
+            devices_constants_1.DataTypeType.SHORT,
+            devices_constants_1.DataTypeType.USHORT,
+            devices_constants_1.DataTypeType.INT,
+            devices_constants_1.DataTypeType.UINT,
+        ].includes(property.dataType) &&
+        property.permissions?.some((permission) => [devices_constants_1.PermissionType.READ_ONLY, devices_constants_1.PermissionType.READ_WRITE].includes(permission)));
+}
+function dewPointOutputContract(property) {
+    const channel = property?.channel;
+    const device = channel?.device;
+    return (property instanceof devices_virtual_entity_1.VirtualChannelPropertyEntity &&
+        property.isDerived &&
+        !property.sourcePropertyId &&
+        device?.type === 'virtual' &&
+        device.mode === devices_virtual_entity_1.VirtualDeviceMode.SENSOR_TRANSFORM &&
+        channel.category === devices_constants_1.ChannelCategory.ANALOG_INPUT &&
+        property.category === devices_constants_1.PropertyCategory.VALUE &&
+        property.dataType === devices_constants_1.DataTypeType.FLOAT &&
+        property.permissions?.includes(devices_constants_1.PermissionType.READ_ONLY) &&
+        !property.permissions.some((permission) => [devices_constants_1.PermissionType.READ_WRITE, devices_constants_1.PermissionType.WRITE_ONLY].includes(permission)));
+}
+function dewPointSourceFingerprint(property) {
+    const channel = property.channel;
+    const device = channel.device;
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(JSON.stringify([
+        property.id,
+        channel.id,
+        device.id,
+        device.type,
+        channel.category,
+        channel.identifier,
+        property.category,
+        property.identifier,
+        property.dataType,
+        (0, property_metadata_utils_1.resolvePropertyUnit)(property),
+        property.measurementQuantity ??
+            String(property.category),
+        [...property.permissions].sort(),
+        property.format,
+        property.invalid,
+    ]))
+        .digest('hex');
+}
+//# sourceMappingURL=virtual-dew-point-contract.utils.js.map

package/dist/plugins/devices-virtual/services/virtual-dew-point-contract.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-dew-point-contract.utils.js","sourceRoot":"","sources":["../../../../src/plugins/devices-virtual/services/virtual-dew-point-contract.utils.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices-virtual/services/virtual-dew-point-runtime.service.d.ts

@@ -0,0 +1,65 @@
+import { DataSource } from 'typeorm';
+import { OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { EventEmitter2 } from '@nestjs/event-emitter';
+import { DeviceConnectionStateService } from '../../../modules/devices/services/device-connection-state.service';
+import { PropertyProducerRegistryService } from '../../../modules/devices/services/property-producer.registry.service';
+import { PropertyValueService } from '../../../modules/devices/services/property-value.service';
+import { VirtualChannelPropertyEntity } from '../entities/devices-virtual.entity';
+import { VirtualDewPointConfigEntity, VirtualDewPointSourceEntity } from '../entities/virtual-dew-point.entity';
+import { VirtualDependencyGraphService } from './virtual-dependency-graph.service';
+import { DewPointRole } from './virtual-dew-point.utils';
+export interface DewPointDiagnostic {
+    value: number | null;
+    quality: 'good' | 'unavailable';
+    errors: string[];
+    expiresAt: Date | null;
+    sources: Partial<Record<DewPointRole, {
+        value: number | null;
+        sampledAt: string | null;
+        ageSeconds: number | null;
+        errors: string[];
+    }>>;
+}
+export declare class VirtualDewPointRuntimeService implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly dataSource;
+    private readonly producers;
+    private readonly values;
+    private readonly graph;
+    private readonly connectivity;
+    private readonly events;
+    private readonly config;
+    private active;
+    private generation;
+    private completed;
+    private running?;
+    private timer?;
+    private readonly stops;
+    private readonly outputs;
+    private readonly barriers;
+    private readonly dirty;
+    private readonly sourceOutputs;
+    private readonly outputSources;
+    private readonly sourceLineages;
+    private readonly sourceOwners;
+    private structuralChange;
+    private readonly diagnostics;
+    constructor(dataSource: DataSource, producers: PropertyProducerRegistryService, values: PropertyValueService, graph: VirtualDependencyGraphService, connectivity: DeviceConnectionStateService, events: EventEmitter2, config?: ConfigService);
+    onApplicationBootstrap(): Promise<void>;
+    onModuleDestroy(): void;
+    activate(property: VirtualChannelPropertyEntity, revision: number): void;
+    requireFreshInputs(id: string): void;
+    readDiagnostics(id: string): DewPointDiagnostic | null;
+    requestRecompute(): void;
+    private markDirty;
+    private requestOutput;
+    private startDrain;
+    private indexSource;
+    private pruneSources;
+    flush(): Promise<void>;
+    private freshAfter;
+    private drain;
+    private evaluate;
+    inspect(config: VirtualDewPointConfigEntity, property: VirtualChannelPropertyEntity, rows: VirtualDewPointSourceEntity[]): Promise<DewPointDiagnostic>;
+    private snapshot;
+}