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

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

@@ -0,0 +1,209 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VirtualTransformConfigService = void 0;
+const typeorm_1 = require("typeorm");
+const uuid_1 = require("uuid");
+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 creation_capture_1 = require("../../../modules/devices/services/creation-capture");
+const device_structure_lock_service_1 = require("../../../modules/devices/services/device-structure-lock.service");
+const property_metadata_utils_1 = require("../../../modules/devices/utils/property-metadata.utils");
+const devices_virtual_entity_1 = require("../entities/devices-virtual.entity");
+const virtual_dew_point_entity_1 = require("../entities/virtual-dew-point.entity");
+const virtual_transform_entity_1 = require("../entities/virtual-transform.entity");
+const transform_response_model_1 = require("../models/transform-response.model");
+const virtual_dependency_graph_service_1 = require("./virtual-dependency-graph.service");
+const virtual_measurement_metadata_utils_1 = require("./virtual-measurement-metadata.utils");
+const virtual_producer_state_service_1 = require("./virtual-producer-state.service");
+const virtual_transform_contract_utils_1 = require("./virtual-transform-contract.utils");
+const virtual_transform_resolver_1 = require("./virtual-transform-resolver");
+const virtual_transform_runtime_service_1 = require("./virtual-transform-runtime.service");
+let VirtualTransformConfigService = class VirtualTransformConfigService {
+    constructor(dataSource, structureLock, graph, events, state, runtime, resolver = new virtual_transform_resolver_1.VirtualTransformResolver()) {
+        this.dataSource = dataSource;
+        this.structureLock = structureLock;
+        this.graph = graph;
+        this.events = events;
+        this.state = state;
+        this.runtime = runtime;
+        this.resolver = resolver;
+    }
+    async configure(outputPropertyId, dto) {
+        const state = (0, creation_capture_1.captureCreation)(this.state, [
+            'captureConfigurationHandoff',
+            'withConfigurationWrite',
+            'recordConfiguration',
+            'installUnavailable',
+        ]);
+        const handoff = state.values.captureConfigurationHandoff.call(state.receiver);
+        return this.structureLock.runExclusive(async () => {
+            let prepared;
+            await state.values.withConfigurationWrite.call(state.receiver, handoff, async (manager) => {
+                prepared = await this.prepare(manager, outputPropertyId, dto);
+                await state.values.recordConfiguration.call(state.receiver, manager, handoff, {
+                    kind: 'transform',
+                    config: prepared.config,
+                    source: prepared.source,
+                    outputs: [prepared.output],
+                });
+                await this.persist(manager, prepared);
+            }, dto.expectedGraphRevision, this.structureLock.captureExclusiveOwner());
+            state.values.installUnavailable.call(state.receiver, prepared.output, prepared.config.revision);
+            prepared.output.unit = prepared.config.unit;
+            prepared.output.measurementQuantity = prepared.config.quantity;
+            this.runtime?.requireFreshSample(outputPropertyId, prepared.source.sourcePropertyId);
+            this.events.emit(devices_constants_1.EventType.CHANNEL_PROPERTY_UPDATED, prepared.output);
+            return this.get(outputPropertyId);
+        });
+    }
+    async persist(manager, prepared) {
+        await manager.save(prepared.config);
+        await manager.save(prepared.source);
+        const range = prepared.config.policy.outputRange;
+        prepared.output.format = [range.minimum, range.maximum];
+        await manager.update(devices_virtual_entity_1.VirtualChannelPropertyEntity, { id: prepared.output.id }, { format: prepared.output.format });
+    }
+    describe(prepared, graphRevision) {
+        return this.model(prepared.config, prepared.source, graphRevision, false);
+    }
+    activate(output, config, source) {
+        this.state.installUnavailable(output, config.revision);
+        output.unit = config.unit;
+        output.measurementQuantity = config.quantity;
+        this.runtime?.requireFreshSample(output.id, source.sourcePropertyId);
+    }
+    async preview(outputPropertyId, dto) {
+        return this.structureLock.runExclusive(async () => {
+            const revision = await this.graph.revision();
+            if (dto.expectedGraphRevision !== undefined && dto.expectedGraphRevision !== revision)
+                throw new devices_exceptions_1.DevicesValidationException('Virtual dependency graph revision changed; reload and retry.');
+            const prepared = await this.prepare(this.dataSource.manager, outputPropertyId, dto, undefined, true);
+            return this.model(prepared.config, prepared.source, revision, false);
+        });
+    }
+    async get(outputPropertyId) {
+        const config = await this.dataSource.manager.findOneBy(virtual_transform_entity_1.VirtualTransformConfigEntity, { outputPropertyId });
+        const source = await this.dataSource.manager.findOneBy(virtual_transform_entity_1.VirtualTransformSourceEntity, { outputPropertyId });
+        if (!config || !source)
+            throw new common_1.NotFoundException('Numeric transform configuration does not exist.');
+        return this.model(config, source, await this.graph.revision(), true);
+    }
+    async property(manager, id, previewOnly = false) {
+        const property = previewOnly
+            ? await manager
+                .createQueryBuilder(devices_entity_1.ChannelPropertyEntity, 'property')
+                .leftJoinAndSelect('property.channel', 'channel')
+                .leftJoinAndSelect('channel.device', 'device')
+                .where('property.id = :id', { id })
+                .callListeners(false)
+                .getOne()
+            : await manager.findOne(devices_entity_1.ChannelPropertyEntity, {
+                where: { id },
+                relations: ['channel', 'channel.device'],
+            });
+        if (!property)
+            throw new devices_exceptions_1.DevicesValidationException('Source/output property does not exist.');
+        if (previewOnly)
+            await (0, virtual_measurement_metadata_utils_1.hydrateMeasurementContract)(manager, property);
+        return property;
+    }
+    async prepare(manager, outputPropertyId, dto, draftOutput, previewOnly = false) {
+        const output = draftOutput ?? (await this.property(manager, outputPropertyId, previewOnly));
+        if (await manager.existsBy(virtual_dew_point_entity_1.VirtualDewPointConfigEntity, { outputPropertyId }))
+            throw new devices_exceptions_1.DevicesValidationException('Dedicated dew point output cannot be reconfigured as a one-input transform.');
+        const existing = await manager.findOneBy(virtual_transform_entity_1.VirtualTransformConfigEntity, { outputPropertyId });
+        if (existing && (existing.quantity !== dto.quantity || existing.unit !== dto.unit))
+            throw new devices_exceptions_1.DevicesValidationException('Existing output quantity and unit are immutable; create a new output for different measurement semantics.');
+        if (!Number.isInteger(dto.expectedRevision) || dto.expectedRevision !== (existing?.revision ?? 0))
+            throw new devices_exceptions_1.DevicesValidationException('Producer configuration revision changed; reload and retry.');
+        const old = await manager.findOneBy(virtual_transform_entity_1.VirtualTransformSourceEntity, { outputPropertyId });
+        if (!dto.source || (dto.source.id && dto.source.id !== old?.id))
+            throw new devices_exceptions_1.DevicesValidationException('Source binding UUID is not owned by this output.');
+        if (!dto.source.sourcePropertyId && (!old || old.sourcePropertyId !== null))
+            throw new devices_exceptions_1.DevicesValidationException('Only a missing existing source may retain a null source.');
+        const physical = dto.source.sourcePropertyId
+            ? await this.property(manager, dto.source.sourcePropertyId, previewOnly)
+            : null;
+        const config = manager.create(virtual_transform_entity_1.VirtualTransformConfigEntity, {
+            outputPropertyId,
+            schemaVersion: dto.schemaVersion,
+            policy: dto.policy,
+            maximumAgeSeconds: dto.maximumAgeSeconds,
+            quantity: dto.quantity,
+            unit: dto.unit,
+            revision: (existing?.revision ?? 0) + 1,
+            configuredAt: new Date(),
+        });
+        const errors = (0, virtual_transform_contract_utils_1.transformContractErrors)(config, output, physical, physical ? undefined : old, this.resolver);
+        if (errors.length)
+            throw new devices_exceptions_1.DevicesValidationException(`Invalid numeric transform contract: ${errors.join(', ')}.`);
+        const source = manager.create(virtual_transform_entity_1.VirtualTransformSourceEntity, {
+            id: old?.id ?? (0, uuid_1.v4)(),
+            outputPropertyId,
+            sourcePropertyId: physical?.id ?? null,
+            sourcePropertyIdentity: physical?.id ?? old.sourcePropertyIdentity,
+            quantity: physical?.category ?? old.quantity,
+            unit: physical ? (0, property_metadata_utils_1.resolvePropertyUnit)(physical) : old.unit,
+        });
+        await this.graph.validateReplacement(manager, [outputPropertyId], physical ? [{ outputPropertyId, sourcePropertyId: physical.id }] : []);
+        return { config, source, output: output };
+    }
+    model(config, source, graphRevision, diagnostics) {
+        const result = diagnostics ? this.runtime?.readDiagnostics(config.outputPropertyId) : null;
+        return Object.assign(new transform_response_model_1.VirtualTransformConfigurationModel(), {
+            output_property: config.outputPropertyId,
+            schema_version: config.schemaVersion,
+            revision: config.revision,
+            graph_revision: graphRevision,
+            maximum_age_seconds: config.maximumAgeSeconds,
+            quantity: config.quantity,
+            unit: config.unit,
+            policy: config.policy,
+            runtime_readiness: this.runtime?.isActive() ? 'ready' : 'unavailable',
+            current_value: result?.value ?? null,
+            quality: result?.quality ?? 'unavailable',
+            errors: result?.reasons ?? ['runtime_unavailable'],
+            source: Object.assign(new transform_response_model_1.VirtualTransformSourceModel(), {
+                id: source.id,
+                output_property: source.outputPropertyId,
+                source_property: source.sourcePropertyId,
+                source_identity: source.sourcePropertyIdentity,
+                quantity: source.quantity,
+                unit: source.unit,
+                current_value: result?.inputValue ?? null,
+                sampled_at: result?.sampledAt?.toISOString() ?? null,
+                age_seconds: result?.ageSeconds ?? null,
+                exclusion: result?.reasons[0] ?? null,
+            }),
+        });
+    }
+};
+exports.VirtualTransformConfigService = VirtualTransformConfigService;
+exports.VirtualTransformConfigService = VirtualTransformConfigService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(5, (0, common_1.Optional)()),
+    __param(6, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [typeorm_1.DataSource,
+        device_structure_lock_service_1.DeviceStructureLockService,
+        virtual_dependency_graph_service_1.VirtualDependencyGraphService,
+        event_emitter_1.EventEmitter2,
+        virtual_producer_state_service_1.VirtualProducerStateService,
+        virtual_transform_runtime_service_1.VirtualTransformRuntimeService,
+        virtual_transform_resolver_1.VirtualTransformResolver])
+], VirtualTransformConfigService);
+//# sourceMappingURL=virtual-transform-config.service.js.map

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

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

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

@@ -0,0 +1,8 @@
+import { ChannelPropertyEntity } from '../../../modules/devices/entities/devices.entity';
+import { VirtualTransformConfigEntity, VirtualTransformSourceEntity } from '../entities/virtual-transform.entity';
+import { VirtualTransformResolver } from './virtual-transform-resolver';
+export declare const isTransformQuantity: (quantity: unknown) => quantity is string;
+export declare const isTransformUnit: (unit: unknown) => unit is string;
+export declare function isTransformOutputSlot(property: ChannelPropertyEntity): boolean;
+export declare function isTransformOutput(property: ChannelPropertyEntity, quantity: string, unit: string): boolean;
+export declare function transformContractErrors(config: Pick<VirtualTransformConfigEntity, 'schemaVersion' | 'policy' | 'maximumAgeSeconds' | 'quantity' | 'unit'>, output: ChannelPropertyEntity, source: ChannelPropertyEntity | null, binding?: Pick<VirtualTransformSourceEntity, 'quantity' | 'unit'>, resolver?: VirtualTransformResolver): string[];

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

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTransformUnit = exports.isTransformQuantity = void 0;
+exports.isTransformOutputSlot = isTransformOutputSlot;
+exports.isTransformOutput = isTransformOutput;
+exports.transformContractErrors = transformContractErrors;
+const devices_constants_1 = require("../../../modules/devices/devices.constants");
+const property_metadata_utils_1 = require("../../../modules/devices/utils/property-metadata.utils");
+const native_temperature_contract_1 = require("../../devices-shelly-ng/contracts/native-temperature.contract");
+const devices_shelly_ng_entity_1 = require("../../devices-shelly-ng/entities/devices-shelly-ng.entity");
+const devices_virtual_entity_1 = require("../entities/devices-virtual.entity");
+const virtual_numeric_transform_utils_1 = require("./virtual-numeric-transform.utils");
+const virtual_transform_resolver_1 = require("./virtual-transform-resolver");
+const isTransformQuantity = (quantity) => typeof quantity === 'string' && quantity.trim() === quantity && /^[a-z][a-z0-9_]{0,63}$/.test(quantity);
+exports.isTransformQuantity = isTransformQuantity;
+const isTransformUnit = (unit) => typeof unit === 'string' &&
+    unit.length > 0 &&
+    unit.length <= 32 &&
+    unit.trim() === unit &&
+    /^[\p{L}\p{N} %°µΩ·*/^()._-]+$/u.test(unit);
+exports.isTransformUnit = isTransformUnit;
+function isTransformOutputSlot(property) {
+    const channel = property?.channel;
+    const device = channel?.device;
+    return (!!property &&
+        device?.type === 'virtual' &&
+        device.mode === devices_virtual_entity_1.VirtualDeviceMode.SENSOR_TRANSFORM &&
+        device.category === devices_constants_1.DeviceCategory.SENSOR &&
+        property.dataType === devices_constants_1.DataTypeType.FLOAT &&
+        property.valueOrigin ===
+            devices_virtual_entity_1.VirtualValueOrigin.DERIVED &&
+        !property.sourcePropertyId &&
+        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)) &&
+        ((channel.category === devices_constants_1.ChannelCategory.ANALOG_INPUT && property.category === devices_constants_1.PropertyCategory.VALUE) ||
+            (0, property_metadata_utils_1.resolvePropertyUnit)(property) !== null));
+}
+function isTransformOutput(property, quantity, unit) {
+    if (!isTransformOutputSlot(property) || !(0, exports.isTransformQuantity)(quantity) || !(0, exports.isTransformUnit)(unit))
+        return false;
+    const channel = property.channel;
+    const generic = channel.category === devices_constants_1.ChannelCategory.ANALOG_INPUT && property.category === devices_constants_1.PropertyCategory.VALUE;
+    if (generic)
+        return quantity !== String(devices_constants_1.PropertyCategory.TEMPERATURE);
+    return (String(property.category) === quantity &&
+        (0, property_metadata_utils_1.resolvePropertyUnit)(property) === unit &&
+        (property.unit == null || property.unit === unit) &&
+        (quantity !== String(devices_constants_1.PropertyCategory.TEMPERATURE) ||
+            (channel.category === devices_constants_1.ChannelCategory.TEMPERATURE && unit === '°C')));
+}
+function transformContractErrors(config, output, source, binding, resolver = new virtual_transform_resolver_1.VirtualTransformResolver()) {
+    const errors = resolver.validate(config.policy, source
+        ? { quantity: String(source.category), unit: (0, property_metadata_utils_1.resolvePropertyUnit)(source) }
+        : binding
+            ? { quantity: binding.quantity, unit: binding.unit }
+            : undefined, { quantity: config.quantity, unit: config.unit });
+    if (config.schemaVersion !== 1 ||
+        !Number.isInteger(config.maximumAgeSeconds) ||
+        config.maximumAgeSeconds < 1 ||
+        config.maximumAgeSeconds > 86400)
+        errors.push('invalid_policy');
+    if (config.quantity === 'dew_point')
+        errors.push('dedicated_dew_point_required');
+    if (!isTransformOutput(output, config.quantity, config.unit))
+        errors.push('incompatible_output');
+    if (!source)
+        return errors;
+    const device = source.channel?.device;
+    const unit = (0, property_metadata_utils_1.resolvePropertyUnit)(source);
+    if (!device ||
+        device.type === 'virtual' ||
+        ![
+            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(source.dataType) ||
+        !source.permissions?.some((permission) => [devices_constants_1.PermissionType.READ_ONLY, devices_constants_1.PermissionType.READ_WRITE].includes(permission)) ||
+        typeof unit !== 'string' ||
+        !unit.length ||
+        (source.unit != null && source.unit !== unit) ||
+        (binding && (binding.quantity !== String(source.category) || binding.unit !== unit)))
+        errors.push('incompatible_source');
+    if ([virtual_numeric_transform_utils_1.VirtualNumericTransformOperator.NTC_BETA, virtual_numeric_transform_utils_1.VirtualNumericTransformOperator.STEINHART_HART].includes(config.policy?.operator) &&
+        ((source.category !== devices_constants_1.PropertyCategory.VOLTAGE &&
+            !(source instanceof devices_shelly_ng_entity_1.ShellyNgChannelPropertyEntity &&
+                source.channel?.device instanceof devices_shelly_ng_entity_1.ShellyNgDeviceEntity &&
+                source.channel.category === devices_constants_1.ChannelCategory.ANALOG_INPUT &&
+                source.category === devices_constants_1.PropertyCategory.VALUE &&
+                source.identifier === 'voltage' &&
+                source.permissions?.includes(devices_constants_1.PermissionType.READ_ONLY) &&
+                !source.permissions.some((permission) => [devices_constants_1.PermissionType.READ_WRITE, devices_constants_1.PermissionType.WRITE_ONLY].includes(permission)) &&
+                (0, native_temperature_contract_1.hasQualifiedRawVoltageIdentity)(source.channel.identifier))) ||
+            unit !== 'V' ||
+            config.quantity !== String(devices_constants_1.PropertyCategory.TEMPERATURE) ||
+            config.unit !== '°C'))
+        errors.push('incompatible_ntc_semantics');
+    return errors;
+}
+//# sourceMappingURL=virtual-transform-contract.utils.js.map

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

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

package/dist/plugins/devices-virtual/services/virtual-transform-preview.utils.d.ts

@@ -0,0 +1,3 @@
+import { VirtualTransformConfigurationModel } from '../models/transform-response.model';
+import { VirtualTransformResolver } from './virtual-transform-resolver';
+export declare function attachTransformPreview(model: VirtualTransformConfigurationModel, input?: number, resolver?: VirtualTransformResolver): VirtualTransformConfigurationModel;

package/dist/plugins/devices-virtual/services/virtual-transform-preview.utils.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachTransformPreview = attachTransformPreview;
+const transform_response_model_1 = require("../models/transform-response.model");
+const virtual_transform_resolver_1 = require("./virtual-transform-resolver");
+function attachTransformPreview(model, input, resolver = new virtual_transform_resolver_1.VirtualTransformResolver()) {
+    if (input === undefined)
+        return model;
+    const computed = resolver.evaluate(model.policy, input);
+    model.preview_result = Object.assign(new transform_response_model_1.VirtualTransformPreviewModel(), {
+        input,
+        value: computed.value,
+        error: computed.reason,
+        qualified: false,
+    });
+    return model;
+}
+//# sourceMappingURL=virtual-transform-preview.utils.js.map

package/dist/plugins/devices-virtual/services/virtual-transform-preview.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-transform-preview.utils.js","sourceRoot":"","sources":["../../../../src/plugins/devices-virtual/services/virtual-transform-preview.utils.ts"],"names":[],"mappings":";;AAKA,wDAcC;AAnBD,iFAAsH;AAEtH,6EAAwE;AAGxE,SAAgB,sBAAsB,CACrC,KAAyC,EACzC,KAAc,EACd,QAAQ,GAAG,IAAI,qDAAwB,EAAE;IAEzC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,uDAA4B,EAAE,EAAE;QACxE,KAAK;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,SAAS,EAAE,KAAc;KACzB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/plugins/devices-virtual/services/virtual-transform-resolver.d.ts

@@ -0,0 +1,15 @@
+import { NumericOperatorScope, VirtualNumericOperatorRegistry } from './virtual-numeric-operator.registry';
+import { VirtualNumericTransformConfig, VirtualNumericTransformResult } from './virtual-numeric-transform.utils';
+export declare class VirtualTransformResolver {
+    readonly registry?: VirtualNumericOperatorRegistry;
+    constructor(registry?: VirtualNumericOperatorRegistry);
+    capture(policy: VirtualNumericTransformConfig): NumericOperatorScope | null;
+    validate(policy: VirtualNumericTransformConfig, input?: {
+        quantity: string;
+        unit: string;
+    }, output?: {
+        quantity: string;
+        unit: string;
+    }, scope?: NumericOperatorScope): string[];
+    evaluate(policy: VirtualNumericTransformConfig, input: unknown, scope?: NumericOperatorScope): VirtualNumericTransformResult;
+}

package/dist/plugins/devices-virtual/services/virtual-transform-resolver.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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VirtualTransformResolver = void 0;
+const smart_panel_extension_sdk_1 = require("@fastybird/smart-panel-extension-sdk");
+const common_1 = require("@nestjs/common");
+const virtual_numeric_operator_registry_1 = require("./virtual-numeric-operator.registry");
+const virtual_numeric_transform_utils_1 = require("./virtual-numeric-transform.utils");
+let VirtualTransformResolver = class VirtualTransformResolver {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    capture(policy) {
+        return policy?.operator === virtual_numeric_transform_utils_1.VirtualNumericTransformOperator.EXTENSION
+            ? (this.registry?.capture(policy.operatorId, policy.operatorVersion) ?? null)
+            : null;
+    }
+    validate(policy, input, output, scope = this.capture(policy)) {
+        if (policy?.operator !== virtual_numeric_transform_utils_1.VirtualNumericTransformOperator.EXTENSION)
+            return (0, virtual_numeric_transform_utils_1.validateVirtualNumericTransform)(policy);
+        const errors = [];
+        if (Object.keys(policy).some((key) => ![
+            'operator',
+            'contractVersion',
+            'operatorId',
+            'operatorVersion',
+            'parameters',
+            'inputRange',
+            'outputRange',
+        ].includes(key)) ||
+            policy.contractVersion !== 1 ||
+            typeof policy.operatorId !== 'string' ||
+            policy.operatorId.length > 280 ||
+            !Number.isSafeInteger(policy.operatorVersion) ||
+            policy.operatorVersion < 1 ||
+            !(0, smart_panel_extension_sdk_1.isNumericOperatorRange)(policy.inputRange) ||
+            !(0, smart_panel_extension_sdk_1.isNumericOperatorRange)(policy.outputRange))
+            return ['invalid_extension_policy'];
+        if (!scope?.isCurrent())
+            return ['operator_unavailable'];
+        const definition = scope.definition;
+        for (const key of ['inputRange', 'outputRange'])
+            if (policy[key].minimum < definition[key].minimum || policy[key].maximum > definition[key].maximum)
+                errors.push('operator_domain_mismatch');
+        if ((input && (input.quantity !== definition.input.quantity || input.unit !== definition.input.unit)) ||
+            (output && (output.quantity !== definition.output.quantity || output.unit !== definition.output.unit)))
+            errors.push('operator_measurement_mismatch');
+        try {
+            (0, smart_panel_extension_sdk_1.validateNumericOperatorParameters)(definition, policy.parameters);
+        }
+        catch {
+            errors.push('invalid_operator_parameters');
+        }
+        return errors;
+    }
+    evaluate(policy, input, scope = this.capture(policy)) {
+        if (policy?.operator !== virtual_numeric_transform_utils_1.VirtualNumericTransformOperator.EXTENSION)
+            return (0, virtual_numeric_transform_utils_1.evaluateVirtualNumericTransform)(policy, input);
+        if (this.validate(policy, undefined, undefined, scope).length || !scope?.isCurrent())
+            return { value: null, reason: 'invalid_configuration' };
+        if (typeof input !== 'number' || !Number.isFinite(input))
+            return { value: null, reason: 'invalid_input' };
+        if (input < policy.inputRange.minimum || input > policy.inputRange.maximum)
+            return { value: null, reason: 'input_out_of_range' };
+        try {
+            const result = scope.definition.evaluate(input, (0, smart_panel_extension_sdk_1.validateNumericOperatorParameters)(scope.definition, policy.parameters));
+            if (typeof result !== 'number' || !Number.isFinite(result)) {
+                if (result &&
+                    (typeof result === 'object' || typeof result === 'function') &&
+                    typeof result.then === 'function')
+                    void Promise.resolve(result).catch(() => undefined);
+                return { value: null, reason: 'nonfinite_output' };
+            }
+            if (!scope.isCurrent())
+                return { value: null, reason: 'invalid_configuration' };
+            if (result < policy.outputRange.minimum || result > policy.outputRange.maximum)
+                return { value: null, reason: 'output_out_of_range' };
+            return { value: result, reason: null };
+        }
+        catch {
+            return { value: null, reason: 'invalid_domain' };
+        }
+    }
+};
+exports.VirtualTransformResolver = VirtualTransformResolver;
+exports.VirtualTransformResolver = VirtualTransformResolver = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [virtual_numeric_operator_registry_1.VirtualNumericOperatorRegistry])
+], VirtualTransformResolver);
+//# sourceMappingURL=virtual-transform-resolver.js.map

package/dist/plugins/devices-virtual/services/virtual-transform-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-transform-resolver.js","sourceRoot":"","sources":["../../../../src/plugins/devices-virtual/services/virtual-transform-resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,oFAAiH;AACjH,2CAAsD;AAEtD,2FAA2G;AAC3G,uFAM2C;AAIpC,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IACpC,YAAiC,QAAyC;QAAzC,aAAQ,GAAR,QAAQ,CAAiC;IAAG,CAAC;IAC9E,OAAO,CAAC,MAAqC;QAC5C,OAAO,MAAM,EAAE,QAAQ,KAAK,iEAA+B,CAAC,SAAS;YACpE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC;YAC7E,CAAC,CAAC,IAAI,CAAC;IACT,CAAC;IACD,QAAQ,CACP,MAAqC,EACrC,KAA0C,EAC1C,MAA2C,EAC3C,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAE5B,IAAI,MAAM,EAAE,QAAQ,KAAK,iEAA+B,CAAC,SAAS;YAAE,OAAO,IAAA,iEAA+B,EAAC,MAAM,CAAC,CAAC;QACnH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IACC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CACvB,CAAC,GAAG,EAAE,EAAE,CACP,CAAC;YACA,UAAU;YACV,iBAAiB;YACjB,YAAY;YACZ,iBAAiB;YACjB,YAAY;YACZ,YAAY;YACZ,aAAa;SACb,CAAC,QAAQ,CAAC,GAAG,CAAC,CAChB;YACD,MAAM,CAAC,eAAe,KAAK,CAAC;YAC5B,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;YACrC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG;YAC9B,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,eAAe,CAAC;YAC7C,MAAM,CAAC,eAAe,GAAG,CAAC;YAC1B,CAAC,IAAA,kDAAsB,EAAC,MAAM,CAAC,UAAU,CAAC;YAC1C,CAAC,IAAA,kDAAsB,EAAC,MAAM,CAAC,WAAW,CAAC;YAE3C,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE;YAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,aAAa,CAAU;YACvD,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO;gBACjG,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,IACC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEtG,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,IAAI,CAAC;YACJ,IAAA,6DAAiC,EAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IACD,QAAQ,CACP,MAAqC,EACrC,KAAc,EACd,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAE5B,IAAI,MAAM,EAAE,QAAQ,KAAK,iEAA+B,CAAC,SAAS;YACjE,OAAO,IAAA,iEAA+B,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE;YACnF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;QACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QAC1G,IAAI,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,IAAI,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO;YACzE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;QACtD,IAAI,CAAC;YACJ,MAAM,MAAM,GAAY,KAAK,CAAC,UAAU,CAAC,QAAQ,CAChD,KAAK,EACL,IAAA,6DAAiC,EAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CACtE,CAAC;YACF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAE5D,IACC,MAAM;oBACN,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC;oBAC5D,OAAQ,MAA+B,CAAC,IAAI,KAAK,UAAU;oBAE3D,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACrD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;YACpD,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE;gBAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;YAChF,IAAI,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,IAAI,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO;gBAC7E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;YACvD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QAClD,CAAC;IACF,CAAC;CACD,CAAA;AAzFY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,mBAAU,GAAE;IAEC,WAAA,IAAA,iBAAQ,GAAE,CAAA;qCAAqB,kEAA8B;GAD9D,wBAAwB,CAyFpC"}

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

@@ -0,0 +1,54 @@
+import { DataSource } from 'typeorm';
+import { OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
+import { ConfigService as NestConfigService } 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 { VirtualDependencyGraphService } from './virtual-dependency-graph.service';
+import { VirtualTransformResolver } from './virtual-transform-resolver';
+export interface TransformEvaluation {
+    value: number | null;
+    inputValue: number | null;
+    quality: 'good' | 'unavailable';
+    reasons: string[];
+    sampledAt: Date | null;
+    expiresAt: Date | null;
+    ageSeconds: number | null;
+}
+export declare class VirtualTransformRuntimeService implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly dataSource;
+    private readonly producers;
+    private readonly values;
+    private readonly connectivity;
+    private readonly graph;
+    private readonly events;
+    private readonly configService;
+    private readonly resolver;
+    private readonly outputs;
+    private readonly diagnostics;
+    private readonly stopListeners;
+    private timer?;
+    private active;
+    private readonly operatorBarriers;
+    private requested;
+    private completed;
+    private readonly dirty;
+    private readonly sourceOutputs;
+    private readonly sourceSequences;
+    private readonly freshBarriers;
+    private readonly sourceOwners;
+    private running?;
+    constructor(dataSource: DataSource, producers: PropertyProducerRegistryService, values: PropertyValueService, connectivity: DeviceConnectionStateService, graph: VirtualDependencyGraphService, events: EventEmitter2, configService?: NestConfigService, resolver?: VirtualTransformResolver);
+    onApplicationBootstrap(): Promise<void>;
+    onModuleDestroy(): void;
+    isActive(): boolean;
+    requireFreshSample(outputId: string, sourceId: string | null): void;
+    readDiagnostics(outputPropertyId: string): TransformEvaluation | null;
+    requestRecompute(sourcePropertyId?: string): void;
+    flush(): Promise<void>;
+    private drain;
+    private evaluateAll;
+    private current;
+    private publish;
+}