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

package/dist/modules/displays/services/registration.service.js

@@ -0,0 +1,146 @@
+"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.RegistrationService = void 0;
+const class_validator_1 = require("class-validator");
+const typeorm_1 = require("typeorm");
+const common_1 = require("@nestjs/common");
+const jwt_1 = require("@nestjs/jwt");
+const typeorm_2 = require("@nestjs/typeorm");
+const logger_1 = require("../../../common/logger");
+const transform_utils_1 = require("../../../common/utils/transform.utils");
+const auth_constants_1 = require("../../auth/auth.constants");
+const tokens_service_1 = require("../../auth/services/tokens.service");
+const token_utils_1 = require("../../auth/utils/token.utils");
+const displays_constants_1 = require("../displays.constants");
+const displays_exceptions_1 = require("../displays.exceptions");
+const register_display_dto_1 = require("../dto/register-display.dto");
+const displays_entity_1 = require("../entities/displays.entity");
+const displays_service_1 = require("./displays.service");
+let RegistrationService = class RegistrationService {
+    constructor(displaysService, tokensService, jwtService, displayRepository) {
+        this.displaysService = displaysService;
+        this.tokensService = tokensService;
+        this.jwtService = jwtService;
+        this.displayRepository = displayRepository;
+        this.logger = (0, logger_1.createExtensionLogger)(displays_constants_1.DISPLAYS_MODULE_NAME, 'RegistrationService');
+    }
+    async registerDisplay(registerDto, _userAgent, clientIp) {
+        const dtoInstance = await this.validateDto(register_display_dto_1.RegisterDisplayDto, registerDto);
+        let display = await this.displaysService.findByMacAddress(dtoInstance.mac_address);
+        if (display) {
+            display = await this.displaysService.update(display.id, {
+                version: dtoInstance.version,
+                build: dtoInstance.build ?? null,
+                screen_width: dtoInstance.screen_width,
+                screen_height: dtoInstance.screen_height,
+                pixel_ratio: dtoInstance.pixel_ratio,
+                unit_size: dtoInstance.unit_size,
+                rows: dtoInstance.rows,
+                cols: dtoInstance.cols,
+            });
+            display.registeredFromIp = clientIp;
+            display = await this.displayRepository.save(display);
+            await this.tokensService.revokeByOwnerId(display.id, auth_constants_1.TokenOwnerType.DISPLAY);
+        }
+        else {
+            display = await this.displaysService.create({
+                macAddress: dtoInstance.mac_address,
+                version: dtoInstance.version,
+                build: dtoInstance.build ?? null,
+                screenWidth: dtoInstance.screen_width ?? 0,
+                screenHeight: dtoInstance.screen_height ?? 0,
+                pixelRatio: dtoInstance.pixel_ratio ?? 1,
+                unitSize: dtoInstance.unit_size ?? 8,
+                rows: dtoInstance.rows ?? 12,
+                cols: dtoInstance.cols ?? 24,
+                audioOutputSupported: dtoInstance.audio_output_supported ?? false,
+                audioInputSupported: dtoInstance.audio_input_supported ?? false,
+                registeredFromIp: clientIp,
+            });
+        }
+        const accessToken = await this.generateDisplayToken(display);
+        return { display, accessToken };
+    }
+    async refreshDisplayToken(displayId, currentToken) {
+        const display = await this.displaysService.getOneOrThrow(displayId);
+        const displayTokens = await this.tokensService.findByOwnerId(displayId, auth_constants_1.TokenOwnerType.DISPLAY);
+        let storedToken = null;
+        for (const token of displayTokens) {
+            if ((0, token_utils_1.hashToken)(currentToken) === token.hashedToken) {
+                storedToken = token;
+                break;
+            }
+        }
+        if (!storedToken) {
+            this.logger.warn(`Token not found for display=${displayId}`);
+            throw new common_1.UnauthorizedException('Invalid token');
+        }
+        if (storedToken.revoked) {
+            this.logger.warn(`Token is revoked for display=${displayId}`);
+            throw new common_1.UnauthorizedException('Token has been revoked');
+        }
+        await this.tokensService.revokeByOwnerId(displayId, auth_constants_1.TokenOwnerType.DISPLAY);
+        const newToken = await this.generateDisplayToken(display);
+        const expiresAt = new Date();
+        expiresAt.setFullYear(expiresAt.getFullYear() + 1);
+        return { accessToken: newToken, expiresAt };
+    }
+    async generateDisplayToken(display) {
+        const expiresAt = new Date();
+        expiresAt.setFullYear(expiresAt.getFullYear() + 1);
+        const token = this.jwtService.sign({
+            sub: display.id,
+            type: auth_constants_1.TokenOwnerType.DISPLAY,
+            mac: display.macAddress,
+        }, {
+            expiresIn: '365d',
+        });
+        await this.tokensService.create({
+            type: auth_constants_1.TokenType.LONG_LIVE,
+            token: token,
+            ownerType: auth_constants_1.TokenOwnerType.DISPLAY,
+            ownerId: display.id,
+            name: `Display Token - ${display.macAddress}`,
+            description: `Auto-generated token for display ${display.name ?? display.macAddress}`,
+            expiresAt: expiresAt,
+        });
+        return token;
+    }
+    async validateDto(DtoClass, dto) {
+        const dtoInstance = (0, transform_utils_1.toInstance)(DtoClass, dto, {
+            excludeExtraneousValues: false,
+        });
+        const errors = await (0, class_validator_1.validate)(dtoInstance, {
+            whitelist: true,
+            forbidNonWhitelisted: true,
+            stopAtFirstError: false,
+        });
+        if (errors.length > 0) {
+            this.logger.error(`Validation failed: ${JSON.stringify(errors)}`);
+            throw new displays_exceptions_1.DisplaysValidationException('Provided registration data is invalid.');
+        }
+        return dtoInstance;
+    }
+};
+exports.RegistrationService = RegistrationService;
+exports.RegistrationService = RegistrationService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(3, (0, typeorm_2.InjectRepository)(displays_entity_1.DisplayEntity)),
+    __metadata("design:paramtypes", [displays_service_1.DisplaysService,
+        tokens_service_1.TokensService,
+        jwt_1.JwtService,
+        typeorm_1.Repository])
+], RegistrationService);
+//# sourceMappingURL=registration.service.js.map

package/dist/modules/displays/services/registration.service.js.map

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

package/dist/modules/displays/subscribers/display-entity.subscriber.d.ts

@@ -0,0 +1,12 @@
+import { DataSource, EntitySubscriberInterface, RemoveEvent } from 'typeorm';
+import { DisplayEntity } from '../entities/displays.entity';
+import { DisplayConnectionStateService } from '../services/display-connection-state.service';
+export declare class DisplayEntitySubscriber implements EntitySubscriberInterface<DisplayEntity> {
+    private readonly displayStatusService;
+    private readonly dataSource;
+    private readonly logger;
+    constructor(displayStatusService: DisplayConnectionStateService, dataSource: DataSource);
+    listenTo(): typeof DisplayEntity;
+    afterLoad(entity: DisplayEntity): Promise<void>;
+    afterRemove(event: RemoveEvent<DisplayEntity>): Promise<void>;
+}

package/dist/modules/displays/subscribers/display-entity.subscriber.js

@@ -0,0 +1,63 @@
+"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.DisplayEntitySubscriber = void 0;
+const typeorm_1 = require("typeorm");
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../../../common/logger");
+const displays_constants_1 = require("../displays.constants");
+const displays_entity_1 = require("../entities/displays.entity");
+const display_connection_state_service_1 = require("../services/display-connection-state.service");
+let DisplayEntitySubscriber = class DisplayEntitySubscriber {
+    constructor(displayStatusService, dataSource) {
+        this.displayStatusService = displayStatusService;
+        this.dataSource = dataSource;
+        this.logger = (0, logger_1.createExtensionLogger)(displays_constants_1.DISPLAYS_MODULE_NAME, 'DisplayEntitySubscriber');
+        this.dataSource.subscribers.push(this);
+    }
+    listenTo() {
+        return displays_entity_1.DisplayEntity;
+    }
+    async afterLoad(entity) {
+        try {
+            const status = await this.displayStatusService.readLatest(entity);
+            entity.online = status.online;
+            entity.status = status.status;
+            this.logger.debug(`Loaded display status from InfluxDB id=${entity.id}, value=${entity.status}`);
+        }
+        catch (error) {
+            const err = error;
+            this.logger.error(`Failed to load display status from InfluxDB id=${entity.id}, error=${err.message}`, err.stack);
+        }
+    }
+    async afterRemove(event) {
+        if (!event.entity) {
+            this.logger.warn(`No entity found in afterRemove event`);
+            return;
+        }
+        const displayId = event.entity.id;
+        try {
+            await this.displayStatusService.delete(event.entity);
+            this.logger.log(`Successfully removed all stored statuses for id=${displayId}`);
+        }
+        catch (error) {
+            const err = error;
+            this.logger.error(`Failed to remove display statuses from InfluxDB id=${displayId} error=${err.message}`, err.stack);
+        }
+    }
+};
+exports.DisplayEntitySubscriber = DisplayEntitySubscriber;
+exports.DisplayEntitySubscriber = DisplayEntitySubscriber = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [display_connection_state_service_1.DisplayConnectionStateService,
+        typeorm_1.DataSource])
+], DisplayEntitySubscriber);
+//# sourceMappingURL=display-entity.subscriber.js.map

package/dist/modules/displays/subscribers/display-entity.subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-entity.subscriber.js","sourceRoot":"","sources":["../../../../src/modules/displays/subscribers/display-entity.subscriber.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAA6E;AAE7E,2CAA4C;AAE5C,mDAA+D;AAC/D,8DAA6D;AAC7D,iEAA4D;AAC5D,mGAA6F;AAGtF,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAGnC,YACkB,oBAAmD,EACnD,UAAsB;QADtB,yBAAoB,GAApB,oBAAoB,CAA+B;QACnD,eAAU,GAAV,UAAU,CAAY;QAJvB,WAAM,GAAG,IAAA,8BAAqB,EAAC,yCAAoB,EAAE,yBAAyB,CAAC,CAAC;QAMhG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ;QACP,OAAO,+BAAa,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAqB;QACpC,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAClE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAE9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,MAAM,CAAC,EAAE,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAClG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,KAAc,CAAC;YAE3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kDAAkD,MAAM,CAAC,EAAE,WAAW,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACnH,CAAC;IACF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAiC;QAClD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACzD,OAAO;QACR,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAElC,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAErD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mDAAmD,SAAS,EAAE,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,KAAc,CAAC;YAE3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAChB,sDAAsD,SAAS,UAAU,GAAG,CAAC,OAAO,EAAE,EACtF,GAAG,CAAC,KAAK,CACT,CAAC;QACH,CAAC;IACF,CAAC;CACD,CAAA;AAjDY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;qCAK4B,gEAA6B;QACvC,oBAAU;GAL5B,uBAAuB,CAiDnC"}

package/dist/modules/displays/utils/ip.utils.d.ts

@@ -0,0 +1,3 @@
+import { Request } from 'express';
+export declare function extractClientIp(request: Request): string;
+export declare function isLocalhost(ip: string): boolean;

package/dist/modules/displays/utils/ip.utils.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractClientIp = extractClientIp;
+exports.isLocalhost = isLocalhost;
+function extractClientIp(request) {
+    const xForwardedFor = request.headers['x-forwarded-for'];
+    if (xForwardedFor) {
+        const ips = Array.isArray(xForwardedFor) ? xForwardedFor[0] : xForwardedFor.split(',')[0];
+        if (ips && typeof ips === 'string') {
+            return ips.trim();
+        }
+    }
+    const xRealIp = request.headers['x-real-ip'];
+    if (xRealIp && typeof xRealIp === 'string') {
+        return xRealIp.trim();
+    }
+    const cfConnectingIp = request.headers['cf-connecting-ip'];
+    if (cfConnectingIp && typeof cfConnectingIp === 'string') {
+        return cfConnectingIp.trim();
+    }
+    if (request.socket?.remoteAddress) {
+        return request.socket.remoteAddress;
+    }
+    if (request.connection?.remoteAddress) {
+        return request.connection.remoteAddress;
+    }
+    return 'unknown';
+}
+function isLocalhost(ip) {
+    if (!ip || ip === 'unknown') {
+        return false;
+    }
+    const normalizedIp = ip.toLowerCase().trim();
+    if (normalizedIp === '127.0.0.1' || normalizedIp === 'localhost') {
+        return true;
+    }
+    if (normalizedIp === '::1' || normalizedIp === '::ffff:127.0.0.1') {
+        return true;
+    }
+    if (normalizedIp.startsWith('127.') || normalizedIp.startsWith('::ffff:127.')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=ip.utils.js.map

package/dist/modules/displays/utils/ip.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.utils.js","sourceRoot":"","sources":["../../../../src/modules/displays/utils/ip.utils.ts"],"names":[],"mappings":";;AAKA,0CAmCC;AAKD,kCAuBC;AA/DD,SAAgB,eAAe,CAAC,OAAgB;IAE/C,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD,IAAI,aAAa,EAAE,CAAC;QAEnB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1F,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC;IACF,CAAC;IAGD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAGD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3D,IAAI,cAAc,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,cAAc,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAGD,IAAI,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;IACrC,CAAC;IAID,IAAK,OAAuD,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC;QACxF,OAAQ,OAAuD,CAAC,UAAU,CAAC,aAAa,CAAC;IAC1F,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAKD,SAAgB,WAAW,CAAC,EAAU;IACrC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAG7C,IAAI,YAAY,KAAK,WAAW,IAAI,YAAY,KAAK,WAAW,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC;IACb,CAAC;IAGD,IAAI,YAAY,KAAK,KAAK,IAAI,YAAY,KAAK,kBAAkB,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC;IACb,CAAC;IAGD,IAAI,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/E,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/modules/displays/validators/display-exists-constraint.validator.d.ts

@@ -0,0 +1,9 @@
+import { ValidationArguments, ValidationOptions, ValidatorConstraintInterface } from 'class-validator';
+import { DisplaysService } from '../services/displays.service';
+export declare class DisplayExistsConstraint implements ValidatorConstraintInterface {
+    private readonly displaysService;
+    constructor(displaysService: DisplaysService);
+    validate(value: string | string[]): Promise<boolean>;
+    defaultMessage(args: ValidationArguments): string;
+}
+export declare function ValidateDisplayExists(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;

package/dist/modules/displays/validators/display-exists-constraint.validator.js

@@ -0,0 +1,64 @@
+"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.DisplayExistsConstraint = void 0;
+exports.ValidateDisplayExists = ValidateDisplayExists;
+const class_validator_1 = require("class-validator");
+const common_1 = require("@nestjs/common");
+const displays_service_1 = require("../services/displays.service");
+let DisplayExistsConstraint = class DisplayExistsConstraint {
+    constructor(displaysService) {
+        this.displaysService = displaysService;
+    }
+    async validate(value) {
+        if (!value) {
+            return true;
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                return true;
+            }
+            for (const displayId of value) {
+                const display = await this.displaysService.findOne(displayId);
+                if (display === null) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        const display = await this.displaysService.findOne(value);
+        return display !== null;
+    }
+    defaultMessage(args) {
+        if (Array.isArray(args.value)) {
+            return `One or more displays with IDs "${args.value.join(', ')}" do not exist.`;
+        }
+        return `Display with ID "${args.value}" does not exist.`;
+    }
+};
+exports.DisplayExistsConstraint = DisplayExistsConstraint;
+exports.DisplayExistsConstraint = DisplayExistsConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ async: true }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [displays_service_1.DisplaysService])
+], DisplayExistsConstraint);
+function ValidateDisplayExists(validationOptions) {
+    return function (object, propertyName) {
+        (0, class_validator_1.registerDecorator)({
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            constraints: [],
+            validator: DisplayExistsConstraint,
+        });
+    };
+}
+//# sourceMappingURL=display-exists-constraint.validator.js.map

package/dist/modules/displays/validators/display-exists-constraint.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-exists-constraint.validator.js","sourceRoot":"","sources":["../../../../src/modules/displays/validators/display-exists-constraint.validator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAoDA,sDAUC;AA9DD,qDAMyB;AAEzB,2CAA4C;AAE5C,mEAA+D;AAIxD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IACnC,YAA6B,eAAgC;QAAhC,oBAAe,GAAf,eAAe,CAAiB;IAAG,CAAC;IAEjE,KAAK,CAAC,QAAQ,CAAC,KAAwB;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACb,CAAC;QAGD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC;YACb,CAAC;YAGD,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC9D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACtB,OAAO,KAAK,CAAC;gBACd,CAAC;YACF,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC;QAGD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE1D,OAAO,OAAO,KAAK,IAAI,CAAC;IACzB,CAAC;IAED,cAAc,CAAC,IAAyB;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,kCAAkC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACjF,CAAC;QACD,OAAO,oBAAoB,IAAI,CAAC,KAAK,mBAAmB,CAAC;IAC1D,CAAC;CACD,CAAA;AApCY,0DAAuB;kCAAvB,uBAAuB;IAFnC,IAAA,qCAAmB,EAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACpC,IAAA,mBAAU,GAAE;qCAEkC,kCAAe;GADjD,uBAAuB,CAoCnC;AAED,SAAgB,qBAAqB,CAAC,iBAAqC;IAC1E,OAAO,UAAU,MAAc,EAAE,YAAoB;QACpD,IAAA,mCAAiB,EAAC;YACjB,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY,EAAE,YAAY;YAC1B,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,uBAAuB;SAClC,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC"}

package/dist/modules/energy/controllers/energy-home.controller.d.ts

@@ -0,0 +1,11 @@
+import { EnergyHomeBreakdownResponseModel, EnergyHomeSummaryResponseModel, EnergyHomeTimeseriesResponseModel } from '../models/energy-home-response.model';
+import { EnergyCacheService } from '../services/energy-cache.service';
+import { EnergyDataService } from '../services/energy-data.service';
+export declare class EnergyHomeController {
+    private readonly energyData;
+    private readonly cache;
+    constructor(energyData: EnergyDataService, cache: EnergyCacheService);
+    getHomeSummary(range?: string): Promise<EnergyHomeSummaryResponseModel>;
+    getHomeTimeseries(range?: string, interval?: string): Promise<EnergyHomeTimeseriesResponseModel>;
+    getHomeBreakdown(range?: string, limitStr?: string): Promise<EnergyHomeBreakdownResponseModel>;
+}

package/dist/modules/energy/controllers/energy-home.controller.js

@@ -0,0 +1,206 @@
+"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.EnergyHomeController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const api_documentation_decorator_1 = require("../../swagger/decorators/api-documentation.decorator");
+const energy_constants_1 = require("../energy.constants");
+const energy_range_helper_1 = require("../helpers/energy-range.helper");
+const energy_breakdown_item_model_1 = require("../models/energy-breakdown-item.model");
+const energy_home_response_model_1 = require("../models/energy-home-response.model");
+const energy_space_summary_model_1 = require("../models/energy-space-summary.model");
+const energy_timeseries_point_model_1 = require("../models/energy-timeseries-point.model");
+const energy_cache_service_1 = require("../services/energy-cache.service");
+const energy_data_service_1 = require("../services/energy-data.service");
+let EnergyHomeController = class EnergyHomeController {
+    constructor(energyData, cache) {
+        this.energyData = energyData;
+        this.cache = cache;
+    }
+    async getHomeSummary(range) {
+        if (range && !energy_constants_1.VALID_ENERGY_RANGES.includes(range)) {
+            throw new common_1.BadRequestException(`Invalid range "${range}". Must be one of: ${energy_constants_1.VALID_ENERGY_RANGES.join(', ')}`);
+        }
+        const resolvedRange = (0, energy_range_helper_1.normalizeEnergyRange)(range);
+        const cacheKey = `home:summary:${resolvedRange}`;
+        const summary = await this.cache.getOrCompute(cacheKey, async () => {
+            const { start, end } = (0, energy_range_helper_1.resolveEnergyRange)(resolvedRange);
+            return this.energyData.getSpaceSummary(start, end, 'home');
+        });
+        const model = new energy_space_summary_model_1.EnergySpaceSummaryModel();
+        model.totalConsumptionKwh = summary.totalConsumptionKwh;
+        model.totalProductionKwh = summary.totalProductionKwh;
+        model.totalGridImportKwh = summary.totalGridImportKwh;
+        model.totalGridExportKwh = summary.totalGridExportKwh;
+        model.netKwh = summary.netKwh;
+        model.netGridKwh = summary.netGridKwh;
+        model.hasGridMetrics = summary.hasGridMetrics;
+        model.range = resolvedRange;
+        model.lastUpdatedAt = summary.lastUpdatedAt;
+        const response = new energy_home_response_model_1.EnergyHomeSummaryResponseModel();
+        response.data = model;
+        return response;
+    }
+    async getHomeTimeseries(range, interval) {
+        if (range && !energy_constants_1.VALID_ENERGY_RANGES.includes(range)) {
+            throw new common_1.BadRequestException(`Invalid range "${range}". Must be one of: ${energy_constants_1.VALID_ENERGY_RANGES.join(', ')}`);
+        }
+        const resolvedRange = (0, energy_range_helper_1.normalizeEnergyRange)(range);
+        const resolvedInterval = interval || '1h';
+        const cacheKey = `home:timeseries:${resolvedRange}:${resolvedInterval}`;
+        const points = await this.cache.getOrCompute(cacheKey, async () => {
+            const { start, end } = (0, energy_range_helper_1.resolveEnergyRange)(resolvedRange);
+            return this.energyData.getSpaceTimeseries(start, end, resolvedInterval, 'home');
+        });
+        const items = points.map((point) => {
+            const model = new energy_timeseries_point_model_1.EnergyTimeseriesPointModel();
+            model.intervalStart = point.intervalStart;
+            model.intervalEnd = point.intervalEnd;
+            model.consumptionDeltaKwh = point.consumptionDeltaKwh;
+            model.productionDeltaKwh = point.productionDeltaKwh;
+            model.gridImportDeltaKwh = point.gridImportDeltaKwh;
+            model.gridExportDeltaKwh = point.gridExportDeltaKwh;
+            return model;
+        });
+        const response = new energy_home_response_model_1.EnergyHomeTimeseriesResponseModel();
+        response.data = items;
+        return response;
+    }
+    async getHomeBreakdown(range, limitStr) {
+        if (range && !energy_constants_1.VALID_ENERGY_RANGES.includes(range)) {
+            throw new common_1.BadRequestException(`Invalid range "${range}". Must be one of: ${energy_constants_1.VALID_ENERGY_RANGES.join(', ')}`);
+        }
+        const parsedLimit = limitStr !== undefined ? parseInt(limitStr, 10) : NaN;
+        const limit = Number.isNaN(parsedLimit) ? 10 : Math.max(1, Math.min(100, parsedLimit));
+        const resolvedRange = (0, energy_range_helper_1.normalizeEnergyRange)(range);
+        const { start, end } = (0, energy_range_helper_1.resolveEnergyRange)(resolvedRange);
+        const items = await this.energyData.getSpaceBreakdown(start, end, 'home', limit);
+        const models = items.map((item) => {
+            const model = new energy_breakdown_item_model_1.EnergyBreakdownItemModel();
+            model.deviceId = item.deviceId;
+            model.deviceName = item.deviceName;
+            model.roomId = item.roomId;
+            model.roomName = item.roomName;
+            model.consumptionKwh = item.consumptionKwh;
+            return model;
+        });
+        const response = new energy_home_response_model_1.EnergyHomeBreakdownResponseModel();
+        response.data = models;
+        return response;
+    }
+};
+exports.EnergyHomeController = EnergyHomeController;
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [energy_constants_1.ENERGY_MODULE_API_TAG_NAME],
+        summary: 'Get home energy summary',
+        description: 'Returns total consumption, production, grid import/export, and net energy in kWh aggregated across all spaces and devices (including unassigned). ' +
+            'Results are cached with a configurable TTL (default 30s) to reduce query load. ' +
+            'Ranges use Europe/Prague timezone: today = midnight to now, week = 7 days ago midnight to now, month = 30 days ago midnight to now.',
+        operationId: 'get-energy-module-home-summary',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'range',
+        required: false,
+        type: 'string',
+        enum: ['today', 'yesterday', 'week', 'month'],
+        description: 'Time range for the summary. Defaults to "today".',
+        example: 'today',
+    }),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(energy_home_response_model_1.EnergyHomeSummaryResponseModel, 'Home energy summary retrieved successfully.'),
+    (0, api_documentation_decorator_1.ApiBadRequestResponse)('Invalid request parameters.'),
+    (0, api_documentation_decorator_1.ApiInternalServerErrorResponse)(),
+    (0, common_1.Get)('summary'),
+    __param(0, (0, common_1.Query)('range')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], EnergyHomeController.prototype, "getHomeSummary", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [energy_constants_1.ENERGY_MODULE_API_TAG_NAME],
+        summary: 'Get home energy time-series',
+        description: 'Returns time-series energy data points aggregated across all spaces and devices (including unassigned). ' +
+            'Supports 5m (native), 1h, and 1d intervals. Missing intervals are zero-filled. ' +
+            'Results are cached with a configurable TTL (default 30s). ' +
+            'Ranges use Europe/Prague timezone.',
+        operationId: 'get-energy-module-home-timeseries',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'range',
+        required: false,
+        type: 'string',
+        enum: ['today', 'yesterday', 'week', 'month'],
+        description: 'Time range for the time-series. Defaults to "today".',
+        example: 'today',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'interval',
+        required: false,
+        type: 'string',
+        enum: ['5m', '1h', '1d'],
+        description: 'Aggregation interval for data points. Defaults to "1h".',
+        example: '1h',
+    }),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(energy_home_response_model_1.EnergyHomeTimeseriesResponseModel, 'Home energy time-series retrieved successfully.'),
+    (0, api_documentation_decorator_1.ApiBadRequestResponse)('Invalid request parameters.'),
+    (0, api_documentation_decorator_1.ApiInternalServerErrorResponse)(),
+    (0, common_1.Get)('timeseries'),
+    __param(0, (0, common_1.Query)('range')),
+    __param(1, (0, common_1.Query)('interval')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], EnergyHomeController.prototype, "getHomeTimeseries", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({
+        tags: [energy_constants_1.ENERGY_MODULE_API_TAG_NAME],
+        summary: 'Get home energy breakdown',
+        description: 'Returns a breakdown of top energy-consuming devices across all spaces, sorted by consumption descending. ' +
+            'Only considers consumption_import source type. Includes device and room names for display.',
+        operationId: 'get-energy-module-home-breakdown',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'range',
+        required: false,
+        type: 'string',
+        enum: ['today', 'yesterday', 'week', 'month'],
+        description: 'Time range for the breakdown. Defaults to "today".',
+        example: 'today',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'limit',
+        required: false,
+        type: 'number',
+        description: 'Maximum number of devices to return. Defaults to 10.',
+        example: 10,
+    }),
+    (0, api_documentation_decorator_1.ApiSuccessResponse)(energy_home_response_model_1.EnergyHomeBreakdownResponseModel, 'Home energy breakdown retrieved successfully.'),
+    (0, api_documentation_decorator_1.ApiBadRequestResponse)('Invalid request parameters.'),
+    (0, api_documentation_decorator_1.ApiInternalServerErrorResponse)(),
+    (0, common_1.Get)('breakdown'),
+    __param(0, (0, common_1.Query)('range')),
+    __param(1, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], EnergyHomeController.prototype, "getHomeBreakdown", null);
+exports.EnergyHomeController = EnergyHomeController = __decorate([
+    (0, swagger_1.ApiTags)(energy_constants_1.ENERGY_MODULE_API_TAG_NAME),
+    (0, common_1.Controller)('energy/home'),
+    __metadata("design:paramtypes", [energy_data_service_1.EnergyDataService,
+        energy_cache_service_1.EnergyCacheService])
+], EnergyHomeController);
+//# sourceMappingURL=energy-home.controller.js.map

package/dist/modules/energy/controllers/energy-home.controller.js.map

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

package/dist/modules/energy/controllers/energy-spaces.controller.d.ts

@@ -0,0 +1,11 @@
+import { EnergySpaceBreakdownResponseModel, EnergySpaceSummaryResponseModel, EnergySpaceTimeseriesResponseModel } from '../models/energy-space-response.model';
+import { EnergyCacheService } from '../services/energy-cache.service';
+import { EnergyDataService } from '../services/energy-data.service';
+export declare class EnergySpacesController {
+    private readonly energyData;
+    private readonly cache;
+    constructor(energyData: EnergyDataService, cache: EnergyCacheService);
+    getSpaceSummary(spaceId: string, range?: string): Promise<EnergySpaceSummaryResponseModel>;
+    getSpaceTimeseries(spaceId: string, range?: string, interval?: string): Promise<EnergySpaceTimeseriesResponseModel>;
+    getSpaceBreakdown(spaceId: string, range?: string, limitStr?: string): Promise<EnergySpaceBreakdownResponseModel>;
+}