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

package/dist/modules/swagger/services/swagger-document.service.js

@@ -0,0 +1,293 @@
+"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.SwaggerDocumentService = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const app_constants_1 = require("../../../app.constants");
+const api_tag_decorator_1 = require("../decorators/api-tag.decorator");
+const extended_discriminator_service_1 = require("./extended-discriminator.service");
+const swagger_models_registry_service_1 = require("./swagger-models-registry.service");
+let SwaggerDocumentService = class SwaggerDocumentService {
+    constructor(registry, extendedDiscriminatorRegistry) {
+        this.registry = registry;
+        this.extendedDiscriminatorRegistry = extendedDiscriminatorRegistry;
+    }
+    createDocument(app) {
+        const swaggerConfig = new swagger_1.DocumentBuilder()
+            .setTitle('🖥️ FastyBird Smart Panel API 🚀')
+            .setDescription('Welcome to the **FastyBird Smart Panel API Documentation**!\n\nThis API is the central interface for integrating with the **FastyBird Smart Panel**, a modern, modular, and open-source platform for managing smart home devices and dashboards — all running on **your local hardware**, with no cloud dependency.\n\n---\n\n## 🌟 What Can This API Do?\n\nThe **FastyBird Smart Panel API** provides:\n\n- 🎛️ **Full Access to Smart Devices**  \n  Manage devices, channels, and properties — read current values or send commands.\n\n- 📊 **Real-Time Monitoring & Sync**  \n  Receive live updates from sensors, switches, and more through WebSocket connections.\n\n- 🔌 **Third-Party Integration Support**  \n  Easily connect external systems using standard API calls to sync data and trigger actions.\n\n- 🧱 **Dashboard Customization**  \n  Build or modify dashboard layouts, pages, tiles, and data sources dynamically via API.\n\n- 🚀 **Local-First Control**  \n  The entire stack is designed to run offline on your own network — secure, private, and fast.\n\n---\n\n## 🚀 Getting Started\n\n> 🛠️ **No cloud required. Everything runs locally.**\n\n### 1. Install the Smart Panel  \nDeploy the platform to a supported device like a Raspberry Pi or ReTerminal.\n\n### 2. Connect & Configure Devices  \nAdd devices via the Admin App or API, either manually or through plugin integrations.\n\n### 3. Interact via REST or WebSocket  \nUse the API to read states, send commands, and subscribe to real-time updates.\n\n---\n\n## 🔎 API Modules Overview\n\n### Devices API  \nManage devices and their structure:  \n- Retrieve device/channel/property metadata  \n- Send control commands  \n- Sync state updates  \n\n### Dashboard API  \nConfigure your Smart Panel UI:  \n- Build pages and tiles  \n- Add data sources  \n- Organize device widgets  \n\n---\n\n## 📚 API Usage Examples\n\nUse this API to:\n\n- 💡 Read a temperature sensor value  \n- 🔘 Toggle a light switch  \n- 🧩 Display custom widgets  \n- 🔄 Sync external device state  \n- 📱 Integrate with your own mobile or desktop app  \n\n---\n\n## 🔐 Authentication\n\nUse token-based access when integrating external apps or third-party devices.  \nSee the [Authentication Guide](#) for details.\n\n---\n\n## 💬 Frequently Asked\n\n**Is the API cloud-based?**  \nNo — it runs entirely on your own hardware.\n\n**Do I need to be online?**  \nNo — the API is designed for offline-first use.\n\n**Can I control third-party devices?**  \nYes — use plugin-based extensions or the generic third-party interface.\n\n**Does the Smart Panel support real-time updates?**  \nYes — WebSocket support is built-in.\n\n---\n\n## 🤝 Need Help?\n\n- 💬 [Join the FastyBird Community](https://discord.gg/H7pHN3hbqq)  \n- 🛠️ [Explore the Docs](https://smart-panel.fastybird.com/docs)  \n- 📨 [Report an issue](https://github.com/fastybird/smart-panel/issues)\n\n---\n\n🚀 **Built with ❤️ by FastyBird** — Local-first, modular smart home integration.')
+            .setVersion('1.0')
+            .setLicense('Apache 2.0', 'https://github.com/FastyBird/smart-panel/blob/main/LICENSE.md')
+            .setContact('Adam Kadlec', 'https://fastybird.com', 'info@fastybird.com')
+            .setTermsOfService('http://smart-panel.fastybird.com')
+            .addServer('http://localhost:3000/api/v1', 'Local development server')
+            .addBearerAuth({
+            type: 'http',
+            scheme: 'bearer',
+            bearerFormat: 'JWT',
+        }, 'authentication')
+            .addApiKey({
+            type: 'apiKey',
+            in: 'header',
+            name: 'x-display-secret',
+        }, 'x-display-secret')
+            .build();
+        const document = swagger_1.SwaggerModule.createDocument(app, swaggerConfig, {
+            operationIdFactory: (controllerKey, methodKey) => methodKey,
+            extraModels: this.registry.getAll(),
+        });
+        document.openapi = '3.1.0';
+        if (document.info) {
+            document.info.summary =
+                'The FastyBird Smart Panel API provides a local, real-time interface for retrieving device data, monitoring statuses, and integrating third-party IoT systems. It enables seamless communication between the smart panel and connected devices, ensuring fast, private, and reliable interactions without cloud dependencies.';
+        }
+        const tagDefinitions = api_tag_decorator_1.openApiTagRegistry.getTagDefinitions();
+        tagDefinitions.sort((a, b) => {
+            const an = a.name.toLowerCase();
+            const bn = b.name.toLowerCase();
+            const aIsModule = an.endsWith(' module');
+            const bIsModule = bn.endsWith(' module');
+            const aIsPlugin = an.endsWith(' plugin');
+            const bIsPlugin = bn.endsWith(' plugin');
+            if (aIsModule && !bIsModule)
+                return -1;
+            if (!aIsModule && bIsModule)
+                return 1;
+            if (aIsPlugin && !bIsPlugin)
+                return -1;
+            if (!aIsPlugin && bIsPlugin)
+                return 1;
+            return an.localeCompare(bn);
+        });
+        document.tags = tagDefinitions;
+        const originalPaths = document.paths;
+        const filteredPaths = {};
+        for (const [path, pathItem] of Object.entries(originalPaths || {})) {
+            if (path.includes('/example-extension/')) {
+                continue;
+            }
+            if (path.startsWith('/modules/') || path.startsWith('/plugins/') || path === '/third-party/webhook') {
+                filteredPaths[path] = pathItem;
+            }
+        }
+        document.paths = filteredPaths;
+        this.applyExtendedDiscriminators(document, this.extendedDiscriminatorRegistry.getAll());
+        this.adjustThirdPartyDemoWebhookPath(document);
+        this.transformAllOfToRef(document);
+        this.removeDiscriminatorFromBaseSchemas(document);
+        this.addSecurityToNonPublicRoutes(document, app);
+        return document;
+    }
+    setup(app) {
+        const document = this.createDocument(app);
+        swagger_1.SwaggerModule.setup(`${app_constants_1.API_PREFIX}/docs`, app, document, {
+            swaggerOptions: {
+                persistAuthorization: true,
+                docExpansion: 'none',
+                filter: true,
+                showRequestDuration: true,
+            },
+        });
+    }
+    adjustThirdPartyDemoWebhookPath(document) {
+        const paths = document.paths;
+        for (const [path, pathItem] of Object.entries(paths)) {
+            const putOperation = pathItem?.put;
+            if (putOperation?.operationId === 'update-devices-third-party-plugin-demo-properties') {
+                paths['/third-party/webhook'] = {
+                    put: putOperation,
+                };
+                delete paths[path];
+                break;
+            }
+        }
+    }
+    transformAllOfToRef(document) {
+        const schemas = document.components?.schemas;
+        if (!schemas)
+            return;
+        for (const [, schema] of Object.entries(schemas)) {
+            if (typeof schema !== 'object' || schema === null || '$ref' in schema) {
+                continue;
+            }
+            if ('properties' in schema && typeof schema.properties === 'object') {
+                for (const [propName, propSchema] of Object.entries(schema.properties)) {
+                    if (typeof propSchema === 'object' && propSchema !== null && 'allOf' in propSchema) {
+                        const allOf = propSchema.allOf;
+                        if (Array.isArray(allOf) &&
+                            allOf.length === 1 &&
+                            typeof allOf[0] === 'object' &&
+                            allOf[0] !== null &&
+                            '$ref' in allOf[0]) {
+                            const ref = allOf[0].$ref;
+                            const description = 'description' in propSchema ? propSchema.description : undefined;
+                            const newPropSchema = {
+                                $ref: ref,
+                            };
+                            if (description) {
+                                newPropSchema.description = description;
+                            }
+                            schema.properties[propName] = newPropSchema;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    removeDiscriminatorFromBaseSchemas(document) {
+        const schemas = document.components?.schemas;
+        if (!schemas)
+            return;
+        const processOneOf = (oneOfSchema, discriminatorProperty) => {
+            if (typeof oneOfSchema !== 'object' ||
+                oneOfSchema === null ||
+                !('oneOf' in oneOfSchema) ||
+                !Array.isArray(oneOfSchema.oneOf)) {
+                return;
+            }
+            for (const oneOfItem of oneOfSchema.oneOf) {
+                if (typeof oneOfItem === 'object' &&
+                    oneOfItem !== null &&
+                    '$ref' in oneOfItem &&
+                    typeof oneOfItem.$ref === 'string') {
+                    const ref = oneOfItem.$ref;
+                    if (ref.startsWith('#/components/schemas/')) {
+                        const variantSchemaName = ref.replace('#/components/schemas/', '');
+                        const variantSchema = schemas[variantSchemaName];
+                        if (variantSchema &&
+                            typeof variantSchema === 'object' &&
+                            variantSchema !== null &&
+                            !('$ref' in variantSchema) &&
+                            'properties' in variantSchema &&
+                            typeof variantSchema.properties === 'object') {
+                            delete variantSchema.properties[discriminatorProperty];
+                        }
+                    }
+                }
+            }
+        };
+        for (const schema of Object.values(schemas)) {
+            if (typeof schema !== 'object' || schema === null || '$ref' in schema) {
+                continue;
+            }
+            if ('oneOf' in schema && 'discriminator' in schema) {
+                const discriminator = schema.discriminator;
+                if (typeof discriminator === 'object' &&
+                    discriminator !== null &&
+                    'propertyName' in discriminator &&
+                    typeof discriminator.propertyName === 'string') {
+                    processOneOf(schema, discriminator.propertyName);
+                }
+            }
+            if ('properties' in schema && typeof schema.properties === 'object') {
+                for (const propSchema of Object.values(schema.properties)) {
+                    if (typeof propSchema === 'object' &&
+                        propSchema !== null &&
+                        'oneOf' in propSchema &&
+                        'discriminator' in propSchema) {
+                        const discriminator = propSchema.discriminator;
+                        if (typeof discriminator === 'object' &&
+                            discriminator !== null &&
+                            'propertyName' in discriminator &&
+                            typeof discriminator.propertyName === 'string') {
+                            processOneOf(propSchema, discriminator.propertyName);
+                        }
+                    }
+                }
+            }
+        }
+        const weatherBaseSchema = schemas['ConfigModuleDataWeather'];
+        if (weatherBaseSchema &&
+            typeof weatherBaseSchema === 'object' &&
+            weatherBaseSchema !== null &&
+            !('$ref' in weatherBaseSchema) &&
+            'properties' in weatherBaseSchema &&
+            typeof weatherBaseSchema.properties === 'object') {
+            delete weatherBaseSchema.properties['location_type'];
+        }
+    }
+    applyExtendedDiscriminators(document, registrations) {
+        const schemas = document.components?.schemas;
+        if (!schemas)
+            return;
+        const groups = new Map();
+        for (const reg of registrations) {
+            const parentSchemaPath = (0, swagger_1.getSchemaPath)(reg.parentClass);
+            const key = `${parentSchemaPath}::${reg.discriminatorProperty}`;
+            const group = groups.get(key);
+            if (group) {
+                group.push(reg);
+            }
+            else {
+                groups.set(key, [reg]);
+            }
+        }
+        for (const [groupKey, regs] of groups.entries()) {
+            const [parentSchemaPath, discriminatorProperty] = groupKey.split('::');
+            const parentSchemaName = parentSchemaPath.replace('#/components/schemas/', '');
+            const parentSchema = schemas[parentSchemaName];
+            if (!parentSchema) {
+                continue;
+            }
+            if ('$ref' in parentSchema) {
+                continue;
+            }
+            parentSchema.discriminator = {
+                propertyName: discriminatorProperty,
+                mapping: regs.reduce((acc, r) => {
+                    acc[r.discriminatorValue] = (0, swagger_1.getSchemaPath)(r.modelClass);
+                    return acc;
+                }, {}),
+            };
+        }
+    }
+    addSecurityToNonPublicRoutes(document, _app) {
+        const paths = document.paths;
+        if (!paths)
+            return;
+        const securityRequirements = [
+            {
+                authentication: [],
+            },
+            {
+                'x-display-secret': [],
+            },
+        ];
+        for (const pathItem of Object.values(paths)) {
+            if (!pathItem || typeof pathItem !== 'object')
+                continue;
+            const operations = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+            for (const method of operations) {
+                const operation = pathItem[method];
+                if (!operation || typeof operation !== 'object')
+                    continue;
+                if (operation.security && Array.isArray(operation.security)) {
+                    const hasPublicMarker = operation.security.some((sec) => typeof sec === 'object' && sec !== null && '__PUBLIC_ROUTE__' in sec);
+                    if (hasPublicMarker) {
+                        operation.security = [];
+                        continue;
+                    }
+                }
+                if (!('security' in operation)) {
+                    operation.security = securityRequirements;
+                }
+            }
+        }
+    }
+};
+exports.SwaggerDocumentService = SwaggerDocumentService;
+exports.SwaggerDocumentService = SwaggerDocumentService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [swagger_models_registry_service_1.SwaggerModelsRegistryService,
+        extended_discriminator_service_1.ExtendedDiscriminatorService])
+], SwaggerDocumentService);
+//# sourceMappingURL=swagger-document.service.js.map

package/dist/modules/swagger/services/swagger-document.service.js.map

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

package/dist/modules/swagger/services/swagger-models-registry.service.d.ts

@@ -0,0 +1,6 @@
+import { Type } from '@nestjs/common';
+export declare class SwaggerModelsRegistryService {
+    private readonly models;
+    register(model: Type<unknown> | (abstract new (...args: unknown[]) => unknown)): void;
+    getAll(): (Type<unknown> | (abstract new (...args: unknown[]) => unknown))[];
+}

package/dist/modules/swagger/services/swagger-models-registry.service.js

@@ -0,0 +1,26 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerModelsRegistryService = void 0;
+const common_1 = require("@nestjs/common");
+let SwaggerModelsRegistryService = class SwaggerModelsRegistryService {
+    constructor() {
+        this.models = new Set();
+    }
+    register(model) {
+        this.models.add(model);
+    }
+    getAll() {
+        return Array.from(this.models);
+    }
+};
+exports.SwaggerModelsRegistryService = SwaggerModelsRegistryService;
+exports.SwaggerModelsRegistryService = SwaggerModelsRegistryService = __decorate([
+    (0, common_1.Injectable)()
+], SwaggerModelsRegistryService);
+//# sourceMappingURL=swagger-models-registry.service.js.map

package/dist/modules/swagger/services/swagger-models-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger-models-registry.service.js","sourceRoot":"","sources":["../../../../src/modules/swagger/services/swagger-models-registry.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAkD;AAS3C,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IAAlC;QACW,WAAM,GAAG,IAAI,GAAG,EAAkE,CAAC;IAiBrG,CAAC;IAXA,QAAQ,CAAC,KAAqE;QAC7E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAMD,MAAM;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;CACD,CAAA;AAlBY,oEAA4B;uCAA5B,4BAA4B;IADxC,IAAA,mBAAU,GAAE;GACA,4BAA4B,CAkBxC"}

package/dist/modules/swagger/swagger.constants.d.ts

@@ -0,0 +1 @@
+export declare const SWAGGER_MODULE_NAME = "swagger-module";

package/dist/modules/swagger/swagger.constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SWAGGER_MODULE_NAME = void 0;
+exports.SWAGGER_MODULE_NAME = 'swagger-module';
+//# sourceMappingURL=swagger.constants.js.map

package/dist/modules/swagger/swagger.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.constants.js","sourceRoot":"","sources":["../../../src/modules/swagger/swagger.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG,gBAAgB,CAAC"}

package/dist/modules/swagger/swagger.module.d.ts

@@ -0,0 +1,2 @@
+export declare class SwaggerModule {
+}

package/dist/modules/swagger/swagger.module.js

@@ -0,0 +1,32 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerModule = void 0;
+const common_1 = require("@nestjs/common");
+const app_instance_holder_service_1 = require("../../common/services/app-instance-holder.service");
+const generate_openapi_command_1 = require("./commands/generate-openapi.command");
+const extended_discriminator_service_1 = require("./services/extended-discriminator.service");
+const swagger_document_service_1 = require("./services/swagger-document.service");
+const swagger_models_registry_service_1 = require("./services/swagger-models-registry.service");
+let SwaggerModule = class SwaggerModule {
+};
+exports.SwaggerModule = SwaggerModule;
+exports.SwaggerModule = SwaggerModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [
+            swagger_document_service_1.SwaggerDocumentService,
+            swagger_models_registry_service_1.SwaggerModelsRegistryService,
+            extended_discriminator_service_1.ExtendedDiscriminatorService,
+            app_instance_holder_service_1.AppInstanceHolder,
+            generate_openapi_command_1.GenerateOpenapiCommand,
+        ],
+        exports: [swagger_document_service_1.SwaggerDocumentService, swagger_models_registry_service_1.SwaggerModelsRegistryService, extended_discriminator_service_1.ExtendedDiscriminatorService, app_instance_holder_service_1.AppInstanceHolder],
+    })
+], SwaggerModule);
+//# sourceMappingURL=swagger.module.js.map

package/dist/modules/swagger/swagger.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.module.js","sourceRoot":"","sources":["../../../src/modules/swagger/swagger.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAEhD,mGAAsF;AAEtF,kFAA6E;AAC7E,8FAAyF;AACzF,kFAA6E;AAC7E,gGAA0F;AAanF,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IAXzB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACP,SAAS,EAAE;YACV,iDAAsB;YACtB,8DAA4B;YAC5B,6DAA4B;YAC5B,+CAAiB;YACjB,iDAAsB;SACtB;QACD,OAAO,EAAE,CAAC,iDAAsB,EAAE,8DAA4B,EAAE,6DAA4B,EAAE,+CAAiB,CAAC;KAChH,CAAC;GACW,aAAa,CAAG"}

package/dist/modules/swagger/utils/openapi-tags.utils.d.ts

@@ -0,0 +1,6 @@
+export interface OpenApiTagDefinition {
+    name: string;
+    description: string;
+}
+export declare function getAllApiTags(): OpenApiTagDefinition[];
+export declare function getTagNameMapping(): Record<string, string>;

package/dist/modules/swagger/utils/openapi-tags.utils.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllApiTags = getAllApiTags;
+exports.getTagNameMapping = getTagNameMapping;
+const api_tag_decorator_1 = require("../decorators/api-tag.decorator");
+function getAllApiTags() {
+    return api_tag_decorator_1.openApiTagRegistry.getTagDefinitions();
+}
+function getTagNameMapping() {
+    return api_tag_decorator_1.openApiTagRegistry.getTagNameMapping();
+}
+//# sourceMappingURL=openapi-tags.utils.js.map

package/dist/modules/swagger/utils/openapi-tags.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-tags.utils.js","sourceRoot":"","sources":["../../../../src/modules/swagger/utils/openapi-tags.utils.ts"],"names":[],"mappings":";;AAcA,sCAEC;AAKD,8CAEC;AAnBD,uEAAqE;AAUrE,SAAgB,aAAa;IAC5B,OAAO,sCAAkB,CAAC,iBAAiB,EAAE,CAAC;AAC/C,CAAC;AAKD,SAAgB,iBAAiB;IAChC,OAAO,sCAAkB,CAAC,iBAAiB,EAAE,CAAC;AAC/C,CAAC"}

package/dist/modules/system/commands/command.utils.d.ts

@@ -0,0 +1,4 @@
+export declare function printStep(msg: string): void;
+export declare function printSuccess(msg: string): void;
+export declare function printWarning(msg: string): void;
+export declare function printError(msg: string): void;

package/dist/modules/system/commands/command.utils.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printStep = printStep;
+exports.printSuccess = printSuccess;
+exports.printWarning = printWarning;
+exports.printError = printError;
+function printStep(msg) {
+    console.log(`  \x1b[34m→\x1b[0m ${msg}`);
+}
+function printSuccess(msg) {
+    console.log(`  \x1b[32m✓\x1b[0m ${msg}`);
+}
+function printWarning(msg) {
+    console.log(`  \x1b[33m!\x1b[0m ${msg}`);
+}
+function printError(msg) {
+    console.log(`  \x1b[31m✗\x1b[0m ${msg}`);
+}
+//# sourceMappingURL=command.utils.js.map

package/dist/modules/system/commands/command.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.utils.js","sourceRoot":"","sources":["../../../../src/modules/system/commands/command.utils.ts"],"names":[],"mappings":";;AAAA,8BAEC;AAED,oCAEC;AAED,oCAEC;AAED,gCAEC;AAdD,SAAgB,SAAS,CAAC,GAAW;IACpC,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,YAAY,CAAC,GAAW;IACvC,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,YAAY,CAAC,GAAW;IACvC,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,UAAU,CAAC,GAAW;IACrC,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/modules/system/commands/update-check.command.d.ts

@@ -0,0 +1,17 @@
+import { CommandRunner } from 'nest-commander';
+import { UpdateService } from '../services/update.service';
+interface UpdateCheckOptions {
+    channel?: string;
+    panel?: boolean;
+    changelog?: boolean;
+}
+export declare class UpdateCheckCommand extends CommandRunner {
+    private readonly updateService;
+    private readonly logger;
+    constructor(updateService: UpdateService);
+    run(_passedParams: string[], options?: UpdateCheckOptions): Promise<void>;
+    parseChannel(val: string): string;
+    parsePanel(val: boolean): boolean;
+    parseChangelog(): boolean;
+}
+export {};

package/dist/modules/system/commands/update-check.command.js

@@ -0,0 +1,135 @@
+"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.UpdateCheckCommand = void 0;
+const nest_commander_1 = require("nest-commander");
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../../../common/logger");
+const update_service_1 = require("../services/update.service");
+const system_constants_1 = require("../system.constants");
+let UpdateCheckCommand = class UpdateCheckCommand extends nest_commander_1.CommandRunner {
+    constructor(updateService) {
+        super();
+        this.updateService = updateService;
+        this.logger = (0, logger_1.createExtensionLogger)(system_constants_1.SYSTEM_MODULE_NAME, 'UpdateCheckCommand');
+    }
+    async run(_passedParams, options) {
+        const channel = options?.channel || 'latest';
+        const checkPanel = options?.panel ?? true;
+        console.log('\n\x1b[36m  FastyBird Smart Panel - Update Check\x1b[0m');
+        console.log('\x1b[90m  ─────────────────────────────────────\x1b[0m\n');
+        console.log('\x1b[1m  Server (Backend + Admin)\x1b[0m\n');
+        const serverInfo = await this.updateService.checkServerUpdate(channel);
+        console.log(`  Current version:  \x1b[37m${serverInfo.current}\x1b[0m`);
+        if (serverInfo.latest) {
+            console.log(`  Latest version:   \x1b[37m${serverInfo.latest}\x1b[0m`);
+            if (serverInfo.updateAvailable) {
+                const typeColor = serverInfo.updateType === 'major' ? '\x1b[31m' : serverInfo.updateType === 'minor' ? '\x1b[33m' : '\x1b[32m';
+                console.log(`  Update type:      ${typeColor}${serverInfo.updateType}\x1b[0m`);
+                console.log(`\n  \x1b[32m✓\x1b[0m Update available! Run \x1b[36msystem:update:server\x1b[0m to install.`);
+                if (options?.changelog && serverInfo.latest) {
+                    const releaseNotes = await this.updateService.fetchReleaseNotes(serverInfo.latest);
+                    if (releaseNotes.body) {
+                        console.log(`\n\x1b[1m  Release Notes (v${releaseNotes.version})\x1b[0m\n`);
+                        console.log(releaseNotes.body
+                            .split('\n')
+                            .map((line) => `  ${line}`)
+                            .join('\n'));
+                    }
+                    console.log(`\n  \x1b[90mFull changelog: ${releaseNotes.url}\x1b[0m`);
+                }
+            }
+            else {
+                console.log('\n  \x1b[32m✓\x1b[0m Server is up to date.');
+            }
+        }
+        else {
+            console.log('  Latest version:   \x1b[33munable to check\x1b[0m');
+        }
+        if (checkPanel) {
+            console.log('\n\x1b[1m  Panel (Display App)\x1b[0m\n');
+            const panelInfo = await this.updateService.checkPanelUpdate(channel !== 'latest');
+            if (panelInfo.latest) {
+                console.log(`  Latest release:   \x1b[37m${panelInfo.latest}\x1b[0m`);
+                if (panelInfo.assets.length > 0) {
+                    console.log('  Available builds:');
+                    for (const asset of panelInfo.assets) {
+                        const sizeMB = (asset.size / (1024 * 1024)).toFixed(1);
+                        console.log(`    \x1b[90m•\x1b[0m ${asset.name} \x1b[90m(${sizeMB} MB)\x1b[0m`);
+                    }
+                    console.log(`\n  Run \x1b[36msystem:update:panel\x1b[0m to update the display app.`);
+                }
+                else {
+                    console.log('  \x1b[33m!\x1b[0m No panel builds found in this release.');
+                }
+            }
+            else {
+                console.log('  Latest release:   \x1b[33munable to check\x1b[0m');
+            }
+        }
+        console.log();
+        this.logger.log('Update check completed');
+    }
+    parseChannel(val) {
+        const allowed = ['latest', 'beta', 'alpha'];
+        if (!allowed.includes(val)) {
+            console.error(`\x1b[31m❌ Invalid channel: ${val}. Allowed: ${allowed.join(', ')}\x1b[0m`);
+            process.exit(1);
+        }
+        return val;
+    }
+    parsePanel(val) {
+        return val;
+    }
+    parseChangelog() {
+        return true;
+    }
+};
+exports.UpdateCheckCommand = UpdateCheckCommand;
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: '-c, --channel <channel>',
+        description: 'Release channel to check (latest, beta, alpha)',
+        defaultValue: 'latest',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", String)
+], UpdateCheckCommand.prototype, "parseChannel", null);
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: '--no-panel',
+        description: 'Skip checking panel updates',
+        defaultValue: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Boolean]),
+    __metadata("design:returntype", Boolean)
+], UpdateCheckCommand.prototype, "parsePanel", null);
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: '--changelog',
+        description: 'Display release notes for available updates',
+        defaultValue: false,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Boolean)
+], UpdateCheckCommand.prototype, "parseChangelog", null);
+exports.UpdateCheckCommand = UpdateCheckCommand = __decorate([
+    (0, nest_commander_1.Command)({
+        name: 'system:update:check',
+        description: 'Check for available updates for server and panel apps',
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [update_service_1.UpdateService])
+], UpdateCheckCommand);
+//# sourceMappingURL=update-check.command.js.map

package/dist/modules/system/commands/update-check.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.command.js","sourceRoot":"","sources":["../../../../src/modules/system/commands/update-check.command.ts"],"names":[],"mappings":"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"}