@uns-kit/core 3.0.21 → 3.0.23

package/MIGRATIONS.md

@@ -9,6 +9,50 @@ Agents must inspect the application's existing ownership and shutdown flow
 before editing it. The examples below describe the intended behavior, not a
 mechanical search-and-replace operation.
 
+## 3.0.23 - Application drain on handover
+
+Applications upgrading from `<3.0.23` to `>=3.0.23` may register
+`handoverShutdown: { onRelease, drain, timeoutMs }` in `UnsProxyProcess`
+construction, before creating MQTT proxies. `onRelease` runs synchronously when
+an active source accepts a handover: stop admitting new background work, but
+continue handling already accepted MQTT input while subscriber queues drain.
+`drain` runs after the target's acknowledgement and source proxy stops. Await
+accepted application writes, durable spills and replay checkpoints, then close
+writers. Do not call `process.exit` inside either hook. Share an idempotent drain
+with SIGINT/SIGTERM cleanup; signal cleanup remains application-owned.
+
+The source exits with status 0 only when its remaining proxy stops and drain
+finish. A rejected hook or deadline exits with status 1 and a generic diagnostic,
+without logging hook error text. The default deadline after acknowledgement is
+30 seconds; a registered timeout may be 1 to 300000 ms. Timeout does not cancel
+IO or guarantee all writes were saved. Persist recoverable work before relying
+on this hook and review pending files after an incomplete drain.
+
+Duplicate acknowledgements share one drain. Unsolicited acknowledgements and
+acknowledgements from a different peer do not exit the process. MQTT wire
+messages are unchanged, so an old source still uses its old immediate exit:
+upgrading only the target cannot retrofit the source hook. `handover_fin` and
+`handover_ack` confirm MQTT ownership transfer, not application drain or a safe
+legacy-directory import. Wait for source process exit separately. This change
+does not add exactly-once semantics or controller fencing.
+
+## 3.0.22 - Safe API request correlation
+
+When upgrading `@uns-kit/api` from `<3.0.22` to `>=3.0.22`, its generic request
+log no longer records raw URLs or email claims decoded from an unverified JWT.
+It logs a server-generated `requestId`, HTTP method, completion status and
+elapsed time. Incoming `x-request-id` values are not reused. The response
+`x-request-id` and request property `Symbol.for("uns.http.request-id")` identify
+the same server-local request; authenticated application handlers may reuse that
+property for downstream query diagnostics. The public `@uns-kit/api/request-log.js`
+module exports `SAFE_REQUEST_LOGGING_VERSION = 1` so privacy-sensitive applications
+can require the safe middleware before opening HTTP listeners.
+
+If an application's diagnostic logic relied on the old `user` or `endpoint`
+log fields, migrate it to operation labels and caller IDs extracted **after**
+signature verification. Do not restore URL/topic/body/credential logging or trust
+identity headers. API response payloads and authorization behavior are unchanged.
+
 ## 3.0.21 - Explicit publisher topic reconciliation
 
 Applications upgrading from `<3.0.21` to `>=3.0.21` can opt into

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 type { HandoverShutdownHooks } from "./uns/handover-shutdown.js";
 export * from "./uns/service-metadata.js";
 export { ConfigFile } from "./config-file.js";
 export { default as logger } 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,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,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACzF,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,gCAAgC,EAChC,wCAAwC,EACxC,wCAAwC,GACzC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,iDAAiD,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,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,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,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACzF,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,gCAAgC,EAChC,wCAAwC,EACxC,wCAAwC,GACzC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,iDAAiD,CAAC"}

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,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,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAgB3C,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,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 { mqttChannelParameters, resolveMqttChannel } from \"./uns-config/mqtt-channel.js\";\nexport type { MqttChannelConfig, ResolvedMqttChannel } from \"./uns-config/mqtt-channel.js\";\nexport { AuthClient, ServiceTokenProvider } from \"./tools/auth/index.js\";\nexport type { AccessTokenProvider, ServiceTokenProviderOptions } from \"./tools/auth/index.js\";\nexport {\n  UnsClient,\n  LastValueResult,\n  ClientError,\n  RangeResult,\n  BatchRangeTopicResult,\n  BatchRangeResponse,\n} from \"./tools/datahub/datahub-client.js\";\nexport type {\n  LastValuePayload,\n  CatchAllTimeField,\n  CatchAllAggregate,\n  RangeQueryOptions,\n  RangeColumn,\n  RangeStats,\n  RangePayload,\n  BatchRangeTopicPayload,\n  BatchRangeResponsePayload,\n  ProviderAssetIdentity,\n  AssetIdentityPublicationMetadata,\n  AssetProviderIdentityPublicationMetadata,\n  AssetIdentityPublicationEvidenceMetadata,\n} from \"./tools/datahub/datahub-client.js\";\nexport { registerService } from \"./tools/datahub/runtime-service-registration.js\";\nexport type {\n  RegisterServiceOptions,\n  RuntimeServiceDescriptor,\n  RuntimeServiceRegistration,\n  RuntimeServiceRegistrationClient,\n} from \"./tools/datahub/runtime-service-registration.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;AAExC,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,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAgB3C,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,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 type { HandoverShutdownHooks } from \"./uns/handover-shutdown.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 { mqttChannelParameters, resolveMqttChannel } from \"./uns-config/mqtt-channel.js\";\nexport type { MqttChannelConfig, ResolvedMqttChannel } from \"./uns-config/mqtt-channel.js\";\nexport { AuthClient, ServiceTokenProvider } from \"./tools/auth/index.js\";\nexport type { AccessTokenProvider, ServiceTokenProviderOptions } from \"./tools/auth/index.js\";\nexport {\n  UnsClient,\n  LastValueResult,\n  ClientError,\n  RangeResult,\n  BatchRangeTopicResult,\n  BatchRangeResponse,\n} from \"./tools/datahub/datahub-client.js\";\nexport type {\n  LastValuePayload,\n  CatchAllTimeField,\n  CatchAllAggregate,\n  RangeQueryOptions,\n  RangeColumn,\n  RangeStats,\n  RangePayload,\n  BatchRangeTopicPayload,\n  BatchRangeResponsePayload,\n  ProviderAssetIdentity,\n  AssetIdentityPublicationMetadata,\n  AssetProviderIdentityPublicationMetadata,\n  AssetIdentityPublicationEvidenceMetadata,\n} from \"./tools/datahub/datahub-client.js\";\nexport { registerService } from \"./tools/datahub/runtime-service-registration.js\";\nexport type {\n  RegisterServiceOptions,\n  RuntimeServiceDescriptor,\n  RuntimeServiceRegistration,\n  RuntimeServiceRegistrationClient,\n} from \"./tools/datahub/runtime-service-registration.js\";\n"]}

package/dist/uns/handover-manager.d.ts

@@ -1,3 +1,4 @@
+import { type HandoverShutdownHooks } from "./handover-shutdown.js";
 import { HandoverManagerEvents } from "../uns-mqtt/mqtt-interfaces.js";
 import MqttProxy from "../uns-mqtt/mqtt-proxy.js";
 import UnsMqttProxy from "../uns-mqtt/uns-mqtt-proxy.js";
@@ -21,10 +22,14 @@ export declare class HandoverManager {
     private readonly handoverId;
     private acceptedHandoverId;
     private active;
+    private sourcePeerId;
+    private sourcePreparation;
+    private sourceExit;
+    private readonly shutdownHooks;
     handoverRequestEnabled: boolean;
     handoverEnabled: boolean;
     forceStartEnabled: boolean;
-    constructor(processName: string, processId: string, mqttProxy: MqttProxy, unsMqttProxies: UnsMqttProxy[], handoverRequestEnabled: boolean, handoverEnabled: boolean, forceStartEnabled: boolean, handoverId?: string);
+    constructor(processName: string, processId: string, mqttProxy: MqttProxy, unsMqttProxies: UnsMqttProxy[], handoverRequestEnabled: boolean, handoverEnabled: boolean, forceStartEnabled: boolean, handoverId?: string, shutdownHooks?: HandoverShutdownHooks);
     private getUserProperties;
     private handoverPayload;
     private getHandoverId;
@@ -40,6 +45,9 @@ export declare class HandoverManager {
     /**
      * Handles handovers.
      */
+    private exitSource;
+    private prepareSourceHandover;
+    private finishSourceHandover;
     private handleHandover;
 }
 //# sourceMappingURL=handover-manager.d.ts.map

package/dist/uns/handover-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handover-manager.d.ts","sourceRoot":"","sources":["../../src/uns/handover-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,SAAS,MAAM,2BAA2B,CAAC;AAElD,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAQhD;;;;GAIG;AACH,qBAAa,eAAe;IACnB,KAAK,EAAE,2BAA2B,CAAC,qBAAqB,CAAC,CAA4D;IAC5H,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,MAAM,CAAkB;IACzB,sBAAsB,EAAE,OAAO,CAAS;IACxC,eAAe,EAAE,OAAO,CAAQ;IAChC,iBAAiB,EAAE,OAAO,CAAS;gBAGxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,YAAY,EAAE,EAC9B,sBAAsB,EAAE,OAAO,EAC/B,eAAe,EAAE,OAAO,EACxB,iBAAiB,EAAE,OAAO,EAC1B,UAAU,CAAC,EAAE,MAAM;IA+BrB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,oBAAoB;IAU5B;;;OAGG;IACU,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoFxE;;OAEG;YACW,cAAc;CAsI7B"}
+{"version":3,"file":"handover-manager.d.ts","sourceRoot":"","sources":["../../src/uns/handover-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAiD,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,SAAS,MAAM,2BAA2B,CAAC;AAElD,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAQhD;;;;GAIG;AACH,qBAAa,eAAe;IACnB,KAAK,EAAE,2BAA2B,CAAC,qBAAqB,CAAC,CAA4D;IAC5H,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAC3D,sBAAsB,EAAE,OAAO,CAAS;IACxC,eAAe,EAAE,OAAO,CAAQ;IAChC,iBAAiB,EAAE,OAAO,CAAS;gBAGxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,YAAY,EAAE,EAC9B,sBAAsB,EAAE,OAAO,EAC/B,eAAe,EAAE,OAAO,EACxB,iBAAiB,EAAE,OAAO,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,qBAAqB;IAiCvC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,oBAAoB;IAU5B;;;OAGG;IACU,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoFxE;;OAEG;IACH,OAAO,CAAC,UAAU;YAIJ,qBAAqB;YA6DrB,oBAAoB;YAiBpB,cAAc;CA2F7B"}

package/dist/uns/handover-manager.js

@@ -1,4 +1,5 @@
 import logger from "../logger.js";
+import { runHandoverShutdown, validateHandoverShutdown } from "./handover-shutdown.js";
 import { MqttTopicBuilder } from "../uns-mqtt/mqtt-topic-builder.js";
 import { HandoverManagerEventEmitter } from "./handover-manager-event-emitter.js";
 import { ACTIVE_TIMEOUT, PACKAGE_INFO } from "./process-config.js";
@@ -26,10 +27,16 @@ export class HandoverManager {
     handoverId;
     acceptedHandoverId;
     active = false;
+    sourcePeerId;
+    sourcePreparation;
+    sourceExit;
+    shutdownHooks;
     handoverRequestEnabled = false;
     handoverEnabled = true;
     forceStartEnabled = false;
-    constructor(processName, processId, mqttProxy, unsMqttProxies, handoverRequestEnabled, handoverEnabled, forceStartEnabled, handoverId) {
+    constructor(processName, processId, mqttProxy, unsMqttProxies, handoverRequestEnabled, handoverEnabled, forceStartEnabled, handoverId, shutdownHooks) {
+        validateHandoverShutdown(shutdownHooks);
+        this.shutdownHooks = shutdownHooks ? { ...shutdownHooks } : undefined;
         this.processName = processName;
         this.processId = processId;
         this.mqttProxy = mqttProxy;
@@ -211,61 +218,102 @@ export class HandoverManager {
     /**
      * Handles handovers.
      */
+    exitSource(code) {
+        process.exit(code);
+    }
+    async prepareSourceHandover(response, event) {
+        const handoverId = this.getHandoverId(response, event);
+        logger.info(`${this.processName} - Received handover request from ${event.packet?.properties?.userProperties?.processName}. Accepting handover.`);
+        this.active = false;
+        this.event.emit("handoverManager", { active: false });
+        this.shutdownHooks?.onRelease?.();
+        // Set all UNS proxy instance subscribers to passive and drain the queue.
+        const mqttWorkerData = [];
+        for (let i = 0; i < this.unsMqttProxies.length; i++) {
+            const unsProxy = this.unsMqttProxies[i];
+            const workerData = await unsProxy.setSubscriberPassiveAndDrainQueue();
+            mqttWorkerData.push(workerData);
+        }
+        logger.info(`${this.processName} - Handover request accepted. Sending handover_subscriber messages.`);
+        // Publish handover_subscriber messages for each instance that has processed some data.
+        for (let i = 0; i < mqttWorkerData.length; i++) {
+            const workerData = mqttWorkerData[i];
+            if (workerData.batchSize > 0) {
+                await this.mqttProxy.publish(event.packet.properties?.responseTopic ?? "", this.handoverPayload("handover_subscriber", handoverId, {
+                    batchSize: workerData.batchSize,
+                    referenceHash: workerData.referenceHash,
+                    instanceName: workerData.instanceName,
+                }), {
+                    retain: false,
+                    properties: {
+                        responseTopic: this.topicBuilder.getHandoverTopic(),
+                        userProperties: this.getUserProperties(handoverId),
+                    },
+                });
+            }
+        }
+        logger.info(`${this.processName} - Handover subscriber messages sent.`);
+        // Publish a single handover acknowledgment only when all
+        // handover_subscriber messages have been sent
+        await this.mqttProxy.publish(event.packet.properties?.responseTopic ?? "", this.handoverPayload("handover_fin", handoverId), {
+            retain: false,
+            properties: {
+                responseTopic: this.topicBuilder.getHandoverTopic(),
+                userProperties: this.getUserProperties(handoverId),
+            },
+        });
+        logger.info(`${this.processName} - Handover fin message sent.`);
+        await Promise.all(this.unsMqttProxies.map((unsProxy) => unsProxy.stop()));
+    }
+    async finishSourceHandover() {
+        const result = await runHandoverShutdown(async () => {
+            await this.sourcePreparation;
+            await this.shutdownHooks?.drain();
+        }, this.shutdownHooks?.timeoutMs ?? 30_000);
+        this.handoverInProgress = false;
+        this.requestingHandover = false;
+        if (result === "completed") {
+            logger.info(`${this.processName} - Handover source drain completed. Exiting process.`);
+            this.exitSource(0);
+        }
+        else {
+            // Do not log application error text: it may contain paths, topics or credentials.
+            logger.error(`${this.processName} - Handover source drain ${result}. Exiting with incomplete drain.`);
+            this.exitSource(1);
+        }
+    }
     async handleHandover(event) {
         try {
             const response = JSON.parse(event.message.toString());
             // Responder process
             // Check if the message is a handover request and publish MULTIPLE handover_subscriber messages
             if (response.type === "handover_request") {
-                const handoverId = this.getHandoverId(response, event);
-                this.acceptedHandoverId = handoverId;
-                logger.info(`${this.processName} - Received handover request from ${event.packet?.properties?.userProperties?.processName}. Accepting handover.`);
-                // Set all UNS proxy instance subscribers to passive and drain the queue.
-                const mqttWorkerData = [];
-                for (let i = 0; i < this.unsMqttProxies.length; i++) {
-                    const unsProxy = this.unsMqttProxies[i];
-                    const workerData = await unsProxy.setSubscriberPassiveAndDrainQueue();
-                    mqttWorkerData.push(workerData);
+                const peerId = this.getSourceProcessId(event);
+                const replyTopic = event.packet?.properties?.responseTopic;
+                if (this.sourcePeerId || !this.active || !peerId || typeof replyTopic !== "string" || !replyTopic)
+                    return;
+                this.sourcePeerId = peerId;
+                this.acceptedHandoverId = this.getHandoverId(response, event);
+                this.handoverInProgress = true;
+                clearTimeout(this.activeTimeout);
+                this.activeTimeout = undefined;
+                this.sourcePreparation = this.prepareSourceHandover(response, event);
+                try {
+                    await this.sourcePreparation;
                 }
-                logger.info(`${this.processName} - Handover request accepted. Sending handover_subscriber messages.`);
-                // Publish handover_subscriber messages for each instance that has processed some data.
-                for (let i = 0; i < mqttWorkerData.length; i++) {
-                    const workerData = mqttWorkerData[i];
-                    if (workerData.batchSize > 0) {
-                        await this.mqttProxy.publish(event.packet.properties?.responseTopic ?? "", this.handoverPayload("handover_subscriber", handoverId, {
-                            batchSize: workerData.batchSize,
-                            referenceHash: workerData.referenceHash,
-                            instanceName: workerData.instanceName,
-                        }), {
-                            retain: false,
-                            properties: {
-                                responseTopic: this.topicBuilder.getHandoverTopic(),
-                                userProperties: this.getUserProperties(handoverId),
-                            },
-                        });
-                    }
+                catch {
+                    // Subscriber transfer or onRelease failed; never report successful source completion.
+                    logger.error(`${this.processName} - Handover source preparation failed. Exiting with incomplete drain.`);
+                    if (!this.sourceExit)
+                        this.exitSource(1);
                 }
-                logger.info(`${this.processName} - Handover subscriber messages sent.`);
-                // Publish a single handover acknowledgment only when all
-                // handover_subscriber messages have been sent
-                this.active = false;
-                this.event.emit("handoverManager", { active: this.active });
-                await this.mqttProxy.publish(event.packet.properties?.responseTopic ?? "", this.handoverPayload("handover_fin", handoverId), {
-                    retain: false,
-                    properties: {
-                        responseTopic: this.topicBuilder.getHandoverTopic(),
-                        userProperties: this.getUserProperties(handoverId),
-                    },
-                });
-                logger.info(`${this.processName} - Handover fin message sent.`);
-                this.handoverInProgress = false;
-                this.requestingHandover = false;
-                await Promise.all(this.unsMqttProxies.map((unsProxy) => unsProxy.stop()));
             }
             // Requestor process
             // Check if the message is one of the handover_subscriber message in response to handover_request
             // and publish a handover_ack message
             if (response.type === "handover_subscriber") {
+                if (this.sourcePeerId)
+                    return;
                 if (!this.acceptsHandoverResponse(this.getHandoverId(response, event)))
                     return;
                 // Find correct unsProxy instance for handover_subscriber and set it active
@@ -278,6 +326,8 @@ export class HandoverManager {
             // Requestor process
             // Check if the message is a handover_fin at the end of handover_subscriber messages
             if (response.type === "handover_fin") {
+                if (this.sourcePeerId)
+                    return;
                 const handoverId = this.getHandoverId(response, event);
                 if (!this.acceptsHandoverResponse(handoverId))
                     return;
@@ -306,16 +356,16 @@ export class HandoverManager {
             // Responder process
             // Check if the message is a handover_ack at the end of handover_fin messages
             if (response.type === "handover_ack") {
+                if (!this.sourcePreparation || this.getSourceProcessId(event) !== this.sourcePeerId)
+                    return;
                 const handoverId = this.getHandoverId(response, event);
                 if (this.acceptedHandoverId && handoverId && this.acceptedHandoverId !== handoverId) {
                     logger.warn(`${this.processName} - Ignoring acknowledgement for another migration.`);
                     return;
                 }
                 logger.info(`${this.processName} - Received handover ack from ${event.packet?.properties?.userProperties?.processName}.`);
-                this.handoverInProgress = false;
-                this.requestingHandover = false;
-                logger.info(`${this.processName} - Handover completed. Exiting process.`);
-                process.exit(0);
+                this.sourceExit ??= this.finishSourceHandover();
+                await this.sourceExit;
             }
         }
         catch (error) {

package/dist/uns/handover-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"handover-manager.js","sourceRoot":"","sources":["../../src/uns/handover-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import logger from \"../logger.js\";\nimport { HandoverManagerEvents } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport MqttProxy from \"../uns-mqtt/mqtt-proxy.js\";\nimport { MqttTopicBuilder } from \"../uns-mqtt/mqtt-topic-builder.js\";\nimport UnsMqttProxy from \"../uns-mqtt/uns-mqtt-proxy.js\";\nimport { HandoverManagerEventEmitter } from \"./handover-manager-event-emitter.js\";\nimport { ACTIVE_TIMEOUT, PACKAGE_INFO } from \"./process-config.js\";\nimport { UnsEvents } from \"./uns-interfaces.js\";\n\nfunction normalizeHandoverId(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const normalized = value.trim();\n  return normalized.length > 0 && normalized.length <= 128 ? normalized : undefined;\n}\n\n/**\n * HandoverManager is responsible for all handover-related logic,\n * including handling incoming MQTT messages, issuing handover requests,\n * and processing handover responses.\n */\nexport class HandoverManager {\n  public event: HandoverManagerEventEmitter<HandoverManagerEvents> = new HandoverManagerEventEmitter<HandoverManagerEvents>();\n  private processName: string;\n  private processId: string;\n  private mqttProxy: MqttProxy;\n  private unsMqttProxies: UnsMqttProxy[];\n  private requestingHandover: boolean = false;\n  private handoverInProgress: boolean = false;\n  private topicBuilder: MqttTopicBuilder;\n  private activeTimeout: NodeJS.Timeout | undefined;\n  private readonly handoverId: string | undefined;\n  private acceptedHandoverId: string | undefined;\n  private active: boolean = false;\n  public handoverRequestEnabled: boolean = false;\n  public handoverEnabled: boolean = true;\n  public forceStartEnabled: boolean = false;\n\n  constructor(\n    processName: string,\n    processId: string,\n    mqttProxy: MqttProxy,\n    unsMqttProxies: UnsMqttProxy[],\n    handoverRequestEnabled: boolean,\n    handoverEnabled: boolean,\n    forceStartEnabled: boolean,\n    handoverId?: string,\n  ) {\n    this.processName = processName;\n    this.processId = processId;\n    this.mqttProxy = mqttProxy;\n    this.unsMqttProxies = unsMqttProxies;\n    this.handoverRequestEnabled = handoverRequestEnabled;\n    this.handoverEnabled = handoverEnabled;\n    this.forceStartEnabled = forceStartEnabled;\n    this.handoverId = normalizeHandoverId(handoverId);\n\n    // Instantiate the topic builder.\n    const packageName = PACKAGE_INFO.name;\n    const version = PACKAGE_INFO.version;\n    this.topicBuilder = new MqttTopicBuilder(\n      `uns-infra/${MqttTopicBuilder.sanitizeTopicPart(packageName)}/${MqttTopicBuilder.sanitizeTopicPart(version)}/${MqttTopicBuilder.sanitizeTopicPart(this.processName)}/`,\n    );\n\n    // Set status as active after a timeout if no other active process are detected.\n    this.activeTimeout = setTimeout(() => {\n      logger.info(`${this.processName} - No active message received within timeout. Assuming no other process is running.`);\n      this.active = true;\n      this.event.emit(\"handoverManager\", { active: this.active });\n      // Activate all UNS proxy instance publishers and subscribers.\n      this.unsMqttProxies.forEach((unsProxy) => {\n        unsProxy.setPublisherActive();\n        unsProxy.setSubscriberActive();\n      });\n    }, ACTIVE_TIMEOUT);\n  }\n\n  private getUserProperties(handoverId?: string): Record<string, string> {\n    const properties: Record<string, string> = {\n      processName: this.processName,\n      processId: this.processId,\n    };\n    const normalized = normalizeHandoverId(handoverId ?? this.handoverId);\n    if (normalized) properties.handoverId = normalized;\n    return properties;\n  }\n\n  private handoverPayload(\n    type: string,\n    handoverId?: string,\n    fields: Record<string, unknown> = {},\n  ): string {\n    const normalized = normalizeHandoverId(handoverId ?? this.handoverId);\n    return JSON.stringify({\n      type,\n      ...fields,\n      ...(normalized ? { handoverId: normalized } : {}),\n    });\n  }\n\n  private getHandoverId(response: unknown, event: UnsEvents[\"input\"]): string | undefined {\n    const fromPayload = response && typeof response === \"object\" && !Array.isArray(response)\n      ? (response as { handoverId?: unknown }).handoverId\n      : undefined;\n    if (typeof fromPayload === \"string\") return normalizeHandoverId(fromPayload);\n    const fromProperties = event.packet?.properties?.userProperties?.handoverId;\n    return typeof fromProperties === \"string\" ? normalizeHandoverId(fromProperties) : undefined;\n  }\n\n  private acceptsHandoverResponse(receivedHandoverId: string | undefined): boolean {\n    if (!this.handoverId || !receivedHandoverId) {\n      return true;\n    }\n    if (this.handoverId === receivedHandoverId) {\n      return true;\n    }\n    logger.warn(`${this.processName} - Ignoring handover message for another migration.`);\n    return false;\n  }\n\n  private getSourceProcessId(event: UnsEvents[\"input\"]): string | undefined {\n    return event.packet?.properties?.userProperties?.processId;\n  }\n\n  private parseActiveValue(message: string): boolean | null {\n    try {\n      const parsed = JSON.parse(message);\n      const value = parsed?.message?.data?.value ?? parsed?.data?.value;\n      if (value === 1 || value === \"1\" || value === true || value === \"true\") {\n        return true;\n      }\n      if (value === 0 || value === \"0\" || value === false || value === \"false\") {\n        return false;\n      }\n      return null;\n    } catch {\n      return null;\n    }\n  }\n\n  private isProcessActiveTopic(topic: string): boolean {\n    const parts = topic.split(\"/\");\n    if (parts.length !== 5) return false;\n    const [root, pkg, , process, tail] = parts;\n    if (root !== \"uns-infra\" || tail !== \"active\") return false;\n    const expectedPackage = MqttTopicBuilder.sanitizeTopicPart(PACKAGE_INFO.name);\n    const expectedProcess = MqttTopicBuilder.sanitizeTopicPart(this.processName);\n    return pkg === expectedPackage && process === expectedProcess;\n  }\n\n  /**\n   * Main entry point for handling incoming MQTT messages.\n   * It checks the topic and delegates to the corresponding handler.\n   */\n  public async handleMqttMessage(event: UnsEvents[\"input\"]): Promise<void> {\n    try {\n      // Check if the packet is active messages from other processes and this process is not active.\n      if (this.isProcessActiveTopic(event.topic) && this.requestingHandover === false && this.active === false && this.handoverInProgress === false) {\n        const sourceProcessId = this.getSourceProcessId(event);\n        if (sourceProcessId === this.processId) {\n          return;\n        }\n        const activeValue = this.parseActiveValue(event.message.toString());\n        if (activeValue !== true) {\n          return;\n        }\n        const sourceInfo = sourceProcessId ? ` (processId=${sourceProcessId})` : \"\";\n        logger.info(`${this.processName} - Another process is active${sourceInfo} on ${event.topic}.`);\n\n        if (event.packet?.retain === true) {\n          // A retained heartbeat can belong to a process that crashed before its\n          // expiry. Wait for a fresh non-retained heartbeat before asking it to\n          // hand over; otherwise a stale retained message would block startup.\n          logger.info(`${this.processName} - Retained active heartbeat observed; waiting for a fresh heartbeat.`);\n          this.activeTimeout?.refresh();\n          return;\n        }\n\n        if (this.handoverRequestEnabled && this.handoverEnabled) {\n          // Requester process\n          // Publish a handover request message after 10 seconds to the handover topic.\n          clearTimeout(this.activeTimeout); // Clear the active timeout if it exists - prevent this process from becoming active after a timeout.\n          this.activeTimeout = undefined;\n          this.event.emit(\"handoverManager\", { active: this.active });\n          this.requestingHandover = true;\n          const eventHandoverTopic = new MqttTopicBuilder(MqttTopicBuilder.extractBaseTopic(event.topic)).getHandoverTopic();\n          await this.mqttProxy.publish(eventHandoverTopic, this.handoverPayload(\"handover_intent\"), {\n            retain: false,\n            properties: {\n              userProperties: this.getUserProperties(),\n            },\n          });\n          logger.info(`${this.processName} - Requesting handover in 10 seconds.`);\n          setTimeout(async () => {\n            logger.info(`${this.processName} - Requesting handover ${eventHandoverTopic}.`);\n            this.handoverInProgress = true;\n            await this.mqttProxy.publish(eventHandoverTopic, this.handoverPayload(\"handover_request\"), {\n              retain: false,\n              properties: {\n                responseTopic: this.topicBuilder.getHandoverTopic(),\n                userProperties: this.getUserProperties(),\n              },\n            });\n          }, 10000);\n        } else {\n          if (this.forceStartEnabled) {\n            // Force start the process even if another process is active.\n            logger.info(`${this.processName} - Force starting the process.`);\n            logger.warn(`${this.processName} - Warning: Source and destination being the same may lead to duplicate messages.`);\n            clearTimeout(this.activeTimeout); // Clear the active timeout if it exists - prevent this process from becoming active after a timeout.\n            this.activeTimeout = undefined;\n            this.active = true;\n            this.event.emit(\"handoverManager\", { active: this.active });\n            // Activate all UNS proxy instance publishers and subscribers.\n            this.unsMqttProxies.forEach((unsProxy) => {\n              unsProxy.setPublisherActive();\n              unsProxy.setSubscriberActive();\n            });\n          } else {\n            logger.info(`${this.processName} - Waiting for the other process on topic ${event.topic} to become passive.`);\n            this.activeTimeout?.refresh();\n          }\n        }\n      }\n\n      // Check if the packet is an handover message, sent to a handover topic.\n      if (event.topic === this.topicBuilder.getHandoverTopic() && this.handoverEnabled) {\n        const sourceProcessId = this.getSourceProcessId(event);\n        if (sourceProcessId !== this.processId) {\n          await this.handleHandover(event);\n        }\n      }\n    } catch (error) {\n      logger.error(`${this.processName} - Error processing MQTT message: ${error.message}`);\n      return;\n    }\n  }\n\n  /**\n   * Handles handovers.\n   */\n  private async handleHandover(event: UnsEvents[\"input\"]): Promise<void> {\n    try {\n      const response = JSON.parse(event.message.toString());\n      // Responder process\n      // Check if the message is a handover request and publish MULTIPLE handover_subscriber messages\n      if (response.type === \"handover_request\") {\n        const handoverId = this.getHandoverId(response, event);\n        this.acceptedHandoverId = handoverId;\n        logger.info(\n          `${this.processName} - Received handover request from ${event.packet?.properties?.userProperties?.processName}. Accepting handover.`,\n        );\n\n        // Set all UNS proxy instance subscribers to passive and drain the queue.\n        const mqttWorkerData: UnsEvents[\"mqttWorker\"][] = [];\n        for (let i = 0; i < this.unsMqttProxies.length; i++) {\n          const unsProxy = this.unsMqttProxies[i];\n          const workerData = await unsProxy.setSubscriberPassiveAndDrainQueue();\n          mqttWorkerData.push(workerData);\n        }\n        logger.info(`${this.processName} - Handover request accepted. Sending handover_subscriber messages.`);\n\n        // Publish handover_subscriber messages for each instance that has processed some data.\n        for (let i = 0; i < mqttWorkerData.length; i++) {\n          const workerData = mqttWorkerData[i];\n          if (workerData.batchSize > 0) {\n            await this.mqttProxy.publish(\n              event.packet.properties?.responseTopic ?? \"\",\n              this.handoverPayload(\"handover_subscriber\", handoverId, {\n                batchSize: workerData.batchSize,\n                referenceHash: workerData.referenceHash,\n                instanceName: workerData.instanceName,\n              }),\n              {\n                retain: false,\n                properties: {\n                  responseTopic: this.topicBuilder.getHandoverTopic(),\n                  userProperties: this.getUserProperties(handoverId),\n                },\n              },\n            );\n          }\n        }\n        logger.info(`${this.processName} - Handover subscriber messages sent.`);\n\n        // Publish a single handover acknowledgment only when all\n        // handover_subscriber messages have been sent\n        this.active = false;\n        this.event.emit(\"handoverManager\", { active: this.active });\n        await this.mqttProxy.publish(\n          event.packet.properties?.responseTopic ?? \"\",\n          this.handoverPayload(\"handover_fin\", handoverId),\n          {\n            retain: false,\n            properties: {\n              responseTopic: this.topicBuilder.getHandoverTopic(),\n              userProperties: this.getUserProperties(handoverId),\n            },\n          },\n        );\n        logger.info(`${this.processName} - Handover fin message sent.`);\n\n        this.handoverInProgress = false;\n        this.requestingHandover = false;\n\n        await Promise.all(this.unsMqttProxies.map((unsProxy: UnsMqttProxy) => unsProxy.stop()));\n      }\n\n      // Requestor process\n      // Check if the message is one of the handover_subscriber message in response to handover_request\n      // and publish a handover_ack message\n      if (response.type === \"handover_subscriber\") {\n        if (!this.acceptsHandoverResponse(this.getHandoverId(response, event))) return;\n        // Find correct unsProxy instance for handover_subscriber and set it active\n        this.unsMqttProxies.forEach((unsProxy: UnsMqttProxy) => {\n          if (unsProxy.instanceName === response.instanceName) {\n            unsProxy.setSubscriberActive(response.batchSize, response.referenceHash);\n          }\n        });\n      }\n\n      // Requestor process\n      // Check if the message is a handover_fin at the end of handover_subscriber messages\n      if (response.type === \"handover_fin\") {\n        const handoverId = this.getHandoverId(response, event);\n        if (!this.acceptsHandoverResponse(handoverId)) return;\n        logger.info(`${this.processName} - Received handover fin from ${event.packet?.properties?.userProperties?.processName}.`);\n\n        // Maybe we should count the number of requests that were allrady made TODO\n        // this.handoverInProgress = false;\n        // this.requestingHandover = false;\n\n        this.active = true;\n        this.event.emit(\"handoverManager\", { active: this.active });\n        logger.info(`${this.processName} - Handover completed.`);\n        // Activate all UNS proxy instance publishers and subscribers.\n        this.unsMqttProxies.forEach((unsProxy) => {\n          unsProxy.setPublisherActive();\n          unsProxy.setSubscriberActive();\n        });\n\n        // Maybe we should reply with handover_ack.\n        await this.mqttProxy.publish(\n          event.packet.properties?.responseTopic ?? \"\",\n          this.handoverPayload(\"handover_ack\", handoverId),\n          {\n            retain: false,\n            properties: {\n              responseTopic: this.topicBuilder.getHandoverTopic(),\n              userProperties: this.getUserProperties(handoverId),\n            },\n          },\n        );\n        logger.info(`${this.processName} - Handover ack message sent.`);\n      }\n\n      // Responder process\n      // Check if the message is a handover_ack at the end of handover_fin messages\n      if (response.type === \"handover_ack\") {\n        const handoverId = this.getHandoverId(response, event);\n        if (this.acceptedHandoverId && handoverId && this.acceptedHandoverId !== handoverId) {\n          logger.warn(`${this.processName} - Ignoring acknowledgement for another migration.`);\n          return;\n        }\n        logger.info(`${this.processName} - Received handover ack from ${event.packet?.properties?.userProperties?.processName}.`);\n        this.handoverInProgress = false;\n        this.requestingHandover = false;\n\n        logger.info(`${this.processName} - Handover completed. Exiting process.`);\n        process.exit(0);\n      }\n    } catch (error) {\n      logger.error(`${this.processName} - Error processing handover response: ${error.message}`);\n    }\n  }\n}\n"]}
+{"version":3,"file":"handover-manager.js","sourceRoot":"","sources":["../../src/uns/handover-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import logger from \"../logger.js\";\nimport { runHandoverShutdown, validateHandoverShutdown, type HandoverShutdownHooks } from \"./handover-shutdown.js\";\nimport { HandoverManagerEvents } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport MqttProxy from \"../uns-mqtt/mqtt-proxy.js\";\nimport { MqttTopicBuilder } from \"../uns-mqtt/mqtt-topic-builder.js\";\nimport UnsMqttProxy from \"../uns-mqtt/uns-mqtt-proxy.js\";\nimport { HandoverManagerEventEmitter } from \"./handover-manager-event-emitter.js\";\nimport { ACTIVE_TIMEOUT, PACKAGE_INFO } from \"./process-config.js\";\nimport { UnsEvents } from \"./uns-interfaces.js\";\n\nfunction normalizeHandoverId(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const normalized = value.trim();\n  return normalized.length > 0 && normalized.length <= 128 ? normalized : undefined;\n}\n\n/**\n * HandoverManager is responsible for all handover-related logic,\n * including handling incoming MQTT messages, issuing handover requests,\n * and processing handover responses.\n */\nexport class HandoverManager {\n  public event: HandoverManagerEventEmitter<HandoverManagerEvents> = new HandoverManagerEventEmitter<HandoverManagerEvents>();\n  private processName: string;\n  private processId: string;\n  private mqttProxy: MqttProxy;\n  private unsMqttProxies: UnsMqttProxy[];\n  private requestingHandover: boolean = false;\n  private handoverInProgress: boolean = false;\n  private topicBuilder: MqttTopicBuilder;\n  private activeTimeout: NodeJS.Timeout | undefined;\n  private readonly handoverId: string | undefined;\n  private acceptedHandoverId: string | undefined;\n  private active: boolean = false;\n  private sourcePeerId: string | undefined;\n  private sourcePreparation: Promise<void> | undefined;\n  private sourceExit: Promise<void> | undefined;\n  private readonly shutdownHooks: HandoverShutdownHooks | undefined;\n  public handoverRequestEnabled: boolean = false;\n  public handoverEnabled: boolean = true;\n  public forceStartEnabled: boolean = false;\n\n  constructor(\n    processName: string,\n    processId: string,\n    mqttProxy: MqttProxy,\n    unsMqttProxies: UnsMqttProxy[],\n    handoverRequestEnabled: boolean,\n    handoverEnabled: boolean,\n    forceStartEnabled: boolean,\n    handoverId?: string,\n    shutdownHooks?: HandoverShutdownHooks,\n  ) {\n    validateHandoverShutdown(shutdownHooks);\n    this.shutdownHooks = shutdownHooks ? { ...shutdownHooks } : undefined;\n    this.processName = processName;\n    this.processId = processId;\n    this.mqttProxy = mqttProxy;\n    this.unsMqttProxies = unsMqttProxies;\n    this.handoverRequestEnabled = handoverRequestEnabled;\n    this.handoverEnabled = handoverEnabled;\n    this.forceStartEnabled = forceStartEnabled;\n    this.handoverId = normalizeHandoverId(handoverId);\n\n    // Instantiate the topic builder.\n    const packageName = PACKAGE_INFO.name;\n    const version = PACKAGE_INFO.version;\n    this.topicBuilder = new MqttTopicBuilder(\n      `uns-infra/${MqttTopicBuilder.sanitizeTopicPart(packageName)}/${MqttTopicBuilder.sanitizeTopicPart(version)}/${MqttTopicBuilder.sanitizeTopicPart(this.processName)}/`,\n    );\n\n    // Set status as active after a timeout if no other active process are detected.\n    this.activeTimeout = setTimeout(() => {\n      logger.info(`${this.processName} - No active message received within timeout. Assuming no other process is running.`);\n      this.active = true;\n      this.event.emit(\"handoverManager\", { active: this.active });\n      // Activate all UNS proxy instance publishers and subscribers.\n      this.unsMqttProxies.forEach((unsProxy) => {\n        unsProxy.setPublisherActive();\n        unsProxy.setSubscriberActive();\n      });\n    }, ACTIVE_TIMEOUT);\n  }\n\n  private getUserProperties(handoverId?: string): Record<string, string> {\n    const properties: Record<string, string> = {\n      processName: this.processName,\n      processId: this.processId,\n    };\n    const normalized = normalizeHandoverId(handoverId ?? this.handoverId);\n    if (normalized) properties.handoverId = normalized;\n    return properties;\n  }\n\n  private handoverPayload(\n    type: string,\n    handoverId?: string,\n    fields: Record<string, unknown> = {},\n  ): string {\n    const normalized = normalizeHandoverId(handoverId ?? this.handoverId);\n    return JSON.stringify({\n      type,\n      ...fields,\n      ...(normalized ? { handoverId: normalized } : {}),\n    });\n  }\n\n  private getHandoverId(response: unknown, event: UnsEvents[\"input\"]): string | undefined {\n    const fromPayload = response && typeof response === \"object\" && !Array.isArray(response)\n      ? (response as { handoverId?: unknown }).handoverId\n      : undefined;\n    if (typeof fromPayload === \"string\") return normalizeHandoverId(fromPayload);\n    const fromProperties = event.packet?.properties?.userProperties?.handoverId;\n    return typeof fromProperties === \"string\" ? normalizeHandoverId(fromProperties) : undefined;\n  }\n\n  private acceptsHandoverResponse(receivedHandoverId: string | undefined): boolean {\n    if (!this.handoverId || !receivedHandoverId) {\n      return true;\n    }\n    if (this.handoverId === receivedHandoverId) {\n      return true;\n    }\n    logger.warn(`${this.processName} - Ignoring handover message for another migration.`);\n    return false;\n  }\n\n  private getSourceProcessId(event: UnsEvents[\"input\"]): string | undefined {\n    return event.packet?.properties?.userProperties?.processId;\n  }\n\n  private parseActiveValue(message: string): boolean | null {\n    try {\n      const parsed = JSON.parse(message);\n      const value = parsed?.message?.data?.value ?? parsed?.data?.value;\n      if (value === 1 || value === \"1\" || value === true || value === \"true\") {\n        return true;\n      }\n      if (value === 0 || value === \"0\" || value === false || value === \"false\") {\n        return false;\n      }\n      return null;\n    } catch {\n      return null;\n    }\n  }\n\n  private isProcessActiveTopic(topic: string): boolean {\n    const parts = topic.split(\"/\");\n    if (parts.length !== 5) return false;\n    const [root, pkg, , process, tail] = parts;\n    if (root !== \"uns-infra\" || tail !== \"active\") return false;\n    const expectedPackage = MqttTopicBuilder.sanitizeTopicPart(PACKAGE_INFO.name);\n    const expectedProcess = MqttTopicBuilder.sanitizeTopicPart(this.processName);\n    return pkg === expectedPackage && process === expectedProcess;\n  }\n\n  /**\n   * Main entry point for handling incoming MQTT messages.\n   * It checks the topic and delegates to the corresponding handler.\n   */\n  public async handleMqttMessage(event: UnsEvents[\"input\"]): Promise<void> {\n    try {\n      // Check if the packet is active messages from other processes and this process is not active.\n      if (this.isProcessActiveTopic(event.topic) && this.requestingHandover === false && this.active === false && this.handoverInProgress === false) {\n        const sourceProcessId = this.getSourceProcessId(event);\n        if (sourceProcessId === this.processId) {\n          return;\n        }\n        const activeValue = this.parseActiveValue(event.message.toString());\n        if (activeValue !== true) {\n          return;\n        }\n        const sourceInfo = sourceProcessId ? ` (processId=${sourceProcessId})` : \"\";\n        logger.info(`${this.processName} - Another process is active${sourceInfo} on ${event.topic}.`);\n\n        if (event.packet?.retain === true) {\n          // A retained heartbeat can belong to a process that crashed before its\n          // expiry. Wait for a fresh non-retained heartbeat before asking it to\n          // hand over; otherwise a stale retained message would block startup.\n          logger.info(`${this.processName} - Retained active heartbeat observed; waiting for a fresh heartbeat.`);\n          this.activeTimeout?.refresh();\n          return;\n        }\n\n        if (this.handoverRequestEnabled && this.handoverEnabled) {\n          // Requester process\n          // Publish a handover request message after 10 seconds to the handover topic.\n          clearTimeout(this.activeTimeout); // Clear the active timeout if it exists - prevent this process from becoming active after a timeout.\n          this.activeTimeout = undefined;\n          this.event.emit(\"handoverManager\", { active: this.active });\n          this.requestingHandover = true;\n          const eventHandoverTopic = new MqttTopicBuilder(MqttTopicBuilder.extractBaseTopic(event.topic)).getHandoverTopic();\n          await this.mqttProxy.publish(eventHandoverTopic, this.handoverPayload(\"handover_intent\"), {\n            retain: false,\n            properties: {\n              userProperties: this.getUserProperties(),\n            },\n          });\n          logger.info(`${this.processName} - Requesting handover in 10 seconds.`);\n          setTimeout(async () => {\n            logger.info(`${this.processName} - Requesting handover ${eventHandoverTopic}.`);\n            this.handoverInProgress = true;\n            await this.mqttProxy.publish(eventHandoverTopic, this.handoverPayload(\"handover_request\"), {\n              retain: false,\n              properties: {\n                responseTopic: this.topicBuilder.getHandoverTopic(),\n                userProperties: this.getUserProperties(),\n              },\n            });\n          }, 10000);\n        } else {\n          if (this.forceStartEnabled) {\n            // Force start the process even if another process is active.\n            logger.info(`${this.processName} - Force starting the process.`);\n            logger.warn(`${this.processName} - Warning: Source and destination being the same may lead to duplicate messages.`);\n            clearTimeout(this.activeTimeout); // Clear the active timeout if it exists - prevent this process from becoming active after a timeout.\n            this.activeTimeout = undefined;\n            this.active = true;\n            this.event.emit(\"handoverManager\", { active: this.active });\n            // Activate all UNS proxy instance publishers and subscribers.\n            this.unsMqttProxies.forEach((unsProxy) => {\n              unsProxy.setPublisherActive();\n              unsProxy.setSubscriberActive();\n            });\n          } else {\n            logger.info(`${this.processName} - Waiting for the other process on topic ${event.topic} to become passive.`);\n            this.activeTimeout?.refresh();\n          }\n        }\n      }\n\n      // Check if the packet is an handover message, sent to a handover topic.\n      if (event.topic === this.topicBuilder.getHandoverTopic() && this.handoverEnabled) {\n        const sourceProcessId = this.getSourceProcessId(event);\n        if (sourceProcessId !== this.processId) {\n          await this.handleHandover(event);\n        }\n      }\n    } catch (error) {\n      logger.error(`${this.processName} - Error processing MQTT message: ${error.message}`);\n      return;\n    }\n  }\n\n  /**\n   * Handles handovers.\n   */\n  private exitSource(code: number): void {\n    process.exit(code);\n  }\n\n  private async prepareSourceHandover(response: any, event: UnsEvents[\"input\"]): Promise<void> {\n    const handoverId = this.getHandoverId(response, event);\n\n    logger.info(\n      `${this.processName} - Received handover request from ${event.packet?.properties?.userProperties?.processName}. Accepting handover.`,\n    );\n\n    this.active = false;\n    this.event.emit(\"handoverManager\", { active: false });\n    this.shutdownHooks?.onRelease?.();\n\n    // Set all UNS proxy instance subscribers to passive and drain the queue.\n    const mqttWorkerData: UnsEvents[\"mqttWorker\"][] = [];\n    for (let i = 0; i < this.unsMqttProxies.length; i++) {\n      const unsProxy = this.unsMqttProxies[i];\n      const workerData = await unsProxy.setSubscriberPassiveAndDrainQueue();\n      mqttWorkerData.push(workerData);\n    }\n    logger.info(`${this.processName} - Handover request accepted. Sending handover_subscriber messages.`);\n\n    // Publish handover_subscriber messages for each instance that has processed some data.\n    for (let i = 0; i < mqttWorkerData.length; i++) {\n      const workerData = mqttWorkerData[i];\n      if (workerData.batchSize > 0) {\n        await this.mqttProxy.publish(\n          event.packet.properties?.responseTopic ?? \"\",\n          this.handoverPayload(\"handover_subscriber\", handoverId, {\n            batchSize: workerData.batchSize,\n            referenceHash: workerData.referenceHash,\n            instanceName: workerData.instanceName,\n          }),\n          {\n            retain: false,\n            properties: {\n              responseTopic: this.topicBuilder.getHandoverTopic(),\n              userProperties: this.getUserProperties(handoverId),\n            },\n          },\n        );\n      }\n    }\n    logger.info(`${this.processName} - Handover subscriber messages sent.`);\n\n    // Publish a single handover acknowledgment only when all\n    // handover_subscriber messages have been sent\n    await this.mqttProxy.publish(\n      event.packet.properties?.responseTopic ?? \"\",\n      this.handoverPayload(\"handover_fin\", handoverId),\n      {\n        retain: false,\n        properties: {\n          responseTopic: this.topicBuilder.getHandoverTopic(),\n          userProperties: this.getUserProperties(handoverId),\n        },\n      },\n    );\n    logger.info(`${this.processName} - Handover fin message sent.`);\n\n    await Promise.all(this.unsMqttProxies.map((unsProxy: UnsMqttProxy) => unsProxy.stop()));\n  }\n\n  private async finishSourceHandover(): Promise<void> {\n    const result = await runHandoverShutdown(async () => {\n      await this.sourcePreparation;\n      await this.shutdownHooks?.drain();\n    }, this.shutdownHooks?.timeoutMs ?? 30_000);\n    this.handoverInProgress = false;\n    this.requestingHandover = false;\n    if (result === \"completed\") {\n      logger.info(`${this.processName} - Handover source drain completed. Exiting process.`);\n      this.exitSource(0);\n    } else {\n      // Do not log application error text: it may contain paths, topics or credentials.\n      logger.error(`${this.processName} - Handover source drain ${result}. Exiting with incomplete drain.`);\n      this.exitSource(1);\n    }\n  }\n\n  private async handleHandover(event: UnsEvents[\"input\"]): Promise<void> {\n    try {\n      const response = JSON.parse(event.message.toString());\n      // Responder process\n      // Check if the message is a handover request and publish MULTIPLE handover_subscriber messages\n      if (response.type === \"handover_request\") {\n        const peerId = this.getSourceProcessId(event);\n        const replyTopic = event.packet?.properties?.responseTopic;\n        if (this.sourcePeerId || !this.active || !peerId || typeof replyTopic !== \"string\" || !replyTopic) return;\n        this.sourcePeerId = peerId;\n        this.acceptedHandoverId = this.getHandoverId(response, event);\n        this.handoverInProgress = true;\n        clearTimeout(this.activeTimeout);\n        this.activeTimeout = undefined;\n        this.sourcePreparation = this.prepareSourceHandover(response, event);\n        try {\n          await this.sourcePreparation;\n        } catch {\n          // Subscriber transfer or onRelease failed; never report successful source completion.\n          logger.error(`${this.processName} - Handover source preparation failed. Exiting with incomplete drain.`);\n          if (!this.sourceExit) this.exitSource(1);\n        }\n      }\n\n      // Requestor process\n      // Check if the message is one of the handover_subscriber message in response to handover_request\n      // and publish a handover_ack message\n      if (response.type === \"handover_subscriber\") {\n        if (this.sourcePeerId) return;\n        if (!this.acceptsHandoverResponse(this.getHandoverId(response, event))) return;\n        // Find correct unsProxy instance for handover_subscriber and set it active\n        this.unsMqttProxies.forEach((unsProxy: UnsMqttProxy) => {\n          if (unsProxy.instanceName === response.instanceName) {\n            unsProxy.setSubscriberActive(response.batchSize, response.referenceHash);\n          }\n        });\n      }\n\n      // Requestor process\n      // Check if the message is a handover_fin at the end of handover_subscriber messages\n      if (response.type === \"handover_fin\") {\n        if (this.sourcePeerId) return;\n        const handoverId = this.getHandoverId(response, event);\n        if (!this.acceptsHandoverResponse(handoverId)) return;\n        logger.info(`${this.processName} - Received handover fin from ${event.packet?.properties?.userProperties?.processName}.`);\n\n        // Maybe we should count the number of requests that were allrady made TODO\n        // this.handoverInProgress = false;\n        // this.requestingHandover = false;\n\n        this.active = true;\n        this.event.emit(\"handoverManager\", { active: this.active });\n        logger.info(`${this.processName} - Handover completed.`);\n        // Activate all UNS proxy instance publishers and subscribers.\n        this.unsMqttProxies.forEach((unsProxy) => {\n          unsProxy.setPublisherActive();\n          unsProxy.setSubscriberActive();\n        });\n\n        // Maybe we should reply with handover_ack.\n        await this.mqttProxy.publish(\n          event.packet.properties?.responseTopic ?? \"\",\n          this.handoverPayload(\"handover_ack\", handoverId),\n          {\n            retain: false,\n            properties: {\n              responseTopic: this.topicBuilder.getHandoverTopic(),\n              userProperties: this.getUserProperties(handoverId),\n            },\n          },\n        );\n        logger.info(`${this.processName} - Handover ack message sent.`);\n      }\n\n      // Responder process\n      // Check if the message is a handover_ack at the end of handover_fin messages\n      if (response.type === \"handover_ack\") {\n        if (!this.sourcePreparation || this.getSourceProcessId(event) !== this.sourcePeerId) return;\n        const handoverId = this.getHandoverId(response, event);\n        if (this.acceptedHandoverId && handoverId && this.acceptedHandoverId !== handoverId) {\n          logger.warn(`${this.processName} - Ignoring acknowledgement for another migration.`);\n          return;\n        }\n        logger.info(`${this.processName} - Received handover ack from ${event.packet?.properties?.userProperties?.processName}.`);\n        this.sourceExit ??= this.finishSourceHandover();\n        await this.sourceExit;\n      }\n    } catch (error) {\n      logger.error(`${this.processName} - Error processing handover response: ${error.message}`);\n    }\n  }\n}\n"]}

package/dist/uns/handover-shutdown.d.ts

@@ -0,0 +1,14 @@
+/** Application-owned work is separate from the MQTT subscriber handover. */
+export interface HandoverShutdownHooks {
+    /** Synchronous: stop admitting new background work when releasing ownership. */
+    onRelease?: () => void;
+    /** After target acknowledgement: finish accepted work and close writers. Never call process.exit here. */
+    drain: () => Promise<void>;
+    /** Total time for remaining proxy stops and application drain; default 30 seconds. */
+    timeoutMs?: number;
+}
+export declare function validateHandoverShutdown(hooks?: HandoverShutdownHooks): void;
+export type HandoverShutdownResult = "completed" | "failed" | "timed-out";
+/** A timeout does not cancel IO or prove durability. The process owner must exit nonzero. */
+export declare function runHandoverShutdown(work: () => Promise<void>, timeoutMs?: number): Promise<HandoverShutdownResult>;
+//# sourceMappingURL=handover-shutdown.d.ts.map

package/dist/uns/handover-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handover-shutdown.d.ts","sourceRoot":"","sources":["../../src/uns/handover-shutdown.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,0GAA0G;IAC1G,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAS5E;AAED,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1E,6FAA6F;AAC7F,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiBxH"}

package/dist/uns/handover-shutdown.js

@@ -0,0 +1,30 @@
+export function validateHandoverShutdown(hooks) {
+    if (!hooks)
+        return;
+    if (typeof hooks.drain !== "function" || (hooks.onRelease !== undefined && typeof hooks.onRelease !== "function")) {
+        throw new TypeError("Invalid handover shutdown hooks.");
+    }
+    const timeout = hooks.timeoutMs ?? 30_000;
+    if (!Number.isInteger(timeout) || timeout < 1 || timeout > 300_000) {
+        throw new RangeError("Handover shutdown timeout must be between 1 and 300000 milliseconds.");
+    }
+}
+/** A timeout does not cancel IO or prove durability. The process owner must exit nonzero. */
+export async function runHandoverShutdown(work, timeoutMs = 30_000) {
+    let timer;
+    try {
+        return await Promise.race([
+            Promise.resolve()
+                .then(work)
+                .then(() => "completed", () => "failed"),
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve("timed-out"), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=handover-shutdown.js.map

package/dist/uns/handover-shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handover-shutdown.js","sourceRoot":"","sources":["../../src/uns/handover-shutdown.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,wBAAwB,CAAC,KAA6B;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,UAAU,CAAC,EAAE,CAAC;QAClH,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACnE,MAAM,IAAI,UAAU,CAAC,sEAAsE,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAID,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAyB,EAAE,SAAS,GAAG,MAAM;IACrF,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO,CAAC,OAAO,EAAE;iBACd,IAAI,CAAC,IAAI,CAAC;iBACV,IAAI,CACH,GAAG,EAAE,CAAC,WAAoB,EAC1B,GAAG,EAAE,CAAC,QAAiB,CACxB;YACH,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,EAAE;gBACnC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;YAC5D,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC","sourcesContent":["/** Application-owned work is separate from the MQTT subscriber handover. */\nexport interface HandoverShutdownHooks {\n  /** Synchronous: stop admitting new background work when releasing ownership. */\n  onRelease?: () => void;\n  /** After target acknowledgement: finish accepted work and close writers. Never call process.exit here. */\n  drain: () => Promise<void>;\n  /** Total time for remaining proxy stops and application drain; default 30 seconds. */\n  timeoutMs?: number;\n}\n\nexport function validateHandoverShutdown(hooks?: HandoverShutdownHooks): void {\n  if (!hooks) return;\n  if (typeof hooks.drain !== \"function\" || (hooks.onRelease !== undefined && typeof hooks.onRelease !== \"function\")) {\n    throw new TypeError(\"Invalid handover shutdown hooks.\");\n  }\n  const timeout = hooks.timeoutMs ?? 30_000;\n  if (!Number.isInteger(timeout) || timeout < 1 || timeout > 300_000) {\n    throw new RangeError(\"Handover shutdown timeout must be between 1 and 300000 milliseconds.\");\n  }\n}\n\nexport type HandoverShutdownResult = \"completed\" | \"failed\" | \"timed-out\";\n\n/** A timeout does not cancel IO or prove durability. The process owner must exit nonzero. */\nexport async function runHandoverShutdown(work: () => Promise<void>, timeoutMs = 30_000): Promise<HandoverShutdownResult> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  try {\n    return await Promise.race([\n      Promise.resolve()\n        .then(work)\n        .then(\n          () => \"completed\" as const,\n          () => \"failed\" as const,\n        ),\n      new Promise<\"timed-out\">((resolve) => {\n        timer = setTimeout(() => resolve(\"timed-out\"), timeoutMs);\n      }),\n    ]);\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n"]}

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

@@ -1,3 +1,4 @@
+import type { HandoverShutdownHooks } from "./handover-shutdown.js";
 import { UnsAttributeType } from "../graphql/schema.js";
 import { MeasurementUnit } from "./uns-measurements.js";
 import { UnsTags } from "./uns-tags.js";
@@ -80,6 +81,8 @@ export interface IUnsParameters {
     defaultPublishOptions?: IMqttPublishOptions;
 }
 export interface IUnsProcessParameters {
+    /** Optional application drain after a cooperative handover. Register before creating proxies. */
+    handoverShutdown?: HandoverShutdownHooks;
     processName: string;
     /**
      * Optional controller-supplied correlation id for one cooperative handover.

package/dist/uns/uns-interfaces.d.ts.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"uns-interfaces.js","sourceRoot":"","sources":["../../src/uns/uns-interfaces.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,YAAY,GAAG,+CAA+C,CAAC;IACrE,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAID,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AA6CxD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,WAAW;IACX,cAAc;IACd,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,SAAS;CACD,CAAC;AAEX,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS,qBAAqB,CAAC,CAAC;AACvE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAW3C,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAC9B,CAAC;AACJ,CAAC","sourcesContent":["import { UnsAttributeType } from \"../graphql/schema.js\";\nimport { MeasurementUnit } from \"./uns-measurements.js\";\nimport { UnsTags } from \"./uns-tags.js\";\nimport type { UnsObjectId, UnsObjectType } from \"./uns-object.js\";\nimport type { UnsAsset } from \"./uns-asset.js\";\nimport type { IMqttConnectProperties, IMqttPublishOptions, IMqttServerConfig, MqttProtocol } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport { UnsTopics } from \"./uns-topics.js\";\nimport { knownUnsAttributes, type KnownUnsAttributeName } from \"./uns-attributes.js\";\n\nexport type ISO8601 = `${number}-${string}-${string}T${string}:${string}:${string}.${string}Z`;\nexport function isIOS8601Type(value: string): value is ISO8601 {\n  const iso8601Regex = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/;\n  return iso8601Regex.test(value);\n}\n// Known attribute names (with IntelliSense) while still allowing arbitrary strings.\nexport type UnsAttribute = KnownUnsAttributeName | (string & {});\n\nexport const valueTypes = [\"string\", \"number\"] as const;\nexport type ValueTypeString = (typeof valueTypes)[number];\nexport type ScalarValueType = string | number;\n/** Scalar telemetry or a scalar array used by metadata such as relationship evidence. */\nexport type ValueType = ScalarValueType | ScalarValueType[];\n\nexport type CounterResetPolicy = \"new-value\" | \"null\" | \"rollover\" | (string & {});\n\nexport type UnsAttributeSystemRole =\n  | \"relationship-evidence\"\n  | \"lifecycle-start\"\n  | \"lifecycle-end\"\n  | \"lifecycle-time-source\"\n  | (string & {});\n\nexport type UnsRelationshipEndpoint = \"source\" | \"target\";\n\nexport interface IUnsRelationshipEvidenceMetadata {\n  relationshipKey: string;\n  ownerEndpoint?: UnsRelationshipEndpoint;\n  valueEndpoint?: UnsRelationshipEndpoint;\n  /** Scalar values produce one edge; array values produce one edge per ObjectId value. */\n  sourceObjectType?: UnsObjectType | (string & {});\n  targetObjectType?: UnsObjectType | (string & {});\n  sourceObjectIdFrom?: string;\n  targetObjectIdFrom?: string;\n  observedAtFrom?: string;\n  status?: \"suggested\" | \"accepted\" | (string & {});\n  defaultStatus?: \"suggested\" | \"accepted\" | (string & {});\n}\n\nexport interface IUnsLifecycleMetadata {\n  timestampFrom?: \"value\" | \"packetTimestamp\" | (string & {});\n  startValues?: string[];\n  endValues?: string[];\n}\n\nexport interface IUnsTableColumnMetadata {\n  name: string;\n  valueType?: ValueTypeString | (string & {});\n  presentationKind?: string;\n  defaultAggregation?: string;\n  counterResetPolicy?: CounterResetPolicy;\n}\n\nexport const questDbPrimitiveTypes = [\n  \"boolean\",\n  \"ipv4\",\n  \"byte\",\n  \"short\",\n  \"char\",\n  \"int\",\n  \"float\",\n  \"symbol\",\n  \"varchar\",\n  \"string\",\n  \"long\",\n  \"date\",\n  \"timestamp\",\n  \"timestamp_ns\",\n  \"double\",\n  \"uuid\",\n  \"binary\",\n  \"long256\",\n] as const;\n\nconst questDbPrimitiveTypeSet = new Set<string>(questDbPrimitiveTypes);\nconst questDbGeohashRegex = /^geohash\\(\\d+[bc]\\)$/;\nconst questDbDecimalRegex = /^decimal\\(\\d+,\\d+\\)$/;\nconst questDbArrayRegex = /^array<[^>]+>$/;\n\nexport type QuestDbPrimitiveType = (typeof questDbPrimitiveTypes)[number];\n\n// Supported QuestDB column types for UNS tables.\nexport type QuestDbType =\n  | QuestDbPrimitiveType\n  | `geohash(${number}${\"b\" | \"c\"})`\n  | `decimal(${number},${number})`\n  | `array<${string}>`;\n\nexport function isQuestDbType(value: unknown): value is QuestDbType {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  if (questDbPrimitiveTypeSet.has(value)) {\n    return true;\n  }\n  return (\n    questDbGeohashRegex.test(value) ||\n    questDbDecimalRegex.test(value) ||\n    questDbArrayRegex.test(value)\n  );\n}\n\nexport interface IUnsParameters {\n  mqttSubToTopics?: string | string[];\n  username?: string;\n  password?: string;\n  mqttSSL?: boolean;\n  publishThrottlingDelay?: number; // Delay in milliseconds; default is 1ms\n  publishConcurrency?: number; // Maximum concurrent outgoing publishes; default is 1\n  maxPendingPublishes?: number; // Maximum pending publishes across the API boundary and worker; default is unlimited\n  subscribeThrottlingDelay?: number; // Delay in milliseconds; default is 1ms\n  rejectUnauthorized?: boolean;\n  clientId?: string;\n  hosts?: string[];\n  servers?: IMqttServerConfig[];\n  port?: number;\n  protocol?: MqttProtocol;\n  keepalive?: number;\n  clean?: boolean;\n  connectTimeout?: number;\n  reconnectPeriod?: number;\n  reconnectOnConnackError?: boolean;\n  resubscribe?: boolean;\n  queueQoSZero?: boolean;\n  properties?: IMqttConnectProperties;\n  ca?: string;\n  cert?: string;\n  key?: string;\n  servername?: string;\n  /**\n   * Default MQTT publish options applied to all outgoing messages\n   * (e.g., qos, retain, messageExpiryInterval).\n   */\n  defaultPublishOptions?: IMqttPublishOptions;\n}\n\nexport interface IUnsProcessParameters {\n  processName: string;\n  /**\n   * Optional controller-supplied correlation id for one cooperative handover.\n   * Older peers ignore it, so it must never be required for normal startup.\n   */\n  handoverId?: string;\n  mqttSubToTopics?: string | string[];\n  username?: string;\n  password?: string;\n  mqttSSL?: boolean;\n  clientId?: string;\n  hosts?: string[];\n  servers?: IMqttServerConfig[];\n  port?: number;\n  protocol?: MqttProtocol;\n  keepalive?: number;\n  clean?: boolean;\n  connectTimeout?: number;\n  reconnectPeriod?: number;\n  reconnectOnConnackError?: boolean;\n  resubscribe?: boolean;\n  queueQoSZero?: boolean;\n  rejectUnauthorized?: boolean;\n  properties?: IMqttConnectProperties;\n  ca?: string;\n  cert?: string;\n  key?: string;\n  servername?: string;\n}\n\nexport interface UnsEvents {\n  // Emitters in MqttProxy, UnsMqttProxy\n  input: { topic: string; message: string, packet: any };\n  mqttProxyStatus: { event: string, value: number, uom: MeasurementUnit, statusTopic: string };\n  \n  // Emitters in MqttProxy\n  error: { code: number; message: string };\n  \n  // Emitters in UnsMqttProxy\n  mqttWorker: { command: string, instanceName: string; batchSize: number, referenceHash: string };\n\n  // Emitter in UnsCronProxy\n  cronEvent: { event?: string; cronExpression?: string };\n\n  // Emitters in UnsApiProxy\n  apiGetEvent: {req: any, res: any};\n  apiPostEvent: {req: any, res: any};\n  apiPutEvent: {req: any, res: any};\n  apiPatchEvent: {req: any, res: any};\n  apiDeleteEvent: {req: any, res: any};\n\n  // Emitters in UnsProxy\n  unsProxyProducedTopics: { producedTopics: ITopicObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedApiEndpoints: { producedApiEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedServiceEndpoints: { producedServiceEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedDataOfferEndpoints: { producedDataOfferEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedApiCatchAll: { producedCatchall: IApiCatchallMapping[], statusTopic: string };\n\n  // Emitters in UnsProxy / UnsApiProxy\n  unsProxyProducedDataCatalogOffers: { producedDataCatalogOffers: unknown[], statusTopic: string };\n}\n\nexport interface IUnsExtendedData extends IUnsData {\n  valueType: ValueTypeString;\n}\n\nexport interface IUnsData {\n  /** Domain-specific evidence/context fields may accompany the canonical value. */\n  [key: string]: unknown;\n  time: ISO8601;\n  value: ValueType;\n  /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */\n  dataGroup?: string;\n  uom?: MeasurementUnit;\n  foreignEventKey?: string;\n  intervalStart?: ISO8601 | number;\n  intervalEnd?: ISO8601 | number;\n  windowStart?: ISO8601 | number;\n  windowEnd?: ISO8601 | number;\n  eventId?: string;\n  deleted?: boolean;\n  deletedAt?: ISO8601 | number;\n  lastSeen?: ISO8601 | number;\n}\n\nexport interface IUnsTableColumn {\n  type: QuestDbType;\n  value: string | number | boolean | null;\n  uom?: MeasurementUnit;\n}\n\n/** MQTT table columns keyed by their stable UNS/QuestDB column name. */\nexport type IUnsTableColumns = Record<string, IUnsTableColumn>;\n\nexport interface IUnsTable {\n  time: ISO8601;\n  /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */\n  dataGroup?: string;\n  columns: IUnsTableColumns;\n  intervalStart?: ISO8601 | number;\n  intervalEnd?: ISO8601 | number;\n  windowStart?: ISO8601 | number;\n  windowEnd?: ISO8601 | number;\n  eventId?: string;\n  deleted?: boolean;\n  deletedAt?: ISO8601 | number;\n  lastSeen?: ISO8601 | number;\n}\n\nexport interface IMqttAttributeMessage {\n  attribute: UnsAttribute;\n  description?: string;\n  tags?: UnsTags[];\n  attributeNeedsPersistence?: boolean | null;\n  /** Optional controller/UI grouping hint for this ObjectId node; does not affect storage/table naming. */\n  virtualGroup?: string;\n  /** Scalar value shape for schema/catalog consumers, for example \"number\" or \"string\". */\n  valueType?: ValueTypeString | (string & {});\n  /**\n   * Operator-facing presentation hint. Use \"counter\" for cumulative counter\n   * state; delta/rate should be requested from Datahub history APIs.\n   */\n  presentationKind?: string;\n  /** Preferred aggregation for sampled history views, for example \"last\". */\n  defaultAggregation?: string;\n  /** Reset handling hint for cumulative counters. Interpreted by Datahub APIs, not by the producer. */\n  counterResetPolicy?: CounterResetPolicy;\n  /** Field-level metadata for table columns that should behave as chartable series. */\n  tableColumns?: IUnsTableColumnMetadata[];\n  /** Optional schema-system role published into Datahub's attribute_schema.schema_json. */\n  systemRole?: UnsAttributeSystemRole;\n  /** Relationship materialization metadata for `systemRole: \"relationship-evidence\"`. */\n  relationshipEvidence?: IUnsRelationshipEvidenceMetadata;\n  /** Lifecycle metadata for lifecycle system roles. */\n  lifecycle?: IUnsLifecycleMetadata;\n  /**\n   * How the controller determines if this attribute is live or stale.\n   * Defaults to `\"interval\"` with the controller's default interval (~120s) when omitted.\n   *\n   * @example\n   * // Sensor publishing every 2 seconds:\n   * { validityMode: \"interval\", expectedIntervalMs: 2000 }\n   *\n   * // Status attribute publishing every 2 seconds (string values like \"HEATING\"):\n   * { validityMode: \"interval\", expectedIntervalMs: 2000 }\n   *\n   * // Material location with ENTERED/EXITED lifecycle:\n   * { validityMode: \"lifecycle\", lifecycleEndValue: \"EXITED\" }\n   *\n   * // Static configuration value:\n   * { validityMode: \"static\" }\n   */\n  validityMode?: ValidityMode;\n  /**\n   * Expected publish interval in milliseconds. Only meaningful for `validityMode: \"interval\"`.\n   * The controller marks the attribute as stale after ~2× this value without a heartbeat update.\n   * Ignored for `\"lifecycle\"` and `\"static\"` modes.\n   */\n  expectedIntervalMs?: number;\n  /**\n   * The string value that marks a lifecycle as completed. Only meaningful for `validityMode: \"lifecycle\"`.\n   * When the attribute's current value matches this, the controller considers the lifecycle done.\n   * Example: `\"EXITED\"` for a location attribute with ENTERED/EXITED events.\n   */\n  lifecycleEndValue?: string;\n}\n\ntype AttributePayload =\n  | { message: IUnsMessage; data?: never; table?: never; createdAt?: never; expiresAt?: never }\n  | { message?: never; data: IUnsData; table?: never; createdAt?: ISO8601; expiresAt?: ISO8601 }\n  | { message?: never; data?: never; table: IUnsTable; createdAt?: ISO8601; expiresAt?: ISO8601 };\n\nexport type IMqttAttributeEntry = IMqttAttributeMessage & AttributePayload;\n\nexport type IAssetProviderIdentity = {\n  providerId: string;\n  externalSystem: string;\n  externalType: string;\n  externalId: string;\n};\n\nexport type IAssetIdentityPublicationMetadata =\n  | {\n      assetStableEntityId?: never;\n      assetDisplayName?: never;\n      assetIdentityProof?: never;\n      assetProviderIdentity?: never;\n      assetProviderIdentityProof?: never;\n    }\n  | {\n      /** Controller-issued stable Asset UUID. It identifies the Asset, not its current path. */\n      assetStableEntityId: string;\n      /** Optional operator-facing name; never used as an identity key. */\n      assetDisplayName?: string;\n      /** Short-lived controller-signed proof bound to this Asset UUID and exact candidate path. */\n      assetIdentityProof: string;\n      assetProviderIdentity?: never;\n      assetProviderIdentityProof?: never;\n    }\n  | {\n      assetStableEntityId?: never;\n      assetDisplayName?: never;\n      assetIdentityProof?: never;\n      /** Reviewed provider namespace plus external identifier for a provisional no-ID Asset. */\n      assetProviderIdentity: IAssetProviderIdentity;\n      /** Short-lived controller-signed proof bound to the provider identifier and exact candidate path. */\n      assetProviderIdentityProof: string;\n    };\n\nexport type IMqttPublishRequest = {\n  topic: UnsTopics;\n  asset: UnsAsset;\n  assetDescription?: string;\n  objectType: UnsObjectType;\n  objectTypeDescription?: string;\n  objectId: UnsObjectId;\n  /** Optional controller/UI grouping hint for ObjectId nodes; does not affect storage/table naming. */\n  virtualGroup?: string;\n  attributes: IMqttAttributeEntry | IMqttAttributeEntry[];\n} & IAssetIdentityPublicationMetadata;\n\n// This interface represents a packet for a UNS system\nexport interface IUnsPacket {\n  // The message object of the packet\n  message: IUnsExtendedMessage;\n  \n  // The HMAC signature of the message\n  messageSignature?: string;\n\n  // Automatically calculated interval between two packets in ms\n  interval?: number;\n\n  // Current library version\n  readonly version: string;\n\n  // Autogenerated sequence number\n  sequenceId?: number;\n}\n\nexport interface IUnsPackatParameters {\n\n}\n\nexport interface IUnsMessage {\n    data?: IUnsData;\n    table?: IUnsTable;\n    expiresAt?: ISO8601;\n    createdAt?: ISO8601;\n}\n\nexport interface IUnsExtendedMessage extends IUnsMessage {\n  data?: IUnsExtendedData;\n}\n\n/**\n * Controls how the controller determines whether an attribute is live or stale.\n *\n * - `\"interval\"` — Attribute publishes periodically. Stale if no heartbeat within ~2× the expected interval.\n *   Use with `expectedIntervalMs`. Works for both numeric sensors (temperature every 2s)\n *   and string status attributes (status every 2s). Example:\n *   `{ validityMode: \"interval\", expectedIntervalMs: 2000 }`\n *\n * - `\"lifecycle\"` — Attribute represents a lifecycle with a start and end event.\n *   Use with `lifecycleEndValue` to mark the end state. Example: material location with \"ENTERED\" / \"EXITED\".\n *\n * - `\"static\"` — Attribute is set once and never changes (configuration, metadata). Always live.\n *\n * When omitted, defaults to `\"interval\"` with the controller's default interval (~120s).\n */\nexport type ValidityMode = \"interval\" | \"lifecycle\" | \"static\";\n\nexport interface ITopicObject {\n  timestamp: string;\n  attribute:string;\n  attributeType: UnsAttributeType;\n  topic:string;\n  description:string;\n  /** Storage/routing group observed on the latest data/table payload for this identity. */\n  dataGroup:string;\n  /** Optional controller/UI grouping hint for ObjectId nodes; does not affect storage/table naming. */\n  virtualGroup?: string;\n  tags:string[] | null;\n  attributeNeedsPersistence: boolean | null;\n  /** Scalar value shape for schema/catalog consumers, for example \"number\" or \"string\". */\n  valueType?: ValueTypeString | (string & {});\n  /** Operator-facing presentation hint, for example \"counter\" for cumulative counter state. */\n  presentationKind?: string;\n  /** Preferred aggregation for sampled history views, for example \"last\". */\n  defaultAggregation?: string;\n  /** Reset handling hint for cumulative counters. Interpreted by Datahub APIs, not by the producer. */\n  counterResetPolicy?: CounterResetPolicy;\n  /** Field-level metadata for table columns that should behave as chartable series. */\n  tableColumns?: IUnsTableColumnMetadata[];\n  /** Optional schema-system role published into Datahub's attribute_schema.schema_json. */\n  systemRole?: UnsAttributeSystemRole;\n  /** Relationship materialization metadata for `systemRole: \"relationship-evidence\"`. */\n  relationshipEvidence?: IUnsRelationshipEvidenceMetadata;\n  /** Lifecycle metadata for lifecycle system roles. */\n  lifecycle?: IUnsLifecycleMetadata;\n  asset: UnsAsset;\n  assetDescription?: string;\n  /** Optional stable Asset UUID; accepted by the controller only with a valid publication proof. */\n  assetStableEntityId?: string;\n  /** Optional operator-facing name; never used as an identity key. */\n  assetDisplayName?: string;\n  /** Short-lived controller-signed evidence for this exact Asset path. */\n  assetIdentityProof?: string;\n  /** Reviewed provider namespace plus external identifier for a provisional no-ID Asset. */\n  assetProviderIdentity?: IAssetProviderIdentity;\n  /** Short-lived controller-signed evidence for this provider identifier and exact Asset path. */\n  assetProviderIdentityProof?: string;\n  objectType: UnsObjectType;\n  objectTypeDescription?: string;\n  objectId: UnsObjectId;\n  /** Liveliness validity mode — how the controller determines if this attribute is live/stale. */\n  validityMode?: ValidityMode;\n  /** For interval mode: expected publish interval in milliseconds (stale after ~2x this value). */\n  expectedIntervalMs?: number;\n  /** For lifecycle mode: the string value that marks the lifecycle as completed (e.g. \"EXITED\"). */\n  lifecycleEndValue?: string;\n}\n\n// API Interfaces below\nexport interface IApiObject {\n  timestamp: string;\n  attribute:string;\n  topic:string;\n  attributeType: UnsAttributeType;\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  apiDescription?: string; // Optional description for the API endpoint\n  apiHost: string; // Hostname of the service\n  apiEndpoint: string; // API endpoint for virtual topics\n  apiSwaggerEndpoint: string; // Swagger endpoint for API documentation\n  apiMethod: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\"; // HTTP method for API endpoint\n  apiQueryParams: QueryParamDef[]; // query parameters for the API endpoint\n  serviceApi?: Record<string, unknown> | null;\n  asset: UnsAsset;\n  objectType: UnsObjectType;\n  objectId: UnsObjectId;\n  controllerName?: string;\n  controllerHost?: string;\n  controllerPort?: string;\n  controllerPublicBase?: string;\n}\n\nexport interface IApiCatchallMapping {\n  topic: string;\n  apiBase: string;\n  apiBasePath: string;\n  swaggerPath: string;\n}\n\nexport interface QueryParamDef {\n  name: string;\n  type: \"string\" | \"number\" | \"boolean\";\n  required?: boolean;\n  description?: string;\n  /**\n   * Optional canonical chat alias used by assistant tooling.\n   * Typical values: from, to, limit, topic, timezone, summaryOnly.\n   */\n  chatCanonical?: string;\n  /**\n   * Optional default query value. Included in generated OpenAPI metadata.\n   */\n  defaultValue?: string | number | boolean;\n}\n\nexport interface ApiChatDefaults {\n  from?: string;\n  to?: string;\n  limit?: number;\n  topic?: string;\n  timezone?: string;\n  summaryOnly?: boolean;\n  [key: string]: string | number | boolean | undefined;\n}\n\nexport interface IApiProxyOptions {\n  jwtSecret?: string;\n  /**\n   * Public origin advertised for generated API endpoint metadata.\n   *\n   * Use a hostname or origin without a port (for example `127.0.0.1` or\n   * `http://service-name`) to keep the API server's actual listening port.\n   * An explicitly supplied port is preserved. Defaults to the machine's\n   * external IPv4 address for backwards compatibility.\n   */\n  publishedApiHost?: string;\n  jwks?: {\n    wellKnownJwksUrl: string;\n    activeKidUrl?: string;\n    cacheTtlMs?: number;\n    algorithms?: (\"RS256\" | \"RS384\" | \"RS512\")[];\n  };\n  /**\n   * Optional base prefixes to mount the API and swagger JSON under (e.g. \"/archiver-3\").\n   * Defaults to \"/api\" when not provided.\n   */\n  apiBasePath?: string;\n  swaggerBasePath?: string;\n  /**\n   * Skip mounting the default \"/api\" route. Useful when rebasing entirely under a custom prefix.\n   */\n  disableDefaultApiMount?: boolean;\n}\n\nexport interface IGetEndpointOptions {\n  apiDescription?: string;\n  tags?: string[];\n  queryParams?: QueryParamDef[];\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  serviceApi?: Record<string, unknown>;\n  /**\n   * Optional defaults consumed by chat tooling (published as OpenAPI vendor extension x-uns-chat.defaults).\n   */\n  chatDefaults?: ApiChatDefaults;\n}\n\nexport interface IPostEndpointOptions {\n  apiDescription?: string;\n  tags?: string[];\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  serviceApi?: Record<string, unknown>;\n  requestBody?: {\n    description?: string;\n    required?: boolean;\n    schema?: Record<string, unknown>;\n  };\n}\n\nexport interface IPutEndpointOptions extends IPostEndpointOptions {}\nexport interface IPatchEndpointOptions extends IPostEndpointOptions {}\nexport interface IDeleteEndpointOptions extends IPostEndpointOptions {}\n"]}
+{"version":3,"file":"uns-interfaces.js","sourceRoot":"","sources":["../../src/uns/uns-interfaces.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,YAAY,GAAG,+CAA+C,CAAC;IACrE,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAID,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AA6CxD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,WAAW;IACX,cAAc;IACd,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,SAAS;CACD,CAAC;AAEX,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS,qBAAqB,CAAC,CAAC;AACvE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAW3C,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAC9B,CAAC;AACJ,CAAC","sourcesContent":["import type { HandoverShutdownHooks } from \"./handover-shutdown.js\";\nimport { UnsAttributeType } from \"../graphql/schema.js\";\nimport { MeasurementUnit } from \"./uns-measurements.js\";\nimport { UnsTags } from \"./uns-tags.js\";\nimport type { UnsObjectId, UnsObjectType } from \"./uns-object.js\";\nimport type { UnsAsset } from \"./uns-asset.js\";\nimport type { IMqttConnectProperties, IMqttPublishOptions, IMqttServerConfig, MqttProtocol } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport { UnsTopics } from \"./uns-topics.js\";\nimport { knownUnsAttributes, type KnownUnsAttributeName } from \"./uns-attributes.js\";\n\nexport type ISO8601 = `${number}-${string}-${string}T${string}:${string}:${string}.${string}Z`;\nexport function isIOS8601Type(value: string): value is ISO8601 {\n  const iso8601Regex = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/;\n  return iso8601Regex.test(value);\n}\n// Known attribute names (with IntelliSense) while still allowing arbitrary strings.\nexport type UnsAttribute = KnownUnsAttributeName | (string & {});\n\nexport const valueTypes = [\"string\", \"number\"] as const;\nexport type ValueTypeString = (typeof valueTypes)[number];\nexport type ScalarValueType = string | number;\n/** Scalar telemetry or a scalar array used by metadata such as relationship evidence. */\nexport type ValueType = ScalarValueType | ScalarValueType[];\n\nexport type CounterResetPolicy = \"new-value\" | \"null\" | \"rollover\" | (string & {});\n\nexport type UnsAttributeSystemRole =\n  | \"relationship-evidence\"\n  | \"lifecycle-start\"\n  | \"lifecycle-end\"\n  | \"lifecycle-time-source\"\n  | (string & {});\n\nexport type UnsRelationshipEndpoint = \"source\" | \"target\";\n\nexport interface IUnsRelationshipEvidenceMetadata {\n  relationshipKey: string;\n  ownerEndpoint?: UnsRelationshipEndpoint;\n  valueEndpoint?: UnsRelationshipEndpoint;\n  /** Scalar values produce one edge; array values produce one edge per ObjectId value. */\n  sourceObjectType?: UnsObjectType | (string & {});\n  targetObjectType?: UnsObjectType | (string & {});\n  sourceObjectIdFrom?: string;\n  targetObjectIdFrom?: string;\n  observedAtFrom?: string;\n  status?: \"suggested\" | \"accepted\" | (string & {});\n  defaultStatus?: \"suggested\" | \"accepted\" | (string & {});\n}\n\nexport interface IUnsLifecycleMetadata {\n  timestampFrom?: \"value\" | \"packetTimestamp\" | (string & {});\n  startValues?: string[];\n  endValues?: string[];\n}\n\nexport interface IUnsTableColumnMetadata {\n  name: string;\n  valueType?: ValueTypeString | (string & {});\n  presentationKind?: string;\n  defaultAggregation?: string;\n  counterResetPolicy?: CounterResetPolicy;\n}\n\nexport const questDbPrimitiveTypes = [\n  \"boolean\",\n  \"ipv4\",\n  \"byte\",\n  \"short\",\n  \"char\",\n  \"int\",\n  \"float\",\n  \"symbol\",\n  \"varchar\",\n  \"string\",\n  \"long\",\n  \"date\",\n  \"timestamp\",\n  \"timestamp_ns\",\n  \"double\",\n  \"uuid\",\n  \"binary\",\n  \"long256\",\n] as const;\n\nconst questDbPrimitiveTypeSet = new Set<string>(questDbPrimitiveTypes);\nconst questDbGeohashRegex = /^geohash\\(\\d+[bc]\\)$/;\nconst questDbDecimalRegex = /^decimal\\(\\d+,\\d+\\)$/;\nconst questDbArrayRegex = /^array<[^>]+>$/;\n\nexport type QuestDbPrimitiveType = (typeof questDbPrimitiveTypes)[number];\n\n// Supported QuestDB column types for UNS tables.\nexport type QuestDbType =\n  | QuestDbPrimitiveType\n  | `geohash(${number}${\"b\" | \"c\"})`\n  | `decimal(${number},${number})`\n  | `array<${string}>`;\n\nexport function isQuestDbType(value: unknown): value is QuestDbType {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  if (questDbPrimitiveTypeSet.has(value)) {\n    return true;\n  }\n  return (\n    questDbGeohashRegex.test(value) ||\n    questDbDecimalRegex.test(value) ||\n    questDbArrayRegex.test(value)\n  );\n}\n\nexport interface IUnsParameters {\n  mqttSubToTopics?: string | string[];\n  username?: string;\n  password?: string;\n  mqttSSL?: boolean;\n  publishThrottlingDelay?: number; // Delay in milliseconds; default is 1ms\n  publishConcurrency?: number; // Maximum concurrent outgoing publishes; default is 1\n  maxPendingPublishes?: number; // Maximum pending publishes across the API boundary and worker; default is unlimited\n  subscribeThrottlingDelay?: number; // Delay in milliseconds; default is 1ms\n  rejectUnauthorized?: boolean;\n  clientId?: string;\n  hosts?: string[];\n  servers?: IMqttServerConfig[];\n  port?: number;\n  protocol?: MqttProtocol;\n  keepalive?: number;\n  clean?: boolean;\n  connectTimeout?: number;\n  reconnectPeriod?: number;\n  reconnectOnConnackError?: boolean;\n  resubscribe?: boolean;\n  queueQoSZero?: boolean;\n  properties?: IMqttConnectProperties;\n  ca?: string;\n  cert?: string;\n  key?: string;\n  servername?: string;\n  /**\n   * Default MQTT publish options applied to all outgoing messages\n   * (e.g., qos, retain, messageExpiryInterval).\n   */\n  defaultPublishOptions?: IMqttPublishOptions;\n}\n\nexport interface IUnsProcessParameters {\n  /** Optional application drain after a cooperative handover. Register before creating proxies. */\n  handoverShutdown?: HandoverShutdownHooks;\n  processName: string;\n  /**\n   * Optional controller-supplied correlation id for one cooperative handover.\n   * Older peers ignore it, so it must never be required for normal startup.\n   */\n  handoverId?: string;\n  mqttSubToTopics?: string | string[];\n  username?: string;\n  password?: string;\n  mqttSSL?: boolean;\n  clientId?: string;\n  hosts?: string[];\n  servers?: IMqttServerConfig[];\n  port?: number;\n  protocol?: MqttProtocol;\n  keepalive?: number;\n  clean?: boolean;\n  connectTimeout?: number;\n  reconnectPeriod?: number;\n  reconnectOnConnackError?: boolean;\n  resubscribe?: boolean;\n  queueQoSZero?: boolean;\n  rejectUnauthorized?: boolean;\n  properties?: IMqttConnectProperties;\n  ca?: string;\n  cert?: string;\n  key?: string;\n  servername?: string;\n}\n\nexport interface UnsEvents {\n  // Emitters in MqttProxy, UnsMqttProxy\n  input: { topic: string; message: string, packet: any };\n  mqttProxyStatus: { event: string, value: number, uom: MeasurementUnit, statusTopic: string };\n  \n  // Emitters in MqttProxy\n  error: { code: number; message: string };\n  \n  // Emitters in UnsMqttProxy\n  mqttWorker: { command: string, instanceName: string; batchSize: number, referenceHash: string };\n\n  // Emitter in UnsCronProxy\n  cronEvent: { event?: string; cronExpression?: string };\n\n  // Emitters in UnsApiProxy\n  apiGetEvent: {req: any, res: any};\n  apiPostEvent: {req: any, res: any};\n  apiPutEvent: {req: any, res: any};\n  apiPatchEvent: {req: any, res: any};\n  apiDeleteEvent: {req: any, res: any};\n\n  // Emitters in UnsProxy\n  unsProxyProducedTopics: { producedTopics: ITopicObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedApiEndpoints: { producedApiEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedServiceEndpoints: { producedServiceEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedDataOfferEndpoints: { producedDataOfferEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedApiCatchAll: { producedCatchall: IApiCatchallMapping[], statusTopic: string };\n\n  // Emitters in UnsProxy / UnsApiProxy\n  unsProxyProducedDataCatalogOffers: { producedDataCatalogOffers: unknown[], statusTopic: string };\n}\n\nexport interface IUnsExtendedData extends IUnsData {\n  valueType: ValueTypeString;\n}\n\nexport interface IUnsData {\n  /** Domain-specific evidence/context fields may accompany the canonical value. */\n  [key: string]: unknown;\n  time: ISO8601;\n  value: ValueType;\n  /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */\n  dataGroup?: string;\n  uom?: MeasurementUnit;\n  foreignEventKey?: string;\n  intervalStart?: ISO8601 | number;\n  intervalEnd?: ISO8601 | number;\n  windowStart?: ISO8601 | number;\n  windowEnd?: ISO8601 | number;\n  eventId?: string;\n  deleted?: boolean;\n  deletedAt?: ISO8601 | number;\n  lastSeen?: ISO8601 | number;\n}\n\nexport interface IUnsTableColumn {\n  type: QuestDbType;\n  value: string | number | boolean | null;\n  uom?: MeasurementUnit;\n}\n\n/** MQTT table columns keyed by their stable UNS/QuestDB column name. */\nexport type IUnsTableColumns = Record<string, IUnsTableColumn>;\n\nexport interface IUnsTable {\n  time: ISO8601;\n  /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */\n  dataGroup?: string;\n  columns: IUnsTableColumns;\n  intervalStart?: ISO8601 | number;\n  intervalEnd?: ISO8601 | number;\n  windowStart?: ISO8601 | number;\n  windowEnd?: ISO8601 | number;\n  eventId?: string;\n  deleted?: boolean;\n  deletedAt?: ISO8601 | number;\n  lastSeen?: ISO8601 | number;\n}\n\nexport interface IMqttAttributeMessage {\n  attribute: UnsAttribute;\n  description?: string;\n  tags?: UnsTags[];\n  attributeNeedsPersistence?: boolean | null;\n  /** Optional controller/UI grouping hint for this ObjectId node; does not affect storage/table naming. */\n  virtualGroup?: string;\n  /** Scalar value shape for schema/catalog consumers, for example \"number\" or \"string\". */\n  valueType?: ValueTypeString | (string & {});\n  /**\n   * Operator-facing presentation hint. Use \"counter\" for cumulative counter\n   * state; delta/rate should be requested from Datahub history APIs.\n   */\n  presentationKind?: string;\n  /** Preferred aggregation for sampled history views, for example \"last\". */\n  defaultAggregation?: string;\n  /** Reset handling hint for cumulative counters. Interpreted by Datahub APIs, not by the producer. */\n  counterResetPolicy?: CounterResetPolicy;\n  /** Field-level metadata for table columns that should behave as chartable series. */\n  tableColumns?: IUnsTableColumnMetadata[];\n  /** Optional schema-system role published into Datahub's attribute_schema.schema_json. */\n  systemRole?: UnsAttributeSystemRole;\n  /** Relationship materialization metadata for `systemRole: \"relationship-evidence\"`. */\n  relationshipEvidence?: IUnsRelationshipEvidenceMetadata;\n  /** Lifecycle metadata for lifecycle system roles. */\n  lifecycle?: IUnsLifecycleMetadata;\n  /**\n   * How the controller determines if this attribute is live or stale.\n   * Defaults to `\"interval\"` with the controller's default interval (~120s) when omitted.\n   *\n   * @example\n   * // Sensor publishing every 2 seconds:\n   * { validityMode: \"interval\", expectedIntervalMs: 2000 }\n   *\n   * // Status attribute publishing every 2 seconds (string values like \"HEATING\"):\n   * { validityMode: \"interval\", expectedIntervalMs: 2000 }\n   *\n   * // Material location with ENTERED/EXITED lifecycle:\n   * { validityMode: \"lifecycle\", lifecycleEndValue: \"EXITED\" }\n   *\n   * // Static configuration value:\n   * { validityMode: \"static\" }\n   */\n  validityMode?: ValidityMode;\n  /**\n   * Expected publish interval in milliseconds. Only meaningful for `validityMode: \"interval\"`.\n   * The controller marks the attribute as stale after ~2× this value without a heartbeat update.\n   * Ignored for `\"lifecycle\"` and `\"static\"` modes.\n   */\n  expectedIntervalMs?: number;\n  /**\n   * The string value that marks a lifecycle as completed. Only meaningful for `validityMode: \"lifecycle\"`.\n   * When the attribute's current value matches this, the controller considers the lifecycle done.\n   * Example: `\"EXITED\"` for a location attribute with ENTERED/EXITED events.\n   */\n  lifecycleEndValue?: string;\n}\n\ntype AttributePayload =\n  | { message: IUnsMessage; data?: never; table?: never; createdAt?: never; expiresAt?: never }\n  | { message?: never; data: IUnsData; table?: never; createdAt?: ISO8601; expiresAt?: ISO8601 }\n  | { message?: never; data?: never; table: IUnsTable; createdAt?: ISO8601; expiresAt?: ISO8601 };\n\nexport type IMqttAttributeEntry = IMqttAttributeMessage & AttributePayload;\n\nexport type IAssetProviderIdentity = {\n  providerId: string;\n  externalSystem: string;\n  externalType: string;\n  externalId: string;\n};\n\nexport type IAssetIdentityPublicationMetadata =\n  | {\n      assetStableEntityId?: never;\n      assetDisplayName?: never;\n      assetIdentityProof?: never;\n      assetProviderIdentity?: never;\n      assetProviderIdentityProof?: never;\n    }\n  | {\n      /** Controller-issued stable Asset UUID. It identifies the Asset, not its current path. */\n      assetStableEntityId: string;\n      /** Optional operator-facing name; never used as an identity key. */\n      assetDisplayName?: string;\n      /** Short-lived controller-signed proof bound to this Asset UUID and exact candidate path. */\n      assetIdentityProof: string;\n      assetProviderIdentity?: never;\n      assetProviderIdentityProof?: never;\n    }\n  | {\n      assetStableEntityId?: never;\n      assetDisplayName?: never;\n      assetIdentityProof?: never;\n      /** Reviewed provider namespace plus external identifier for a provisional no-ID Asset. */\n      assetProviderIdentity: IAssetProviderIdentity;\n      /** Short-lived controller-signed proof bound to the provider identifier and exact candidate path. */\n      assetProviderIdentityProof: string;\n    };\n\nexport type IMqttPublishRequest = {\n  topic: UnsTopics;\n  asset: UnsAsset;\n  assetDescription?: string;\n  objectType: UnsObjectType;\n  objectTypeDescription?: string;\n  objectId: UnsObjectId;\n  /** Optional controller/UI grouping hint for ObjectId nodes; does not affect storage/table naming. */\n  virtualGroup?: string;\n  attributes: IMqttAttributeEntry | IMqttAttributeEntry[];\n} & IAssetIdentityPublicationMetadata;\n\n// This interface represents a packet for a UNS system\nexport interface IUnsPacket {\n  // The message object of the packet\n  message: IUnsExtendedMessage;\n  \n  // The HMAC signature of the message\n  messageSignature?: string;\n\n  // Automatically calculated interval between two packets in ms\n  interval?: number;\n\n  // Current library version\n  readonly version: string;\n\n  // Autogenerated sequence number\n  sequenceId?: number;\n}\n\nexport interface IUnsPackatParameters {\n\n}\n\nexport interface IUnsMessage {\n    data?: IUnsData;\n    table?: IUnsTable;\n    expiresAt?: ISO8601;\n    createdAt?: ISO8601;\n}\n\nexport interface IUnsExtendedMessage extends IUnsMessage {\n  data?: IUnsExtendedData;\n}\n\n/**\n * Controls how the controller determines whether an attribute is live or stale.\n *\n * - `\"interval\"` — Attribute publishes periodically. Stale if no heartbeat within ~2× the expected interval.\n *   Use with `expectedIntervalMs`. Works for both numeric sensors (temperature every 2s)\n *   and string status attributes (status every 2s). Example:\n *   `{ validityMode: \"interval\", expectedIntervalMs: 2000 }`\n *\n * - `\"lifecycle\"` — Attribute represents a lifecycle with a start and end event.\n *   Use with `lifecycleEndValue` to mark the end state. Example: material location with \"ENTERED\" / \"EXITED\".\n *\n * - `\"static\"` — Attribute is set once and never changes (configuration, metadata). Always live.\n *\n * When omitted, defaults to `\"interval\"` with the controller's default interval (~120s).\n */\nexport type ValidityMode = \"interval\" | \"lifecycle\" | \"static\";\n\nexport interface ITopicObject {\n  timestamp: string;\n  attribute:string;\n  attributeType: UnsAttributeType;\n  topic:string;\n  description:string;\n  /** Storage/routing group observed on the latest data/table payload for this identity. */\n  dataGroup:string;\n  /** Optional controller/UI grouping hint for ObjectId nodes; does not affect storage/table naming. */\n  virtualGroup?: string;\n  tags:string[] | null;\n  attributeNeedsPersistence: boolean | null;\n  /** Scalar value shape for schema/catalog consumers, for example \"number\" or \"string\". */\n  valueType?: ValueTypeString | (string & {});\n  /** Operator-facing presentation hint, for example \"counter\" for cumulative counter state. */\n  presentationKind?: string;\n  /** Preferred aggregation for sampled history views, for example \"last\". */\n  defaultAggregation?: string;\n  /** Reset handling hint for cumulative counters. Interpreted by Datahub APIs, not by the producer. */\n  counterResetPolicy?: CounterResetPolicy;\n  /** Field-level metadata for table columns that should behave as chartable series. */\n  tableColumns?: IUnsTableColumnMetadata[];\n  /** Optional schema-system role published into Datahub's attribute_schema.schema_json. */\n  systemRole?: UnsAttributeSystemRole;\n  /** Relationship materialization metadata for `systemRole: \"relationship-evidence\"`. */\n  relationshipEvidence?: IUnsRelationshipEvidenceMetadata;\n  /** Lifecycle metadata for lifecycle system roles. */\n  lifecycle?: IUnsLifecycleMetadata;\n  asset: UnsAsset;\n  assetDescription?: string;\n  /** Optional stable Asset UUID; accepted by the controller only with a valid publication proof. */\n  assetStableEntityId?: string;\n  /** Optional operator-facing name; never used as an identity key. */\n  assetDisplayName?: string;\n  /** Short-lived controller-signed evidence for this exact Asset path. */\n  assetIdentityProof?: string;\n  /** Reviewed provider namespace plus external identifier for a provisional no-ID Asset. */\n  assetProviderIdentity?: IAssetProviderIdentity;\n  /** Short-lived controller-signed evidence for this provider identifier and exact Asset path. */\n  assetProviderIdentityProof?: string;\n  objectType: UnsObjectType;\n  objectTypeDescription?: string;\n  objectId: UnsObjectId;\n  /** Liveliness validity mode — how the controller determines if this attribute is live/stale. */\n  validityMode?: ValidityMode;\n  /** For interval mode: expected publish interval in milliseconds (stale after ~2x this value). */\n  expectedIntervalMs?: number;\n  /** For lifecycle mode: the string value that marks the lifecycle as completed (e.g. \"EXITED\"). */\n  lifecycleEndValue?: string;\n}\n\n// API Interfaces below\nexport interface IApiObject {\n  timestamp: string;\n  attribute:string;\n  topic:string;\n  attributeType: UnsAttributeType;\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  apiDescription?: string; // Optional description for the API endpoint\n  apiHost: string; // Hostname of the service\n  apiEndpoint: string; // API endpoint for virtual topics\n  apiSwaggerEndpoint: string; // Swagger endpoint for API documentation\n  apiMethod: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\"; // HTTP method for API endpoint\n  apiQueryParams: QueryParamDef[]; // query parameters for the API endpoint\n  serviceApi?: Record<string, unknown> | null;\n  asset: UnsAsset;\n  objectType: UnsObjectType;\n  objectId: UnsObjectId;\n  controllerName?: string;\n  controllerHost?: string;\n  controllerPort?: string;\n  controllerPublicBase?: string;\n}\n\nexport interface IApiCatchallMapping {\n  topic: string;\n  apiBase: string;\n  apiBasePath: string;\n  swaggerPath: string;\n}\n\nexport interface QueryParamDef {\n  name: string;\n  type: \"string\" | \"number\" | \"boolean\";\n  required?: boolean;\n  description?: string;\n  /**\n   * Optional canonical chat alias used by assistant tooling.\n   * Typical values: from, to, limit, topic, timezone, summaryOnly.\n   */\n  chatCanonical?: string;\n  /**\n   * Optional default query value. Included in generated OpenAPI metadata.\n   */\n  defaultValue?: string | number | boolean;\n}\n\nexport interface ApiChatDefaults {\n  from?: string;\n  to?: string;\n  limit?: number;\n  topic?: string;\n  timezone?: string;\n  summaryOnly?: boolean;\n  [key: string]: string | number | boolean | undefined;\n}\n\nexport interface IApiProxyOptions {\n  jwtSecret?: string;\n  /**\n   * Public origin advertised for generated API endpoint metadata.\n   *\n   * Use a hostname or origin without a port (for example `127.0.0.1` or\n   * `http://service-name`) to keep the API server's actual listening port.\n   * An explicitly supplied port is preserved. Defaults to the machine's\n   * external IPv4 address for backwards compatibility.\n   */\n  publishedApiHost?: string;\n  jwks?: {\n    wellKnownJwksUrl: string;\n    activeKidUrl?: string;\n    cacheTtlMs?: number;\n    algorithms?: (\"RS256\" | \"RS384\" | \"RS512\")[];\n  };\n  /**\n   * Optional base prefixes to mount the API and swagger JSON under (e.g. \"/archiver-3\").\n   * Defaults to \"/api\" when not provided.\n   */\n  apiBasePath?: string;\n  swaggerBasePath?: string;\n  /**\n   * Skip mounting the default \"/api\" route. Useful when rebasing entirely under a custom prefix.\n   */\n  disableDefaultApiMount?: boolean;\n}\n\nexport interface IGetEndpointOptions {\n  apiDescription?: string;\n  tags?: string[];\n  queryParams?: QueryParamDef[];\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  serviceApi?: Record<string, unknown>;\n  /**\n   * Optional defaults consumed by chat tooling (published as OpenAPI vendor extension x-uns-chat.defaults).\n   */\n  chatDefaults?: ApiChatDefaults;\n}\n\nexport interface IPostEndpointOptions {\n  apiDescription?: string;\n  tags?: string[];\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  serviceApi?: Record<string, unknown>;\n  requestBody?: {\n    description?: string;\n    required?: boolean;\n    schema?: Record<string, unknown>;\n  };\n}\n\nexport interface IPutEndpointOptions extends IPostEndpointOptions {}\nexport interface IPatchEndpointOptions extends IPostEndpointOptions {}\nexport interface IDeleteEndpointOptions extends IPostEndpointOptions {}\n"]}

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

@@ -23,6 +23,7 @@ declare class UnsProxyProcess {
     private processName;
     private processId;
     private handoverId;
+    private handoverShutdown;
     private unsMqttProxies;
     private unsApiProxies;
     private processMqttProxy;

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":"AAMA,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAI7E,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,uBAAuB,EAA2B,MAAM,uBAAuB,CAAC;AAEvH,OAAO,EAAe,cAAc,EAAE,qBAAqB,EAAa,MAAM,qBAAqB,CAAC;AAGpG;;;;;;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,UAAU,CAAqB;IACvC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,eAAe,CAA8B;IAGrD,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;IAuE9E;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACU,kBAAkB,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,cAAc,GAC7B,OAAO,CAAC,YAAY,CAAC;IAqCX,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtD;;;;;;OAMG;IACU,sBAAsB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWnG;;;OAGG;IACI,QAAQ,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;YASvD,eAAe;CAgD9B;AAED,UAAU,eAAe;CAAG;AAE5B,eAAe,eAAe,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"uns-proxy-process.d.ts","sourceRoot":"","sources":["../../src/uns/uns-proxy-process.ts"],"names":[],"mappings":"AAMA,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAK7E,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,uBAAuB,EAA2B,MAAM,uBAAuB,CAAC;AAEvH,OAAO,EAAe,cAAc,EAAE,qBAAqB,EAAa,MAAM,qBAAqB,CAAC;AAGpG;;;;;;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,UAAU,CAAqB;IACvC,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,eAAe,CAA8B;IAGrD,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;IA0E9E;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;IACU,kBAAkB,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,cAAc,GAC7B,OAAO,CAAC,YAAY,CAAC;IAqCX,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtD;;;;;;OAMG;IACU,sBAAsB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWnG;;;OAGG;IACI,QAAQ,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;YASvD,eAAe;CAgD9B;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

@@ -4,6 +4,7 @@ import MqttProxy from "../uns-mqtt/mqtt-proxy.js";
 import { MqttTopicBuilder } from "../uns-mqtt/mqtt-topic-builder.js";
 import UnsMqttProxy from "../uns-mqtt/uns-mqtt-proxy.js";
 import { HandoverManager } from "./handover-manager.js";
+import { validateHandoverShutdown } from "./handover-shutdown.js";
 // Import configuration and initialization modules.
 import { MQTT_UPDATE_INTERVAL, PACKAGE_INFO } from "./process-config.js";
 import { buildUnsServiceMetadata } from "./service-metadata.js";
@@ -15,6 +16,7 @@ class UnsProxyProcess {
     processName;
     processId;
     handoverId;
+    handoverShutdown;
     unsMqttProxies;
     unsApiProxies;
     processMqttProxy;
@@ -75,6 +77,9 @@ class UnsProxyProcess {
         if (!unsProxyProcessParameters?.processName) {
             throw new Error("UnsProxyProcess requires a processName in configuration.");
         }
+        validateHandoverShutdown(unsProxyProcessParameters.handoverShutdown);
+        this.handoverShutdown = unsProxyProcessParameters.handoverShutdown
+            ? { ...unsProxyProcessParameters.handoverShutdown } : undefined;
         this.processName = unsProxyProcessParameters.processName;
         this.processId = randomBytes(16).toString("hex");
         this.handoverId = unsProxyProcessParameters.handoverId ?? process.env["UNS_HANDOVER_ID"];
@@ -129,7 +134,7 @@ class UnsProxyProcess {
     initHandoverManager(instanceMode, handover, handoverId) {
         const handoverRequestEnabled = instanceMode == "handover" ? true : false;
         const forceStartEnabled = instanceMode == "force" ? true : false;
-        this.handoverManager = new HandoverManager(this.processName, this.processId, this.processMqttProxy, this.unsMqttProxies, handoverRequestEnabled, handover ?? true, forceStartEnabled, handoverId);
+        this.handoverManager = new HandoverManager(this.processName, this.processId, this.processMqttProxy, this.unsMqttProxies, handoverRequestEnabled, handover ?? true, forceStartEnabled, handoverId, this.handoverShutdown);
         // Listen for handover events.
         this.handoverManager.event.on("handoverManager", (event) => {
             this.active = event.active;

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 { randomBytes } from \"crypto\";\n\nimport logger from \"../logger.js\";\nimport { IMqttParameters } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport MqttProxy from \"../uns-mqtt/mqtt-proxy.js\";\nimport { MqttTopicBuilder } from \"../uns-mqtt/mqtt-topic-builder.js\";\nimport UnsMqttProxy from \"../uns-mqtt/uns-mqtt-proxy.js\";\nimport type { UnsMqttProxyStopOptions } from \"../uns-mqtt/uns-mqtt-proxy.js\";\nimport { HandoverManager } from \"./handover-manager.js\";\n// Import configuration and initialization modules.\nimport { MQTT_UPDATE_INTERVAL, PACKAGE_INFO } from \"./process-config.js\";\nimport { type UnsServiceMetadata, type UnsServiceMetadataInput, buildUnsServiceMetadata } from \"./service-metadata.js\";\nimport { StatusMonitor } from \"./status-monitor.js\";\nimport { IUnsMessage, IUnsParameters, IUnsProcessParameters, UnsEvents } from \"./uns-interfaces.js\";\nimport { UnsPacket } from \"./uns-packet.js\";\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 handoverId: string | undefined;\n  private unsMqttProxies: UnsMqttProxy[];\n  private unsApiProxies: unknown[];\n  private processMqttProxy: MqttProxy;\n  private handoverManager: HandoverManager;\n  private statusMonitor: StatusMonitor;\n  private serviceMetadataTopic: string;\n  private shutdownPromise: Promise<void> | null = null;\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    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    this.handoverId = unsProxyProcessParameters.handoverId ?? process.env[\"UNS_HANDOVER_ID\"];\n    const { name: packageName, version } = PACKAGE_INFO;\n\n    // Instantiate the topic builder.\n    const topicBuilder = new MqttTopicBuilder(\n      `uns-infra/${MqttTopicBuilder.sanitizeTopicPart(packageName)}/${MqttTopicBuilder.sanitizeTopicPart(version)}/${MqttTopicBuilder.sanitizeTopicPart(this.processName)}/`,\n    );\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 ?? [wildcardActiveTopic, handoverTopic];\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, handoverId?: string) {\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      handoverId,\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,\n  ): 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(\n        instanceMode,\n        handover,\n        this.handoverId,\n      );\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(event.statusTopic, JSON.stringify(event.producedTopics));\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(event.statusTopic, JSON.stringify(packet));\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(this.serviceMetadataTopic, JSON.stringify(resolved), { retain: true });\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(options: UnsMqttProxyStopOptions = {}): Promise<void> {\n    if (this.shutdownPromise) {\n      return this.shutdownPromise;\n    }\n\n    this.shutdownPromise = this.performShutdown(options);\n    return this.shutdownPromise;\n  }\n\n  private async performShutdown(options: UnsMqttProxyStopOptions): Promise<void> {\n    logger.info(`${this.processName} - Shutting down UnsProxyProcess...`);\n    const shutdownErrors: Error[] = [];\n\n    try {\n      this.statusMonitor.stop();\n      await this.statusMonitor.publishInactiveStatus();\n    } catch (e: any) {\n      const reason = e instanceof Error ? e : new Error(String(e));\n      logger.error(`${this.processName} - Error stopping StatusMonitor or publishing passive state: ${reason.message}`);\n      shutdownErrors.push(reason);\n    }\n\n    if (this.mqttInputHandler) {\n      try {\n        this.processMqttProxy.event.off(\"input\", this.mqttInputHandler);\n      } catch (e: any) {\n        const reason = e instanceof Error ? e : new Error(String(e));\n        logger.error(`${this.processName} - Error removing MQTT input handler: ${reason.message}`);\n        shutdownErrors.push(reason);\n      }\n    }\n\n    const proxyStopResults = await Promise.allSettled(this.unsMqttProxies.map((proxy) => proxy.stop(options)));\n    for (const result of proxyStopResults) {\n      if (result.status === \"rejected\") {\n        const reason = result.reason instanceof Error ? result.reason : new Error(String(result.reason));\n        logger.error(`${this.processName} - Error stopping UNS MQTT proxy: ${reason.message}`);\n        shutdownErrors.push(reason);\n      }\n    }\n\n    try {\n      if (typeof this.processMqttProxy.stop === \"function\") {\n        await this.processMqttProxy.stop();\n      }\n    } catch (e: any) {\n      const reason = e instanceof Error ? e : new Error(String(e));\n      logger.error(`${this.processName} - Error stopping MQTT proxy: ${reason.message}`);\n      shutdownErrors.push(reason);\n    }\n\n    if (shutdownErrors.length > 0) {\n      throw new AggregateError(shutdownErrors, `${this.processName} - Shutdown completed with errors.`);\n    }\n\n    logger.info(`${this.processName} - Shutdown complete.`);\n  }\n}\n\ninterface UnsProxyProcess {}\n\nexport default UnsProxyProcess;\nexport type { UnsServiceMetadata, UnsServiceMetadataInput };\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 { randomBytes } from \"crypto\";\n\nimport logger from \"../logger.js\";\nimport { IMqttParameters } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport MqttProxy from \"../uns-mqtt/mqtt-proxy.js\";\nimport { MqttTopicBuilder } from \"../uns-mqtt/mqtt-topic-builder.js\";\nimport UnsMqttProxy from \"../uns-mqtt/uns-mqtt-proxy.js\";\nimport type { UnsMqttProxyStopOptions } from \"../uns-mqtt/uns-mqtt-proxy.js\";\nimport { HandoverManager } from \"./handover-manager.js\";\nimport { validateHandoverShutdown, type HandoverShutdownHooks } from \"./handover-shutdown.js\";\n// Import configuration and initialization modules.\nimport { MQTT_UPDATE_INTERVAL, PACKAGE_INFO } from \"./process-config.js\";\nimport { type UnsServiceMetadata, type UnsServiceMetadataInput, buildUnsServiceMetadata } from \"./service-metadata.js\";\nimport { StatusMonitor } from \"./status-monitor.js\";\nimport { IUnsMessage, IUnsParameters, IUnsProcessParameters, UnsEvents } from \"./uns-interfaces.js\";\nimport { UnsPacket } from \"./uns-packet.js\";\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 handoverId: string | undefined;\n  private handoverShutdown: HandoverShutdownHooks | undefined;\n  private unsMqttProxies: UnsMqttProxy[];\n  private unsApiProxies: unknown[];\n  private processMqttProxy: MqttProxy;\n  private handoverManager: HandoverManager;\n  private statusMonitor: StatusMonitor;\n  private serviceMetadataTopic: string;\n  private shutdownPromise: Promise<void> | null = null;\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    if (!unsProxyProcessParameters?.processName) {\n      throw new Error(\"UnsProxyProcess requires a processName in configuration.\");\n    }\n    validateHandoverShutdown(unsProxyProcessParameters.handoverShutdown);\n    this.handoverShutdown = unsProxyProcessParameters.handoverShutdown\n      ? { ...unsProxyProcessParameters.handoverShutdown } : undefined;\n    this.processName = unsProxyProcessParameters.processName;\n    this.processId = randomBytes(16).toString(\"hex\");\n    this.handoverId = unsProxyProcessParameters.handoverId ?? process.env[\"UNS_HANDOVER_ID\"];\n    const { name: packageName, version } = PACKAGE_INFO;\n\n    // Instantiate the topic builder.\n    const topicBuilder = new MqttTopicBuilder(\n      `uns-infra/${MqttTopicBuilder.sanitizeTopicPart(packageName)}/${MqttTopicBuilder.sanitizeTopicPart(version)}/${MqttTopicBuilder.sanitizeTopicPart(this.processName)}/`,\n    );\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 ?? [wildcardActiveTopic, handoverTopic];\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, handoverId?: string) {\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      handoverId,\n      this.handoverShutdown,\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,\n  ): 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(\n        instanceMode,\n        handover,\n        this.handoverId,\n      );\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(event.statusTopic, JSON.stringify(event.producedTopics));\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(event.statusTopic, JSON.stringify(packet));\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(this.serviceMetadataTopic, JSON.stringify(resolved), { retain: true });\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(options: UnsMqttProxyStopOptions = {}): Promise<void> {\n    if (this.shutdownPromise) {\n      return this.shutdownPromise;\n    }\n\n    this.shutdownPromise = this.performShutdown(options);\n    return this.shutdownPromise;\n  }\n\n  private async performShutdown(options: UnsMqttProxyStopOptions): Promise<void> {\n    logger.info(`${this.processName} - Shutting down UnsProxyProcess...`);\n    const shutdownErrors: Error[] = [];\n\n    try {\n      this.statusMonitor.stop();\n      await this.statusMonitor.publishInactiveStatus();\n    } catch (e: any) {\n      const reason = e instanceof Error ? e : new Error(String(e));\n      logger.error(`${this.processName} - Error stopping StatusMonitor or publishing passive state: ${reason.message}`);\n      shutdownErrors.push(reason);\n    }\n\n    if (this.mqttInputHandler) {\n      try {\n        this.processMqttProxy.event.off(\"input\", this.mqttInputHandler);\n      } catch (e: any) {\n        const reason = e instanceof Error ? e : new Error(String(e));\n        logger.error(`${this.processName} - Error removing MQTT input handler: ${reason.message}`);\n        shutdownErrors.push(reason);\n      }\n    }\n\n    const proxyStopResults = await Promise.allSettled(this.unsMqttProxies.map((proxy) => proxy.stop(options)));\n    for (const result of proxyStopResults) {\n      if (result.status === \"rejected\") {\n        const reason = result.reason instanceof Error ? result.reason : new Error(String(result.reason));\n        logger.error(`${this.processName} - Error stopping UNS MQTT proxy: ${reason.message}`);\n        shutdownErrors.push(reason);\n      }\n    }\n\n    try {\n      if (typeof this.processMqttProxy.stop === \"function\") {\n        await this.processMqttProxy.stop();\n      }\n    } catch (e: any) {\n      const reason = e instanceof Error ? e : new Error(String(e));\n      logger.error(`${this.processName} - Error stopping MQTT proxy: ${reason.message}`);\n      shutdownErrors.push(reason);\n    }\n\n    if (shutdownErrors.length > 0) {\n      throw new AggregateError(shutdownErrors, `${this.processName} - Shutdown completed with errors.`);\n    }\n\n    logger.info(`${this.processName} - Shutdown complete.`);\n  }\n}\n\ninterface UnsProxyProcess {}\n\nexport default UnsProxyProcess;\nexport type { UnsServiceMetadata, UnsServiceMetadataInput };\nexport { UnsProxyProcess };\n"]}

package/package.json

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