@uns-kit/core 2.0.40 → 2.0.42

package/dist/uns/uns-path.js

@@ -1,11 +1,11 @@
-const normalizeSegment = (value) => value.trim().replace(/^\/+|\/+$/g, "");
-export function buildUnsIdentityPath(...segments) {
-    return segments
-        .map((segment) => normalizeSegment(String(segment ?? "")))
-        .filter((segment) => segment.length > 0)
-        .join("/");
-}
-export function buildUnsRoutePath(...segments) {
-    return `/${buildUnsIdentityPath(...segments)}`.replace(/\/{2,}/g, "/");
-}
+const normalizeSegment = (value) => value.trim().replace(/^\/+|\/+$/g, "");
+export function buildUnsIdentityPath(...segments) {
+    return segments
+        .map((segment) => normalizeSegment(String(segment ?? "")))
+        .filter((segment) => segment.length > 0)
+        .join("/");
+}
+export function buildUnsRoutePath(...segments) {
+    return `/${buildUnsIdentityPath(...segments)}`.replace(/\/{2,}/g, "/");
+}
 //# sourceMappingURL=uns-path.js.map

package/dist/uns/uns-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"uns-path.js","sourceRoot":"","sources":["../../src/uns/uns-path.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAE3F,MAAM,UAAU,oBAAoB,CAAC,GAAG,QAAkB;IACxD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;SACzD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAG,QAAkB;IACrD,OAAO,IAAI,oBAAoB,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AACzE,CAAC","sourcesContent":["const normalizeSegment = (value: string): string => value.trim().replace(/^\\/+|\\/+$/g, \"\");\n\nexport function buildUnsIdentityPath(...segments: string[]): string {\n  return segments\n    .map((segment) => normalizeSegment(String(segment ?? \"\")))\n    .filter((segment) => segment.length > 0)\n    .join(\"/\");\n}\n\nexport function buildUnsRoutePath(...segments: string[]): string {\n  return `/${buildUnsIdentityPath(...segments)}`.replace(/\\/{2,}/g, \"/\");\n}\n"]}
+{"version":3,"file":"uns-path.js","sourceRoot":"","sources":["../../src/uns/uns-path.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAE3F,MAAM,UAAU,oBAAoB,CAAC,GAAG,QAAkB;IACxD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;SACzD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAG,QAAkB;IACrD,OAAO,IAAI,oBAAoB,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AACzE,CAAC","sourcesContent":["const normalizeSegment = (value: string): string => value.trim().replace(/^\\/+|\\/+$/g, \"\");\r\n\r\nexport function buildUnsIdentityPath(...segments: string[]): string {\r\n  return segments\r\n    .map((segment) => normalizeSegment(String(segment ?? \"\")))\r\n    .filter((segment) => segment.length > 0)\r\n    .join(\"/\");\r\n}\r\n\r\nexport function buildUnsRoutePath(...segments: string[]): string {\r\n  return `/${buildUnsIdentityPath(...segments)}`.replace(/\\/{2,}/g, \"/\");\r\n}\r\n"]}

package/dist/uns/uns-proxy-process.d.ts

@@ -1,5 +1,6 @@
 import { IUnsParameters, IUnsProcessParameters } from "./uns-interfaces.js";
 import UnsMqttProxy from "../uns-mqtt/uns-mqtt-proxy.js";
+import { type UnsServiceMetadata, type UnsServiceMetadataInput } from "./service-metadata.js";
 /**
  * UnsProxyProcess is responsible for managing the process lifecycle,
  * configuring MQTT (subscriptions and publishing for status updates), and
@@ -26,6 +27,7 @@ declare class UnsProxyProcess {
     private processMqttProxy;
     private handoverManager;
     private statusMonitor;
+    private serviceMetadataTopic;
     static pluginApiVersion: number;
     private static registered;
     private static registeredMethodNames;
@@ -45,6 +47,14 @@ declare class UnsProxyProcess {
      */
     createUnsMqttProxy(mqttHost: string, instanceName: string, instanceMode: string, handover: boolean, unsParameters?: IUnsParameters): Promise<UnsMqttProxy>;
     waitForProcessConnection(): Promise<void>;
+    /**
+     * Publishes retained product/system service metadata for controller discovery.
+     *
+     * The payload is intentionally separate from the volatile active/alive status
+     * topics. Controllers can combine this retained identity/capability metadata
+     * with live process status to decide whether a service is currently healthy.
+     */
+    publishServiceMetadata(metadata: UnsServiceMetadataInput): Promise<UnsServiceMetadata>;
     /**
      * Shuts down the process by clearing intervals, timeouts, and removing
      * MQTT event listeners, and stopping the StatusMonitor.
@@ -54,5 +64,6 @@ declare class UnsProxyProcess {
 interface UnsProxyProcess {
 }
 export default UnsProxyProcess;
+export type { UnsServiceMetadata, UnsServiceMetadataInput };
 export { UnsProxyProcess };
 //# sourceMappingURL=uns-proxy-process.d.ts.map

package/dist/uns/uns-proxy-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uns-proxy-process.d.ts","sourceRoot":"","sources":["../../src/uns/uns-proxy-process.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,cAAc,EAAE,qBAAqB,EAAa,MAAM,qBAAqB,CAAC;AAGpG,OAAO,YAAY,MAAM,+BAA+B,CAAC;AAUzD;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAEjG,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;AAEvF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACpD,eAAe,EAAE,OAAO,eAAe,CAAC;CACzC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,CAAC;AAE5E,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,kBAAkB,CAAY;IACtC,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAgB;IAGrC,MAAM,CAAC,gBAAgB,SAAK;IAC5B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAoC;IAC7D,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAqB;IACzD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAS;IAE/B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB;IAOxC,OAAO,CAAC,MAAM,CAAC,WAAW;IA0B1B,OAAO,CAAC,MAAM,CAAC,QAAQ;IAOvB,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,QAAQ,EAAE,MAAM,EAAE,yBAAyB,EAAE,qBAAqB;IAsE9E;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACU,kBAAkB,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAuC7C,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtD;;;OAGG;IACI,QAAQ,IAAI,IAAI;CAuBxB;AAED,UAAU,eAAe;CAAG;AAE5B,eAAe,eAAe,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"uns-proxy-process.d.ts","sourceRoot":"","sources":["../../src/uns/uns-proxy-process.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,cAAc,EAAE,qBAAqB,EAAa,MAAM,qBAAqB,CAAC;AAGpG,OAAO,YAAY,MAAM,+BAA+B,CAAC;AAQzD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAG/B;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAEjG,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;AAEvF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACpD,eAAe,EAAE,OAAO,eAAe,CAAC;CACzC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,CAAC;AAE5E,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,kBAAkB,CAAY;IACtC,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,oBAAoB,CAAS;IAGrC,MAAM,CAAC,gBAAgB,SAAK;IAC5B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAoC;IAC7D,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAqB;IACzD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAS;IAE/B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB;IAOxC,OAAO,CAAC,MAAM,CAAC,WAAW;IA0B1B,OAAO,CAAC,MAAM,CAAC,QAAQ;IAOvB,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,QAAQ,EAAE,MAAM,EAAE,yBAAyB,EAAE,qBAAqB;IAwE9E;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACU,kBAAkB,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAuC7C,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtD;;;;;;OAMG;IACU,sBAAsB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAenG;;;OAGG;IACI,QAAQ,IAAI,IAAI;CAuBxB;AAED,UAAU,eAAe;CAAG;AAE5B,eAAe,eAAe,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/uns/uns-proxy-process.js

@@ -1,204 +1,225 @@
-import logger from "../logger.js";
-import { randomBytes } from "crypto";
-import MqttProxy from "../uns-mqtt/mqtt-proxy.js";
-import UnsMqttProxy from "../uns-mqtt/uns-mqtt-proxy.js";
-import { HandoverManager } from "./handover-manager.js";
-// Import configuration and initialization modules.
-import { PACKAGE_INFO, MQTT_UPDATE_INTERVAL } from "./process-config.js";
-import { MqttTopicBuilder } from "../uns-mqtt/mqtt-topic-builder.js";
-import { StatusMonitor } from "./status-monitor.js";
-import { UnsPacket } from "./uns-packet.js";
-class UnsProxyProcess {
-    active = false;
-    processStatusTopic;
-    processName;
-    processId;
-    unsMqttProxies;
-    unsApiProxies;
-    unsTemporalProxies;
-    processMqttProxy;
-    handoverManager;
-    statusMonitor;
-    // Plugin
-    static pluginApiVersion = 1;
-    static registered = new Set();
-    static registeredMethodNames = new Set();
-    static applied = false;
-    static use(plugin) {
-        if (this.registered.has(plugin))
-            return this;
-        this.registered.add(plugin);
-        if (this.applied)
-            this.applyPlugin(plugin);
-        return this;
-    }
-    static applyPlugin(plugin) {
-        const define = (methods) => {
-            for (const [name, fn] of Object.entries(methods)) {
-                if (typeof fn !== "function") {
-                    throw new TypeError(`UnsProxyProcess plugin attempted to register non-function member \"${name}\".`);
-                }
-                if (this.registeredMethodNames.has(name) || Reflect.has(this.prototype, name)) {
-                    throw new Error(`UnsProxyProcess plugin attempted to overwrite existing member \"${name}\".`);
-                }
-                Object.defineProperty(this.prototype, name, {
-                    value: fn,
-                    writable: true,
-                    configurable: true,
-                    enumerable: false,
-                });
-                this.registeredMethodNames.add(name);
-            }
-        };
-        plugin({
-            define,
-            version: this.pluginApiVersion,
-            UnsProxyProcess: this,
-        });
-    }
-    static applyAll() {
-        if (this.applied)
-            return;
-        this.applied = true;
-        for (const p of this.registered)
-            this.applyPlugin(p);
-    }
-    // References for cleanup.
-    mqttInputHandler;
-    constructor(mqttHost, unsProxyProcessParameters) {
-        this.constructor.applyAll(); // Activate all the plugins
-        this.unsMqttProxies = [];
-        this.unsApiProxies = [];
-        this.unsTemporalProxies = [];
-        if (!unsProxyProcessParameters?.processName) {
-            throw new Error("UnsProxyProcess requires a processName in configuration.");
-        }
-        this.processName = unsProxyProcessParameters.processName;
-        this.processId = randomBytes(16).toString("hex");
-        const { name: packageName, version } = PACKAGE_INFO;
-        // Instantiate the topic builder.
-        const topicBuilder = new MqttTopicBuilder(`uns-infra/${MqttTopicBuilder.sanitizeTopicPart(packageName)}/${MqttTopicBuilder.sanitizeTopicPart(version)}/${MqttTopicBuilder.sanitizeTopicPart(this.processName)}/`);
-        // Generate topics.
-        const processStatusTopic = topicBuilder.getProcessStatusTopic();
-        const handoverTopic = topicBuilder.getHandoverTopic();
-        const wildcardActiveTopic = topicBuilder.getWildcardActiveTopic();
-        this.processStatusTopic = processStatusTopic;
-        // Configure MQTT topics for subscription.
-        const mqttSubToTopics = unsProxyProcessParameters?.mqttSubToTopics ?? [
-            wildcardActiveTopic,
-            handoverTopic,
-        ];
-        const mqttParameters = {
-            mqttSubToTopics,
-            username: unsProxyProcessParameters?.username ?? "",
-            password: unsProxyProcessParameters?.password ?? "",
-            mqttSSL: unsProxyProcessParameters?.mqttSSL ?? false,
-            statusTopic: this.processStatusTopic,
-            clientId: unsProxyProcessParameters?.clientId ?? `${this.processName}-${this.processId}`,
-            hosts: unsProxyProcessParameters?.hosts,
-            servers: unsProxyProcessParameters?.servers,
-            port: unsProxyProcessParameters?.port,
-            protocol: unsProxyProcessParameters?.protocol,
-            keepalive: unsProxyProcessParameters?.keepalive,
-            clean: unsProxyProcessParameters?.clean,
-            connectTimeout: unsProxyProcessParameters?.connectTimeout,
-            reconnectPeriod: unsProxyProcessParameters?.reconnectPeriod,
-            reconnectOnConnackError: unsProxyProcessParameters?.reconnectOnConnackError,
-            resubscribe: unsProxyProcessParameters?.resubscribe,
-            queueQoSZero: unsProxyProcessParameters?.queueQoSZero,
-            rejectUnauthorized: unsProxyProcessParameters?.rejectUnauthorized ?? false,
-            properties: unsProxyProcessParameters?.properties,
-            ca: unsProxyProcessParameters?.ca,
-            cert: unsProxyProcessParameters?.cert,
-            key: unsProxyProcessParameters?.key,
-            servername: unsProxyProcessParameters?.servername,
-        };
-        // Initialize MQTT proxy and start connection.
-        this.processMqttProxy = new MqttProxy(mqttHost, this.processName, mqttParameters);
-        this.processMqttProxy.start();
-        // Instantiate and start the StatusMonitor for memory and status updates.
-        this.statusMonitor = new StatusMonitor(this.processMqttProxy, this.processStatusTopic, () => this.active, MQTT_UPDATE_INTERVAL, MQTT_UPDATE_INTERVAL, { processName: this.processName, processId: this.processId });
-        this.statusMonitor.start();
-    }
-    /**
-     * Initializes the HandoverManager instance and sets up event listeners for handover and MQTT input events.
-     * Determines handover and force start modes based on process arguments.
-     */
-    initHandoverManager(instanceMode, handover) {
-        const handoverRequestEnabled = instanceMode == "handover" ? true : false;
-        const forceStartEnabled = instanceMode == "force" ? true : false;
-        this.handoverManager = new HandoverManager(this.processName, this.processId, this.processMqttProxy, this.unsMqttProxies, handoverRequestEnabled, handover ?? true, forceStartEnabled);
-        // Listen for handover events.
-        this.handoverManager.event.on("handoverManager", (event) => {
-            this.active = event.active;
-        });
-        // Delegate MQTT events to the HandoverManager.
-        this.mqttInputHandler = async (event) => {
-            await this.handoverManager.handleMqttMessage(event);
-        };
-        this.processMqttProxy.event.on("input", this.mqttInputHandler);
-    }
-    /**
-     * Creates a new UNS proxy instance and stores it for future management.
-     */
-    async createUnsMqttProxy(mqttHost, instanceName, instanceMode, handover, unsParameters) {
-        // Wait until the MQTT connection is established before proceeding.
-        await this.waitForProcessConnection();
-        // Currently handover manager can handle only mqtt events
-        if (!this.handoverManager) {
-            this.initHandoverManager(instanceMode, handover);
-        }
-        const resolvedUnsParameters = {
-            ...(unsParameters ?? {}),
-            clientId: unsParameters?.clientId ?? `${this.processName}-${instanceName}-${this.processId}`,
-        };
-        const unsMqttProxy = new UnsMqttProxy(mqttHost, this.processName, instanceName, resolvedUnsParameters);
-        // Listen for UNS proxy producing topics and publish them via MQTT.
-        unsMqttProxy.event.on("unsProxyProducedTopics", (event) => {
-            this.processMqttProxy.publish(event.statusTopic, JSON.stringify(event.producedTopics));
-        });
-        // Listen for UNS proxy status events and publish them via MQTT.
-        unsMqttProxy.event.on("mqttProxyStatus", (event) => {
-            const time = UnsPacket.formatToISO8601(new Date());
-            const unsMessage = { data: { time, value: event.value, uom: event.uom } };
-            UnsPacket.unsPacketFromUnsMessage(unsMessage).then((packet) => {
-                this.processMqttProxy.publish(event.statusTopic, JSON.stringify(packet));
-            });
-        });
-        this.unsMqttProxies.push(unsMqttProxy);
-        return unsMqttProxy;
-    }
-    async waitForProcessConnection() {
-        while (!this.processMqttProxy?.isConnected) {
-            await new Promise((resolve) => setTimeout(resolve, 100));
-        }
-    }
-    /**
-     * Shuts down the process by clearing intervals, timeouts, and removing
-     * MQTT event listeners, and stopping the StatusMonitor.
-     */
-    shutdown() {
-        logger.info(`${this.processName} - Shutting down UnsProxyProcess...`);
-        try {
-            this.statusMonitor.stop();
-        }
-        catch (e) {
-            logger.error(`${this.processName} - Error stopping StatusMonitor: ${e.message}`);
-        }
-        if (this.mqttInputHandler) {
-            this.processMqttProxy.event.off("input", this.mqttInputHandler);
-        }
-        try {
-            if (typeof this.processMqttProxy.stop === "function") {
-                this.processMqttProxy.stop();
-            }
-        }
-        catch (e) {
-            logger.error(`${this.processName} - Error stopping MQTT proxy: ${e.message}`);
-        }
-        logger.info(`${this.processName} - Shutdown complete.`);
-    }
-}
-export default UnsProxyProcess;
-export { UnsProxyProcess };
+import logger from "../logger.js";
+import { randomBytes } from "crypto";
+import MqttProxy from "../uns-mqtt/mqtt-proxy.js";
+import UnsMqttProxy from "../uns-mqtt/uns-mqtt-proxy.js";
+import { HandoverManager } from "./handover-manager.js";
+// Import configuration and initialization modules.
+import { PACKAGE_INFO, MQTT_UPDATE_INTERVAL } from "./process-config.js";
+import { MqttTopicBuilder } from "../uns-mqtt/mqtt-topic-builder.js";
+import { StatusMonitor } from "./status-monitor.js";
+import { UnsPacket } from "./uns-packet.js";
+import { buildUnsServiceMetadata, } from "./service-metadata.js";
+class UnsProxyProcess {
+    active = false;
+    processStatusTopic;
+    processName;
+    processId;
+    unsMqttProxies;
+    unsApiProxies;
+    unsTemporalProxies;
+    processMqttProxy;
+    handoverManager;
+    statusMonitor;
+    serviceMetadataTopic;
+    // Plugin
+    static pluginApiVersion = 1;
+    static registered = new Set();
+    static registeredMethodNames = new Set();
+    static applied = false;
+    static use(plugin) {
+        if (this.registered.has(plugin))
+            return this;
+        this.registered.add(plugin);
+        if (this.applied)
+            this.applyPlugin(plugin);
+        return this;
+    }
+    static applyPlugin(plugin) {
+        const define = (methods) => {
+            for (const [name, fn] of Object.entries(methods)) {
+                if (typeof fn !== "function") {
+                    throw new TypeError(`UnsProxyProcess plugin attempted to register non-function member \"${name}\".`);
+                }
+                if (this.registeredMethodNames.has(name) || Reflect.has(this.prototype, name)) {
+                    throw new Error(`UnsProxyProcess plugin attempted to overwrite existing member \"${name}\".`);
+                }
+                Object.defineProperty(this.prototype, name, {
+                    value: fn,
+                    writable: true,
+                    configurable: true,
+                    enumerable: false,
+                });
+                this.registeredMethodNames.add(name);
+            }
+        };
+        plugin({
+            define,
+            version: this.pluginApiVersion,
+            UnsProxyProcess: this,
+        });
+    }
+    static applyAll() {
+        if (this.applied)
+            return;
+        this.applied = true;
+        for (const p of this.registered)
+            this.applyPlugin(p);
+    }
+    // References for cleanup.
+    mqttInputHandler;
+    constructor(mqttHost, unsProxyProcessParameters) {
+        this.constructor.applyAll(); // Activate all the plugins
+        this.unsMqttProxies = [];
+        this.unsApiProxies = [];
+        this.unsTemporalProxies = [];
+        if (!unsProxyProcessParameters?.processName) {
+            throw new Error("UnsProxyProcess requires a processName in configuration.");
+        }
+        this.processName = unsProxyProcessParameters.processName;
+        this.processId = randomBytes(16).toString("hex");
+        const { name: packageName, version } = PACKAGE_INFO;
+        // Instantiate the topic builder.
+        const topicBuilder = new MqttTopicBuilder(`uns-infra/${MqttTopicBuilder.sanitizeTopicPart(packageName)}/${MqttTopicBuilder.sanitizeTopicPart(version)}/${MqttTopicBuilder.sanitizeTopicPart(this.processName)}/`);
+        // Generate topics.
+        const processStatusTopic = topicBuilder.getProcessStatusTopic();
+        const handoverTopic = topicBuilder.getHandoverTopic();
+        const wildcardActiveTopic = topicBuilder.getWildcardActiveTopic();
+        const serviceMetadataTopic = topicBuilder.getServiceMetadataTopic();
+        this.processStatusTopic = processStatusTopic;
+        this.serviceMetadataTopic = serviceMetadataTopic;
+        // Configure MQTT topics for subscription.
+        const mqttSubToTopics = unsProxyProcessParameters?.mqttSubToTopics ?? [
+            wildcardActiveTopic,
+            handoverTopic,
+        ];
+        const mqttParameters = {
+            mqttSubToTopics,
+            username: unsProxyProcessParameters?.username ?? "",
+            password: unsProxyProcessParameters?.password ?? "",
+            mqttSSL: unsProxyProcessParameters?.mqttSSL ?? false,
+            statusTopic: this.processStatusTopic,
+            clientId: unsProxyProcessParameters?.clientId ?? `${this.processName}-${this.processId}`,
+            hosts: unsProxyProcessParameters?.hosts,
+            servers: unsProxyProcessParameters?.servers,
+            port: unsProxyProcessParameters?.port,
+            protocol: unsProxyProcessParameters?.protocol,
+            keepalive: unsProxyProcessParameters?.keepalive,
+            clean: unsProxyProcessParameters?.clean,
+            connectTimeout: unsProxyProcessParameters?.connectTimeout,
+            reconnectPeriod: unsProxyProcessParameters?.reconnectPeriod,
+            reconnectOnConnackError: unsProxyProcessParameters?.reconnectOnConnackError,
+            resubscribe: unsProxyProcessParameters?.resubscribe,
+            queueQoSZero: unsProxyProcessParameters?.queueQoSZero,
+            rejectUnauthorized: unsProxyProcessParameters?.rejectUnauthorized ?? false,
+            properties: unsProxyProcessParameters?.properties,
+            ca: unsProxyProcessParameters?.ca,
+            cert: unsProxyProcessParameters?.cert,
+            key: unsProxyProcessParameters?.key,
+            servername: unsProxyProcessParameters?.servername,
+        };
+        // Initialize MQTT proxy and start connection.
+        this.processMqttProxy = new MqttProxy(mqttHost, this.processName, mqttParameters);
+        this.processMqttProxy.start();
+        // Instantiate and start the StatusMonitor for memory and status updates.
+        this.statusMonitor = new StatusMonitor(this.processMqttProxy, this.processStatusTopic, () => this.active, MQTT_UPDATE_INTERVAL, MQTT_UPDATE_INTERVAL, { processName: this.processName, processId: this.processId });
+        this.statusMonitor.start();
+    }
+    /**
+     * Initializes the HandoverManager instance and sets up event listeners for handover and MQTT input events.
+     * Determines handover and force start modes based on process arguments.
+     */
+    initHandoverManager(instanceMode, handover) {
+        const handoverRequestEnabled = instanceMode == "handover" ? true : false;
+        const forceStartEnabled = instanceMode == "force" ? true : false;
+        this.handoverManager = new HandoverManager(this.processName, this.processId, this.processMqttProxy, this.unsMqttProxies, handoverRequestEnabled, handover ?? true, forceStartEnabled);
+        // Listen for handover events.
+        this.handoverManager.event.on("handoverManager", (event) => {
+            this.active = event.active;
+        });
+        // Delegate MQTT events to the HandoverManager.
+        this.mqttInputHandler = async (event) => {
+            await this.handoverManager.handleMqttMessage(event);
+        };
+        this.processMqttProxy.event.on("input", this.mqttInputHandler);
+    }
+    /**
+     * Creates a new UNS proxy instance and stores it for future management.
+     */
+    async createUnsMqttProxy(mqttHost, instanceName, instanceMode, handover, unsParameters) {
+        // Wait until the MQTT connection is established before proceeding.
+        await this.waitForProcessConnection();
+        // Currently handover manager can handle only mqtt events
+        if (!this.handoverManager) {
+            this.initHandoverManager(instanceMode, handover);
+        }
+        const resolvedUnsParameters = {
+            ...(unsParameters ?? {}),
+            clientId: unsParameters?.clientId ?? `${this.processName}-${instanceName}-${this.processId}`,
+        };
+        const unsMqttProxy = new UnsMqttProxy(mqttHost, this.processName, instanceName, resolvedUnsParameters);
+        // Listen for UNS proxy producing topics and publish them via MQTT.
+        unsMqttProxy.event.on("unsProxyProducedTopics", (event) => {
+            this.processMqttProxy.publish(event.statusTopic, JSON.stringify(event.producedTopics));
+        });
+        // Listen for UNS proxy status events and publish them via MQTT.
+        unsMqttProxy.event.on("mqttProxyStatus", (event) => {
+            const time = UnsPacket.formatToISO8601(new Date());
+            const unsMessage = { data: { time, value: event.value, uom: event.uom } };
+            UnsPacket.unsPacketFromUnsMessage(unsMessage).then((packet) => {
+                this.processMqttProxy.publish(event.statusTopic, JSON.stringify(packet));
+            });
+        });
+        this.unsMqttProxies.push(unsMqttProxy);
+        return unsMqttProxy;
+    }
+    async waitForProcessConnection() {
+        while (!this.processMqttProxy?.isConnected) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+    }
+    /**
+     * Publishes retained product/system service metadata for controller discovery.
+     *
+     * The payload is intentionally separate from the volatile active/alive status
+     * topics. Controllers can combine this retained identity/capability metadata
+     * with live process status to decide whether a service is currently healthy.
+     */
+    async publishServiceMetadata(metadata) {
+        await this.waitForProcessConnection();
+        const resolved = buildUnsServiceMetadata({
+            processName: this.processName,
+            processId: this.processId,
+            metadata,
+        });
+        await this.processMqttProxy.publish(this.serviceMetadataTopic, JSON.stringify(resolved), { retain: true });
+        return resolved;
+    }
+    /**
+     * Shuts down the process by clearing intervals, timeouts, and removing
+     * MQTT event listeners, and stopping the StatusMonitor.
+     */
+    shutdown() {
+        logger.info(`${this.processName} - Shutting down UnsProxyProcess...`);
+        try {
+            this.statusMonitor.stop();
+        }
+        catch (e) {
+            logger.error(`${this.processName} - Error stopping StatusMonitor: ${e.message}`);
+        }
+        if (this.mqttInputHandler) {
+            this.processMqttProxy.event.off("input", this.mqttInputHandler);
+        }
+        try {
+            if (typeof this.processMqttProxy.stop === "function") {
+                this.processMqttProxy.stop();
+            }
+        }
+        catch (e) {
+            logger.error(`${this.processName} - Error stopping MQTT proxy: ${e.message}`);
+        }
+        logger.info(`${this.processName} - Shutdown complete.`);
+    }
+}
+export default UnsProxyProcess;
+export { UnsProxyProcess };
 //# sourceMappingURL=uns-proxy-process.js.map

package/dist/uns/uns-proxy-process.js.map

@@ -1 +1 @@
-{"version":3,"file":"uns-proxy-process.js","sourceRoot":"","sources":["../../src/uns/uns-proxy-process.ts"],"names":[],"mappings":"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","sourcesContent":["import logger from \"../logger.js\";\nimport { randomBytes } from \"crypto\";\nimport { IUnsMessage, IUnsParameters, IUnsProcessParameters, UnsEvents } from \"./uns-interfaces.js\";\nimport { IMqttParameters } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport MqttProxy from \"../uns-mqtt/mqtt-proxy.js\";\nimport UnsMqttProxy from \"../uns-mqtt/uns-mqtt-proxy.js\";\nimport { HandoverManager } from \"./handover-manager.js\";\n\n// Import configuration and initialization modules.\nimport { PACKAGE_INFO, MQTT_UPDATE_INTERVAL } from \"./process-config.js\";\nimport { MqttTopicBuilder } from \"../uns-mqtt/mqtt-topic-builder.js\";\nimport { StatusMonitor } from \"./status-monitor.js\";\nimport { UnsPacket } from \"./uns-packet.js\";\n\n\n/**\n * UnsProxyProcess is responsible for managing the process lifecycle,\n * configuring MQTT (subscriptions and publishing for status updates), and\n * handling UNS proxy instances.\n *\n * It leverages HandoverManager for handover events and StatusMonitor for health reporting.\n */\nexport type UnsProxyProcessPluginMethod = (this: UnsProxyProcess, ...args: unknown[]) => unknown;\n\nexport type UnsProxyProcessPluginMethods = Record<string, UnsProxyProcessPluginMethod>;\n\nexport interface UnsProxyProcessPluginApi {\n  version: number;\n  define(methods: UnsProxyProcessPluginMethods): void;\n  UnsProxyProcess: typeof UnsProxyProcess;\n}\n\nexport type UnsProxyProcessPlugin = (api: UnsProxyProcessPluginApi) => void;\n\nclass UnsProxyProcess {\n  private active: boolean = false;\n  private processStatusTopic: string;\n  private processName: string;\n  private processId: string;\n  private unsMqttProxies: UnsMqttProxy[];\n  private unsApiProxies: unknown[];\n  private unsTemporalProxies: unknown[];\n  private processMqttProxy: MqttProxy;\n  private handoverManager: HandoverManager;\n  private statusMonitor: StatusMonitor;\n\n  // Plugin\n  static pluginApiVersion = 1;\n  private static registered = new Set<UnsProxyProcessPlugin>();\n  private static registeredMethodNames = new Set<string>();\n  private static applied = false;\n\n  static use(plugin: UnsProxyProcessPlugin) {\n    if (this.registered.has(plugin)) return this;\n    this.registered.add(plugin);\n    if (this.applied) this.applyPlugin(plugin);\n    return this;\n  }\n\n  private static applyPlugin(plugin: UnsProxyProcessPlugin) {\n    const define: UnsProxyProcessPluginApi[\"define\"] = (methods) => {\n      for (const [name, fn] of Object.entries(methods)) {\n        if (typeof fn !== \"function\") {\n          throw new TypeError(`UnsProxyProcess plugin attempted to register non-function member \\\"${name}\\\".`);\n        }\n        if (this.registeredMethodNames.has(name) || Reflect.has(this.prototype, name)) {\n          throw new Error(`UnsProxyProcess plugin attempted to overwrite existing member \\\"${name}\\\".`);\n        }\n        Object.defineProperty(this.prototype, name, {\n          value: fn,\n          writable: true,\n          configurable: true,\n          enumerable: false,\n        });\n        this.registeredMethodNames.add(name);\n      }\n    };\n\n    plugin({\n      define,\n      version: this.pluginApiVersion,\n      UnsProxyProcess: this,\n    });\n  }\n\n  private static applyAll() {\n    if (this.applied) return;\n    this.applied = true;\n    for (const p of this.registered) this.applyPlugin(p);\n  }\n\n  // References for cleanup.\n  private mqttInputHandler: (event: any) => void;\n\n  constructor(mqttHost: string, unsProxyProcessParameters: IUnsProcessParameters) {\n    (this.constructor as typeof UnsProxyProcess).applyAll(); // Activate all the plugins\n\n    this.unsMqttProxies = [];\n    this.unsApiProxies = [];\n    this.unsTemporalProxies = [];\n    if (!unsProxyProcessParameters?.processName) {\n      throw new Error(\"UnsProxyProcess requires a processName in configuration.\");\n    }\n    this.processName = unsProxyProcessParameters.processName;\n    this.processId = randomBytes(16).toString(\"hex\");\n    const { name: packageName, version } = PACKAGE_INFO;\n\n    // Instantiate the topic builder.\n    const topicBuilder = new MqttTopicBuilder(`uns-infra/${MqttTopicBuilder.sanitizeTopicPart(packageName)}/${MqttTopicBuilder.sanitizeTopicPart(version)}/${MqttTopicBuilder.sanitizeTopicPart(this.processName)}/`);\n\n    // Generate topics.\n    const processStatusTopic = topicBuilder.getProcessStatusTopic();\n    const handoverTopic = topicBuilder.getHandoverTopic();\n    const wildcardActiveTopic = topicBuilder.getWildcardActiveTopic();\n\n    this.processStatusTopic = processStatusTopic;\n\n    // Configure MQTT topics for subscription.\n    const mqttSubToTopics = unsProxyProcessParameters?.mqttSubToTopics ?? [\n      wildcardActiveTopic,\n      handoverTopic,\n    ];\n    const mqttParameters: IMqttParameters = {\n      mqttSubToTopics,\n      username: unsProxyProcessParameters?.username ?? \"\",\n      password: unsProxyProcessParameters?.password ?? \"\",\n      mqttSSL: unsProxyProcessParameters?.mqttSSL ?? false,\n      statusTopic: this.processStatusTopic,\n      clientId: unsProxyProcessParameters?.clientId ?? `${this.processName}-${this.processId}`,\n      hosts: unsProxyProcessParameters?.hosts,\n      servers: unsProxyProcessParameters?.servers,\n      port: unsProxyProcessParameters?.port,\n      protocol: unsProxyProcessParameters?.protocol,\n      keepalive: unsProxyProcessParameters?.keepalive,\n      clean: unsProxyProcessParameters?.clean,\n      connectTimeout: unsProxyProcessParameters?.connectTimeout,\n      reconnectPeriod: unsProxyProcessParameters?.reconnectPeriod,\n      reconnectOnConnackError: unsProxyProcessParameters?.reconnectOnConnackError,\n      resubscribe: unsProxyProcessParameters?.resubscribe,\n      queueQoSZero: unsProxyProcessParameters?.queueQoSZero,\n      rejectUnauthorized: unsProxyProcessParameters?.rejectUnauthorized ?? false,\n      properties: unsProxyProcessParameters?.properties,\n      ca: unsProxyProcessParameters?.ca,\n      cert: unsProxyProcessParameters?.cert,\n      key: unsProxyProcessParameters?.key,\n      servername: unsProxyProcessParameters?.servername,\n    };\n\n    // Initialize MQTT proxy and start connection.\n    this.processMqttProxy = new MqttProxy(mqttHost, this.processName, mqttParameters);\n    this.processMqttProxy.start();\n\n    // Instantiate and start the StatusMonitor for memory and status updates.\n    this.statusMonitor = new StatusMonitor(\n      this.processMqttProxy,\n      this.processStatusTopic,\n      () => this.active,\n      MQTT_UPDATE_INTERVAL,\n      MQTT_UPDATE_INTERVAL,\n      { processName: this.processName, processId: this.processId },\n    );\n    this.statusMonitor.start();\n  }\n\n  /**\n   * Initializes the HandoverManager instance and sets up event listeners for handover and MQTT input events.\n   * Determines handover and force start modes based on process arguments.\n   */\n  private initHandoverManager(instanceMode: string, handover: boolean) {\n\n    const handoverRequestEnabled = instanceMode == \"handover\" ? true : false;\n    const forceStartEnabled = instanceMode == \"force\" ? true : false;\n\n    this.handoverManager = new HandoverManager(\n      this.processName,\n      this.processId,\n      this.processMqttProxy,\n      this.unsMqttProxies,\n      handoverRequestEnabled,\n      handover ?? true,\n      forceStartEnabled\n    );\n\n    // Listen for handover events.\n    this.handoverManager.event.on(\"handoverManager\", (event) => {\n      this.active = event.active;\n    });\n\n    // Delegate MQTT events to the HandoverManager.\n    this.mqttInputHandler = async (event: UnsEvents[\"input\"]) => {\n      await this.handoverManager.handleMqttMessage(event);\n    };\n    this.processMqttProxy.event.on(\"input\", this.mqttInputHandler);\n  }\n\n  /**\n   * Creates a new UNS proxy instance and stores it for future management.\n   */\n  public async createUnsMqttProxy(\n      mqttHost: string, \n      instanceName: string,\n      instanceMode: string,\n      handover: boolean,\n      unsParameters?: IUnsParameters): Promise<UnsMqttProxy> {\n    // Wait until the MQTT connection is established before proceeding.\n    await this.waitForProcessConnection();\n\n    // Currently handover manager can handle only mqtt events\n    if (!this.handoverManager) {\n      this.initHandoverManager(instanceMode, handover);\n    }\n\n    const resolvedUnsParameters: IUnsParameters = {\n      ...(unsParameters ?? {}),\n      clientId: unsParameters?.clientId ?? `${this.processName}-${instanceName}-${this.processId}`,\n    };\n    const unsMqttProxy = new UnsMqttProxy(mqttHost, this.processName, instanceName, resolvedUnsParameters);\n    \n    // Listen for UNS proxy producing topics and publish them via MQTT.\n    unsMqttProxy.event.on(\"unsProxyProducedTopics\", (event) => {\n      this.processMqttProxy.publish(\n        event.statusTopic,\n        JSON.stringify(event.producedTopics),\n      );\n    });\n\n    // Listen for UNS proxy status events and publish them via MQTT.\n    unsMqttProxy.event.on(\"mqttProxyStatus\", (event) => {\n      const time = UnsPacket.formatToISO8601(new Date());\n      const unsMessage: IUnsMessage = { data: { time, value: event.value, uom: event.uom } };\n      UnsPacket.unsPacketFromUnsMessage(unsMessage).then((packet) => {\n        this.processMqttProxy.publish(\n          event.statusTopic,\n          JSON.stringify(packet),\n        );\n      });\n    });\n\n    this.unsMqttProxies.push(unsMqttProxy);\n    return unsMqttProxy;\n  }\n\n  public async waitForProcessConnection(): Promise<void> {\n    while (!this.processMqttProxy?.isConnected) {\n      await new Promise((resolve) => setTimeout(resolve, 100));\n    }\n  }\n\n  /**\n   * Shuts down the process by clearing intervals, timeouts, and removing\n   * MQTT event listeners, and stopping the StatusMonitor.\n   */\n  public shutdown(): void {\n    logger.info(`${this.processName} - Shutting down UnsProxyProcess...`);\n    try {\n      this.statusMonitor.stop();\n    } catch (e: any) {\n      logger.error(`${this.processName} - Error stopping StatusMonitor: ${e.message}`);\n    }\n    \n    if (this.mqttInputHandler) {\n      this.processMqttProxy.event.off(\"input\", this.mqttInputHandler);\n    }\n    \n    try {\n      if (typeof this.processMqttProxy.stop === \"function\") {\n        this.processMqttProxy.stop();\n      }\n    } catch (e: any) {\n      logger.error(`${this.processName} - Error stopping MQTT proxy: ${e.message}`);\n    }\n    \n    logger.info(`${this.processName} - Shutdown complete.`);\n  }\n  \n}\n\ninterface UnsProxyProcess {}\n\nexport default UnsProxyProcess;\nexport { UnsProxyProcess };\n"]}
+{"version":3,"file":"uns-proxy-process.js","sourceRoot":"","sources":["../../src/uns/uns-proxy-process.ts"],"names":[],"mappings":"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","sourcesContent":["import logger from \"../logger.js\";\r\nimport { randomBytes } from \"crypto\";\r\nimport { IUnsMessage, IUnsParameters, IUnsProcessParameters, UnsEvents } from \"./uns-interfaces.js\";\r\nimport { IMqttParameters } from \"../uns-mqtt/mqtt-interfaces.js\";\r\nimport MqttProxy from \"../uns-mqtt/mqtt-proxy.js\";\r\nimport UnsMqttProxy from \"../uns-mqtt/uns-mqtt-proxy.js\";\r\nimport { HandoverManager } from \"./handover-manager.js\";\r\n\r\n// Import configuration and initialization modules.\r\nimport { PACKAGE_INFO, MQTT_UPDATE_INTERVAL } from \"./process-config.js\";\r\nimport { MqttTopicBuilder } from \"../uns-mqtt/mqtt-topic-builder.js\";\r\nimport { StatusMonitor } from \"./status-monitor.js\";\r\nimport { UnsPacket } from \"./uns-packet.js\";\r\nimport {\r\n  buildUnsServiceMetadata,\r\n  type UnsServiceMetadata,\r\n  type UnsServiceMetadataInput,\r\n} from \"./service-metadata.js\";\r\n\r\n\r\n/**\r\n * UnsProxyProcess is responsible for managing the process lifecycle,\r\n * configuring MQTT (subscriptions and publishing for status updates), and\r\n * handling UNS proxy instances.\r\n *\r\n * It leverages HandoverManager for handover events and StatusMonitor for health reporting.\r\n */\r\nexport type UnsProxyProcessPluginMethod = (this: UnsProxyProcess, ...args: unknown[]) => unknown;\r\n\r\nexport type UnsProxyProcessPluginMethods = Record<string, UnsProxyProcessPluginMethod>;\r\n\r\nexport interface UnsProxyProcessPluginApi {\r\n  version: number;\r\n  define(methods: UnsProxyProcessPluginMethods): void;\r\n  UnsProxyProcess: typeof UnsProxyProcess;\r\n}\r\n\r\nexport type UnsProxyProcessPlugin = (api: UnsProxyProcessPluginApi) => void;\r\n\r\nclass UnsProxyProcess {\r\n  private active: boolean = false;\r\n  private processStatusTopic: string;\r\n  private processName: string;\r\n  private processId: string;\r\n  private unsMqttProxies: UnsMqttProxy[];\r\n  private unsApiProxies: unknown[];\r\n  private unsTemporalProxies: unknown[];\r\n  private processMqttProxy: MqttProxy;\r\n  private handoverManager: HandoverManager;\r\n  private statusMonitor: StatusMonitor;\r\n  private serviceMetadataTopic: string;\r\n\r\n  // Plugin\r\n  static pluginApiVersion = 1;\r\n  private static registered = new Set<UnsProxyProcessPlugin>();\r\n  private static registeredMethodNames = new Set<string>();\r\n  private static applied = false;\r\n\r\n  static use(plugin: UnsProxyProcessPlugin) {\r\n    if (this.registered.has(plugin)) return this;\r\n    this.registered.add(plugin);\r\n    if (this.applied) this.applyPlugin(plugin);\r\n    return this;\r\n  }\r\n\r\n  private static applyPlugin(plugin: UnsProxyProcessPlugin) {\r\n    const define: UnsProxyProcessPluginApi[\"define\"] = (methods) => {\r\n      for (const [name, fn] of Object.entries(methods)) {\r\n        if (typeof fn !== \"function\") {\r\n          throw new TypeError(`UnsProxyProcess plugin attempted to register non-function member \\\"${name}\\\".`);\r\n        }\r\n        if (this.registeredMethodNames.has(name) || Reflect.has(this.prototype, name)) {\r\n          throw new Error(`UnsProxyProcess plugin attempted to overwrite existing member \\\"${name}\\\".`);\r\n        }\r\n        Object.defineProperty(this.prototype, name, {\r\n          value: fn,\r\n          writable: true,\r\n          configurable: true,\r\n          enumerable: false,\r\n        });\r\n        this.registeredMethodNames.add(name);\r\n      }\r\n    };\r\n\r\n    plugin({\r\n      define,\r\n      version: this.pluginApiVersion,\r\n      UnsProxyProcess: this,\r\n    });\r\n  }\r\n\r\n  private static applyAll() {\r\n    if (this.applied) return;\r\n    this.applied = true;\r\n    for (const p of this.registered) this.applyPlugin(p);\r\n  }\r\n\r\n  // References for cleanup.\r\n  private mqttInputHandler: (event: any) => void;\r\n\r\n  constructor(mqttHost: string, unsProxyProcessParameters: IUnsProcessParameters) {\r\n    (this.constructor as typeof UnsProxyProcess).applyAll(); // Activate all the plugins\r\n\r\n    this.unsMqttProxies = [];\r\n    this.unsApiProxies = [];\r\n    this.unsTemporalProxies = [];\r\n    if (!unsProxyProcessParameters?.processName) {\r\n      throw new Error(\"UnsProxyProcess requires a processName in configuration.\");\r\n    }\r\n    this.processName = unsProxyProcessParameters.processName;\r\n    this.processId = randomBytes(16).toString(\"hex\");\r\n    const { name: packageName, version } = PACKAGE_INFO;\r\n\r\n    // Instantiate the topic builder.\r\n    const topicBuilder = new MqttTopicBuilder(`uns-infra/${MqttTopicBuilder.sanitizeTopicPart(packageName)}/${MqttTopicBuilder.sanitizeTopicPart(version)}/${MqttTopicBuilder.sanitizeTopicPart(this.processName)}/`);\r\n\r\n    // Generate topics.\r\n    const processStatusTopic = topicBuilder.getProcessStatusTopic();\r\n    const handoverTopic = topicBuilder.getHandoverTopic();\r\n    const wildcardActiveTopic = topicBuilder.getWildcardActiveTopic();\r\n    const serviceMetadataTopic = topicBuilder.getServiceMetadataTopic();\r\n\r\n    this.processStatusTopic = processStatusTopic;\r\n    this.serviceMetadataTopic = serviceMetadataTopic;\r\n\r\n    // Configure MQTT topics for subscription.\r\n    const mqttSubToTopics = unsProxyProcessParameters?.mqttSubToTopics ?? [\r\n      wildcardActiveTopic,\r\n      handoverTopic,\r\n    ];\r\n    const mqttParameters: IMqttParameters = {\r\n      mqttSubToTopics,\r\n      username: unsProxyProcessParameters?.username ?? \"\",\r\n      password: unsProxyProcessParameters?.password ?? \"\",\r\n      mqttSSL: unsProxyProcessParameters?.mqttSSL ?? false,\r\n      statusTopic: this.processStatusTopic,\r\n      clientId: unsProxyProcessParameters?.clientId ?? `${this.processName}-${this.processId}`,\r\n      hosts: unsProxyProcessParameters?.hosts,\r\n      servers: unsProxyProcessParameters?.servers,\r\n      port: unsProxyProcessParameters?.port,\r\n      protocol: unsProxyProcessParameters?.protocol,\r\n      keepalive: unsProxyProcessParameters?.keepalive,\r\n      clean: unsProxyProcessParameters?.clean,\r\n      connectTimeout: unsProxyProcessParameters?.connectTimeout,\r\n      reconnectPeriod: unsProxyProcessParameters?.reconnectPeriod,\r\n      reconnectOnConnackError: unsProxyProcessParameters?.reconnectOnConnackError,\r\n      resubscribe: unsProxyProcessParameters?.resubscribe,\r\n      queueQoSZero: unsProxyProcessParameters?.queueQoSZero,\r\n      rejectUnauthorized: unsProxyProcessParameters?.rejectUnauthorized ?? false,\r\n      properties: unsProxyProcessParameters?.properties,\r\n      ca: unsProxyProcessParameters?.ca,\r\n      cert: unsProxyProcessParameters?.cert,\r\n      key: unsProxyProcessParameters?.key,\r\n      servername: unsProxyProcessParameters?.servername,\r\n    };\r\n\r\n    // Initialize MQTT proxy and start connection.\r\n    this.processMqttProxy = new MqttProxy(mqttHost, this.processName, mqttParameters);\r\n    this.processMqttProxy.start();\r\n\r\n    // Instantiate and start the StatusMonitor for memory and status updates.\r\n    this.statusMonitor = new StatusMonitor(\r\n      this.processMqttProxy,\r\n      this.processStatusTopic,\r\n      () => this.active,\r\n      MQTT_UPDATE_INTERVAL,\r\n      MQTT_UPDATE_INTERVAL,\r\n      { processName: this.processName, processId: this.processId },\r\n    );\r\n    this.statusMonitor.start();\r\n  }\r\n\r\n  /**\r\n   * Initializes the HandoverManager instance and sets up event listeners for handover and MQTT input events.\r\n   * Determines handover and force start modes based on process arguments.\r\n   */\r\n  private initHandoverManager(instanceMode: string, handover: boolean) {\r\n\r\n    const handoverRequestEnabled = instanceMode == \"handover\" ? true : false;\r\n    const forceStartEnabled = instanceMode == \"force\" ? true : false;\r\n\r\n    this.handoverManager = new HandoverManager(\r\n      this.processName,\r\n      this.processId,\r\n      this.processMqttProxy,\r\n      this.unsMqttProxies,\r\n      handoverRequestEnabled,\r\n      handover ?? true,\r\n      forceStartEnabled\r\n    );\r\n\r\n    // Listen for handover events.\r\n    this.handoverManager.event.on(\"handoverManager\", (event) => {\r\n      this.active = event.active;\r\n    });\r\n\r\n    // Delegate MQTT events to the HandoverManager.\r\n    this.mqttInputHandler = async (event: UnsEvents[\"input\"]) => {\r\n      await this.handoverManager.handleMqttMessage(event);\r\n    };\r\n    this.processMqttProxy.event.on(\"input\", this.mqttInputHandler);\r\n  }\r\n\r\n  /**\r\n   * Creates a new UNS proxy instance and stores it for future management.\r\n   */\r\n  public async createUnsMqttProxy(\r\n      mqttHost: string, \r\n      instanceName: string,\r\n      instanceMode: string,\r\n      handover: boolean,\r\n      unsParameters?: IUnsParameters): Promise<UnsMqttProxy> {\r\n    // Wait until the MQTT connection is established before proceeding.\r\n    await this.waitForProcessConnection();\r\n\r\n    // Currently handover manager can handle only mqtt events\r\n    if (!this.handoverManager) {\r\n      this.initHandoverManager(instanceMode, handover);\r\n    }\r\n\r\n    const resolvedUnsParameters: IUnsParameters = {\r\n      ...(unsParameters ?? {}),\r\n      clientId: unsParameters?.clientId ?? `${this.processName}-${instanceName}-${this.processId}`,\r\n    };\r\n    const unsMqttProxy = new UnsMqttProxy(mqttHost, this.processName, instanceName, resolvedUnsParameters);\r\n    \r\n    // Listen for UNS proxy producing topics and publish them via MQTT.\r\n    unsMqttProxy.event.on(\"unsProxyProducedTopics\", (event) => {\r\n      this.processMqttProxy.publish(\r\n        event.statusTopic,\r\n        JSON.stringify(event.producedTopics),\r\n      );\r\n    });\r\n\r\n    // Listen for UNS proxy status events and publish them via MQTT.\r\n    unsMqttProxy.event.on(\"mqttProxyStatus\", (event) => {\r\n      const time = UnsPacket.formatToISO8601(new Date());\r\n      const unsMessage: IUnsMessage = { data: { time, value: event.value, uom: event.uom } };\r\n      UnsPacket.unsPacketFromUnsMessage(unsMessage).then((packet) => {\r\n        this.processMqttProxy.publish(\r\n          event.statusTopic,\r\n          JSON.stringify(packet),\r\n        );\r\n      });\r\n    });\r\n\r\n    this.unsMqttProxies.push(unsMqttProxy);\r\n    return unsMqttProxy;\r\n  }\r\n\r\n  public async waitForProcessConnection(): Promise<void> {\r\n    while (!this.processMqttProxy?.isConnected) {\r\n      await new Promise((resolve) => setTimeout(resolve, 100));\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Publishes retained product/system service metadata for controller discovery.\r\n   *\r\n   * The payload is intentionally separate from the volatile active/alive status\r\n   * topics. Controllers can combine this retained identity/capability metadata\r\n   * with live process status to decide whether a service is currently healthy.\r\n   */\r\n  public async publishServiceMetadata(metadata: UnsServiceMetadataInput): Promise<UnsServiceMetadata> {\r\n    await this.waitForProcessConnection();\r\n    const resolved = buildUnsServiceMetadata({\r\n      processName: this.processName,\r\n      processId: this.processId,\r\n      metadata,\r\n    });\r\n    await this.processMqttProxy.publish(\r\n      this.serviceMetadataTopic,\r\n      JSON.stringify(resolved),\r\n      { retain: true },\r\n    );\r\n    return resolved;\r\n  }\r\n\r\n  /**\r\n   * Shuts down the process by clearing intervals, timeouts, and removing\r\n   * MQTT event listeners, and stopping the StatusMonitor.\r\n   */\r\n  public shutdown(): void {\r\n    logger.info(`${this.processName} - Shutting down UnsProxyProcess...`);\r\n    try {\r\n      this.statusMonitor.stop();\r\n    } catch (e: any) {\r\n      logger.error(`${this.processName} - Error stopping StatusMonitor: ${e.message}`);\r\n    }\r\n    \r\n    if (this.mqttInputHandler) {\r\n      this.processMqttProxy.event.off(\"input\", this.mqttInputHandler);\r\n    }\r\n    \r\n    try {\r\n      if (typeof this.processMqttProxy.stop === \"function\") {\r\n        this.processMqttProxy.stop();\r\n      }\r\n    } catch (e: any) {\r\n      logger.error(`${this.processName} - Error stopping MQTT proxy: ${e.message}`);\r\n    }\r\n    \r\n    logger.info(`${this.processName} - Shutdown complete.`);\r\n  }\r\n  \r\n}\r\n\r\ninterface UnsProxyProcess {}\r\n\r\nexport default UnsProxyProcess;\r\nexport type { UnsServiceMetadata, UnsServiceMetadataInput };\r\nexport { UnsProxyProcess };\r\n"]}