@uns-kit/core 3.0.22 → 3.0.24

package/MIGRATIONS.md

@@ -9,6 +9,55 @@ 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.24 - Generated numeric delta metadata
+
+When upgrading from `<3.0.24` to `>=3.0.24`, numeric scalar publications in
+the deprecated `MessageMode.Delta` and `MessageMode.Both` modes declare
+`presentationKind: "delta"` and `defaultAggregation: "sum"` on the generated
+`-delta` attribute. They no longer inherit cumulative-counter presentation,
+last aggregation or a counter reset-policy hint. The original raw attribute
+keeps its caller-supplied metadata. Paths, packet values, timestamps, units,
+persistence, freshness and the existing difference/reset calculation remain
+unchanged. Non-numeric and table publication metadata are unchanged.
+
+Review existing canonical schema definitions for generated delta attributes:
+controllers may keep previously stored non-null shape fields after an upgrade.
+Correct reviewed definitions to interval/delta semantics and request raw
+history with sum aggregation for interval amounts. Do not difference already
+calculated deltas. Do not globally label unsuffixed attributes as counters
+from their names: other publishers can reuse a name for interval amounts.
+
+These legacy producer delta modes still lose previous-value state on restart.
+Preserve consumers while migrating toward raw cumulative counters and history
+API delta/rate transforms; this metadata fix does not make delta state durable.
+
+## 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

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.