@camera.ui/server 0.0.69 → 0.0.71-dev.0

package/dist/server/src/workers/agent.js

@@ -0,0 +1,161 @@
+import { Logger } from '@camera.ui/common/logger';
+import { SignalHandler } from '@camera.ui/common/utils';
+import { createRPCClient } from '@camera.ui/rpc';
+import { totalmem } from 'node:os';
+import { container } from 'tsyringe';
+import { WorkersService } from '../api/services/workers.service.js';
+import { NamespaceManager } from '../rpc/namespaces.js';
+import { FrameDecodingHandler } from './capabilities/frame-decoding.js';
+import { WorkerCapability } from './types.js';
+export class WorkerAgent {
+    agentId;
+    capabilities;
+    logger;
+    configService;
+    natsServer;
+    startTime = Date.now();
+    proxy;
+    handlers = new Map();
+    heartbeatInterval;
+    closeHandler;
+    signalHandler;
+    previousCpuUsage = process.cpuUsage();
+    previousCpuTime = Date.now();
+    constructor() {
+        this.configService = container.resolve('configService');
+        this.natsServer = container.resolve('natsServer');
+        const workerName = this.configService.config.workers?.name ?? 'worker';
+        this.agentId = new WorkersService().getOrCreateAgentId(workerName);
+        const validCapabilities = new Set(Object.values(WorkerCapability));
+        const configuredCapabilities = this.configService.config.workers?.capabilities ?? [];
+        this.capabilities = configuredCapabilities.filter((cap) => validCapabilities.has(cap));
+        const loggerOptions = {
+            prefix: 'WorkerAgent',
+            suffix: this.configService.config.workers?.name ?? 'worker',
+            debugEnabled: this.configService.config.logger?.level === 'debug' || this.configService.config.logger?.level === 'trace',
+            traceEnabled: this.configService.config.logger?.level === 'trace',
+        };
+        this.logger = new Logger(loggerOptions);
+        this.signalHandler = new SignalHandler({
+            displayName: '[WorkerAgent]',
+            timeoutDuration: 5000,
+            logger: this.logger,
+            closeFunction: this.close.bind(this),
+        });
+    }
+    async start() {
+        this.logger.log(`Starting WorkerAgent (id: ${this.agentId})`);
+        if (this.capabilities.length === 0) {
+            const available = Object.values(WorkerCapability).join(', ');
+            throw new Error(`Worker has no valid capabilities configured. Configure "workers.capabilities" in config (available: ${available})`);
+        }
+        const configuredCapabilities = this.configService.config.workers?.capabilities ?? [];
+        const invalidCapabilities = configuredCapabilities.filter((cap) => !this.capabilities.includes(cap));
+        if (invalidCapabilities.length > 0) {
+            this.logger.warn(`Ignoring unknown capabilities: [${invalidCapabilities.join(', ')}]`);
+        }
+        this.logger.log(`Capabilities: [${this.capabilities.join(', ')}]`);
+        for (const cap of this.capabilities) {
+            switch (cap) {
+                case WorkerCapability.FrameDecoding:
+                    this.handlers.set(cap, new FrameDecodingHandler(this.natsServer, this.configService, this.logger));
+                    break;
+                default:
+                    this.logger.warn(`No handler for capability: ${cap}`);
+            }
+        }
+        // Local NATS (leaf node)
+        this.proxy = createRPCClient({
+            name: `worker-agent-${this.agentId}`,
+            servers: this.natsServer.endpoints.filter((ep) => ep.startsWith('nats://')),
+            auth: {
+                user: this.natsServer.localAuth.user,
+                password: this.natsServer.localAuth.password,
+            },
+        });
+        await this.proxy.connect();
+        const rpcSubject = NamespaceManager.workerAgentRpc(this.agentId);
+        this.closeHandler = await this.proxy.registerHandler(rpcSubject, this, { isolatedConnection: true, withoutDecorators: true });
+        this.startHeartbeat();
+        this.logger.log('WorkerAgent started and ready for commands');
+    }
+    async close() {
+        this.logger.log('Shutting down WorkerAgent...');
+        try {
+            this.proxy.publish(NamespaceManager.workerDisconnect(), { agentId: this.agentId });
+        }
+        catch {
+            // best-effort — proxy might already be disconnected
+        }
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = undefined;
+        }
+        for (const handler of this.handlers.values()) {
+            await handler.stopAll();
+        }
+        await this.closeHandler?.();
+        await this.proxy?.disconnect();
+        this.logger.log('WorkerAgent shut down');
+    }
+    async startCamera(config) {
+        this.logger.log(`Starting camera: ${config.cameraName} (${config.cameraId})`);
+        for (const handler of this.handlers.values()) {
+            await handler.start(config.cameraId, config);
+        }
+    }
+    async stopCamera(cameraId) {
+        this.logger.log(`Stopping camera: ${cameraId}`);
+        for (const handler of this.handlers.values()) {
+            await handler.stop(cameraId);
+        }
+    }
+    async ping() {
+        return {
+            agentId: this.agentId,
+            name: this.configService.config.workers?.name ?? 'worker',
+            uptime: Date.now() - this.startTime,
+            cameras: Array.from(this.handlers.values()).flatMap((h) => h.getActiveWorkIds()),
+            capabilities: this.capabilities,
+        };
+    }
+    async restart() {
+        this.logger.log('Restart requested — shutting down gracefully');
+        // Defer so the RPC response is sent before the connection drops
+        setTimeout(async () => {
+            await this.close();
+            process.exit(0);
+        }, 100);
+    }
+    startHeartbeat() {
+        const sendHeartbeat = () => {
+            const heartbeat = {
+                agentId: this.agentId,
+                name: this.configService.config.workers?.name ?? 'worker',
+                cameras: Array.from(this.handlers.values()).flatMap((h) => h.getActiveWorkIds()),
+                uptime: Date.now() - this.startTime,
+                capabilities: this.capabilities,
+                pid: process.pid,
+                cpuLoad: this.getCpuLoad(),
+                memLoad: this.getMemLoad(),
+            };
+            this.proxy.publish(NamespaceManager.workerHeartbeat(), heartbeat);
+        };
+        sendHeartbeat();
+        this.heartbeatInterval = setInterval(sendHeartbeat, 5_000);
+    }
+    getCpuLoad() {
+        const current = process.cpuUsage(this.previousCpuUsage);
+        const elapsed = (Date.now() - this.previousCpuTime) * 1000; // ms → µs
+        this.previousCpuUsage = process.cpuUsage();
+        this.previousCpuTime = Date.now();
+        const cpuPercent = ((current.user + current.system) / elapsed) * 100;
+        return Math.min(cpuPercent, 100).toFixed(2);
+    }
+    getMemLoad() {
+        const used = process.memoryUsage().rss;
+        const total = totalmem();
+        return ((used / total) * 100).toFixed(2);
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/server/src/workers/agent.js.map

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

package/dist/server/src/workers/capabilities/frame-decoding.d.ts

@@ -0,0 +1,24 @@
+import { WorkerCapability } from '../types.js';
+import type { Logger } from '@camera.ui/common/logger';
+import type { NATS } from '../../rpc/server.js';
+import type { ConfigService } from '../../services/config/index.js';
+import type { RemoteCameraConfig } from '../types.js';
+import type { CapabilityHandler } from './handler.js';
+export declare class FrameDecodingHandler implements CapabilityHandler<WorkerCapability.FrameDecoding> {
+    private readonly natsServer;
+    private readonly configService;
+    private readonly logger;
+    readonly capability = WorkerCapability.FrameDecoding;
+    private cameras;
+    private restartTimers;
+    private isClosed;
+    constructor(natsServer: NATS, configService: ConfigService, logger: Logger);
+    start(id: string, spec: RemoteCameraConfig): Promise<void>;
+    stop(id: string): Promise<void>;
+    stopAll(): Promise<void>;
+    getActiveWorkIds(): string[];
+    private forkFrameWorker;
+    private killProcess;
+    private attemptRestart;
+    private logChildOutput;
+}

package/dist/server/src/workers/capabilities/frame-decoding.js

@@ -0,0 +1,180 @@
+import { sleep } from '@camera.ui/common/utils';
+import { fork } from 'node:child_process';
+import { nodeDecoderPath } from '../../utils/path.js';
+import { WorkerCapability } from '../types.js';
+export class FrameDecodingHandler {
+    natsServer;
+    configService;
+    logger;
+    capability = WorkerCapability.FrameDecoding;
+    cameras = new Map();
+    restartTimers = new Map();
+    isClosed = false;
+    constructor(natsServer, configService, logger) {
+        this.natsServer = natsServer;
+        this.configService = configService;
+        this.logger = logger;
+    }
+    async start(id, spec) {
+        this.logger.log(`Starting camera: ${spec.cameraName} (${id})`);
+        if (this.cameras.has(id)) {
+            await this.stop(id);
+            await sleep(1000);
+        }
+        const managed = {
+            cameraId: id,
+            config: spec,
+        };
+        this.cameras.set(id, managed);
+        try {
+            managed.frameWorkerProcess = this.forkFrameWorker(spec);
+        }
+        catch (error) {
+            this.logger.error(`Failed to fork FrameWorker for ${spec.cameraName}:`, error);
+            await this.stop(id);
+            throw error;
+        }
+    }
+    async stop(id) {
+        const managed = this.cameras.get(id);
+        if (!managed) {
+            return;
+        }
+        this.logger.log(`Stopping camera: ${managed.config.cameraName} (${id})`);
+        this.cameras.delete(id);
+        const restartTimer = this.restartTimers.get(id);
+        if (restartTimer) {
+            clearTimeout(restartTimer);
+            this.restartTimers.delete(id);
+        }
+        if (managed.frameWorkerProcess) {
+            await this.killProcess(managed.frameWorkerProcess);
+            managed.frameWorkerProcess = undefined;
+        }
+    }
+    async stopAll() {
+        this.isClosed = true;
+        for (const timer of this.restartTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.restartTimers.clear();
+        const stopPromises = Array.from(this.cameras.keys()).map((id) => this.stop(id));
+        await Promise.allSettled(stopPromises);
+    }
+    getActiveWorkIds() {
+        return Array.from(this.cameras.keys());
+    }
+    forkFrameWorker(config) {
+        const proxyAuth = this.natsServer.localAuth;
+        const processName = 'camera.ui - Frame Worker (remote)';
+        const env = {
+            CAMERA_ID: config.cameraId,
+            CAMERA_NAME: config.cameraName,
+            PROXY_USER: proxyAuth.user,
+            PROXY_PASSWORD: proxyAuth.password,
+            PROXY_ENDPOINTS: this.natsServer.endpoints.join(','),
+            PROXY_CERT: this.configService.ssl.cert.toString('utf-8'),
+            PROXY_KEY: this.configService.ssl.key.toString('utf-8'),
+            PROXY_CA: this.configService.ssl.ca.toString('utf-8'),
+            LOGGER_LEVEL: config.loggerLevel,
+        };
+        this.logger.debug(`Forking FrameWorker for ${config.cameraName}`);
+        const child = fork(nodeDecoderPath, [processName], {
+            env: { ...process.env, ...env },
+            silent: true,
+        });
+        child.once('spawn', () => {
+            this.logger.log(`FrameWorker for ${config.cameraName} started with PID: ${child.pid}`);
+            if (child.pid) {
+                this.configService.addProcess({
+                    pid: child.pid,
+                    startTime: Date.now(),
+                    command: process.execPath,
+                    args: [processName],
+                    titles: [processName],
+                });
+            }
+        });
+        child.once('exit', (code, signal) => {
+            this.logger.warn(`FrameWorker for ${config.cameraName} exited (code: ${code}, signal: ${signal})`);
+            this.configService.removeProcessByPID(child.pid);
+            const managed = this.cameras.get(config.cameraId);
+            if (managed) {
+                managed.frameWorkerProcess = undefined;
+            }
+            this.attemptRestart(config);
+        });
+        child.stdout?.on('data', (data) => {
+            this.logChildOutput(data, config.cameraName);
+        });
+        child.stderr?.on('data', (data) => {
+            this.logChildOutput(data, config.cameraName);
+        });
+        return child;
+    }
+    async killProcess(child) {
+        return new Promise((resolve) => {
+            if (!child.connected && child.exitCode !== null) {
+                resolve();
+                return;
+            }
+            const timeout = setTimeout(() => {
+                child.kill('SIGKILL');
+                resolve();
+            }, 3000);
+            child.once('exit', () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+            child.kill('SIGTERM');
+        });
+    }
+    attemptRestart(config) {
+        if (this.isClosed) {
+            return;
+        }
+        const managed = this.cameras.get(config.cameraId);
+        if (!managed) {
+            return;
+        }
+        const existingTimer = this.restartTimers.get(config.cameraId);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        this.logger.log(`Scheduling FrameWorker restart for ${config.cameraName} in 5s`);
+        const timer = setTimeout(async () => {
+            this.restartTimers.delete(config.cameraId);
+            if (this.isClosed) {
+                return;
+            }
+            const current = this.cameras.get(config.cameraId);
+            if (!current) {
+                return;
+            }
+            // Already running (restarted by master via RPC)
+            if (current.frameWorkerProcess) {
+                return;
+            }
+            try {
+                this.logger.log(`Restarting FrameWorker for ${config.cameraName}`);
+                current.frameWorkerProcess = this.forkFrameWorker(config);
+            }
+            catch (error) {
+                this.logger.error(`Failed to restart FrameWorker for ${config.cameraName}:`, error);
+                // Remove camera so heartbeat reflects reality
+                this.cameras.delete(config.cameraId);
+            }
+        }, 5000);
+        this.restartTimers.set(config.cameraId, timer);
+    }
+    logChildOutput(data, label) {
+        const lines = data.toString().split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed) {
+                this.logger.trace(`[${label}] ${trimmed}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=frame-decoding.js.map

package/dist/server/src/workers/capabilities/frame-decoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-decoding.js","sourceRoot":"","sources":["../../../../../src/workers/capabilities/frame-decoding.ts"],"names":[],"mappings":"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"}

package/dist/server/src/workers/capabilities/handler.d.ts

@@ -0,0 +1,8 @@
+import type { CapabilitySpec, WorkerCapability } from '../types.js';
+export interface CapabilityHandler<C extends WorkerCapability = WorkerCapability> {
+    readonly capability: C;
+    start(id: string, spec: CapabilitySpec[C]): Promise<void>;
+    stop(id: string): Promise<void>;
+    stopAll(): Promise<void>;
+    getActiveWorkIds(): string[];
+}

package/dist/server/src/workers/capabilities/handler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=handler.js.map

package/dist/server/src/workers/capabilities/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../../src/workers/capabilities/handler.ts"],"names":[],"mappings":""}

package/dist/server/src/workers/manager.d.ts

@@ -0,0 +1,31 @@
+import type { WorkerInfo } from './types.js';
+export declare class WorkerManager {
+    private readonly logger;
+    private readonly configService;
+    private readonly camerasService;
+    private readonly proxyServer;
+    private workers;
+    private unsubscribeHeartbeat?;
+    private unsubscribeDisconnect?;
+    private timeoutCheckInterval?;
+    constructor();
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getWorkers(): WorkerInfo[];
+    isWorkerOnline(agentId: string): boolean;
+    getAssignment(cameraId: string): string | undefined;
+    isAssignedToWorker(cameraId: string): boolean;
+    restartWorker(agentId: string): Promise<void>;
+    assignCamera(cameraId: string, agentId: string): Promise<void>;
+    unassignCamera(cameraId: string): Promise<void>;
+    startRemoteCamera(cameraId: string): Promise<void>;
+    stopRemoteCamera(cameraId: string): Promise<void>;
+    private createWorkerProxy;
+    private buildRemoteCameraConfig;
+    private handleHeartbeat;
+    private handleGracefulDisconnect;
+    private checkTimeouts;
+    private emitWorkerUpdate;
+    private onWorkerOnline;
+    private onWorkerOffline;
+}