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

package/dist/plugins/devices-virtual/controllers/virtual-thermostat-authoring.controller.js

@@ -0,0 +1,111 @@
+"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.VirtualThermostatAuthoringController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const devices_exceptions_1 = require("../../../modules/devices/devices.exceptions");
+const api_documentation_decorator_1 = require("../../../modules/swagger/decorators/api-documentation.decorator");
+const roles_guard_1 = require("../../../modules/users/guards/roles.guard");
+const users_constants_1 = require("../../../modules/users/users.constants");
+const devices_virtual_constants_1 = require("../devices-virtual.constants");
+const thermostat_authoring_dto_1 = require("../dto/thermostat-authoring.dto");
+const thermostat_authoring_response_model_1 = require("../models/thermostat-authoring-response.model");
+const thermostat_response_model_1 = require("../models/thermostat-response.model");
+const virtual_thermostat_authoring_service_1 = require("../services/virtual-thermostat-authoring.service");
+let VirtualThermostatAuthoringController = class VirtualThermostatAuthoringController {
+    constructor(authoring) {
+        this.authoring = authoring;
+    }
+    async propertyBinding(id) {
+        const binding = await this.authoring.propertyBinding(id);
+        if (!binding)
+            throw new common_1.NotFoundException('Thermostat binding property does not exist.');
+        const response = new thermostat_authoring_response_model_1.VirtualThermostatPropertyBindingResponseModel();
+        response.data = binding;
+        return response;
+    }
+    async create(dto) {
+        const response = new thermostat_authoring_response_model_1.VirtualCreatedThermostatResponseModel();
+        response.data = await this.execute(() => this.authoring.create(dto));
+        return response;
+    }
+    async preview(dto) {
+        const response = new thermostat_response_model_1.VirtualThermostatConfigurationResponseModel();
+        response.data = await this.execute(() => this.authoring.preview(dto));
+        return response;
+    }
+    async execute(operation) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (error instanceof devices_exceptions_1.DevicesValidationException)
+                throw new common_1.UnprocessableEntityException(error.message);
+            throw error;
+        }
+    }
+};
+exports.VirtualThermostatAuthoringController = VirtualThermostatAuthoringController;
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Resolve a thermostat binding property',
+        description: 'Resolve the owning channel and device of a saved thermostat binding by property UUID.',
+        operationId: 'get-devices-virtual-plugin-thermostat-property-binding',
+    }),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_authoring_response_model_1.VirtualThermostatPropertyBindingResponseModel, 'Thermostat binding path'),
+    (0, common_1.Get)('binding-properties/:id'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatAuthoringController.prototype, "propertyBinding", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Create climate controller thermostat',
+        description: 'Create a complete thermostat graph, source policy, local settings and exclusive actuator claims in one admitted writer.',
+        operationId: 'create-devices-virtual-plugin-thermostat-producer',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Proposed graph, source, claim, policy or revision is invalid'),
+    (0, api_documentation_decorator_1.ApiCreatedSuccessResponse)(thermostat_authoring_response_model_1.VirtualCreatedThermostatResponseModel, 'Create thermostat'),
+    (0, roles_guard_1.Roles)(users_constants_1.UserRole.OWNER, users_constants_1.UserRole.ADMIN),
+    (0, common_1.Post)(),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [thermostat_authoring_dto_1.CreateVirtualThermostatProducerDto]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatAuthoringController.prototype, "create", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Preview climate controller thermostat',
+        description: 'Validate a proposed thermostat, bindings and reservations through metadata only, without catalog writes or runtime effects.',
+        operationId: 'preview-devices-virtual-plugin-thermostat-draft',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Proposed graph, source, claim, policy or revision is invalid'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_response_model_1.VirtualThermostatConfigurationResponseModel, 'Preview thermostat'),
+    (0, common_1.Post)('draft-preview'),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [thermostat_authoring_dto_1.CreateVirtualThermostatProducerDto]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatAuthoringController.prototype, "preview", null);
+exports.VirtualThermostatAuthoringController = VirtualThermostatAuthoringController = __decorate([
+    (0, swagger_1.ApiTags)(devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME),
+    (0, common_1.Controller)('producers/thermostats'),
+    __metadata("design:paramtypes", [virtual_thermostat_authoring_service_1.VirtualThermostatAuthoringService])
+], VirtualThermostatAuthoringController);
+//# sourceMappingURL=virtual-thermostat-authoring.controller.js.map

package/dist/plugins/devices-virtual/controllers/virtual-thermostat-authoring.controller.js.map

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

package/dist/plugins/devices-virtual/controllers/virtual-thermostat-comfort.controller.d.ts

@@ -0,0 +1,14 @@
+import { AuthenticatedRequest } from '../../../modules/auth/guards/auth.guard';
+import { CancelThermostatOverrideDto, ConfigureThermostatComfortDto, CreateThermostatOverrideDto, SelectThermostatPresetDto } from '../dto/thermostat-comfort.dto';
+import { ThermostatComfortResponseModel } from '../models/thermostat-comfort-response.model';
+import { VirtualThermostatComfortService } from '../services/virtual-thermostat-comfort.service';
+export declare class VirtualThermostatComfortController {
+    private readonly comfort;
+    constructor(comfort: VirtualThermostatComfortService);
+    get(id: string): Promise<ThermostatComfortResponseModel>;
+    configure(id: string, dto: ConfigureThermostatComfortDto): Promise<ThermostatComfortResponseModel>;
+    select(id: string, dto: SelectThermostatPresetDto): Promise<ThermostatComfortResponseModel>;
+    override(id: string, dto: CreateThermostatOverrideDto, request: AuthenticatedRequest): Promise<ThermostatComfortResponseModel>;
+    cancel(id: string, dto: CancelThermostatOverrideDto): Promise<ThermostatComfortResponseModel>;
+    private response;
+}

package/dist/plugins/devices-virtual/controllers/virtual-thermostat-comfort.controller.js

@@ -0,0 +1,160 @@
+"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.VirtualThermostatComfortController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const auth_constants_1 = require("../../../modules/auth/auth.constants");
+const devices_exceptions_1 = require("../../../modules/devices/devices.exceptions");
+const api_documentation_decorator_1 = require("../../../modules/swagger/decorators/api-documentation.decorator");
+const roles_guard_1 = require("../../../modules/users/guards/roles.guard");
+const users_constants_1 = require("../../../modules/users/users.constants");
+const devices_virtual_constants_1 = require("../devices-virtual.constants");
+const thermostat_comfort_dto_1 = require("../dto/thermostat-comfort.dto");
+const thermostat_comfort_response_model_1 = require("../models/thermostat-comfort-response.model");
+const virtual_thermostat_comfort_service_1 = require("../services/virtual-thermostat-comfort.service");
+let VirtualThermostatComfortController = class VirtualThermostatComfortController {
+    constructor(comfort) {
+        this.comfort = comfort;
+    }
+    get(id) {
+        return this.response(() => this.comfort.get(id));
+    }
+    configure(id, dto) {
+        return this.response(() => this.comfort.configure(id, dto, {
+            heating_range: dto.heating_range,
+            cooling_range: dto.cooling_range,
+            presets: dto.presets,
+            automation_enabled: dto.automation_enabled,
+        }));
+    }
+    select(id, dto) {
+        return this.response(() => this.comfort.select(id, dto, dto.preset, dto.clear_user_off));
+    }
+    override(id, dto, request) {
+        const auth = request.auth;
+        const panel = auth?.type === 'token' && auth.ownerType === auth_constants_1.TokenOwnerType.DISPLAY && !!auth.ownerId && !!auth.tokenId;
+        if (auth?.type !== 'user' && !panel)
+            throw new common_1.ForbiddenException('An identified user or display session is required.');
+        const actorId = auth.type === 'user' ? auth.id : `display:${auth.ownerId}:token:${auth.tokenId}`;
+        const source = auth.type === 'user' ? 'user' : 'panel';
+        return this.response(() => this.comfort.override(id, dto, {
+            preset: dto.preset,
+            setpoints: dto.setpoints,
+            expires_at: dto.expires_at,
+        }, actorId, source));
+    }
+    cancel(id, dto) {
+        return this.response(() => this.comfort.cancel(id, dto, dto.override_id));
+    }
+    async response(operation) {
+        try {
+            const response = new thermostat_comfort_response_model_1.ThermostatComfortResponseModel();
+            response.data = Object.assign(new thermostat_comfort_response_model_1.ThermostatComfortModel(), await operation());
+            return response;
+        }
+        catch (error) {
+            if (error instanceof devices_exceptions_1.DevicesValidationException)
+                throw new common_1.UnprocessableEntityException(error.message);
+            throw error;
+        }
+    }
+};
+exports.VirtualThermostatComfortController = VirtualThermostatComfortController;
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Read thermostat comfort arbitration',
+        description: 'Read manual/preset/override intent, durable expiry state and explicit restart clock policy. Physical activity and guards remain in the runtime endpoint.',
+        operationId: 'get-devices-virtual-plugin-thermostat-comfort',
+    }),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_comfort_response_model_1.ThermostatComfortResponseModel, 'Current comfort arbitration'),
+    (0, common_1.Get)(),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatComfortController.prototype, "get", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Configure explicit thermostat presets',
+        description: "Configure Celsius ranges and ordered comfort/eco/away definitions without seeding temperatures. Returns this operation's persisted six-field intent accepted by its native database acknowledgement. Subsequent maintenance or concurrent writes may supersede it; GET reads current arbitration. This response does not establish an unexpired lease or output permission. Automation requires explicit opt-in; no engines run here. A live override retains its resolved setpoints.",
+        operationId: 'configure-devices-virtual-plugin-thermostat-comfort',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Invalid branch, range, deadband or revision'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_comfort_response_model_1.ThermostatComfortResponseModel, 'Committed comfort definition intent'),
+    (0, roles_guard_1.Roles)(users_constants_1.UserRole.OWNER, users_constants_1.UserRole.ADMIN),
+    (0, common_1.Put)(),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, thermostat_comfort_dto_1.ConfigureThermostatComfortDto]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatComfortController.prototype, "configure", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Select thermostat baseline preset',
+        description: "Select a preset/manual baseline without overwriting an override. Returns this operation's persisted intent accepted by its native database acknowledgement, including the effective intent derived from that postimage. It may be superseded by subsequent maintenance or concurrent writes; GET reads current arbitration. This response does not establish an unexpired lease or output permission. Clearing user OFF requires an explicit action; HVAC mode is separate.",
+        operationId: 'select-devices-virtual-plugin-thermostat-preset',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Missing preset, locked controller or revision conflict'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_comfort_response_model_1.ThermostatComfortResponseModel, 'Committed selection intent'),
+    (0, common_1.Post)('selection'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, thermostat_comfort_dto_1.SelectThermostatPresetDto]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatComfortController.prototype, "select", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Create temporary thermostat override',
+        description: "An authenticated user or display creates or replaces a preset/explicit-setpoint override until an absolute expiry. Source and actor are assigned by the server. Returns this operation's persisted six-field intent accepted by its native database acknowledgement. Subsequent maintenance or concurrent writes may supersede it; GET reads current arbitration. The response does not establish an unexpired lease or output permission, clear user OFF or bypass guards.",
+        operationId: 'create-devices-virtual-plugin-thermostat-override',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Invalid override, locked controller or revision conflict'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_comfort_response_model_1.ThermostatComfortResponseModel, 'Committed override intent'),
+    (0, common_1.Post)('override'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(1, (0, common_1.Body)()),
+    __param(2, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, thermostat_comfort_dto_1.CreateThermostatOverrideDto, Object]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatComfortController.prototype, "override", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Cancel temporary thermostat override',
+        description: "Terminate only the exactly identified active or clock-uncertain override, retaining its identity and lifetime metadata. Returns this operation's persisted six-field cancellation intent accepted by its native database acknowledgement, with its then-current baseline. Subsequent maintenance or concurrent writes may supersede it; GET reads current arbitration. Wrong, terminal or stale targets still reject. The response grants no output permission, replays no historical command and does not clear user OFF.",
+        operationId: 'cancel-devices-virtual-plugin-thermostat-override',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Override identity or revision conflict'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_comfort_response_model_1.ThermostatComfortResponseModel, 'Committed cancellation intent'),
+    (0, common_1.Post)('override/cancel'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, thermostat_comfort_dto_1.CancelThermostatOverrideDto]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatComfortController.prototype, "cancel", null);
+exports.VirtualThermostatComfortController = VirtualThermostatComfortController = __decorate([
+    (0, swagger_1.ApiTags)(devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME),
+    (0, common_1.Controller)('producers/thermostats/:id/comfort'),
+    __metadata("design:paramtypes", [virtual_thermostat_comfort_service_1.VirtualThermostatComfortService])
+], VirtualThermostatComfortController);
+//# sourceMappingURL=virtual-thermostat-comfort.controller.js.map

package/dist/plugins/devices-virtual/controllers/virtual-thermostat-comfort.controller.js.map

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

package/dist/plugins/devices-virtual/controllers/virtual-thermostat-config.controller.d.ts

@@ -0,0 +1,18 @@
+import { AuthenticatedRequest } from '../../../modules/auth/guards/auth.guard';
+import { ConfigureVirtualThermostatDto, RequestVirtualThermostatReleaseDto, RestoreVirtualThermostatActuatorDto } from '../dto/thermostat-config.dto';
+import { VirtualThermostatConfigurationResponseModel, VirtualThermostatRecoveriesResponseModel, VirtualThermostatRuntimeResponseModel } from '../models/thermostat-response.model';
+import { VirtualThermostatConfigService } from '../services/virtual-thermostat-config.service';
+import { VirtualThermostatRuntimeService } from '../services/virtual-thermostat-runtime.service';
+export declare class VirtualThermostatConfigController {
+    private readonly configs;
+    private readonly runtime;
+    constructor(configs: VirtualThermostatConfigService, runtime: VirtualThermostatRuntimeService);
+    getRuntime(id: string): Promise<VirtualThermostatRuntimeResponseModel>;
+    get(id: string): Promise<VirtualThermostatConfigurationResponseModel>;
+    configure(id: string, dto: ConfigureVirtualThermostatDto): Promise<VirtualThermostatConfigurationResponseModel>;
+    preview(id: string, dto: ConfigureVirtualThermostatDto): Promise<VirtualThermostatConfigurationResponseModel>;
+    release(id: string, dto: RequestVirtualThermostatReleaseDto): Promise<VirtualThermostatConfigurationResponseModel>;
+    restoreActuator(id: string, claimId: string, dto: RestoreVirtualThermostatActuatorDto, req: AuthenticatedRequest): Promise<VirtualThermostatConfigurationResponseModel>;
+    recoveries(id: string): Promise<VirtualThermostatRecoveriesResponseModel>;
+    private response;
+}

package/dist/plugins/devices-virtual/controllers/virtual-thermostat-config.controller.js

@@ -0,0 +1,196 @@
+"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.VirtualThermostatConfigController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const devices_exceptions_1 = require("../../../modules/devices/devices.exceptions");
+const api_documentation_decorator_1 = require("../../../modules/swagger/decorators/api-documentation.decorator");
+const roles_guard_1 = require("../../../modules/users/guards/roles.guard");
+const users_constants_1 = require("../../../modules/users/users.constants");
+const devices_virtual_constants_1 = require("../devices-virtual.constants");
+const thermostat_config_dto_1 = require("../dto/thermostat-config.dto");
+const thermostat_response_model_1 = require("../models/thermostat-response.model");
+const virtual_thermostat_config_service_1 = require("../services/virtual-thermostat-config.service");
+const virtual_thermostat_runtime_service_1 = require("../services/virtual-thermostat-runtime.service");
+let VirtualThermostatConfigController = class VirtualThermostatConfigController {
+    constructor(configs, runtime) {
+        this.configs = configs;
+        this.runtime = runtime;
+    }
+    async getRuntime(id) {
+        const runtime = await this.runtime.inspect(id);
+        if (!runtime)
+            throw new common_1.NotFoundException('Thermostat configuration does not exist.');
+        const response = new thermostat_response_model_1.VirtualThermostatRuntimeResponseModel();
+        response.data = Object.assign(new thermostat_response_model_1.VirtualThermostatRuntimeModel(), runtime);
+        return response;
+    }
+    async get(id) {
+        return this.response(() => this.configs.get(id));
+    }
+    async configure(id, dto) {
+        return this.response(() => this.configs.configure(id, dto));
+    }
+    async preview(id, dto) {
+        return this.response(() => this.configs.preview(id, dto));
+    }
+    async release(id, dto) {
+        return this.response(() => this.configs.requestRelease(id, dto.expectedRevision));
+    }
+    async restoreActuator(id, claimId, dto, req) {
+        if (req.auth?.type !== 'user')
+            throw new common_1.ForbiddenException('An identified operator user session is required.');
+        const actorId = req.auth.id;
+        return this.response(() => this.configs.restoreActuator(id, claimId, dto, actorId));
+    }
+    async recoveries(id) {
+        const response = new thermostat_response_model_1.VirtualThermostatRecoveriesResponseModel();
+        response.data = (await this.configs.recoveryEvents(id)).map((row) => Object.assign(new thermostat_response_model_1.VirtualThermostatRecoveryModel(), row));
+        return response;
+    }
+    async response(operation) {
+        try {
+            const response = new thermostat_response_model_1.VirtualThermostatConfigurationResponseModel();
+            response.data = Object.assign(new thermostat_response_model_1.VirtualThermostatConfigurationModel(), await operation());
+            return response;
+        }
+        catch (error) {
+            if (error instanceof devices_exceptions_1.DevicesValidationException)
+                throw new common_1.UnprocessableEntityException(error.message);
+            throw error;
+        }
+    }
+};
+exports.VirtualThermostatConfigController = VirtualThermostatConfigController;
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Read thermostat runtime',
+        description: 'Read requested comfort intent, qualified measurements, physical branch activity and independent inhibit reasons.',
+        operationId: 'get-devices-virtual-plugin-thermostat-runtime',
+    }),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_response_model_1.VirtualThermostatRuntimeResponseModel, 'Thermostat runtime'),
+    (0, common_1.Get)('thermostats/:id/runtime'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatConfigController.prototype, "getRuntime", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Read thermostat configuration',
+        description: 'Read role-aware sources, persistent reservations, registered settings and activation blockers.',
+        operationId: 'get-devices-virtual-plugin-thermostat-configuration',
+    }),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_response_model_1.VirtualThermostatConfigurationResponseModel, 'Thermostat configuration'),
+    (0, common_1.Get)('thermostats/:id'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatConfigController.prototype, "get", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Configure thermostat',
+        description: 'Atomically validate configuration, register local settings and reserve canonical physical actuator leaves. Authoring remains draft until installed hardware qualification and durable runtime reconciliation.',
+        operationId: 'configure-devices-virtual-plugin-thermostat',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Policy, reservation, source or revision conflict'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_response_model_1.VirtualThermostatConfigurationResponseModel, 'Durable thermostat configuration'),
+    (0, roles_guard_1.Roles)(users_constants_1.UserRole.OWNER, users_constants_1.UserRole.ADMIN),
+    (0, common_1.Put)('thermostats/:id'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, thermostat_config_dto_1.ConfigureVirtualThermostatDto]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatConfigController.prototype, "configure", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Preview thermostat configuration',
+        description: 'Run the same configuration and ownership checks without reserving hardware or changing local permissions.',
+        operationId: 'preview-devices-virtual-plugin-thermostat',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Policy, reservation, source or revision conflict'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_response_model_1.VirtualThermostatConfigurationResponseModel, 'Proposed thermostat configuration'),
+    (0, common_1.Post)('thermostats/:id/preview'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, thermostat_config_dto_1.ConfigureVirtualThermostatDto]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatConfigController.prototype, "preview", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Request thermostat actuator release',
+        description: 'Atomically persist requested HVAC OFF and release demand for every retained non-released reservation, preserving comfort and recovery metadata. Return the latest configuration and diagnostics after ordinary maintenance. Dispatch acceptance, timeout and unrelated OFF readback do not free hardware.',
+        operationId: 'release-devices-virtual-plugin-thermostat',
+    }),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Configuration revision conflict'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_response_model_1.VirtualThermostatConfigurationResponseModel, 'Pending release and retained reservations'),
+    (0, common_1.Post)('thermostats/:id/release'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, thermostat_config_dto_1.RequestVirtualThermostatReleaseDto]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatConfigController.prototype, "release", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Restore a missing thermostat actuator endpoint',
+        description: 'Owner or administrator re-adopts only the same canonical physical switch. Forces requested OFF, revokes prior hardware qualification and retains the reservation; operator acknowledgement is not release proof.',
+        operationId: 'restore-devices-virtual-plugin-thermostat-actuator',
+    }),
+    (0, api_documentation_decorator_1.ApiForbiddenResponse)('Owner or administrator user session required'),
+    (0, api_documentation_decorator_1.ApiUnprocessableEntityResponse)('Claim revision, canonical identity or endpoint conflict'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_response_model_1.VirtualThermostatConfigurationResponseModel, 'Restored reservation awaiting new qualification'),
+    (0, roles_guard_1.Roles)(users_constants_1.UserRole.OWNER, users_constants_1.UserRole.ADMIN),
+    (0, common_1.Post)('thermostats/:id/claims/:claimId/restore'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(1, (0, common_1.Param)('claimId', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __param(2, (0, common_1.Body)()),
+    __param(3, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, thermostat_config_dto_1.RestoreVirtualThermostatActuatorDto, Object]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatConfigController.prototype, "restoreActuator", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME],
+        summary: 'Read thermostat actuator recovery audit',
+        description: 'Read retained operator recovery declarations, distinct from machine-verified OFF and drainage evidence.',
+        operationId: 'get-devices-virtual-plugin-thermostat-recoveries',
+    }),
+    (0, api_documentation_decorator_1.ApiForbiddenResponse)('Owner or administrator access required'),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(thermostat_response_model_1.VirtualThermostatRecoveriesResponseModel, 'Recovery audit entries'),
+    (0, roles_guard_1.Roles)(users_constants_1.UserRole.OWNER, users_constants_1.UserRole.ADMIN),
+    (0, common_1.Get)('thermostats/:id/recoveries'),
+    __param(0, (0, common_1.Param)('id', new common_1.ParseUUIDPipe({ version: '4' }))),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], VirtualThermostatConfigController.prototype, "recoveries", null);
+exports.VirtualThermostatConfigController = VirtualThermostatConfigController = __decorate([
+    (0, swagger_1.ApiTags)(devices_virtual_constants_1.DEVICES_VIRTUAL_PLUGIN_API_TAG_NAME),
+    (0, common_1.Controller)('producers'),
+    __metadata("design:paramtypes", [virtual_thermostat_config_service_1.VirtualThermostatConfigService,
+        virtual_thermostat_runtime_service_1.VirtualThermostatRuntimeService])
+], VirtualThermostatConfigController);
+//# sourceMappingURL=virtual-thermostat-config.controller.js.map

package/dist/plugins/devices-virtual/controllers/virtual-thermostat-config.controller.js.map

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

package/dist/plugins/devices-virtual/controllers/virtual-transform-config.controller.d.ts

@@ -0,0 +1,14 @@
+import { PreviewVirtualTransformDto } from '../dto/measurement-authoring.dto';
+import { ConfigureVirtualTransformDto } from '../dto/transform-config.dto';
+import { NumericOperatorsResponseModel } from '../models/numeric-operator.model';
+import { VirtualTransformConfigurationResponseModel } from '../models/transform-response.model';
+import { VirtualTransformConfigService } from '../services/virtual-transform-config.service';
+export declare class VirtualTransformConfigController {
+    private readonly configs;
+    constructor(configs: VirtualTransformConfigService);
+    operators(): NumericOperatorsResponseModel;
+    get(id: string): Promise<VirtualTransformConfigurationResponseModel>;
+    configure(id: string, dto: ConfigureVirtualTransformDto): Promise<VirtualTransformConfigurationResponseModel>;
+    preview(id: string, dto: PreviewVirtualTransformDto): Promise<VirtualTransformConfigurationResponseModel>;
+    private execute;
+}