@matterbridge/thread 3.10.13-dev-20261007-320f739 → 3.10.13-dev-20261008-55d98fb

package/dist/backend.js

@@ -1,369 +0,0 @@
-import EventEmitter from 'node:events';
-import path from 'node:path';
-import { NODE_STORAGE_DIR, } from '@matterbridge/types';
-import { getParameter, hasAnyParameter, hasParameter } from '@matterbridge/utils/cli';
-import { writeDiagnostic } from '@matterbridge/utils/diagnostic';
-import { getErrorMessage, inspectError, logError } from '@matterbridge/utils/error';
-import { logModuleLoaded } from '@matterbridge/utils/loader';
-import { fireAndForget } from '@matterbridge/utils/wait';
-import { AnsiLogger, rs, UNDERLINE, UNDERLINEOFF } from 'node-ansi-logger';
-import { NodeStorageManager } from 'node-persist-manager';
-import { BroadcastServer } from './broadcastServer.js';
-logModuleLoaded('Backend');
-export class Backend extends EventEmitter {
-    debug;
-    verbose;
-    diagnostic;
-    log;
-    matterbridge;
-    server;
-    port = 8283;
-    listening = false;
-    httpServer;
-    httpsServer;
-    secure;
-    requestCert;
-    backendExpress;
-    backendWsServer;
-    storedPassword = undefined;
-    authClients = new Set();
-    authClientsTimeout = undefined;
-    constructor(matterbridge) {
-        super();
-        this.debug = hasAnyParameter('debug', 'verbose', 'debug-backend', 'verbose-backend');
-        this.verbose = hasAnyParameter('verbose', 'verbose-backend');
-        this.diagnostic = hasAnyParameter('diagnostic', 'diagnostic-backend');
-        this.secure = hasAnyParameter('ssl', 'tls', 'mtls');
-        this.requestCert = hasParameter('mtls');
-        this.matterbridge = matterbridge;
-        this.log = new AnsiLogger({
-            logName: 'Backend',
-            logNameColor: '\x1b[38;5;97m',
-            logTimestampFormat: 4,
-            logLevel: this.debug ? "debug" : "info",
-        });
-        this.server = new BroadcastServer('frontend', this.log);
-        this.server.on('broadcast_message', (msg) => fireAndForget(this.broadcastMsgHandler(msg), this.log, 'Broadcast message handler'));
-    }
-    destroy() {
-        this.server.close();
-    }
-    async broadcastMsgHandler(msg) {
-        if (this.server.isWorkerRequest(msg)) {
-            switch (msg.type) {
-                case 'get_log_level':
-                    this.server.respond({ ...msg, result: { logLevel: this.log.logLevel } });
-                    break;
-                case 'set_log_level':
-                    this.log.logLevel = msg.params.logLevel;
-                    this.server.respond({ ...msg, result: { logLevel: this.log.logLevel } });
-                    break;
-            }
-        }
-    }
-    async start(port = 8283) {
-        this.log.debug('Starting backend...');
-        this.port = port;
-        const start = performance.now();
-        const nodeStorage = new NodeStorageManager({
-            dir: path.join(this.matterbridge.matterbridgeDirectory, NODE_STORAGE_DIR),
-            writeQueue: false,
-            expiredInterval: undefined,
-            logging: false,
-        });
-        try {
-            const nodeContext = await nodeStorage.createStorage('matterbridge');
-            try {
-                this.storedPassword = await nodeContext.get('password', '');
-            }
-            finally {
-                await nodeContext.close();
-            }
-        }
-        finally {
-            await nodeStorage.close();
-            if (this.diagnostic)
-                writeDiagnostic('Backend', `Loading storedPassword took ${(performance.now() - start).toFixed(2)} ms`);
-        }
-        const { BackendExpress } = await import('./backendExpress.js');
-        const { BackendWsServer } = await import('./backendWsServer.js');
-        this.backendExpress = new BackendExpress(this.matterbridge, this);
-        this.backendWsServer = new BackendWsServer(this.matterbridge, this);
-        if (this.secure) {
-            let cert;
-            let key;
-            let ca;
-            let fullChain;
-            let pfx;
-            let passphrase;
-            let httpsServerOptions;
-            const fs = await import('node:fs');
-            if (fs.existsSync(path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.p12'))) {
-                try {
-                    pfx = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.p12'));
-                    this.log.info(`Loaded p12 certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.p12')}`);
-                }
-                catch (error) {
-                    logError(this.log, `Error reading p12 certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.p12')}`, error);
-                    this.emit('server_error', error);
-                    return;
-                }
-                try {
-                    passphrase = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.pass'), 'utf8');
-                    passphrase = passphrase.trim();
-                    this.log.info(`Loaded p12 passphrase file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.pass')}`);
-                }
-                catch (error) {
-                    logError(this.log, `Error reading p12 passphrase file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.pass')}`, error);
-                    this.emit('server_error', error);
-                    return;
-                }
-                httpsServerOptions = { pfx, passphrase };
-            }
-            else {
-                try {
-                    cert = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.pem'), 'utf8');
-                    this.log.info(`Loaded certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.pem')}`);
-                }
-                catch (error) {
-                    logError(this.log, `Error reading certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'cert.pem')}`, error);
-                    this.emit('server_error', error);
-                    return;
-                }
-                try {
-                    key = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'key.pem'), 'utf8');
-                    this.log.info(`Loaded key file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'key.pem')}`);
-                }
-                catch (error) {
-                    logError(this.log, `Error reading key file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'key.pem')}`, error);
-                    this.emit('server_error', error);
-                    return;
-                }
-                try {
-                    ca = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'ca.pem'), 'utf8');
-                    fullChain = `${cert}\n${ca}`;
-                    this.log.info(`Loaded CA certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'ca.pem')}`);
-                }
-                catch (error) {
-                    this.log.info(`CA certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs', 'ca.pem')} not loaded: ${getErrorMessage(error)}`);
-                }
-                httpsServerOptions = { cert: fullChain ?? cert, key, ca };
-            }
-            if (this.requestCert) {
-                httpsServerOptions.requestCert = true;
-                httpsServerOptions.rejectUnauthorized = true;
-            }
-            const https = await import('node:https');
-            await this.backendExpress.start();
-            try {
-                this.log.debug(`Creating HTTPS server...`);
-                this.httpsServer = https.createServer(httpsServerOptions, this.backendExpress.expressApp);
-            }
-            catch (error) {
-                logError(this.log, `Failed to create HTTPS server`, error);
-                this.emit('server_error', error);
-                await this.backendExpress.stop();
-                return;
-            }
-            await this.backendWsServer.start();
-            this.httpsServer.listen(this.port, getParameter('bind'), () => {
-                const addr = this.httpsServer?.address();
-                if (addr && typeof addr !== 'string') {
-                    this.log.info(`The frontend https server is bound to ${addr.family} ${addr.address}:${addr.port}`);
-                }
-                if (this.matterbridge.systemInformation.ipv4Address !== '' && !getParameter('bind'))
-                    this.log.info(`The frontend https server is listening on ${UNDERLINE}https://${this.matterbridge.systemInformation.ipv4Address}:${this.port}${UNDERLINEOFF}${rs}`);
-                if (this.matterbridge.systemInformation.ipv6Address !== '' && !getParameter('bind'))
-                    this.log.info(`The frontend https server is listening on ${UNDERLINE}https://[${this.matterbridge.systemInformation.ipv6Address}]:${this.port}${UNDERLINEOFF}${rs}`);
-                this.listening = true;
-                this.emit('server_listening', 'https', this.port);
-            });
-            this.httpsServer.on('upgrade', (req, socket, head) => {
-                try {
-                    const upgrade = (req.headers.upgrade || '').toLowerCase();
-                    if (upgrade !== 'websocket') {
-                        socket.write('HTTP/1.1 400 Bad Request\r\nConnection: close\r\n\r\n');
-                        socket.destroy();
-                        return;
-                    }
-                    const url = new URL(req.url ?? '/', `https://${req.headers.host || 'localhost'}`);
-                    const password = url.searchParams.get('password') ?? '';
-                    if (password !== this.storedPassword) {
-                        this.log.error(`WebSocket upgrade error: Invalid password ${password ? '[redacted]' : '(empty)'}`);
-                        socket.write('HTTP/1.1 401 Unauthorized\r\nConnection: close\r\n\r\n');
-                        socket.destroy();
-                        return;
-                    }
-                    this.log.debug(`WebSocket upgrade success host ${url.host} password ${password ? '[redacted]' : '(empty)'}`);
-                    if (req.socket.remoteAddress)
-                        this.authClients.add(req.socket.remoteAddress);
-                    this.backendWsServer?.webSocketServer?.handleUpgrade(req, socket, head, (ws) => {
-                        this.backendWsServer?.webSocketServer?.emit('connection', ws, req);
-                    });
-                }
-                catch (err) {
-                    {
-                        inspectError(this.log, 'WebSocket upgrade error:', err);
-                        socket.write('HTTP/1.1 500 Internal Server Error\r\nConnection: close\r\n\r\n');
-                        socket.destroy();
-                    }
-                }
-            });
-            this.httpsServer.on('error', (error) => {
-                this.log.error(`Frontend https server error listening on ${this.port}`);
-                switch (error.code) {
-                    case 'EACCES':
-                        this.log.error(`Port ${this.port} requires elevated privileges`);
-                        break;
-                    case 'EADDRINUSE':
-                        this.log.error(`Port ${this.port} is already in use`);
-                        break;
-                }
-                this.emit('server_error', error);
-            });
-        }
-        else {
-            const http = await import('node:http');
-            await this.backendExpress.start();
-            try {
-                this.log.debug(`Creating HTTP server...`);
-                this.httpServer = http.createServer(this.backendExpress.expressApp);
-            }
-            catch (error) {
-                logError(this.log, `Failed to create HTTP server`, error);
-                this.emit('server_error', error);
-                await this.backendExpress.stop();
-                return;
-            }
-            await this.backendWsServer.start();
-            this.httpServer.listen(this.port, getParameter('bind'), () => {
-                const addr = this.httpServer?.address();
-                if (addr && typeof addr !== 'string') {
-                    this.log.info(`The frontend http server is bound to ${addr.family} ${addr.address}:${addr.port}`);
-                }
-                if (this.matterbridge.systemInformation.ipv4Address !== '' && !getParameter('bind'))
-                    this.log.info(`The frontend http server is listening on ${UNDERLINE}http://${this.matterbridge.systemInformation.ipv4Address}:${this.port}${UNDERLINEOFF}${rs}`);
-                if (this.matterbridge.systemInformation.ipv6Address !== '' && !getParameter('bind'))
-                    this.log.info(`The frontend http server is listening on ${UNDERLINE}http://[${this.matterbridge.systemInformation.ipv6Address}]:${this.port}${UNDERLINEOFF}${rs}`);
-                this.listening = true;
-                this.emit('server_listening', 'http', this.port);
-            });
-            this.httpServer.on('upgrade', (req, socket, head) => {
-                try {
-                    const upgrade = (req.headers.upgrade || '').toLowerCase();
-                    if (upgrade !== 'websocket') {
-                        this.log.error(`WebSocket upgrade error: Invalid upgrade header ${req.headers.upgrade}`);
-                        socket.write('HTTP/1.1 400 Bad Request\r\nConnection: close\r\n\r\n');
-                        socket.destroy();
-                        return;
-                    }
-                    const url = new URL(req.url ?? '/', `http://${req.headers.host || 'localhost'}`);
-                    const password = url.searchParams.get('password') ?? '';
-                    if (password !== this.storedPassword) {
-                        this.log.error(`WebSocket upgrade error: Invalid password ${password ? '[redacted]' : '(empty)'}`);
-                        socket.write('HTTP/1.1 401 Unauthorized\r\nConnection: close\r\n\r\n');
-                        socket.destroy();
-                        return;
-                    }
-                    this.log.debug(`WebSocket upgrade success host ${url.host} password ${password ? '[redacted]' : '(empty)'}`);
-                    if (req.socket.remoteAddress)
-                        this.authClients.add(req.socket.remoteAddress);
-                    this.backendWsServer?.webSocketServer?.handleUpgrade(req, socket, head, (ws) => {
-                        this.backendWsServer?.webSocketServer?.emit('connection', ws, req);
-                    });
-                }
-                catch (err) {
-                    {
-                        inspectError(this.log, 'WebSocket upgrade error:', err);
-                        socket.write('HTTP/1.1 500 Internal Server Error\r\nConnection: close\r\n\r\n');
-                        socket.destroy();
-                    }
-                }
-                return;
-            });
-            this.httpServer.on('error', (error) => {
-                this.log.error(`Frontend http server error listening on ${this.port}`);
-                switch (error.code) {
-                    case 'EACCES':
-                        this.log.error(`Port ${this.port} requires elevated privileges`);
-                        break;
-                    case 'EADDRINUSE':
-                        this.log.error(`Port ${this.port} is already in use`);
-                        break;
-                }
-                this.emit('server_error', error);
-            });
-        }
-        this.log.debug('Backend started');
-    }
-    async stop() {
-        this.log.debug('Stopping backend...');
-        await this.backendWsServer?.stop();
-        if (this.httpServer) {
-            this.log.debug('Closing http server...');
-            this.httpServer.close();
-            this.log.debug('Http server closed successfully');
-            this.listening = false;
-            this.emit('server_stopped');
-            this.httpServer.removeAllListeners();
-            this.httpServer = undefined;
-            this.log.debug('Backend http server closed successfully');
-        }
-        if (this.httpsServer) {
-            this.log.debug('Closing https server...');
-            this.httpsServer.close();
-            this.log.debug('Https server closed successfully');
-            this.listening = false;
-            this.emit('server_stopped');
-            this.httpsServer.removeAllListeners();
-            this.httpsServer = undefined;
-            this.log.debug('Backend https server closed successfully');
-        }
-        await this.backendExpress?.stop();
-        this.backendWsServer?.destroy();
-        this.backendExpress?.destroy();
-        this.backendWsServer = undefined;
-        this.backendExpress = undefined;
-        this.log.debug('Backend stopped');
-    }
-    async getApiSettings() {
-        const start = performance.now();
-        const response = await this.server.fetch({ type: 'matterbridge_apisettings', src: 'frontend', dst: 'matterbridge', params: undefined });
-        if (this.diagnostic)
-            writeDiagnostic('Backend', `getApiSettings() took ${(performance.now() - start).toFixed(2)} ms`);
-        return response.result.data;
-    }
-    async getApiPlugins() {
-        const start = performance.now();
-        const response = await this.server.fetch({ type: 'plugins_apipluginarray', src: 'frontend', dst: 'plugins', params: undefined });
-        if (this.diagnostic)
-            writeDiagnostic('Backend', `getApiPlugins() took ${(performance.now() - start).toFixed(2)} ms`);
-        return response.result.plugins;
-    }
-    async getApiDevices(pluginName) {
-        const start = performance.now();
-        const response = await this.server.fetch({ type: 'devices_apidevicearray', src: 'frontend', dst: 'devices', params: { pluginName } });
-        if (this.diagnostic)
-            writeDiagnostic('Backend', `getApiDevices() took ${(performance.now() - start).toFixed(2)} ms`);
-        return response.result.devices;
-    }
-    async getApiCluster(pluginName, endpointNumber, serialNumber, uniqueId) {
-        const start = performance.now();
-        this.log.debug(`Retrieving API cluster for plugin: ${pluginName}, endpoint: ${endpointNumber}, serial: ${serialNumber}, uniqueId: ${uniqueId}`);
-        if (this.diagnostic)
-            writeDiagnostic('Backend', `getApiCluster() took ${(performance.now() - start).toFixed(2)} ms`);
-        return undefined;
-    }
-    async generateDiagnostic() {
-        const start = performance.now();
-        if (this.diagnostic)
-            writeDiagnostic('Backend', `generateDiagnostic() took ${(performance.now() - start).toFixed(2)} ms`);
-    }
-    async getApiMatter(id) {
-        const start = performance.now();
-        const response = await this.server.fetch({ type: 'matterbridge_apimatter', src: 'frontend', dst: 'matterbridge', params: { id } });
-        if (this.diagnostic)
-            writeDiagnostic('Backend', `getApiMatter() took ${(performance.now() - start).toFixed(2)} ms`);
-        return response.result.matter;
-    }
-}

package/dist/backendExpress.d.ts

@@ -1,21 +0,0 @@
-import { type SharedMatterbridge } from '@matterbridge/types';
-import express from 'express';
-import type { Backend } from './backend.js';
-export declare class BackendExpress {
-    private debug;
-    private verbose;
-    private diagnostic;
-    private log;
-    private backend;
-    private matterbridge;
-    private readonly server;
-    private fileLimiter;
-    expressApp: express.Application | undefined;
-    serverFetchTimeout: number;
-    constructor(matterbridge: SharedMatterbridge, backend: Backend);
-    destroy(): void;
-    private broadcastMsgHandler;
-    private validateReq;
-    start(): Promise<express.Application | undefined>;
-    stop(): Promise<express.Application | undefined>;
-}