@uns-kit/core 2.0.40 → 2.0.42

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

@@ -1,52 +1,52 @@
-import { IApiObject, ITopicObject, UnsEvents } from "./uns-interfaces.js";
-import { UnsEventEmitter } from "./uns-event-emitter.js";
-import { UnsAsset } from "./uns-asset.js";
-import { UnsObjectId, UnsObjectType } from "./uns-object.js";
-import { IApiCatchallMapping } from "./uns-interfaces.js";
-export default class UnsProxy {
-    private publishInterval;
-    event: UnsEventEmitter<UnsEvents>;
-    protected instanceStatusTopic: string;
-    protected instanceNameWithSuffix: string;
-    private producedTopics;
-    private producedApiEndpoints;
-    private producedApiCatchall;
-    private readonly controllerNameEnv;
-    private readonly controllerHostEnv;
-    private readonly controllerPortEnv;
-    private readonly controllerPublicBaseEnv;
-    constructor();
-    /**
-     * Publishes the list of produced topics to the MQTT broker.
-     */
-    private emitProducedTopics;
-    /**
-     * Publishes the list of produced API endpoints to the MQTT broker.
-     */
-    private emitProducedApiEndpoints;
-    /**
-     * Publishes the list of catch-all API mappings to the MQTT broker.
-     */
-    private emitProducedApiCatchall;
-    /**
-     * Registers a unique topic and keeps its timestamp current.
-     *
-     * On first call the full entry is created and immediately emitted so the
-     * controller can persist the new schema node.  On subsequent calls only the
-     * timestamp is updated in-place; the 60-second heartbeat interval will carry
-     * the updated value to the controller, making the timestamp reflect the time
-     * of the most recent data publication rather than the one-off registration
-     * moment.
-     *
-     * @param topicObject - The object containing topic details.
-     */
-    protected registerUniqueTopic(topicObject: ITopicObject): void;
-    /**
-     * Registers an API endpoint to handle requests for a specific topic and attribute.
-     */
-    protected registerApiEndpoint(apiObject: IApiObject): void;
-    protected registerApiCatchAll(mapping: IApiCatchallMapping): void;
-    protected unregisterApiEndpoint(topic: string, asset: UnsAsset, objectType: UnsObjectType, objectId: UnsObjectId, attribute: string): void;
-    stop(): Promise<void>;
-}
+import { IApiObject, ITopicObject, UnsEvents } from "./uns-interfaces.js";
+import { UnsEventEmitter } from "./uns-event-emitter.js";
+import { UnsAsset } from "./uns-asset.js";
+import { UnsObjectId, UnsObjectType } from "./uns-object.js";
+import { IApiCatchallMapping } from "./uns-interfaces.js";
+export default class UnsProxy {
+    private publishInterval;
+    event: UnsEventEmitter<UnsEvents>;
+    protected instanceStatusTopic: string;
+    protected instanceNameWithSuffix: string;
+    private producedTopics;
+    private producedApiEndpoints;
+    private producedApiCatchall;
+    private readonly controllerNameEnv;
+    private readonly controllerHostEnv;
+    private readonly controllerPortEnv;
+    private readonly controllerPublicBaseEnv;
+    constructor();
+    /**
+     * Publishes the list of produced topics to the MQTT broker.
+     */
+    private emitProducedTopics;
+    /**
+     * Publishes the list of produced API endpoints to the MQTT broker.
+     */
+    private emitProducedApiEndpoints;
+    /**
+     * Publishes the list of catch-all API mappings to the MQTT broker.
+     */
+    private emitProducedApiCatchall;
+    /**
+     * Registers a unique topic and keeps its timestamp current.
+     *
+     * On first call the full entry is created and immediately emitted so the
+     * controller can persist the new schema node.  On subsequent calls only the
+     * timestamp is updated in-place; the 60-second heartbeat interval will carry
+     * the updated value to the controller, making the timestamp reflect the time
+     * of the most recent data publication rather than the one-off registration
+     * moment.
+     *
+     * @param topicObject - The object containing topic details.
+     */
+    protected registerUniqueTopic(topicObject: ITopicObject): void;
+    /**
+     * Registers an API endpoint to handle requests for a specific topic and attribute.
+     */
+    protected registerApiEndpoint(apiObject: IApiObject): void;
+    protected registerApiCatchAll(mapping: IApiCatchallMapping): void;
+    protected unregisterApiEndpoint(topic: string, asset: UnsAsset, objectType: UnsObjectType, objectId: UnsObjectId, attribute: string): void;
+    stop(): Promise<void>;
+}
 //# sourceMappingURL=uns-proxy.d.ts.map

package/dist/uns/uns-proxy.js

@@ -1,191 +1,191 @@
-import logger from "../logger.js";
-import { UnsEventEmitter } from "./uns-event-emitter.js";
-import { UnsPacket } from "./uns-packet.js";
-import { buildUnsIdentityPath } from "./uns-path.js";
-export default class UnsProxy {
-    publishInterval = null;
-    event = new UnsEventEmitter();
-    instanceStatusTopic;
-    instanceNameWithSuffix; //was prot
-    producedTopics = new Map();
-    producedApiEndpoints = new Map();
-    producedApiCatchall = new Map();
-    controllerNameEnv;
-    controllerHostEnv;
-    controllerPortEnv;
-    controllerPublicBaseEnv;
-    constructor() {
-        this.controllerNameEnv = process.env["UNS_CONTROLLER_NAME"];
-        this.controllerHostEnv = process.env["UNS_CONTROLLER_HOST"];
-        this.controllerPortEnv = process.env["UNS_CONTROLLER_PORT"];
-        this.controllerPublicBaseEnv =
-            process.env["UNS_CONTROLLER_PUBLIC_BASE"] ?? process.env["UNS_PUBLIC_BASE"];
-        // Set up interval to publish produced topics every 60 seconds.
-        this.publishInterval = setInterval(() => {
-            this.emitProducedTopics();
-            this.emitProducedApiEndpoints();
-            this.emitProducedApiCatchall();
-        }, 60000);
-    }
-    /**
-     * Publishes the list of produced topics to the MQTT broker.
-     */
-    async emitProducedTopics() {
-        if (this.instanceStatusTopic !== "") {
-            const topicsArray = [...this.producedTopics.values()];
-            if (topicsArray.length > 0) {
-                try {
-                    this.event.emit("unsProxyProducedTopics", { producedTopics: topicsArray, statusTopic: this.instanceStatusTopic + "topics" });
-                }
-                catch (error) {
-                    logger.error(`${this.instanceNameWithSuffix} - Error publishing produced topics: ${error.message}`);
-                }
-                logger.debug(`${this.instanceNameWithSuffix} - Published produced topics.`);
-            }
-        }
-    }
-    /**
-     * Publishes the list of produced API endpoints to the MQTT broker.
-     */
-    async emitProducedApiEndpoints() {
-        if (this.instanceStatusTopic !== "") {
-            const apiEndpointsArray = [...this.producedApiEndpoints.values()];
-            if (apiEndpointsArray.length > 0) {
-                try {
-                    if (apiEndpointsArray.length > 0) {
-                        this.event.emit("unsProxyProducedApiEndpoints", { producedApiEndpoints: apiEndpointsArray, statusTopic: this.instanceStatusTopic + "api-endpoints" });
-                    }
-                }
-                catch (error) {
-                    logger.error(`${this.instanceNameWithSuffix} - Error publishing produced API endpoints: ${error.message}`);
-                }
-                logger.debug(`${this.instanceNameWithSuffix} - Published produced API endpoints.`);
-            }
-        }
-    }
-    /**
-     * Publishes the list of catch-all API mappings to the MQTT broker.
-     */
-    async emitProducedApiCatchall() {
-        if (this.instanceStatusTopic !== "") {
-            const catchallArray = [...this.producedApiCatchall.values()];
-            if (catchallArray.length > 0) {
-                try {
-                    this.event.emit("unsProxyProducedApiCatchAll", {
-                        producedCatchall: catchallArray,
-                        statusTopic: this.instanceStatusTopic + "api-catchall",
-                    });
-                }
-                catch (error) {
-                    logger.error(`${this.instanceNameWithSuffix} - Error publishing catch-all API mappings: ${error.message}`);
-                }
-                logger.debug(`${this.instanceNameWithSuffix} - Published catch-all API mappings.`);
-            }
-        }
-    }
-    /**
-     * Registers a unique topic and keeps its timestamp current.
-     *
-     * On first call the full entry is created and immediately emitted so the
-     * controller can persist the new schema node.  On subsequent calls only the
-     * timestamp is updated in-place; the 60-second heartbeat interval will carry
-     * the updated value to the controller, making the timestamp reflect the time
-     * of the most recent data publication rather than the one-off registration
-     * moment.
-     *
-     * @param topicObject - The object containing topic details.
-     */
-    registerUniqueTopic(topicObject) {
-        if (this.instanceStatusTopic !== "") {
-            const fullTopic = buildUnsIdentityPath(topicObject.topic, topicObject.asset, topicObject.objectType, topicObject.objectId, topicObject.attribute);
-            if (!this.producedTopics.has(fullTopic)) {
-                this.producedTopics.set(fullTopic, {
-                    timestamp: topicObject.timestamp,
-                    topic: topicObject.topic,
-                    attribute: topicObject.attribute,
-                    attributeType: topicObject.attributeType,
-                    description: topicObject.description,
-                    tags: topicObject.tags,
-                    attributeNeedsPersistence: topicObject.attributeNeedsPersistence ?? true,
-                    dataGroup: topicObject.dataGroup ?? "",
-                    asset: topicObject.asset,
-                    assetDescription: topicObject.assetDescription,
-                    objectType: topicObject.objectType,
-                    objectTypeDescription: topicObject.objectTypeDescription,
-                    objectId: topicObject.objectId,
-                    ...(topicObject.validityMode ? { validityMode: topicObject.validityMode } : {}),
-                    ...(topicObject.expectedIntervalMs ? { expectedIntervalMs: topicObject.expectedIntervalMs } : {}),
-                    ...(topicObject.lifecycleEndValue ? { lifecycleEndValue: topicObject.lifecycleEndValue } : {}),
-                });
-                this.emitProducedTopics();
-                logger.info(`${this.instanceNameWithSuffix} - Registered new topic: ${fullTopic}`);
-            }
-            else {
-                // Already registered — refresh only the timestamp so the periodic
-                // heartbeat reflects actual data flow rather than frozen startup time.
-                this.producedTopics.get(fullTopic).timestamp = topicObject.timestamp;
-            }
-        }
-    }
-    /**
-     * Registers an API endpoint to handle requests for a specific topic and attribute.
-     */
-    registerApiEndpoint(apiObject) {
-        if (this.instanceStatusTopic !== "") {
-            const fullTopic = buildUnsIdentityPath(apiObject.topic, apiObject.asset, apiObject.objectType, apiObject.objectId, apiObject.attribute);
-            if (!this.producedApiEndpoints.has(fullTopic)) {
-                const time = UnsPacket.formatToISO8601(new Date());
-                this.producedApiEndpoints.set(fullTopic, {
-                    timestamp: time,
-                    topic: apiObject.topic,
-                    attribute: apiObject.attribute,
-                    apiHost: apiObject.apiHost,
-                    apiEndpoint: apiObject.apiEndpoint,
-                    apiMethod: apiObject.apiMethod,
-                    apiQueryParams: apiObject.apiQueryParams,
-                    apiDescription: apiObject.apiDescription,
-                    attributeType: apiObject.attributeType,
-                    apiSwaggerEndpoint: apiObject.apiSwaggerEndpoint,
-                    asset: apiObject.asset,
-                    objectType: apiObject.objectType,
-                    objectId: apiObject.objectId,
-                    ...(this.controllerNameEnv ? { controllerName: this.controllerNameEnv } : {}),
-                    ...(this.controllerHostEnv ? { controllerHost: this.controllerHostEnv } : {}),
-                    ...(this.controllerPortEnv ? { controllerPort: this.controllerPortEnv } : {}),
-                    ...(this.controllerPublicBaseEnv ? { controllerPublicBase: this.controllerPublicBaseEnv } : {}),
-                });
-                this.emitProducedApiEndpoints();
-                logger.info(`${this.instanceNameWithSuffix} - Registered new api endpoint: /${fullTopic}`);
-            }
-        }
-    }
-    registerApiCatchAll(mapping) {
-        if (this.instanceStatusTopic !== "") {
-            const key = mapping.topic.replace(/\/+$/, "");
-            if (!this.producedApiCatchall.has(key)) {
-                this.producedApiCatchall.set(key, mapping);
-            }
-            else {
-                this.producedApiCatchall.set(key, { ...this.producedApiCatchall.get(key), ...mapping });
-            }
-            this.emitProducedApiCatchall();
-            logger.info(`${this.instanceNameWithSuffix} - Registered catch-all API mapping: ${key}`);
-        }
-    }
-    unregisterApiEndpoint(topic, asset, objectType, objectId, attribute) {
-        const fullTopic = buildUnsIdentityPath(topic, asset, objectType, objectId, attribute);
-        if (this.producedApiEndpoints.has(fullTopic)) {
-            this.producedApiEndpoints.delete(fullTopic);
-            this.emitProducedApiEndpoints();
-            logger.info(`${this.instanceNameWithSuffix} - Unregistered API endpoint: ${fullTopic}`);
-        }
-    }
-    async stop() {
-        // Clear the publishing interval.
-        if (this.publishInterval) {
-            clearInterval(this.publishInterval);
-            this.publishInterval = null;
-        }
-    }
-}
+import logger from "../logger.js";
+import { UnsEventEmitter } from "./uns-event-emitter.js";
+import { UnsPacket } from "./uns-packet.js";
+import { buildUnsIdentityPath } from "./uns-path.js";
+export default class UnsProxy {
+    publishInterval = null;
+    event = new UnsEventEmitter();
+    instanceStatusTopic;
+    instanceNameWithSuffix; //was prot
+    producedTopics = new Map();
+    producedApiEndpoints = new Map();
+    producedApiCatchall = new Map();
+    controllerNameEnv;
+    controllerHostEnv;
+    controllerPortEnv;
+    controllerPublicBaseEnv;
+    constructor() {
+        this.controllerNameEnv = process.env["UNS_CONTROLLER_NAME"];
+        this.controllerHostEnv = process.env["UNS_CONTROLLER_HOST"];
+        this.controllerPortEnv = process.env["UNS_CONTROLLER_PORT"];
+        this.controllerPublicBaseEnv =
+            process.env["UNS_CONTROLLER_PUBLIC_BASE"] ?? process.env["UNS_PUBLIC_BASE"];
+        // Set up interval to publish produced topics every 60 seconds.
+        this.publishInterval = setInterval(() => {
+            this.emitProducedTopics();
+            this.emitProducedApiEndpoints();
+            this.emitProducedApiCatchall();
+        }, 60000);
+    }
+    /**
+     * Publishes the list of produced topics to the MQTT broker.
+     */
+    async emitProducedTopics() {
+        if (this.instanceStatusTopic !== "") {
+            const topicsArray = [...this.producedTopics.values()];
+            if (topicsArray.length > 0) {
+                try {
+                    this.event.emit("unsProxyProducedTopics", { producedTopics: topicsArray, statusTopic: this.instanceStatusTopic + "topics" });
+                }
+                catch (error) {
+                    logger.error(`${this.instanceNameWithSuffix} - Error publishing produced topics: ${error.message}`);
+                }
+                logger.debug(`${this.instanceNameWithSuffix} - Published produced topics.`);
+            }
+        }
+    }
+    /**
+     * Publishes the list of produced API endpoints to the MQTT broker.
+     */
+    async emitProducedApiEndpoints() {
+        if (this.instanceStatusTopic !== "") {
+            const apiEndpointsArray = [...this.producedApiEndpoints.values()];
+            if (apiEndpointsArray.length > 0) {
+                try {
+                    if (apiEndpointsArray.length > 0) {
+                        this.event.emit("unsProxyProducedApiEndpoints", { producedApiEndpoints: apiEndpointsArray, statusTopic: this.instanceStatusTopic + "api-endpoints" });
+                    }
+                }
+                catch (error) {
+                    logger.error(`${this.instanceNameWithSuffix} - Error publishing produced API endpoints: ${error.message}`);
+                }
+                logger.debug(`${this.instanceNameWithSuffix} - Published produced API endpoints.`);
+            }
+        }
+    }
+    /**
+     * Publishes the list of catch-all API mappings to the MQTT broker.
+     */
+    async emitProducedApiCatchall() {
+        if (this.instanceStatusTopic !== "") {
+            const catchallArray = [...this.producedApiCatchall.values()];
+            if (catchallArray.length > 0) {
+                try {
+                    this.event.emit("unsProxyProducedApiCatchAll", {
+                        producedCatchall: catchallArray,
+                        statusTopic: this.instanceStatusTopic + "api-catchall",
+                    });
+                }
+                catch (error) {
+                    logger.error(`${this.instanceNameWithSuffix} - Error publishing catch-all API mappings: ${error.message}`);
+                }
+                logger.debug(`${this.instanceNameWithSuffix} - Published catch-all API mappings.`);
+            }
+        }
+    }
+    /**
+     * Registers a unique topic and keeps its timestamp current.
+     *
+     * On first call the full entry is created and immediately emitted so the
+     * controller can persist the new schema node.  On subsequent calls only the
+     * timestamp is updated in-place; the 60-second heartbeat interval will carry
+     * the updated value to the controller, making the timestamp reflect the time
+     * of the most recent data publication rather than the one-off registration
+     * moment.
+     *
+     * @param topicObject - The object containing topic details.
+     */
+    registerUniqueTopic(topicObject) {
+        if (this.instanceStatusTopic !== "") {
+            const fullTopic = buildUnsIdentityPath(topicObject.topic, topicObject.asset, topicObject.objectType, topicObject.objectId, topicObject.attribute);
+            if (!this.producedTopics.has(fullTopic)) {
+                this.producedTopics.set(fullTopic, {
+                    timestamp: topicObject.timestamp,
+                    topic: topicObject.topic,
+                    attribute: topicObject.attribute,
+                    attributeType: topicObject.attributeType,
+                    description: topicObject.description,
+                    tags: topicObject.tags,
+                    attributeNeedsPersistence: topicObject.attributeNeedsPersistence ?? true,
+                    dataGroup: topicObject.dataGroup ?? "",
+                    asset: topicObject.asset,
+                    assetDescription: topicObject.assetDescription,
+                    objectType: topicObject.objectType,
+                    objectTypeDescription: topicObject.objectTypeDescription,
+                    objectId: topicObject.objectId,
+                    ...(topicObject.validityMode ? { validityMode: topicObject.validityMode } : {}),
+                    ...(topicObject.expectedIntervalMs ? { expectedIntervalMs: topicObject.expectedIntervalMs } : {}),
+                    ...(topicObject.lifecycleEndValue ? { lifecycleEndValue: topicObject.lifecycleEndValue } : {}),
+                });
+                this.emitProducedTopics();
+                logger.info(`${this.instanceNameWithSuffix} - Registered new topic: ${fullTopic}`);
+            }
+            else {
+                // Already registered — refresh only the timestamp so the periodic
+                // heartbeat reflects actual data flow rather than frozen startup time.
+                this.producedTopics.get(fullTopic).timestamp = topicObject.timestamp;
+            }
+        }
+    }
+    /**
+     * Registers an API endpoint to handle requests for a specific topic and attribute.
+     */
+    registerApiEndpoint(apiObject) {
+        if (this.instanceStatusTopic !== "") {
+            const fullTopic = buildUnsIdentityPath(apiObject.topic, apiObject.asset, apiObject.objectType, apiObject.objectId, apiObject.attribute);
+            if (!this.producedApiEndpoints.has(fullTopic)) {
+                const time = UnsPacket.formatToISO8601(new Date());
+                this.producedApiEndpoints.set(fullTopic, {
+                    timestamp: time,
+                    topic: apiObject.topic,
+                    attribute: apiObject.attribute,
+                    apiHost: apiObject.apiHost,
+                    apiEndpoint: apiObject.apiEndpoint,
+                    apiMethod: apiObject.apiMethod,
+                    apiQueryParams: apiObject.apiQueryParams,
+                    apiDescription: apiObject.apiDescription,
+                    attributeType: apiObject.attributeType,
+                    apiSwaggerEndpoint: apiObject.apiSwaggerEndpoint,
+                    asset: apiObject.asset,
+                    objectType: apiObject.objectType,
+                    objectId: apiObject.objectId,
+                    ...(this.controllerNameEnv ? { controllerName: this.controllerNameEnv } : {}),
+                    ...(this.controllerHostEnv ? { controllerHost: this.controllerHostEnv } : {}),
+                    ...(this.controllerPortEnv ? { controllerPort: this.controllerPortEnv } : {}),
+                    ...(this.controllerPublicBaseEnv ? { controllerPublicBase: this.controllerPublicBaseEnv } : {}),
+                });
+                this.emitProducedApiEndpoints();
+                logger.info(`${this.instanceNameWithSuffix} - Registered new api endpoint: /${fullTopic}`);
+            }
+        }
+    }
+    registerApiCatchAll(mapping) {
+        if (this.instanceStatusTopic !== "") {
+            const key = mapping.topic.replace(/\/+$/, "");
+            if (!this.producedApiCatchall.has(key)) {
+                this.producedApiCatchall.set(key, mapping);
+            }
+            else {
+                this.producedApiCatchall.set(key, { ...this.producedApiCatchall.get(key), ...mapping });
+            }
+            this.emitProducedApiCatchall();
+            logger.info(`${this.instanceNameWithSuffix} - Registered catch-all API mapping: ${key}`);
+        }
+    }
+    unregisterApiEndpoint(topic, asset, objectType, objectId, attribute) {
+        const fullTopic = buildUnsIdentityPath(topic, asset, objectType, objectId, attribute);
+        if (this.producedApiEndpoints.has(fullTopic)) {
+            this.producedApiEndpoints.delete(fullTopic);
+            this.emitProducedApiEndpoints();
+            logger.info(`${this.instanceNameWithSuffix} - Unregistered API endpoint: ${fullTopic}`);
+        }
+    }
+    async stop() {
+        // Clear the publishing interval.
+        if (this.publishInterval) {
+            clearInterval(this.publishInterval);
+            this.publishInterval = null;
+        }
+    }
+}
 //# sourceMappingURL=uns-proxy.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"uns-proxy.js","sourceRoot":"","sources":["../../src/uns/uns-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["import { IApiObject, ITopicObject, UnsEvents } from \"./uns-interfaces.js\";\nimport logger from \"../logger.js\";\nimport { UnsEventEmitter } from \"./uns-event-emitter.js\";\nimport { UnsPacket } from \"./uns-packet.js\";\nimport { UnsAsset } from \"./uns-asset.js\";\nimport { UnsObjectId, UnsObjectType } from \"./uns-object.js\";\nimport { IApiCatchallMapping } from \"./uns-interfaces.js\";\nimport { buildUnsIdentityPath } from \"./uns-path.js\";\n\nexport default class UnsProxy {\n  private publishInterval: NodeJS.Timeout | null = null;\n  public event: UnsEventEmitter<UnsEvents> = new UnsEventEmitter<UnsEvents>();\n  protected instanceStatusTopic: string;\n  protected instanceNameWithSuffix: string; //was prot\n  private producedTopics: Map<string, ITopicObject> = new Map();\n  private producedApiEndpoints: Map<string, IApiObject> = new Map();\n  private producedApiCatchall: Map<string, IApiCatchallMapping> = new Map();\n  private readonly controllerNameEnv: string | undefined;\n  private readonly controllerHostEnv: string | undefined;\n  private readonly controllerPortEnv: string | undefined;\n  private readonly controllerPublicBaseEnv: string | undefined;\n\n  constructor() {\n    this.controllerNameEnv = process.env[\"UNS_CONTROLLER_NAME\"];\n    this.controllerHostEnv = process.env[\"UNS_CONTROLLER_HOST\"];\n    this.controllerPortEnv = process.env[\"UNS_CONTROLLER_PORT\"];\n    this.controllerPublicBaseEnv =\n      process.env[\"UNS_CONTROLLER_PUBLIC_BASE\"] ?? process.env[\"UNS_PUBLIC_BASE\"];\n    // Set up interval to publish produced topics every 60 seconds.\n    this.publishInterval = setInterval(() => {\n      this.emitProducedTopics();\n      this.emitProducedApiEndpoints();\n      this.emitProducedApiCatchall();\n    }, 60000);    \n  }\n      \n  /**\n   * Publishes the list of produced topics to the MQTT broker.\n   */\n  private async emitProducedTopics(): Promise<void> {\n    if (this.instanceStatusTopic !== \"\") {\n      const topicsArray = [...this.producedTopics.values()];\n      if (topicsArray.length > 0) {\n        try {\n          this.event.emit(\"unsProxyProducedTopics\", { producedTopics: topicsArray, statusTopic: this.instanceStatusTopic + \"topics\" });\n        } catch (error) {\n          logger.error(`${this.instanceNameWithSuffix} - Error publishing produced topics: ${error.message}`);\n        }\n        logger.debug(`${this.instanceNameWithSuffix} - Published produced topics.`);\n      }\n    }\n  }\n\n  /**\n   * Publishes the list of produced API endpoints to the MQTT broker.\n   */\n  private async emitProducedApiEndpoints(): Promise<void> {\n    if (this.instanceStatusTopic !== \"\") {\n      const apiEndpointsArray = [...this.producedApiEndpoints.values()];\n      if (apiEndpointsArray.length > 0) {\n        try {\n          if (apiEndpointsArray.length > 0) {\n            this.event.emit(\"unsProxyProducedApiEndpoints\", { producedApiEndpoints: apiEndpointsArray, statusTopic: this.instanceStatusTopic + \"api-endpoints\" });\n          }\n        } catch (error) {\n          logger.error(`${this.instanceNameWithSuffix} - Error publishing produced API endpoints: ${error.message}`);\n        }\n        logger.debug(`${this.instanceNameWithSuffix} - Published produced API endpoints.`);\n      }\n    }\n  }\n\n  /**\n   * Publishes the list of catch-all API mappings to the MQTT broker.\n   */\n  private async emitProducedApiCatchall(): Promise<void> {\n    if (this.instanceStatusTopic !== \"\") {\n      const catchallArray = [...this.producedApiCatchall.values()];\n      if (catchallArray.length > 0) {\n        try {\n          this.event.emit(\"unsProxyProducedApiCatchAll\", {\n            producedCatchall: catchallArray,\n            statusTopic: this.instanceStatusTopic + \"api-catchall\",\n          });\n        } catch (error: any) {\n          logger.error(`${this.instanceNameWithSuffix} - Error publishing catch-all API mappings: ${error.message}`);\n        }\n        logger.debug(`${this.instanceNameWithSuffix} - Published catch-all API mappings.`);\n      }\n    }\n  }\n\n  /**\n   * Registers a unique topic and keeps its timestamp current.\n   *\n   * On first call the full entry is created and immediately emitted so the\n   * controller can persist the new schema node.  On subsequent calls only the\n   * timestamp is updated in-place; the 60-second heartbeat interval will carry\n   * the updated value to the controller, making the timestamp reflect the time\n   * of the most recent data publication rather than the one-off registration\n   * moment.\n   *\n   * @param topicObject - The object containing topic details.\n   */\n  protected registerUniqueTopic(topicObject: ITopicObject): void {\n    if (this.instanceStatusTopic !== \"\") {\n      const fullTopic = buildUnsIdentityPath(\n        topicObject.topic,\n        topicObject.asset,\n        topicObject.objectType,\n        topicObject.objectId,\n        topicObject.attribute,\n      );\n      if (!this.producedTopics.has(fullTopic)) {\n        this.producedTopics.set(fullTopic, {\n          timestamp: topicObject.timestamp,\n          topic: topicObject.topic,\n          attribute: topicObject.attribute,\n          attributeType: topicObject.attributeType,\n          description: topicObject.description,\n          tags: topicObject.tags,\n          attributeNeedsPersistence: topicObject.attributeNeedsPersistence ?? true,\n          dataGroup: topicObject.dataGroup ?? \"\",\n          asset: topicObject.asset,\n          assetDescription: topicObject.assetDescription,\n          objectType: topicObject.objectType,\n          objectTypeDescription: topicObject.objectTypeDescription,\n          objectId: topicObject.objectId,\n          ...(topicObject.validityMode ? { validityMode: topicObject.validityMode } : {}),\n          ...(topicObject.expectedIntervalMs ? { expectedIntervalMs: topicObject.expectedIntervalMs } : {}),\n          ...(topicObject.lifecycleEndValue ? { lifecycleEndValue: topicObject.lifecycleEndValue } : {}),\n        });\n        this.emitProducedTopics();\n        logger.info(`${this.instanceNameWithSuffix} - Registered new topic: ${fullTopic}`);\n      } else {\n        // Already registered — refresh only the timestamp so the periodic\n        // heartbeat reflects actual data flow rather than frozen startup time.\n        this.producedTopics.get(fullTopic)!.timestamp = topicObject.timestamp;\n      }\n    }\n  }\n\n  /**\n   * Registers an API endpoint to handle requests for a specific topic and attribute.\n   */\n  protected registerApiEndpoint(apiObject: IApiObject): void {\n    if (this.instanceStatusTopic !== \"\") {\n      const fullTopic = buildUnsIdentityPath(\n        apiObject.topic,\n        apiObject.asset,\n        apiObject.objectType,\n        apiObject.objectId,\n        apiObject.attribute,\n      );\n      if (!this.producedApiEndpoints.has(fullTopic)) {\n        const time = UnsPacket.formatToISO8601(new Date());\n        this.producedApiEndpoints.set(fullTopic, {\n          timestamp: time,\n          topic: apiObject.topic,\n          attribute: apiObject.attribute,\n          apiHost: apiObject.apiHost,\n          apiEndpoint: apiObject.apiEndpoint,\n          apiMethod: apiObject.apiMethod,\n          apiQueryParams: apiObject.apiQueryParams,\n          apiDescription: apiObject.apiDescription,\n          attributeType: apiObject.attributeType,\n          apiSwaggerEndpoint: apiObject.apiSwaggerEndpoint,\n          asset: apiObject.asset,\n          objectType: apiObject.objectType,\n          objectId: apiObject.objectId,\n          ...(this.controllerNameEnv ? { controllerName: this.controllerNameEnv } : {}),\n          ...(this.controllerHostEnv ? { controllerHost: this.controllerHostEnv } : {}),\n          ...(this.controllerPortEnv ? { controllerPort: this.controllerPortEnv } : {}),\n          ...(this.controllerPublicBaseEnv ? { controllerPublicBase: this.controllerPublicBaseEnv } : {}),\n        });\n        this.emitProducedApiEndpoints();\n        logger.info(`${this.instanceNameWithSuffix} - Registered new api endpoint: /${fullTopic}`);\n      }\n    }\n  }\n\n  protected registerApiCatchAll(mapping: IApiCatchallMapping): void {\n    if (this.instanceStatusTopic !== \"\") {\n      const key = mapping.topic.replace(/\\/+$/, \"\");\n      if (!this.producedApiCatchall.has(key)) {\n        this.producedApiCatchall.set(key, mapping);\n      } else {\n        this.producedApiCatchall.set(key, { ...this.producedApiCatchall.get(key)!, ...mapping });\n      }\n      this.emitProducedApiCatchall();\n      logger.info(`${this.instanceNameWithSuffix} - Registered catch-all API mapping: ${key}`);\n    }\n  }\n\n  protected unregisterApiEndpoint(topic: string, asset:UnsAsset, objectType: UnsObjectType, objectId: UnsObjectId, attribute: string): void {\n    const fullTopic = buildUnsIdentityPath(topic, asset, objectType, objectId, attribute);\n    if (this.producedApiEndpoints.has(fullTopic)) {\n      this.producedApiEndpoints.delete(fullTopic);\n      this.emitProducedApiEndpoints();\n      logger.info(`${this.instanceNameWithSuffix} - Unregistered API endpoint: ${fullTopic}`);\n    }\n  }\n  public async stop() {\n    // Clear the publishing interval.\n    if (this.publishInterval) {\n      clearInterval(this.publishInterval);\n      this.publishInterval = null;\n    }\n\n  }\n\n}\n"]}
+{"version":3,"file":"uns-proxy.js","sourceRoot":"","sources":["../../src/uns/uns-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["import { IApiObject, ITopicObject, UnsEvents } from \"./uns-interfaces.js\";\r\nimport logger from \"../logger.js\";\r\nimport { UnsEventEmitter } from \"./uns-event-emitter.js\";\r\nimport { UnsPacket } from \"./uns-packet.js\";\r\nimport { UnsAsset } from \"./uns-asset.js\";\r\nimport { UnsObjectId, UnsObjectType } from \"./uns-object.js\";\r\nimport { IApiCatchallMapping } from \"./uns-interfaces.js\";\r\nimport { buildUnsIdentityPath } from \"./uns-path.js\";\r\n\r\nexport default class UnsProxy {\r\n  private publishInterval: NodeJS.Timeout | null = null;\r\n  public event: UnsEventEmitter<UnsEvents> = new UnsEventEmitter<UnsEvents>();\r\n  protected instanceStatusTopic: string;\r\n  protected instanceNameWithSuffix: string; //was prot\r\n  private producedTopics: Map<string, ITopicObject> = new Map();\r\n  private producedApiEndpoints: Map<string, IApiObject> = new Map();\r\n  private producedApiCatchall: Map<string, IApiCatchallMapping> = new Map();\r\n  private readonly controllerNameEnv: string | undefined;\r\n  private readonly controllerHostEnv: string | undefined;\r\n  private readonly controllerPortEnv: string | undefined;\r\n  private readonly controllerPublicBaseEnv: string | undefined;\r\n\r\n  constructor() {\r\n    this.controllerNameEnv = process.env[\"UNS_CONTROLLER_NAME\"];\r\n    this.controllerHostEnv = process.env[\"UNS_CONTROLLER_HOST\"];\r\n    this.controllerPortEnv = process.env[\"UNS_CONTROLLER_PORT\"];\r\n    this.controllerPublicBaseEnv =\r\n      process.env[\"UNS_CONTROLLER_PUBLIC_BASE\"] ?? process.env[\"UNS_PUBLIC_BASE\"];\r\n    // Set up interval to publish produced topics every 60 seconds.\r\n    this.publishInterval = setInterval(() => {\r\n      this.emitProducedTopics();\r\n      this.emitProducedApiEndpoints();\r\n      this.emitProducedApiCatchall();\r\n    }, 60000);    \r\n  }\r\n      \r\n  /**\r\n   * Publishes the list of produced topics to the MQTT broker.\r\n   */\r\n  private async emitProducedTopics(): Promise<void> {\r\n    if (this.instanceStatusTopic !== \"\") {\r\n      const topicsArray = [...this.producedTopics.values()];\r\n      if (topicsArray.length > 0) {\r\n        try {\r\n          this.event.emit(\"unsProxyProducedTopics\", { producedTopics: topicsArray, statusTopic: this.instanceStatusTopic + \"topics\" });\r\n        } catch (error) {\r\n          logger.error(`${this.instanceNameWithSuffix} - Error publishing produced topics: ${error.message}`);\r\n        }\r\n        logger.debug(`${this.instanceNameWithSuffix} - Published produced topics.`);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Publishes the list of produced API endpoints to the MQTT broker.\r\n   */\r\n  private async emitProducedApiEndpoints(): Promise<void> {\r\n    if (this.instanceStatusTopic !== \"\") {\r\n      const apiEndpointsArray = [...this.producedApiEndpoints.values()];\r\n      if (apiEndpointsArray.length > 0) {\r\n        try {\r\n          if (apiEndpointsArray.length > 0) {\r\n            this.event.emit(\"unsProxyProducedApiEndpoints\", { producedApiEndpoints: apiEndpointsArray, statusTopic: this.instanceStatusTopic + \"api-endpoints\" });\r\n          }\r\n        } catch (error) {\r\n          logger.error(`${this.instanceNameWithSuffix} - Error publishing produced API endpoints: ${error.message}`);\r\n        }\r\n        logger.debug(`${this.instanceNameWithSuffix} - Published produced API endpoints.`);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Publishes the list of catch-all API mappings to the MQTT broker.\r\n   */\r\n  private async emitProducedApiCatchall(): Promise<void> {\r\n    if (this.instanceStatusTopic !== \"\") {\r\n      const catchallArray = [...this.producedApiCatchall.values()];\r\n      if (catchallArray.length > 0) {\r\n        try {\r\n          this.event.emit(\"unsProxyProducedApiCatchAll\", {\r\n            producedCatchall: catchallArray,\r\n            statusTopic: this.instanceStatusTopic + \"api-catchall\",\r\n          });\r\n        } catch (error: any) {\r\n          logger.error(`${this.instanceNameWithSuffix} - Error publishing catch-all API mappings: ${error.message}`);\r\n        }\r\n        logger.debug(`${this.instanceNameWithSuffix} - Published catch-all API mappings.`);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Registers a unique topic and keeps its timestamp current.\r\n   *\r\n   * On first call the full entry is created and immediately emitted so the\r\n   * controller can persist the new schema node.  On subsequent calls only the\r\n   * timestamp is updated in-place; the 60-second heartbeat interval will carry\r\n   * the updated value to the controller, making the timestamp reflect the time\r\n   * of the most recent data publication rather than the one-off registration\r\n   * moment.\r\n   *\r\n   * @param topicObject - The object containing topic details.\r\n   */\r\n  protected registerUniqueTopic(topicObject: ITopicObject): void {\r\n    if (this.instanceStatusTopic !== \"\") {\r\n      const fullTopic = buildUnsIdentityPath(\r\n        topicObject.topic,\r\n        topicObject.asset,\r\n        topicObject.objectType,\r\n        topicObject.objectId,\r\n        topicObject.attribute,\r\n      );\r\n      if (!this.producedTopics.has(fullTopic)) {\r\n        this.producedTopics.set(fullTopic, {\r\n          timestamp: topicObject.timestamp,\r\n          topic: topicObject.topic,\r\n          attribute: topicObject.attribute,\r\n          attributeType: topicObject.attributeType,\r\n          description: topicObject.description,\r\n          tags: topicObject.tags,\r\n          attributeNeedsPersistence: topicObject.attributeNeedsPersistence ?? true,\r\n          dataGroup: topicObject.dataGroup ?? \"\",\r\n          asset: topicObject.asset,\r\n          assetDescription: topicObject.assetDescription,\r\n          objectType: topicObject.objectType,\r\n          objectTypeDescription: topicObject.objectTypeDescription,\r\n          objectId: topicObject.objectId,\r\n          ...(topicObject.validityMode ? { validityMode: topicObject.validityMode } : {}),\r\n          ...(topicObject.expectedIntervalMs ? { expectedIntervalMs: topicObject.expectedIntervalMs } : {}),\r\n          ...(topicObject.lifecycleEndValue ? { lifecycleEndValue: topicObject.lifecycleEndValue } : {}),\r\n        });\r\n        this.emitProducedTopics();\r\n        logger.info(`${this.instanceNameWithSuffix} - Registered new topic: ${fullTopic}`);\r\n      } else {\r\n        // Already registered — refresh only the timestamp so the periodic\r\n        // heartbeat reflects actual data flow rather than frozen startup time.\r\n        this.producedTopics.get(fullTopic)!.timestamp = topicObject.timestamp;\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Registers an API endpoint to handle requests for a specific topic and attribute.\r\n   */\r\n  protected registerApiEndpoint(apiObject: IApiObject): void {\r\n    if (this.instanceStatusTopic !== \"\") {\r\n      const fullTopic = buildUnsIdentityPath(\r\n        apiObject.topic,\r\n        apiObject.asset,\r\n        apiObject.objectType,\r\n        apiObject.objectId,\r\n        apiObject.attribute,\r\n      );\r\n      if (!this.producedApiEndpoints.has(fullTopic)) {\r\n        const time = UnsPacket.formatToISO8601(new Date());\r\n        this.producedApiEndpoints.set(fullTopic, {\r\n          timestamp: time,\r\n          topic: apiObject.topic,\r\n          attribute: apiObject.attribute,\r\n          apiHost: apiObject.apiHost,\r\n          apiEndpoint: apiObject.apiEndpoint,\r\n          apiMethod: apiObject.apiMethod,\r\n          apiQueryParams: apiObject.apiQueryParams,\r\n          apiDescription: apiObject.apiDescription,\r\n          attributeType: apiObject.attributeType,\r\n          apiSwaggerEndpoint: apiObject.apiSwaggerEndpoint,\r\n          asset: apiObject.asset,\r\n          objectType: apiObject.objectType,\r\n          objectId: apiObject.objectId,\r\n          ...(this.controllerNameEnv ? { controllerName: this.controllerNameEnv } : {}),\r\n          ...(this.controllerHostEnv ? { controllerHost: this.controllerHostEnv } : {}),\r\n          ...(this.controllerPortEnv ? { controllerPort: this.controllerPortEnv } : {}),\r\n          ...(this.controllerPublicBaseEnv ? { controllerPublicBase: this.controllerPublicBaseEnv } : {}),\r\n        });\r\n        this.emitProducedApiEndpoints();\r\n        logger.info(`${this.instanceNameWithSuffix} - Registered new api endpoint: /${fullTopic}`);\r\n      }\r\n    }\r\n  }\r\n\r\n  protected registerApiCatchAll(mapping: IApiCatchallMapping): void {\r\n    if (this.instanceStatusTopic !== \"\") {\r\n      const key = mapping.topic.replace(/\\/+$/, \"\");\r\n      if (!this.producedApiCatchall.has(key)) {\r\n        this.producedApiCatchall.set(key, mapping);\r\n      } else {\r\n        this.producedApiCatchall.set(key, { ...this.producedApiCatchall.get(key)!, ...mapping });\r\n      }\r\n      this.emitProducedApiCatchall();\r\n      logger.info(`${this.instanceNameWithSuffix} - Registered catch-all API mapping: ${key}`);\r\n    }\r\n  }\r\n\r\n  protected unregisterApiEndpoint(topic: string, asset:UnsAsset, objectType: UnsObjectType, objectId: UnsObjectId, attribute: string): void {\r\n    const fullTopic = buildUnsIdentityPath(topic, asset, objectType, objectId, attribute);\r\n    if (this.producedApiEndpoints.has(fullTopic)) {\r\n      this.producedApiEndpoints.delete(fullTopic);\r\n      this.emitProducedApiEndpoints();\r\n      logger.info(`${this.instanceNameWithSuffix} - Unregistered API endpoint: ${fullTopic}`);\r\n    }\r\n  }\r\n  public async stop() {\r\n    // Clear the publishing interval.\r\n    if (this.publishInterval) {\r\n      clearInterval(this.publishInterval);\r\n      this.publishInterval = null;\r\n    }\r\n\r\n  }\r\n\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"uns-tags.js","sourceRoot":"","sources":["../../src/uns/uns-tags.ts"],"names":[],"mappings":"","sourcesContent":["export type UnsTags = \"\" |\n(string & {});"]}
+{"version":3,"file":"uns-tags.js","sourceRoot":"","sources":["../../src/uns/uns-tags.ts"],"names":[],"mappings":"","sourcesContent":["export type UnsTags = \"\" |\r\n(string & {});"]}

package/dist/uns/uns-topic-matcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"uns-topic-matcher.js","sourceRoot":"","sources":["../../src/uns/uns-topic-matcher.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,WAAmB,EAAE,KAAa;QAC/C,0DAA0D;QAC1D,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YAExC,qBAAqB;YACrB,IAAI,aAAa,KAAK,GAAG,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,CAAC,sCAAsC;YACrD,CAAC;YAED,qBAAqB;YACrB,IAAI,aAAa,KAAK,GAAG,EAAE,CAAC;gBAC1B,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;oBACnC,OAAO,KAAK,CAAC,CAAC,qCAAqC;gBACrD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,uBAAuB;gBACvB,IAAI,aAAa,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,OAAO,cAAc,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC;IACxD,CAAC;CACF","sourcesContent":["export class UnsTopicMatcher {\n  /**\n   * Matches a topic with a topic filter, using MQTT rules.\n   * @param topicFilter The MQTT topic filter (may contain `#` or `+` wildcards).\n   * @param topic The topic to test against the filter.\n   * @returns `true` if the topic matches the filter, `false` otherwise.\n   */\n  static matches(topicFilter: string, topic: string): boolean {\n    // Normalize leading/trailing slashes and collapse empties\n    const filterSegments = topicFilter.split('/').filter(Boolean);\n    const topicSegments = topic.split('/').filter(Boolean);\n\n    for (let i = 0; i < filterSegments.length; i++) {\n      const filterSegment = filterSegments[i];\n\n      // Match `#` wildcard\n      if (filterSegment === '#') {\n        return true; // `#` matches everything that follows\n      }\n\n      // Match `+` wildcard\n      if (filterSegment === '+') {\n        if (topicSegments[i] === undefined) {\n          return false; // `+` should match exactly one level\n        }\n      } else {\n        // Exact match required\n        if (filterSegment !== topicSegments[i]) {\n          return false;\n        }\n      }\n    }\n\n    // Ensure there are no unmatched segments in the topic\n    return filterSegments.length === topicSegments.length;\n  }\n}\n"]}
+{"version":3,"file":"uns-topic-matcher.js","sourceRoot":"","sources":["../../src/uns/uns-topic-matcher.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,WAAmB,EAAE,KAAa;QAC/C,0DAA0D;QAC1D,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YAExC,qBAAqB;YACrB,IAAI,aAAa,KAAK,GAAG,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,CAAC,sCAAsC;YACrD,CAAC;YAED,qBAAqB;YACrB,IAAI,aAAa,KAAK,GAAG,EAAE,CAAC;gBAC1B,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;oBACnC,OAAO,KAAK,CAAC,CAAC,qCAAqC;gBACrD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,uBAAuB;gBACvB,IAAI,aAAa,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,OAAO,cAAc,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC;IACxD,CAAC;CACF","sourcesContent":["export class UnsTopicMatcher {\r\n  /**\r\n   * Matches a topic with a topic filter, using MQTT rules.\r\n   * @param topicFilter The MQTT topic filter (may contain `#` or `+` wildcards).\r\n   * @param topic The topic to test against the filter.\r\n   * @returns `true` if the topic matches the filter, `false` otherwise.\r\n   */\r\n  static matches(topicFilter: string, topic: string): boolean {\r\n    // Normalize leading/trailing slashes and collapse empties\r\n    const filterSegments = topicFilter.split('/').filter(Boolean);\r\n    const topicSegments = topic.split('/').filter(Boolean);\r\n\r\n    for (let i = 0; i < filterSegments.length; i++) {\r\n      const filterSegment = filterSegments[i];\r\n\r\n      // Match `#` wildcard\r\n      if (filterSegment === '#') {\r\n        return true; // `#` matches everything that follows\r\n      }\r\n\r\n      // Match `+` wildcard\r\n      if (filterSegment === '+') {\r\n        if (topicSegments[i] === undefined) {\r\n          return false; // `+` should match exactly one level\r\n        }\r\n      } else {\r\n        // Exact match required\r\n        if (filterSegment !== topicSegments[i]) {\r\n          return false;\r\n        }\r\n      }\r\n    }\r\n\r\n    // Ensure there are no unmatched segments in the topic\r\n    return filterSegments.length === topicSegments.length;\r\n  }\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"uns-topics.js","sourceRoot":"","sources":["../../src/uns/uns-topics.ts"],"names":[],"mappings":"","sourcesContent":["export type UnsTopics = \"\" |\n(string & {});"]}
+{"version":3,"file":"uns-topics.js","sourceRoot":"","sources":["../../src/uns/uns-topics.ts"],"names":[],"mappings":"","sourcesContent":["export type UnsTopics = \"\" |\r\n(string & {});"]}

package/dist/uns-config/config-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/uns-config/config-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,sEAAsE;AACtE,MAAM,CAAC,MAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,MAAM,EAAE,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { composeConfigSchema } from \"./schema-tools.js\";\nimport { unsCoreSchema } from \"./uns-core-schema.js\";\nimport { projectExtrasSchema } from \"../config/project.config.extension.js\";\n\n// Plain strict object for generators (no Effects, no dynamic imports)\nexport const baseSchema = composeConfigSchema(unsCoreSchema, projectExtrasSchema).strict();\n\n// Optional: export type from here too (handy for other libs)\nexport type AppConfigFromZod = z.infer<typeof baseSchema>;\n"]}
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/uns-config/config-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,sEAAsE;AACtE,MAAM,CAAC,MAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,MAAM,EAAE,CAAC","sourcesContent":["import { z } from \"zod\";\r\nimport { composeConfigSchema } from \"./schema-tools.js\";\r\nimport { unsCoreSchema } from \"./uns-core-schema.js\";\r\nimport { projectExtrasSchema } from \"../config/project.config.extension.js\";\r\n\r\n// Plain strict object for generators (no Effects, no dynamic imports)\r\nexport const baseSchema = composeConfigSchema(unsCoreSchema, projectExtrasSchema).strict();\r\n\r\n// Optional: export type from here too (handy for other libs)\r\nexport type AppConfigFromZod = z.infer<typeof baseSchema>;\r\n"]}

package/dist/uns-config/host-placeholders.js.map

@@ -1 +1 @@
-{"version":3,"file":"host-placeholders.js","sourceRoot":"","sources":["../../src/uns-config/host-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,0EAA0E;AAC1E,iFAAiF;AACjF,6CAA6C;AAE7C,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC9E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;SACnC,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,kDAAkD,CAAC,CAAC;AAEhE,MAAM,kBAAkB,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACtF,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;SACvC,QAAQ,CAAC,mEAAmE,CAAC;IAChF,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;IACxF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wEAAwE,CAAC;CACtF,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,8FAA8F,CAAC,CAAC;AAE5G,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACzF,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;SAC7C,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,oDAAoD,CAAC;IACjE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;IACvF,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,wEAAwE,CAAC;IACrF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,wDAAwD,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE;IACpE,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IACrC,CAAC;SACE,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;SACnC,QAAQ,CAAC,uDAAuD,CAAC;IACpE,qBAAqB;CACtB,CAAC,CAAC;AAQH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC","sourcesContent":["import { z } from \"zod\";\n\n// Host placeholders allow configuration values such as MQTT brokers or database\n// hosts to be defined dynamically. They support in-line values as well as\n// externally resolved entries so projects can avoid storing environment-specific\n// hosts directly inside shared config files.\n\nconst inlineHostSchema = z\n  .object({\n    provider: z.literal(\"inline\").describe(\"Use the supplied host or IP address.\"),\n    value: z\n      .string()\n      .min(1, \"Host/IP value is required\")\n      .describe(\"Host or IP address that should be used directly.\"),\n  })\n  .strict()\n  .describe(\"Host placeholder resolved from an in-line value.\");\n\nconst externalHostSchema = z\n  .object({\n    provider: z.literal(\"external\").describe(\"Resolve the host from an external mapping.\"),\n    key: z\n      .string()\n      .min(1, \"External host key is required\")\n      .describe(\"Identifier used when resolving the host from HostResolverOptions.\"),\n    optional: z\n      .boolean()\n      .optional()\n      .describe(\"Allow the external host to be missing without throwing during resolution.\"),\n    default: z\n      .string()\n      .optional()\n      .describe(\"Fallback host when optional is true and the external entry is missing.\"),\n  })\n  .strict()\n  .describe(\"Host placeholder resolved via HostResolverOptions.externalHosts or resolveExternal function.\");\n\nconst systemHostSchema = z\n  .object({\n    provider: z.literal(\"system\").describe(\"Resolve the host from local network interfaces.\"),\n    family: z\n      .union([z.literal(\"IPv4\"), z.literal(\"IPv6\")])\n      .default(\"IPv4\")\n      .describe(\"Address family to return when scanning interfaces.\"),\n    interfaceName: z\n      .string()\n      .optional()\n      .describe(\"Specific interface to read (falls back to the first match when omitted).\"),\n    optional: z\n      .boolean()\n      .optional()\n      .describe(\"Allow the interface lookup to fail without throwing during resolution.\"),\n    default: z\n      .string()\n      .optional()\n      .describe(\"Fallback host/IP when optional is true and no interface matches.\"),\n  })\n  .strict()\n  .describe(\"Host placeholder resolved from os.networkInterfaces().\");\n\nexport const hostPlaceholderSchema = z.discriminatedUnion(\"provider\", [\n  inlineHostSchema,\n  externalHostSchema,\n  systemHostSchema,\n]);\n\nexport const hostValueSchema = z.union([\n  z\n    .string()\n    .min(1, \"Host/IP value is required\")\n    .describe(\"Host or IP address used directly without placeholder.\"),\n  hostPlaceholderSchema,\n]);\n\nexport type HostPlaceholder = z.infer<typeof hostPlaceholderSchema>;\nexport type HostValue = z.infer<typeof hostValueSchema>;\nexport type InlineHostPlaceholder = z.infer<typeof inlineHostSchema>;\nexport type ExternalHostPlaceholder = z.infer<typeof externalHostSchema>;\nexport type SystemHostPlaceholder = z.infer<typeof systemHostSchema>;\n\nexport function isHostPlaceholder(value: unknown): value is HostPlaceholder {\n  return hostPlaceholderSchema.safeParse(value).success;\n}\n"]}
+{"version":3,"file":"host-placeholders.js","sourceRoot":"","sources":["../../src/uns-config/host-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,0EAA0E;AAC1E,iFAAiF;AACjF,6CAA6C;AAE7C,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC9E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;SACnC,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,kDAAkD,CAAC,CAAC;AAEhE,MAAM,kBAAkB,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACtF,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;SACvC,QAAQ,CAAC,mEAAmE,CAAC;IAChF,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;IACxF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wEAAwE,CAAC;CACtF,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,8FAA8F,CAAC,CAAC;AAE5G,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACzF,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;SAC7C,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,oDAAoD,CAAC;IACjE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;IACvF,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,wEAAwE,CAAC;IACrF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,wDAAwD,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE;IACpE,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IACrC,CAAC;SACE,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;SACnC,QAAQ,CAAC,uDAAuD,CAAC;IACpE,qBAAqB;CACtB,CAAC,CAAC;AAQH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC","sourcesContent":["import { z } from \"zod\";\r\n\r\n// Host placeholders allow configuration values such as MQTT brokers or database\r\n// hosts to be defined dynamically. They support in-line values as well as\r\n// externally resolved entries so projects can avoid storing environment-specific\r\n// hosts directly inside shared config files.\r\n\r\nconst inlineHostSchema = z\r\n  .object({\r\n    provider: z.literal(\"inline\").describe(\"Use the supplied host or IP address.\"),\r\n    value: z\r\n      .string()\r\n      .min(1, \"Host/IP value is required\")\r\n      .describe(\"Host or IP address that should be used directly.\"),\r\n  })\r\n  .strict()\r\n  .describe(\"Host placeholder resolved from an in-line value.\");\r\n\r\nconst externalHostSchema = z\r\n  .object({\r\n    provider: z.literal(\"external\").describe(\"Resolve the host from an external mapping.\"),\r\n    key: z\r\n      .string()\r\n      .min(1, \"External host key is required\")\r\n      .describe(\"Identifier used when resolving the host from HostResolverOptions.\"),\r\n    optional: z\r\n      .boolean()\r\n      .optional()\r\n      .describe(\"Allow the external host to be missing without throwing during resolution.\"),\r\n    default: z\r\n      .string()\r\n      .optional()\r\n      .describe(\"Fallback host when optional is true and the external entry is missing.\"),\r\n  })\r\n  .strict()\r\n  .describe(\"Host placeholder resolved via HostResolverOptions.externalHosts or resolveExternal function.\");\r\n\r\nconst systemHostSchema = z\r\n  .object({\r\n    provider: z.literal(\"system\").describe(\"Resolve the host from local network interfaces.\"),\r\n    family: z\r\n      .union([z.literal(\"IPv4\"), z.literal(\"IPv6\")])\r\n      .default(\"IPv4\")\r\n      .describe(\"Address family to return when scanning interfaces.\"),\r\n    interfaceName: z\r\n      .string()\r\n      .optional()\r\n      .describe(\"Specific interface to read (falls back to the first match when omitted).\"),\r\n    optional: z\r\n      .boolean()\r\n      .optional()\r\n      .describe(\"Allow the interface lookup to fail without throwing during resolution.\"),\r\n    default: z\r\n      .string()\r\n      .optional()\r\n      .describe(\"Fallback host/IP when optional is true and no interface matches.\"),\r\n  })\r\n  .strict()\r\n  .describe(\"Host placeholder resolved from os.networkInterfaces().\");\r\n\r\nexport const hostPlaceholderSchema = z.discriminatedUnion(\"provider\", [\r\n  inlineHostSchema,\r\n  externalHostSchema,\r\n  systemHostSchema,\r\n]);\r\n\r\nexport const hostValueSchema = z.union([\r\n  z\r\n    .string()\r\n    .min(1, \"Host/IP value is required\")\r\n    .describe(\"Host or IP address used directly without placeholder.\"),\r\n  hostPlaceholderSchema,\r\n]);\r\n\r\nexport type HostPlaceholder = z.infer<typeof hostPlaceholderSchema>;\r\nexport type HostValue = z.infer<typeof hostValueSchema>;\r\nexport type InlineHostPlaceholder = z.infer<typeof inlineHostSchema>;\r\nexport type ExternalHostPlaceholder = z.infer<typeof externalHostSchema>;\r\nexport type SystemHostPlaceholder = z.infer<typeof systemHostSchema>;\r\n\r\nexport function isHostPlaceholder(value: unknown): value is HostPlaceholder {\r\n  return hostPlaceholderSchema.safeParse(value).success;\r\n}\r\n"]}