@camera.ui/server 0.0.112 → 0.0.113

package/dist/server/src/workers/capabilities/plugin-host.js

@@ -0,0 +1,160 @@
+import { pathExists, readJson } from 'fs-extra/esm';
+import { dirname, join } from 'node:path';
+import { WorkersService } from '../../api/services/workers.service.js';
+import { extractBundledPlugin } from '../../plugins/bundle.js';
+import { PluginManager } from '../../plugins/index.js';
+import { resolvePluginMain } from '../../plugins/main-file.js';
+import { RuntimeFactory } from '../../plugins/runtime/index.js';
+import { extractPackage, installDependencies } from '../../utils/npm/index.js';
+import { describePlatformRequirement, isPlatformCompatible } from '../../utils/platform.js';
+import { WorkerCapability } from '../types.js';
+const PROVISION_RETRY_MS = 30_000;
+const CRASH_RESTART_MS = 5_000;
+export class PluginHostHandler {
+    configService;
+    logger;
+    forwardLog;
+    capability = WorkerCapability.PluginHost;
+    plugins = new Map();
+    isClosed = false;
+    constructor(configService, logger, forwardLog) {
+        this.configService = configService;
+        this.logger = logger;
+        this.forwardLog = forwardLog;
+    }
+    async start(id, spec) {
+        const existing = this.plugins.get(id);
+        if (existing) {
+            await this.stop(id);
+        }
+        this.logger.log(`Hosting plugin: ${spec.displayName} (${spec.pluginName}@${spec.version})`);
+        const managed = { spec, stopped: false };
+        this.plugins.set(id, managed);
+        void this.provisionAndStart(managed);
+    }
+    async stop(id) {
+        const managed = this.plugins.get(id);
+        if (!managed) {
+            return;
+        }
+        this.logger.log(`Stopping hosted plugin: ${managed.spec.displayName} (${id})`);
+        managed.stopped = true;
+        this.plugins.delete(id);
+        if (managed.retryTimer) {
+            clearTimeout(managed.retryTimer);
+            managed.retryTimer = undefined;
+        }
+        if (managed.runtime) {
+            await managed.runtime.stop();
+            managed.runtime.cleanup();
+            managed.runtime = undefined;
+        }
+    }
+    async stopAll() {
+        this.isClosed = true;
+        const stopPromises = Array.from(this.plugins.keys()).map((id) => this.stop(id));
+        await Promise.allSettled(stopPromises);
+    }
+    getActiveWorkIds() {
+        return Array.from(this.plugins.keys());
+    }
+    getActiveProcessIds() {
+        const pids = [];
+        for (const managed of this.plugins.values()) {
+            const pid = managed.runtime?.getPID();
+            if (pid) {
+                pids.push(pid);
+            }
+        }
+        return pids;
+    }
+    async provisionAndStart(managed) {
+        const { spec } = managed;
+        try {
+            const installPath = await this.ensureInstalled(spec);
+            if (managed.stopped || this.isClosed) {
+                return;
+            }
+            const plugin = await this.buildRuntimePlugin(spec, installPath);
+            const runtime = RuntimeFactory.createRuntime(plugin);
+            runtime.logForwarder = this.forwardLog;
+            runtime.once('exit', () => {
+                if (managed.stopped || this.isClosed) {
+                    return;
+                }
+                this.logger.warn(`Hosted plugin ${spec.displayName} exited — restarting in ${CRASH_RESTART_MS / 1000}s`);
+                this.scheduleRetry(managed, CRASH_RESTART_MS);
+            });
+            managed.runtime = runtime;
+            await runtime.start();
+            this.logger.log(`Hosted plugin started: ${spec.displayName} (${spec.pluginName}@${spec.version})`);
+        }
+        catch (error) {
+            managed.runtime?.cleanup();
+            managed.runtime = undefined;
+            if (managed.stopped || this.isClosed) {
+                return;
+            }
+            this.logger.error(`Failed to provision/start plugin ${spec.pluginName}: ${error.message} — retrying in ${PROVISION_RETRY_MS / 1000}s`);
+            this.scheduleRetry(managed, PROVISION_RETRY_MS);
+        }
+    }
+    scheduleRetry(managed, delayMs) {
+        if (managed.retryTimer) {
+            clearTimeout(managed.retryTimer);
+        }
+        managed.retryTimer = setTimeout(() => {
+            managed.retryTimer = undefined;
+            if (managed.stopped || this.isClosed) {
+                return;
+            }
+            void this.provisionAndStart(managed);
+        }, delayMs);
+    }
+    async ensureInstalled(spec) {
+        const installPath = join(this.configService.PLUGINS_INSTALL_PATH, spec.pluginName);
+        const installed = await readJson(join(installPath, 'package.json')).catch(() => null);
+        if (installed?.version !== spec.version) {
+            this.logger.log(`Installing ${spec.pluginName}@${spec.version} (was: ${installed?.version ?? 'not installed'})`);
+            await extractPackage(`${spec.pluginName}@${spec.version}`, installPath);
+            await installDependencies(installPath, (chunk) => this.logger.debug(chunk.toString().trim()));
+            await extractBundledPlugin(installPath);
+        }
+        return installPath;
+    }
+    async buildRuntimePlugin(spec, installPath) {
+        const pjson = (await readJson(join(installPath, 'package.json')));
+        if (!isPlatformCompatible(pjson.os, pjson.cpu)) {
+            throw new Error(`plugin requires ${describePlatformRequirement(pjson.os, pjson.cpu)}, this worker is ${process.platform}/${process.arch}`);
+        }
+        let main = resolvePluginMain(pjson);
+        let mainPath = join(installPath, dirname(main));
+        const bundlePackageJsonPath = join(installPath, 'bundle', 'package.json');
+        if (await pathExists(bundlePackageJsonPath)) {
+            const bundlePjson = (await readJson(bundlePackageJsonPath));
+            main = resolvePluginMain(bundlePjson);
+            mainPath = join(installPath, 'bundle', dirname(main));
+        }
+        const contractFile = await PluginManager.loadContractFile(installPath);
+        const pythonVersion = contractFile ? PluginManager.normalizeContract(contractFile, spec.pluginName).pythonVersion : undefined;
+        const masterAddress = new WorkersService().getWorkerConnection()?.master;
+        return {
+            id: spec.pluginId,
+            pluginName: spec.pluginName,
+            displayName: spec.displayName,
+            main,
+            mainPath,
+            installPath,
+            isPython: main.endsWith('.py'),
+            isGo: main.endsWith('.go'),
+            info: { installedVersion: pjson.version },
+            contract: { pythonVersion },
+            remoteEnv: {
+                CAMERAUI_MASTER_ADDRESS: masterAddress,
+                CAMERAUI_RTSP_USERNAME: spec.rtspUsername,
+                CAMERAUI_RTSP_PASSWORD: spec.rtspPassword,
+            },
+        };
+    }
+}
+//# sourceMappingURL=plugin-host.js.map

package/dist/server/src/workers/capabilities/plugin-host.js.map

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

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

@@ -3,28 +3,53 @@ export declare class WorkerManager {
     private readonly logger;
     private readonly configService;
     private readonly camerasService;
+    private readonly workersService;
     private readonly proxyServer;
     private workers;
-    private unsubscribeHeartbeat?;
+    private desired;
+    private closeHeartbeatHandler?;
     private unsubscribeDisconnect?;
+    private unsubscribeLogs?;
     private timeoutCheckInterval?;
+    private addressWarned;
+    private workloadRevision;
+    private active;
     constructor();
+    isEnabled(): boolean;
     start(): Promise<void>;
+    enable(reconcileAcceptor?: boolean): Promise<void>;
+    disable(): Promise<void>;
     stop(): Promise<void>;
+    private teardown;
     getWorkers(): WorkerInfo[];
     isWorkerOnline(agentId: string): boolean;
+    isWorkerKnown(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>;
+    noteWorkerPaired(agentId: string, name: string): Promise<void>;
+    assignPlugin(pluginName: string, agentId: string): Promise<void>;
+    unassignPlugin(pluginName: string): Promise<void>;
+    getPluginAssignment(pluginName: string): string | undefined;
+    removeWorker(agentId: string): Promise<void>;
+    desireFrameDecoding(cameraId: string): string | undefined;
+    clearFrameDecoding(cameraId: string): void;
+    desirePluginHost(pluginName: string): string | undefined;
+    clearPluginHost(pluginName: string): void;
+    private clearWorkload;
     private createWorkerProxy;
+    private nudge;
+    private restartFrameWorker;
+    private restartPluginWorker;
     private buildRemoteCameraConfig;
     private handleHeartbeat;
+    private desiredFor;
+    private seedKnownWorkers;
     private handleGracefulDisconnect;
     private checkTimeouts;
+    private handleForwardedLog;
     private emitWorkerUpdate;
     private onWorkerOnline;
     private onWorkerOffline;