@uns-kit/core 2.0.39 → 2.0.41

package/README.md

@@ -41,6 +41,29 @@ const config = await ConfigFile.loadConfig();
 const proc = new UnsProxyProcess(config.infra.host!, { processName: config.uns.processName });
 ```
 
+Publish retained service metadata when a runtime should be discoverable by the
+controller as a core service, addon, or built-in capability:
+
+```ts
+await proc.publishServiceMetadata({
+  serviceId: "uns-bridge-mqtt",
+  kind: "addon",
+  addonId: "uns-bridge-mqtt",
+  capabilities: ["mqtt-source-browser", "runtime-mappings"],
+  apiRoutes: [
+    {
+      path: "/api/system/bridge/mqtt/runtime/service/bridge/health",
+      kind: "health",
+    },
+  ],
+});
+```
+
+The metadata is retained on
+`uns-infra/<package>/<version>/<processName>/service-metadata`. Controllers
+combine this identity/capability payload with live process telemetry and route
+health before marking a service healthy.
+
 Extend it with plugins:
 
 ```ts

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { default as UnsProxyProcess } from "./uns/uns-proxy-process.js";
 export type { UnsProxyProcessPlugin, UnsProxyProcessPluginApi, UnsProxyProcessPluginMethod, UnsProxyProcessPluginMethods, } from "./uns/uns-proxy-process.js";
 export * from "./uns/uns-interfaces.js";
+export * from "./uns/service-metadata.js";
 export { ConfigFile } from "./config-file.js";
 export { default as logger } from "./logger.js";
 export { getLogger } from "./logger.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACxE,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACxE,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { default as UnsProxyProcess } from "./uns/uns-proxy-process.js";
 export * from "./uns/uns-interfaces.js";
+export * from "./uns/service-metadata.js";
 export { ConfigFile } from "./config-file.js";
 export { default as logger } from "./logger.js";
 export { getLogger } from "./logger.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAOxE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC","sourcesContent":["export { default as UnsProxyProcess } from \"./uns/uns-proxy-process.js\";\nexport type {\n  UnsProxyProcessPlugin,\n  UnsProxyProcessPluginApi,\n  UnsProxyProcessPluginMethod,\n  UnsProxyProcessPluginMethods,\n} from \"./uns/uns-proxy-process.js\";\nexport * from \"./uns/uns-interfaces.js\";\nexport { ConfigFile } from \"./config-file.js\";\nexport { default as logger } from \"./logger.js\";\nexport { getLogger } from \"./logger.js\";\nexport { resolveInfisicalConfig } from \"./uns-config/secret-resolver.js\";\nexport { UnsClient, LastValueResult, LastValueClientError } from \"./tools/datahub/datahub-client.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAOxE,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC","sourcesContent":["export { default as UnsProxyProcess } from \"./uns/uns-proxy-process.js\";\nexport type {\n  UnsProxyProcessPlugin,\n  UnsProxyProcessPluginApi,\n  UnsProxyProcessPluginMethod,\n  UnsProxyProcessPluginMethods,\n} from \"./uns/uns-proxy-process.js\";\nexport * from \"./uns/uns-interfaces.js\";\nexport * from \"./uns/service-metadata.js\";\nexport { ConfigFile } from \"./config-file.js\";\nexport { default as logger } from \"./logger.js\";\nexport { getLogger } from \"./logger.js\";\nexport { resolveInfisicalConfig } from \"./uns-config/secret-resolver.js\";\nexport { UnsClient, LastValueResult, LastValueClientError } from \"./tools/datahub/datahub-client.js\";\n"]}

package/dist/tools/datahub/datahub-client.js

@@ -109,7 +109,7 @@ export class UnsClient {
         }
         const token = options.token ?? (await this.ensureToken());
         try {
-            const payload = await this.requestJson("POST", this.buildUrl("/batch/last"), { topics: topicList }, token);
+            const payload = await this.requestJson("POST", this.buildUrl("catchall//batch/last"), { topics: topicList }, token);
             const rawResults = payload.results;
             if (!Array.isArray(rawResults)) {
                 throw new LastValueClientError("Last-value response did not include a results array.");

package/dist/tools/datahub/datahub-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"datahub-client.js","sourceRoot":"","sources":["../../../src/tools/datahub/datahub-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { AuthClient } from \"../auth/auth-client.js\";\n\nexport type LastValuePayload = {\n  topic: string;\n  value: unknown;\n  values?: Record<string, unknown> | null;\n  uom?: string | null;\n  timestamp?: string | null;\n  dataGroup?: string | null;\n  ageMs?: number | null;\n  source: string;\n};\n\nexport class LastValueResult {\n  readonly topic: string;\n  readonly value: unknown;\n  readonly values?: Record<string, unknown> | null;\n  readonly uom?: string | null;\n  readonly timestamp?: string | null;\n  readonly dataGroup?: string | null;\n  readonly ageMs?: number | null;\n  readonly source: string;\n\n  constructor(payload: LastValuePayload) {\n    this.topic = payload.topic;\n    this.value = payload.value;\n    this.values = payload.values ?? null;\n    this.uom = payload.uom ?? null;\n    this.timestamp = payload.timestamp ?? null;\n    this.dataGroup = payload.dataGroup ?? null;\n    this.ageMs = payload.ageMs ?? null;\n    this.source = payload.source;\n  }\n\n  static fromMapping(value: Record<string, unknown>): LastValueResult {\n    const rawValues = value.values;\n    return new LastValueResult({\n      topic: typeof value.topic === \"string\" ? value.topic : \"\",\n      value: value.value,\n      values: rawValues && typeof rawValues === \"object\" && !Array.isArray(rawValues) ? (rawValues as Record<string, unknown>) : null,\n      uom: typeof value.uom === \"string\" ? value.uom : null,\n      timestamp: typeof value.timestamp === \"string\" ? value.timestamp : null,\n      dataGroup: typeof value.dataGroup === \"string\" ? value.dataGroup : null,\n      ageMs: typeof value.ageMs === \"number\" ? value.ageMs : null,\n      source: typeof value.source === \"string\" ? value.source : \"miss\",\n    });\n  }\n\n  get hit(): boolean {\n    return this.source === \"cache\";\n  }\n\n  toObject(): LastValuePayload {\n    return {\n      topic: this.topic,\n      value: this.value,\n      values: this.values ?? null,\n      uom: this.uom ?? null,\n      timestamp: this.timestamp ?? null,\n      dataGroup: this.dataGroup ?? null,\n      ageMs: this.ageMs ?? null,\n      source: this.source,\n    };\n  }\n}\n\nexport class LastValueClientError extends Error {\n  readonly statusCode?: number;\n\n  constructor(message: string, statusCode?: number) {\n    super(message);\n    this.statusCode = statusCode;\n  }\n}\n\nexport type UnsClientOptions = {\n  apiBasePath?: string;\n  token?: string;\n  timeoutMs?: number;\n  authClient?: AuthClient;\n};\n\nexport class UnsClient {\n  private readonly apiBasePath: string;\n  private readonly baseUrl: string;\n  private readonly apiUrl: string;\n  private readonly timeoutMs: number;\n  private readonly authClient?: AuthClient;\n  private accessToken?: string;\n\n  constructor(baseUrl: string, options: UnsClientOptions = {}) {\n    const apiBasePath = UnsClient.normalizeBasePath(options.apiBasePath ?? \"/api\");\n    const strippedBase = baseUrl.replace(/\\/$/, \"\");\n    if (apiBasePath && strippedBase.endsWith(apiBasePath)) {\n      this.apiUrl = strippedBase;\n      this.baseUrl = strippedBase.slice(0, -apiBasePath.length).replace(/\\/$/, \"\");\n    } else {\n      this.baseUrl = strippedBase;\n      this.apiUrl = `${strippedBase}${apiBasePath}`;\n    }\n    this.apiBasePath = apiBasePath;\n    this.timeoutMs = options.timeoutMs ?? 10_000;\n    this.authClient = options.authClient;\n    this.accessToken = options.token;\n  }\n\n  setToken(token?: string): void {\n    this.accessToken = token;\n  }\n\n  async ensureToken(): Promise<string | undefined> {\n    if (this.accessToken) return this.accessToken;\n    if (!this.authClient) return undefined;\n    const token = await this.authClient.getAccessToken();\n    this.accessToken = token;\n    return token;\n  }\n\n  async get(endpoint: string, params?: Record<string, string | number | boolean>, options: { baseUrl?: string; authorize?: boolean } = {}): Promise<Record<string, unknown>> {\n    const authorize = options.authorize ?? true;\n    const token = authorize ? await this.ensureToken() : undefined;\n    const search = params ? `?${new URLSearchParams(this.stringifyQueryParams(params))}` : \"\";\n    return this.requestJson(\"GET\", `${this.buildUrl(endpoint, options.baseUrl)}${search}`, undefined, token);\n  }\n\n  async post(endpoint: string, body?: Record<string, unknown>, options: { baseUrl?: string; authorize?: boolean } = {}): Promise<Record<string, unknown>> {\n    const authorize = options.authorize ?? true;\n    const token = authorize ? await this.ensureToken() : undefined;\n    return this.requestJson(\"POST\", this.buildUrl(endpoint, options.baseUrl), body ?? {}, token);\n  }\n\n  async lastValue(topics: string | string[], options: { token?: string } = {}): Promise<Record<string, LastValuePayload> | null> {\n    const topicList = Array.isArray(topics) ? topics : [topics];\n    if (!topicList.length) {\n      throw new Error(\"topics must contain at least one topic.\");\n    }\n    if (topicList.length > 500) {\n      throw new Error(\"Maximum 500 topics per request.\");\n    }\n    const token = options.token ?? (await this.ensureToken());\n    try {\n      const payload = await this.requestJson(\"POST\", this.buildUrl(\"/batch/last\"), { topics: topicList }, token);\n      const rawResults = payload.results;\n      if (!Array.isArray(rawResults)) {\n        throw new LastValueClientError(\"Last-value response did not include a results array.\");\n      }\n      const results = rawResults\n        .filter((item): item is Record<string, unknown> => !!item && typeof item === \"object\" && !Array.isArray(item))\n        .map((item) => LastValueResult.fromMapping(item));\n      return Object.fromEntries(results.map((result) => [result.topic, result.toObject()]));\n    } catch (error) {\n      if (error instanceof LastValueClientError && error.statusCode === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  private async requestJson(\n    method: \"GET\" | \"POST\",\n    url: string,\n    body?: Record<string, unknown>,\n    token?: string,\n  ): Promise<Record<string, unknown>> {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      const resp = await fetch(url, {\n        method,\n        headers: {\n          \"Accept\": \"application/json\",\n          ...(body ? { \"Content-Type\": \"application/json\" } : {}),\n          ...(token ? { \"Authorization\": `Bearer ${token}` } : {}),\n        },\n        ...(body ? { body: JSON.stringify(body) } : {}),\n        signal: controller.signal,\n      });\n      const text = await resp.text();\n      if (!resp.ok) {\n        throw new LastValueClientError(\n          `UNS request failed with HTTP ${resp.status}: ${text || resp.statusText}`,\n          resp.status,\n        );\n      }\n      if (!text) return {};\n      const parsed = JSON.parse(text);\n      if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n        throw new LastValueClientError(\"UNS response must be a JSON object.\");\n      }\n      return parsed as Record<string, unknown>;\n    } catch (error: any) {\n      if (error instanceof LastValueClientError) {\n        throw error;\n      }\n      if (error?.name === \"AbortError\") {\n        throw new LastValueClientError(\"UNS request timed out.\");\n      }\n      throw new LastValueClientError(`UNS request failed: ${error?.message ?? String(error)}`);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n\n  private buildUrl(endpoint: string, baseUrl?: string): string {\n    if (endpoint.startsWith(\"http://\") || endpoint.startsWith(\"https://\")) {\n      return endpoint;\n    }\n    const root = (baseUrl ?? this.apiUrl).replace(/\\/$/, \"\");\n    let path = endpoint.startsWith(\"/\") ? endpoint : `/${endpoint}`;\n    if (!baseUrl && this.apiBasePath && (path === this.apiBasePath || path.startsWith(`${this.apiBasePath}/`))) {\n      path = path.slice(this.apiBasePath.length) || \"/\";\n    }\n    return `${root}${path}`;\n  }\n\n  private stringifyQueryParams(params: Record<string, string | number | boolean>): Record<string, string> {\n    return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, String(value)]));\n  }\n\n  private static normalizeBasePath(value: string): string {\n    const stripped = value.trim();\n    if (!stripped) return \"\";\n    return stripped.startsWith(\"/\") ? stripped : `/${stripped}`;\n  }\n}\n"]}
+{"version":3,"file":"datahub-client.js","sourceRoot":"","sources":["../../../src/tools/datahub/datahub-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { AuthClient } from \"../auth/auth-client.js\";\n\nexport type LastValuePayload = {\n  topic: string;\n  value: unknown;\n  values?: Record<string, unknown> | null;\n  uom?: string | null;\n  timestamp?: string | null;\n  dataGroup?: string | null;\n  ageMs?: number | null;\n  source: string;\n};\n\nexport class LastValueResult {\n  readonly topic: string;\n  readonly value: unknown;\n  readonly values?: Record<string, unknown> | null;\n  readonly uom?: string | null;\n  readonly timestamp?: string | null;\n  readonly dataGroup?: string | null;\n  readonly ageMs?: number | null;\n  readonly source: string;\n\n  constructor(payload: LastValuePayload) {\n    this.topic = payload.topic;\n    this.value = payload.value;\n    this.values = payload.values ?? null;\n    this.uom = payload.uom ?? null;\n    this.timestamp = payload.timestamp ?? null;\n    this.dataGroup = payload.dataGroup ?? null;\n    this.ageMs = payload.ageMs ?? null;\n    this.source = payload.source;\n  }\n\n  static fromMapping(value: Record<string, unknown>): LastValueResult {\n    const rawValues = value.values;\n    return new LastValueResult({\n      topic: typeof value.topic === \"string\" ? value.topic : \"\",\n      value: value.value,\n      values: rawValues && typeof rawValues === \"object\" && !Array.isArray(rawValues) ? (rawValues as Record<string, unknown>) : null,\n      uom: typeof value.uom === \"string\" ? value.uom : null,\n      timestamp: typeof value.timestamp === \"string\" ? value.timestamp : null,\n      dataGroup: typeof value.dataGroup === \"string\" ? value.dataGroup : null,\n      ageMs: typeof value.ageMs === \"number\" ? value.ageMs : null,\n      source: typeof value.source === \"string\" ? value.source : \"miss\",\n    });\n  }\n\n  get hit(): boolean {\n    return this.source === \"cache\";\n  }\n\n  toObject(): LastValuePayload {\n    return {\n      topic: this.topic,\n      value: this.value,\n      values: this.values ?? null,\n      uom: this.uom ?? null,\n      timestamp: this.timestamp ?? null,\n      dataGroup: this.dataGroup ?? null,\n      ageMs: this.ageMs ?? null,\n      source: this.source,\n    };\n  }\n}\n\nexport class LastValueClientError extends Error {\n  readonly statusCode?: number;\n\n  constructor(message: string, statusCode?: number) {\n    super(message);\n    this.statusCode = statusCode;\n  }\n}\n\nexport type UnsClientOptions = {\n  apiBasePath?: string;\n  token?: string;\n  timeoutMs?: number;\n  authClient?: AuthClient;\n};\n\nexport class UnsClient {\n  private readonly apiBasePath: string;\n  private readonly baseUrl: string;\n  private readonly apiUrl: string;\n  private readonly timeoutMs: number;\n  private readonly authClient?: AuthClient;\n  private accessToken?: string;\n\n  constructor(baseUrl: string, options: UnsClientOptions = {}) {\n    const apiBasePath = UnsClient.normalizeBasePath(options.apiBasePath ?? \"/api\");\n    const strippedBase = baseUrl.replace(/\\/$/, \"\");\n    if (apiBasePath && strippedBase.endsWith(apiBasePath)) {\n      this.apiUrl = strippedBase;\n      this.baseUrl = strippedBase.slice(0, -apiBasePath.length).replace(/\\/$/, \"\");\n    } else {\n      this.baseUrl = strippedBase;\n      this.apiUrl = `${strippedBase}${apiBasePath}`;\n    }\n    this.apiBasePath = apiBasePath;\n    this.timeoutMs = options.timeoutMs ?? 10_000;\n    this.authClient = options.authClient;\n    this.accessToken = options.token;\n  }\n\n  setToken(token?: string): void {\n    this.accessToken = token;\n  }\n\n  async ensureToken(): Promise<string | undefined> {\n    if (this.accessToken) return this.accessToken;\n    if (!this.authClient) return undefined;\n    const token = await this.authClient.getAccessToken();\n    this.accessToken = token;\n    return token;\n  }\n\n  async get(endpoint: string, params?: Record<string, string | number | boolean>, options: { baseUrl?: string; authorize?: boolean } = {}): Promise<Record<string, unknown>> {\n    const authorize = options.authorize ?? true;\n    const token = authorize ? await this.ensureToken() : undefined;\n    const search = params ? `?${new URLSearchParams(this.stringifyQueryParams(params))}` : \"\";\n    return this.requestJson(\"GET\", `${this.buildUrl(endpoint, options.baseUrl)}${search}`, undefined, token);\n  }\n\n  async post(endpoint: string, body?: Record<string, unknown>, options: { baseUrl?: string; authorize?: boolean } = {}): Promise<Record<string, unknown>> {\n    const authorize = options.authorize ?? true;\n    const token = authorize ? await this.ensureToken() : undefined;\n    return this.requestJson(\"POST\", this.buildUrl(endpoint, options.baseUrl), body ?? {}, token);\n  }\n\n  async lastValue(topics: string | string[], options: { token?: string } = {}): Promise<Record<string, LastValuePayload> | null> {\n    const topicList = Array.isArray(topics) ? topics : [topics];\n    if (!topicList.length) {\n      throw new Error(\"topics must contain at least one topic.\");\n    }\n    if (topicList.length > 500) {\n      throw new Error(\"Maximum 500 topics per request.\");\n    }\n    const token = options.token ?? (await this.ensureToken());\n    try {\n      const payload = await this.requestJson(\"POST\", this.buildUrl(\"catchall//batch/last\"), { topics: topicList }, token);\n      const rawResults = payload.results;\n      if (!Array.isArray(rawResults)) {\n        throw new LastValueClientError(\"Last-value response did not include a results array.\");\n      }\n      const results = rawResults\n        .filter((item): item is Record<string, unknown> => !!item && typeof item === \"object\" && !Array.isArray(item))\n        .map((item) => LastValueResult.fromMapping(item));\n      return Object.fromEntries(results.map((result) => [result.topic, result.toObject()]));\n    } catch (error) {\n      if (error instanceof LastValueClientError && error.statusCode === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  private async requestJson(\n    method: \"GET\" | \"POST\",\n    url: string,\n    body?: Record<string, unknown>,\n    token?: string,\n  ): Promise<Record<string, unknown>> {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      const resp = await fetch(url, {\n        method,\n        headers: {\n          \"Accept\": \"application/json\",\n          ...(body ? { \"Content-Type\": \"application/json\" } : {}),\n          ...(token ? { \"Authorization\": `Bearer ${token}` } : {}),\n        },\n        ...(body ? { body: JSON.stringify(body) } : {}),\n        signal: controller.signal,\n      });\n      const text = await resp.text();\n      if (!resp.ok) {\n        throw new LastValueClientError(\n          `UNS request failed with HTTP ${resp.status}: ${text || resp.statusText}`,\n          resp.status,\n        );\n      }\n      if (!text) return {};\n      const parsed = JSON.parse(text);\n      if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n        throw new LastValueClientError(\"UNS response must be a JSON object.\");\n      }\n      return parsed as Record<string, unknown>;\n    } catch (error: any) {\n      if (error instanceof LastValueClientError) {\n        throw error;\n      }\n      if (error?.name === \"AbortError\") {\n        throw new LastValueClientError(\"UNS request timed out.\");\n      }\n      throw new LastValueClientError(`UNS request failed: ${error?.message ?? String(error)}`);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n\n  private buildUrl(endpoint: string, baseUrl?: string): string {\n    if (endpoint.startsWith(\"http://\") || endpoint.startsWith(\"https://\")) {\n      return endpoint;\n    }\n    const root = (baseUrl ?? this.apiUrl).replace(/\\/$/, \"\");\n    let path = endpoint.startsWith(\"/\") ? endpoint : `/${endpoint}`;\n    if (!baseUrl && this.apiBasePath && (path === this.apiBasePath || path.startsWith(`${this.apiBasePath}/`))) {\n      path = path.slice(this.apiBasePath.length) || \"/\";\n    }\n    return `${root}${path}`;\n  }\n\n  private stringifyQueryParams(params: Record<string, string | number | boolean>): Record<string, string> {\n    return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, String(value)]));\n  }\n\n  private static normalizeBasePath(value: string): string {\n    const stripped = value.trim();\n    if (!stripped) return \"\";\n    return stripped.startsWith(\"/\") ? stripped : `/${stripped}`;\n  }\n}\n"]}

package/dist/uns/service-metadata.d.ts

@@ -0,0 +1,53 @@
+export type UnsServiceKind = "core" | "addon" | "capability" | "service";
+export type UnsServiceApiRouteKind = "api-route" | "api-catchall" | "health" | "swagger";
+export interface UnsServiceApiRouteMetadata {
+    path: string;
+    kind?: UnsServiceApiRouteKind;
+    healthPath?: string;
+    swaggerPath?: string;
+}
+export interface UnsServiceControllerMetadata {
+    name?: string;
+    publicBase?: string;
+}
+export interface UnsServiceMetadataInput {
+    serviceId: string;
+    kind: UnsServiceKind;
+    addonId?: string;
+    label?: string;
+    description?: string;
+    capabilities?: string[];
+    apiRoutes?: UnsServiceApiRouteMetadata[];
+    healthPath?: string;
+    controller?: UnsServiceControllerMetadata;
+    instanceId?: string;
+    packageName?: string;
+    packageVersion?: string;
+    extra?: Record<string, unknown>;
+}
+export interface UnsServiceMetadata {
+    schemaVersion: 1;
+    serviceId: string;
+    kind: UnsServiceKind;
+    addonId?: string;
+    label?: string;
+    description?: string;
+    packageName: string;
+    packageVersion: string;
+    processName: string;
+    processId: string;
+    instanceId?: string;
+    capabilities: string[];
+    apiRoutes: UnsServiceApiRouteMetadata[];
+    healthPath?: string;
+    controller?: UnsServiceControllerMetadata;
+    extra?: Record<string, unknown>;
+    publishedAt: string;
+}
+export declare function buildUnsServiceMetadata(input: {
+    processName: string;
+    processId: string;
+    metadata: UnsServiceMetadataInput;
+    now?: Date;
+}): UnsServiceMetadata;
+//# sourceMappingURL=service-metadata.d.ts.map

package/dist/uns/service-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-metadata.d.ts","sourceRoot":"","sources":["../../src/uns/service-metadata.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzF,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,4BAA4B,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,4BAA4B,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AA4BD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,kBAAkB,CAqCrB"}

package/dist/uns/service-metadata.js

@@ -0,0 +1,56 @@
+import { PACKAGE_INFO } from "./process-config.js";
+function cleanOptionalString(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function cleanStringList(values) {
+    return Array.from(new Set((values ?? [])
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0)));
+}
+function cleanApiRoutes(routes) {
+    return (routes ?? [])
+        .map((route) => ({
+        ...route,
+        path: route.path.trim(),
+        healthPath: cleanOptionalString(route.healthPath),
+        swaggerPath: cleanOptionalString(route.swaggerPath),
+    }))
+        .filter((route) => route.path.length > 0);
+}
+export function buildUnsServiceMetadata(input) {
+    const serviceId = input.metadata.serviceId.trim();
+    if (!serviceId) {
+        throw new Error("Uns service metadata requires a serviceId.");
+    }
+    const packageName = cleanOptionalString(input.metadata.packageName) ?? PACKAGE_INFO.name;
+    const packageVersion = cleanOptionalString(input.metadata.packageVersion) ?? PACKAGE_INFO.version;
+    const controller = input.metadata.controller
+        ? {
+            name: cleanOptionalString(input.metadata.controller.name),
+            publicBase: cleanOptionalString(input.metadata.controller.publicBase),
+        }
+        : undefined;
+    return {
+        schemaVersion: 1,
+        serviceId,
+        kind: input.metadata.kind,
+        addonId: cleanOptionalString(input.metadata.addonId),
+        label: cleanOptionalString(input.metadata.label),
+        description: cleanOptionalString(input.metadata.description),
+        packageName,
+        packageVersion,
+        processName: input.processName,
+        processId: input.processId,
+        instanceId: cleanOptionalString(input.metadata.instanceId),
+        capabilities: cleanStringList(input.metadata.capabilities),
+        apiRoutes: cleanApiRoutes(input.metadata.apiRoutes),
+        healthPath: cleanOptionalString(input.metadata.healthPath),
+        controller: controller && (controller.name || controller.publicBase)
+            ? controller
+            : undefined,
+        extra: input.metadata.extra,
+        publishedAt: (input.now ?? new Date()).toISOString(),
+    };
+}
+//# sourceMappingURL=service-metadata.js.map

package/dist/uns/service-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-metadata.js","sourceRoot":"","sources":["../../src/uns/service-metadata.ts"],"names":[],"mappings":"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","sourcesContent":["import { PACKAGE_INFO } from \"./process-config.js\";\n\nexport type UnsServiceKind = \"core\" | \"addon\" | \"capability\" | \"service\";\n\nexport type UnsServiceApiRouteKind = \"api-route\" | \"api-catchall\" | \"health\" | \"swagger\";\n\nexport interface UnsServiceApiRouteMetadata {\n  path: string;\n  kind?: UnsServiceApiRouteKind;\n  healthPath?: string;\n  swaggerPath?: string;\n}\n\nexport interface UnsServiceControllerMetadata {\n  name?: string;\n  publicBase?: string;\n}\n\nexport interface UnsServiceMetadataInput {\n  serviceId: string;\n  kind: UnsServiceKind;\n  addonId?: string;\n  label?: string;\n  description?: string;\n  capabilities?: string[];\n  apiRoutes?: UnsServiceApiRouteMetadata[];\n  healthPath?: string;\n  controller?: UnsServiceControllerMetadata;\n  instanceId?: string;\n  packageName?: string;\n  packageVersion?: string;\n  extra?: Record<string, unknown>;\n}\n\nexport interface UnsServiceMetadata {\n  schemaVersion: 1;\n  serviceId: string;\n  kind: UnsServiceKind;\n  addonId?: string;\n  label?: string;\n  description?: string;\n  packageName: string;\n  packageVersion: string;\n  processName: string;\n  processId: string;\n  instanceId?: string;\n  capabilities: string[];\n  apiRoutes: UnsServiceApiRouteMetadata[];\n  healthPath?: string;\n  controller?: UnsServiceControllerMetadata;\n  extra?: Record<string, unknown>;\n  publishedAt: string;\n}\n\nfunction cleanOptionalString(value: string | undefined): string | undefined {\n  const trimmed = value?.trim();\n  return trimmed ? trimmed : undefined;\n}\n\nfunction cleanStringList(values: string[] | undefined): string[] {\n  return Array.from(\n    new Set(\n      (values ?? [])\n        .map((value) => value.trim())\n        .filter((value) => value.length > 0),\n    ),\n  );\n}\n\nfunction cleanApiRoutes(routes: UnsServiceApiRouteMetadata[] | undefined): UnsServiceApiRouteMetadata[] {\n  return (routes ?? [])\n    .map((route) => ({\n      ...route,\n      path: route.path.trim(),\n      healthPath: cleanOptionalString(route.healthPath),\n      swaggerPath: cleanOptionalString(route.swaggerPath),\n    }))\n    .filter((route) => route.path.length > 0);\n}\n\nexport function buildUnsServiceMetadata(input: {\n  processName: string;\n  processId: string;\n  metadata: UnsServiceMetadataInput;\n  now?: Date;\n}): UnsServiceMetadata {\n  const serviceId = input.metadata.serviceId.trim();\n  if (!serviceId) {\n    throw new Error(\"Uns service metadata requires a serviceId.\");\n  }\n\n  const packageName = cleanOptionalString(input.metadata.packageName) ?? PACKAGE_INFO.name;\n  const packageVersion = cleanOptionalString(input.metadata.packageVersion) ?? PACKAGE_INFO.version;\n  const controller = input.metadata.controller\n    ? {\n      name: cleanOptionalString(input.metadata.controller.name),\n      publicBase: cleanOptionalString(input.metadata.controller.publicBase),\n    }\n    : undefined;\n\n  return {\n    schemaVersion: 1,\n    serviceId,\n    kind: input.metadata.kind,\n    addonId: cleanOptionalString(input.metadata.addonId),\n    label: cleanOptionalString(input.metadata.label),\n    description: cleanOptionalString(input.metadata.description),\n    packageName,\n    packageVersion,\n    processName: input.processName,\n    processId: input.processId,\n    instanceId: cleanOptionalString(input.metadata.instanceId),\n    capabilities: cleanStringList(input.metadata.capabilities),\n    apiRoutes: cleanApiRoutes(input.metadata.apiRoutes),\n    healthPath: cleanOptionalString(input.metadata.healthPath),\n    controller:\n      controller && (controller.name || controller.publicBase)\n        ? controller\n        : undefined,\n    extra: input.metadata.extra,\n    publishedAt: (input.now ?? new Date()).toISOString(),\n  };\n}\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

@@ -8,6 +8,7 @@ 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;
@@ -19,6 +20,7 @@ class UnsProxyProcess {
     processMqttProxy;
     handoverManager;
     statusMonitor;
+    serviceMetadataTopic;
     // Plugin
     static pluginApiVersion = 1;
     static registered = new Set();
@@ -82,7 +84,9 @@ class UnsProxyProcess {
         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,
@@ -173,6 +177,23 @@ class UnsProxyProcess {
             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.

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\";\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\";\nimport {\n  buildUnsServiceMetadata,\n  type UnsServiceMetadata,\n  type UnsServiceMetadataInput,\n} from \"./service-metadata.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  private serviceMetadataTopic: string;\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    const serviceMetadataTopic = topicBuilder.getServiceMetadataTopic();\n\n    this.processStatusTopic = processStatusTopic;\n    this.serviceMetadataTopic = serviceMetadataTopic;\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   * Publishes retained product/system service metadata for controller discovery.\n   *\n   * The payload is intentionally separate from the volatile active/alive status\n   * topics. Controllers can combine this retained identity/capability metadata\n   * with live process status to decide whether a service is currently healthy.\n   */\n  public async publishServiceMetadata(metadata: UnsServiceMetadataInput): Promise<UnsServiceMetadata> {\n    await this.waitForProcessConnection();\n    const resolved = buildUnsServiceMetadata({\n      processName: this.processName,\n      processId: this.processId,\n      metadata,\n    });\n    await this.processMqttProxy.publish(\n      this.serviceMetadataTopic,\n      JSON.stringify(resolved),\n      { retain: true },\n    );\n    return resolved;\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 type { UnsServiceMetadata, UnsServiceMetadataInput };\nexport { UnsProxyProcess };\n"]}

package/dist/uns-mqtt/mqtt-topic-builder.d.ts

@@ -38,6 +38,12 @@ export declare class MqttTopicBuilder {
      * Example: "uns-infra/packageName/version/processName/handover"
      */
     getHandoverTopic(): string;
+    /**
+     * Returns the retained metadata topic for product/system service discovery.
+     *
+     * Example: "uns-infra/packageName/version/processName/service-metadata"
+     */
+    getServiceMetadataTopic(): string;
     /**
      * Returns a wildcard topic for active status messages from any process.
      * Useful for subscriptions that must capture status from multiple processes.

package/dist/uns-mqtt/mqtt-topic-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mqtt-topic-builder.d.ts","sourceRoot":"","sources":["../../src/uns-mqtt/mqtt-topic-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;OAKG;gBACS,kBAAkB,EAAE,MAAM;IAQtC;;;;OAIG;WACW,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASrD;;;;OAIG;IACI,qBAAqB,IAAI,MAAM;IAItC;;;;OAIG;IACI,cAAc,IAAI,MAAM;IAI/B;;;;OAIG;IACI,gBAAgB,IAAI,MAAM;IAIjC;;;;;OAKG;IACI,sBAAsB,IAAI,MAAM;IAIvC;;;;;;;OAOG;WACW,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAO1D"}
+{"version":3,"file":"mqtt-topic-builder.d.ts","sourceRoot":"","sources":["../../src/uns-mqtt/mqtt-topic-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;OAKG;gBACS,kBAAkB,EAAE,MAAM;IAQtC;;;;OAIG;WACW,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASrD;;;;OAIG;IACI,qBAAqB,IAAI,MAAM;IAItC;;;;OAIG;IACI,cAAc,IAAI,MAAM;IAI/B;;;;OAIG;IACI,gBAAgB,IAAI,MAAM;IAIjC;;;;OAIG;IACI,uBAAuB,IAAI,MAAM;IAIxC;;;;;OAKG;IACI,sBAAsB,IAAI,MAAM;IAIvC;;;;;;;OAOG;WACW,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAO1D"}

package/dist/uns-mqtt/mqtt-topic-builder.js

@@ -56,6 +56,14 @@ export class MqttTopicBuilder {
     getHandoverTopic() {
         return this.getProcessStatusTopic() + "handover";
     }
+    /**
+     * Returns the retained metadata topic for product/system service discovery.
+     *
+     * Example: "uns-infra/packageName/version/processName/service-metadata"
+     */
+    getServiceMetadataTopic() {
+        return this.getProcessStatusTopic() + "service-metadata";
+    }
     /**
      * Returns a wildcard topic for active status messages from any process.
      * Useful for subscriptions that must capture status from multiple processes.

package/dist/uns-mqtt/mqtt-topic-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"mqtt-topic-builder.js","sourceRoot":"","sources":["../../src/uns-mqtt/mqtt-topic-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACjB,kBAAkB,CAAS;IAEnC;;;;;OAKG;IACH,YAAY,kBAA0B;QAEpC,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;QACnH,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,iBAAiB,CAAC,IAAY;QAC1C,MAAM,SAAS,GAAG,IAAI;aACnB,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;aAChC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;aACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAE3B,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IAC1D,CAAC;IAAA,CAAC;IAEF;;;;OAIG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,cAAc;QACnB,OAAO,IAAI,CAAC,qBAAqB,EAAE,GAAG,QAAQ,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,qBAAqB,EAAE,GAAG,UAAU,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,sBAAsB;QAC3B,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC;IACvF,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,gBAAgB,CAAC,SAAiB;QAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;QACxG,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,CAAC;CACF","sourcesContent":["/**\n * MqttTopicBuilder is a utility class responsible for generating MQTT topics\n * based on a standardized pattern using the package name, version, and process name.\n *\n * This centralizes all MQTT topic definitions so that changes to topic structures\n * only need to be made in one place.\n */\nexport class MqttTopicBuilder {\n    private processStatusTopic: string;\n\n    /**\n     * Constructor for MqttTopicBuilder.\n     * It validates the provided process status topic and initializes the instance.\n     * @param processStatusTopic The base topic for the process status.\n     * Example: \"uns-infra/packageName/version/processName/\"\n     */\n    constructor(processStatusTopic: string) {\n      \n      if (!/^uns-infra\\/[^/]+\\/[^/]+\\/[^/]+\\/$/.test(processStatusTopic)) {\n        throw new Error(\"processStatusTopic must follow the pattern 'uns-infra/<packageName>/<version>/<processName>/'\");\n      }\n      this.processStatusTopic = processStatusTopic;\n    }\n\n    /**\n     * Sanitize topic\n     * @param name \n     * @returns \n     */\n    public static sanitizeTopicPart(name: string): string {\n      const sanitized = name\n        .replace(/[^a-zA-Z0-9_-]+/g, \"-\")\n        .replace(/-{2,}/g, \"-\")\n        .replace(/^-+|-+$/g, \"\");\n\n      return sanitized.length > 0 ? sanitized : \"uns-process\";\n    };    \n  \n    /**\n     * Returns the process status topic.\n     *\n     * Example: \"uns-infra/packageName/version/processName\"\n     */\n    public getProcessStatusTopic(): string {\n      return this.processStatusTopic;\n    }\n  \n    /**\n     * Returns the topic used for publishing the active state.\n     *\n     * Example: \"uns-infra/packageName/version/processName/active\"\n     */\n    public getActiveTopic(): string {\n      return this.getProcessStatusTopic() + \"active\";\n    }\n  \n    /**\n     * Returns the topic used for handover requests.\n     *\n     * Example: \"uns-infra/packageName/version/processName/handover\"\n     */\n    public getHandoverTopic(): string {\n      return this.getProcessStatusTopic() + \"handover\";\n    }\n    \n    /**\n     * Returns a wildcard topic for active status messages from any process.\n     * Useful for subscriptions that must capture status from multiple processes.\n     *\n     * Example: \"uns-infra/packageName/+/+/active\"\n     */\n    public getWildcardActiveTopic(): string {\n      return this.getProcessStatusTopic().split('/').slice(0, 2).join('/') + '/+/+/active';\n    }\n\n    /**\n     * Extract base topic from a full topic string.\n     * This is useful for creating a topic builder from an existing topic.\n     * @param fullTopic The full topic string.\n     * Example: \"uns-infra/packageName/version/processName/active\"\n     * @returns The base topic string.\n     * Example: \"uns-infra/packageName/version/processName/\"\n     */\n    public static extractBaseTopic(fullTopic: string): string {\n      const parts = fullTopic.split('/');\n      if (parts.length < 4) {\n        throw new Error(\"Invalid topic format. Expected 'uns-infra/<packageName>/<version>/<processName>/'.\");\n      }\n      return parts.slice(0, 4).join('/') + '/';\n    }\n  }\n  "]}
+{"version":3,"file":"mqtt-topic-builder.js","sourceRoot":"","sources":["../../src/uns-mqtt/mqtt-topic-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACjB,kBAAkB,CAAS;IAEnC;;;;;OAKG;IACH,YAAY,kBAA0B;QAEpC,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;QACnH,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,iBAAiB,CAAC,IAAY;QAC1C,MAAM,SAAS,GAAG,IAAI;aACnB,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;aAChC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;aACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAE3B,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IAC1D,CAAC;IAAA,CAAC;IAEF;;;;OAIG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,cAAc;QACnB,OAAO,IAAI,CAAC,qBAAqB,EAAE,GAAG,QAAQ,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,qBAAqB,EAAE,GAAG,UAAU,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,uBAAuB;QAC5B,OAAO,IAAI,CAAC,qBAAqB,EAAE,GAAG,kBAAkB,CAAC;IAC3D,CAAC;IAED;;;;;OAKG;IACI,sBAAsB;QAC3B,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC;IACvF,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,gBAAgB,CAAC,SAAiB;QAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;QACxG,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,CAAC;CACF","sourcesContent":["/**\n * MqttTopicBuilder is a utility class responsible for generating MQTT topics\n * based on a standardized pattern using the package name, version, and process name.\n *\n * This centralizes all MQTT topic definitions so that changes to topic structures\n * only need to be made in one place.\n */\nexport class MqttTopicBuilder {\n    private processStatusTopic: string;\n\n    /**\n     * Constructor for MqttTopicBuilder.\n     * It validates the provided process status topic and initializes the instance.\n     * @param processStatusTopic The base topic for the process status.\n     * Example: \"uns-infra/packageName/version/processName/\"\n     */\n    constructor(processStatusTopic: string) {\n      \n      if (!/^uns-infra\\/[^/]+\\/[^/]+\\/[^/]+\\/$/.test(processStatusTopic)) {\n        throw new Error(\"processStatusTopic must follow the pattern 'uns-infra/<packageName>/<version>/<processName>/'\");\n      }\n      this.processStatusTopic = processStatusTopic;\n    }\n\n    /**\n     * Sanitize topic\n     * @param name \n     * @returns \n     */\n    public static sanitizeTopicPart(name: string): string {\n      const sanitized = name\n        .replace(/[^a-zA-Z0-9_-]+/g, \"-\")\n        .replace(/-{2,}/g, \"-\")\n        .replace(/^-+|-+$/g, \"\");\n\n      return sanitized.length > 0 ? sanitized : \"uns-process\";\n    };    \n  \n    /**\n     * Returns the process status topic.\n     *\n     * Example: \"uns-infra/packageName/version/processName\"\n     */\n    public getProcessStatusTopic(): string {\n      return this.processStatusTopic;\n    }\n  \n    /**\n     * Returns the topic used for publishing the active state.\n     *\n     * Example: \"uns-infra/packageName/version/processName/active\"\n     */\n    public getActiveTopic(): string {\n      return this.getProcessStatusTopic() + \"active\";\n    }\n  \n    /**\n     * Returns the topic used for handover requests.\n     *\n     * Example: \"uns-infra/packageName/version/processName/handover\"\n     */\n    public getHandoverTopic(): string {\n      return this.getProcessStatusTopic() + \"handover\";\n    }\n\n    /**\n     * Returns the retained metadata topic for product/system service discovery.\n     *\n     * Example: \"uns-infra/packageName/version/processName/service-metadata\"\n     */\n    public getServiceMetadataTopic(): string {\n      return this.getProcessStatusTopic() + \"service-metadata\";\n    }\n    \n    /**\n     * Returns a wildcard topic for active status messages from any process.\n     * Useful for subscriptions that must capture status from multiple processes.\n     *\n     * Example: \"uns-infra/packageName/+/+/active\"\n     */\n    public getWildcardActiveTopic(): string {\n      return this.getProcessStatusTopic().split('/').slice(0, 2).join('/') + '/+/+/active';\n    }\n\n    /**\n     * Extract base topic from a full topic string.\n     * This is useful for creating a topic builder from an existing topic.\n     * @param fullTopic The full topic string.\n     * Example: \"uns-infra/packageName/version/processName/active\"\n     * @returns The base topic string.\n     * Example: \"uns-infra/packageName/version/processName/\"\n     */\n    public static extractBaseTopic(fullTopic: string): string {\n      const parts = fullTopic.split('/');\n      if (parts.length < 4) {\n        throw new Error(\"Invalid topic format. Expected 'uns-infra/<packageName>/<version>/<processName>/'.\");\n      }\n      return parts.slice(0, 4).join('/') + '/';\n    }\n  }\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uns-kit/core",
-  "version": "2.0.39",
+  "version": "2.0.41",
   "description": "Core utilities and runtime building blocks for UNS-based realtime transformers.",
   "type": "module",
   "license": "MIT",