@zlink-systems/framework 0.25.0 → 0.27.0

package/dist/runtime/framework-errors-internal.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES = exports.ZLinkFrameworkInternalErrorKind = void 0;
+exports.frameworkRelocationFailureCode = frameworkRelocationFailureCode;
 exports.createInternalFrameworkException = createInternalFrameworkException;
 exports.internalFrameworkErrorKind = internalFrameworkErrorKind;
 exports.requestResultToPublicErrorKind = requestResultToPublicErrorKind;
@@ -14,6 +15,7 @@ exports.isCanonicalWireReplyTerminal = isCanonicalWireReplyTerminal;
 const ZLinkFrameworkException_1 = require("../contracts/Errors/ZLinkFrameworkException");
 const runtime_values_1 = require("./backend/runtime-values");
 const service_wire_m6a_codec_1 = require("./foundation/service-wire-m6a-codec");
+const service_wire_constants_generated_1 = require("./foundation/service-wire-constants.generated");
 /** Detailed failure reasons owned by Framework runtime bounded contexts. */
 var ZLinkFrameworkInternalErrorKind;
 (function (ZLinkFrameworkInternalErrorKind) {
@@ -60,110 +62,326 @@ var ZLinkFrameworkInternalErrorKind;
     ZLinkFrameworkInternalErrorKind["InvalidOperation"] = "invalidOperation";
     ZLinkFrameworkInternalErrorKind["ActorRouteUnavailable"] = "actorRouteUnavailable";
 })(ZLinkFrameworkInternalErrorKind || (exports.ZLinkFrameworkInternalErrorKind = ZLinkFrameworkInternalErrorKind = {}));
-const INTERNAL_TO_PUBLIC = Object.freeze({
-    [ZLinkFrameworkInternalErrorKind.ActorRouteNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.ActorCreateFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.ActorAlreadyExists]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
-    [ZLinkFrameworkInternalErrorKind.ActorTypeMismatch]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
-    [ZLinkFrameworkInternalErrorKind.SpotCreateFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.SpotRouteNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.SpotTypeMismatch]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
-    [ZLinkFrameworkInternalErrorKind.ActorSessionNotBound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.HandlerNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.RouteHandlerNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
-    [ZLinkFrameworkInternalErrorKind.RouteNotConnected]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.RequestTargetNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.RequestRejected]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
-    [ZLinkFrameworkInternalErrorKind.RequestProtocolError]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
-    [ZLinkFrameworkInternalErrorKind.RequestFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.WorkerQueueFull]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.WorkerTimedOut]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
-    [ZLinkFrameworkInternalErrorKind.WorkerFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.ActorLocationStale]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.ActorCreateRejected]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
-    [ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
-    [ZLinkFrameworkInternalErrorKind.MeshSelectionRequired]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
-    [ZLinkFrameworkInternalErrorKind.MeshNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.InvalidConfiguration]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
-    [ZLinkFrameworkInternalErrorKind.AlreadySubmitted]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.ActorGenerationStale]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.ActorMoving]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.DeadlineExceeded]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
-    [ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.RoutingIdConflict]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
-    [ZLinkFrameworkInternalErrorKind.SpotGenerationStale]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.SpotMoving]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.RelocationDataLost]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DataLost,
-    [ZLinkFrameworkInternalErrorKind.SpotIdConflict]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
-    [ZLinkFrameworkInternalErrorKind.RuntimeShutdown]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ShuttingDown,
-    [ZLinkFrameworkInternalErrorKind.RelocationDisabled]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
-    [ZLinkFrameworkInternalErrorKind.RelocationTargetUnavailable]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.RelocationFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.InvalidOperation]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.ActorRouteUnavailable]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable
-});
-exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES = Object.freeze({
-    [ZLinkFrameworkInternalErrorKind.ActorRouteNotFound]: 0,
-    [ZLinkFrameworkInternalErrorKind.ActorCreateFailed]: 1,
-    [ZLinkFrameworkInternalErrorKind.ActorAlreadyExists]: 2,
-    [ZLinkFrameworkInternalErrorKind.ActorTypeMismatch]: 3,
-    [ZLinkFrameworkInternalErrorKind.SpotCreateFailed]: 4,
-    [ZLinkFrameworkInternalErrorKind.SpotRouteNotFound]: 5,
-    [ZLinkFrameworkInternalErrorKind.SpotTypeMismatch]: 6,
-    [ZLinkFrameworkInternalErrorKind.ActorSessionNotBound]: 7,
-    [ZLinkFrameworkInternalErrorKind.HandlerNotFound]: 8,
-    [ZLinkFrameworkInternalErrorKind.RouteHandlerNotFound]: 9,
-    [ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound]: 10,
-    [ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed]: 11,
-    [ZLinkFrameworkInternalErrorKind.RouteNotConnected]: 12,
-    [ZLinkFrameworkInternalErrorKind.RequestTargetNotFound]: 13,
-    [ZLinkFrameworkInternalErrorKind.RequestRejected]: 14,
-    [ZLinkFrameworkInternalErrorKind.RequestProtocolError]: 15,
-    [ZLinkFrameworkInternalErrorKind.RequestFailed]: 16,
-    [ZLinkFrameworkInternalErrorKind.WorkerQueueFull]: 17,
-    [ZLinkFrameworkInternalErrorKind.WorkerTimedOut]: 18,
-    [ZLinkFrameworkInternalErrorKind.WorkerFailed]: 19,
-    [ZLinkFrameworkInternalErrorKind.ActorLocationStale]: 20,
-    [ZLinkFrameworkInternalErrorKind.ActorCreateRejected]: 21,
-    [ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured]: 22,
-    [ZLinkFrameworkInternalErrorKind.MeshSelectionRequired]: 23,
-    [ZLinkFrameworkInternalErrorKind.MeshNotFound]: 24,
-    [ZLinkFrameworkInternalErrorKind.InvalidConfiguration]: 25,
-    [ZLinkFrameworkInternalErrorKind.AlreadySubmitted]: 26,
-    [ZLinkFrameworkInternalErrorKind.ActorGenerationStale]: 27,
-    [ZLinkFrameworkInternalErrorKind.ActorMoving]: 28,
-    [ZLinkFrameworkInternalErrorKind.DeadlineExceeded]: 29,
-    [ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted]: 30,
-    [ZLinkFrameworkInternalErrorKind.RoutingIdConflict]: 31,
-    [ZLinkFrameworkInternalErrorKind.SpotGenerationStale]: 32,
-    [ZLinkFrameworkInternalErrorKind.SpotMoving]: 33,
-    [ZLinkFrameworkInternalErrorKind.RelocationDataLost]: 34,
-    [ZLinkFrameworkInternalErrorKind.SpotIdConflict]: 35,
-    [ZLinkFrameworkInternalErrorKind.RuntimeShutdown]: 36,
-    [ZLinkFrameworkInternalErrorKind.RelocationDisabled]: 37,
-    [ZLinkFrameworkInternalErrorKind.RelocationTargetUnavailable]: 38,
-    [ZLinkFrameworkInternalErrorKind.RelocationFailed]: 39,
-    [ZLinkFrameworkInternalErrorKind.InvalidOperation]: 40,
-    [ZLinkFrameworkInternalErrorKind.ActorRouteUnavailable]: 41
-});
-const INTERNAL_KIND_BY_WIRE_FAILURE_CODE = new Map([
-    ...Object.entries(exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES).map(([kind, code]) => [code + 1, kind]),
-    //  Spec 32-framework-error-model:99-103 — a workerQueueFull(18) received in a
-    //  remote reply is the target's queue state and maps to Unavailable.
-    [18, ZLinkFrameworkInternalErrorKind.RouteNotConnected]
-]);
+// Error model §2.1 owns the wire codes and public representatives.
+const FAILURE_MAPPINGS = [
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorRouteNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorRouteNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorRouteNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorCreateFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorCreateFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorCreateFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorAlreadyExists,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorAlreadyExists - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorAlreadyExists
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorTypeMismatch,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorTypeMismatch - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorTypeMismatch
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotCreateFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotCreateFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotCreateFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotRouteNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotRouteNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotRouteNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotTypeMismatch,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotTypeMismatch - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotTypeMismatch
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorSessionNotBound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorSessionNotBound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorSessionNotBound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.HandlerNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.handlerNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.handlerNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RouteHandlerNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeHandlerNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeHandlerNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorDispatchHandlerNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorDispatchHandlerNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.payloadDecodeFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.payloadDecodeFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RouteNotConnected,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RequestTargetNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestTargetNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestTargetNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RequestRejected,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestRejected - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestRejected
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RequestProtocolError,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestProtocolError - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestProtocolError
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RequestFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.WorkerQueueFull,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerQueueFull - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerQueueFull
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.WorkerTimedOut,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerTimedOut - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerTimedOut
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.WorkerFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorLocationStale,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorLocationStale - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorLocationStale
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorCreateRejected,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorCreateRejected - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorCreateRejected
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
+        internalValue: 22
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.MeshSelectionRequired,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
+        internalValue: 23
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.MeshNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: 24
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.InvalidConfiguration,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
+        internalValue: 25
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.AlreadySubmitted,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: 26
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorGenerationStale,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: 27
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorMoving,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: 28
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.DeadlineExceeded,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
+        internalValue: 29
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: 30
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RoutingIdConflict,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
+        internalValue: 31
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotGenerationStale,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotGenerationStale - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotGenerationStale
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotMoving,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotMoving - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotMoving
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RelocationDataLost,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DataLost,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.relocationDataLost - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.relocationDataLost
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotIdConflict,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
+        internalValue: 35
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RuntimeShutdown,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ShuttingDown,
+        internalValue: 36
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RelocationDisabled,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
+        internalValue: 37
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RelocationTargetUnavailable,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: 38
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RelocationFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: 39
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.InvalidOperation,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: 40
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorRouteUnavailable,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected - 1
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestTargetNotFound,
+        sendTerminal: runtime_values_1.RequestResult.NotFound
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorAlreadyExists,
+        sendTerminal: runtime_values_1.RequestResult.Conflict
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotTypeMismatch,
+        sendTerminal: runtime_values_1.RequestResult.Conflict
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestRejected,
+        sendTerminal: runtime_values_1.RequestResult.Rejected
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerTimedOut,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ShuttingDown,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.none,
+        codeOnlySend: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected,
+        sendTerminal: runtime_values_1.RequestResult.Terminated
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestProtocolError,
+        sendTerminal: runtime_values_1.RequestResult.ProtocolError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.none,
+        codeOnlySend: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed,
+        sendTerminal: runtime_values_1.RequestResult.InvalidState
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DataLost,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.relocationDataLost,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    }
+];
+const INTERNAL_MAPPING = new Map(FAILURE_MAPPINGS.filter((row) => row.internalKind !== undefined).map((row) => [
+    row.internalKind,
+    row
+]));
+const PUBLIC_MAPPING = new Map(FAILURE_MAPPINGS.filter((row) => row.internalKind === undefined).map((row) => [
+    row.publicKind,
+    row
+]));
+const RECEIVE_MAPPING = new Map(FAILURE_MAPPINGS.filter((row) => row.internalKind !== undefined && row.send !== undefined).map((row) => [row.send, row.internalKind]));
+exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES = Object.freeze(Object.fromEntries([...INTERNAL_MAPPING].map(([kind, row]) => [kind, row.internalValue])));
+function frameworkRelocationFailureCode(error) {
+    const row = outgoingFailureMapping(error);
+    return row.codeOnlySend ?? row.send;
+}
 const WIRE_TERMINAL_RESULT_BY_FAILURE_CODE = new Map([
-    ...[1, 6, 8, 9, 10, 11, 14].map((code) => [code, 102]),
-    ...[2, 5, 13, 17, 19, 20, 35, 42].map((code) => [code, 105]),
-    ...[3, 4, 7, 21, 33, 34].map((code) => [code, 107]),
-    ...[12, 16].map((code) => [code, 104]),
-    ...[15, 18, 22].map((code) => [code, 106])
+    ...Object.entries(service_wire_constants_generated_1.ServiceWireExactTerminalByFailureCode).map(([code, terminal]) => [Number(code), terminal])
 ]);
 const INTERNAL_KIND = new WeakMap();
 function createInternalFrameworkException(kind, message, causeOrRetry, cause) {
-    const error = new ZLinkFrameworkException_1.ZLinkFrameworkException(INTERNAL_TO_PUBLIC[kind], message, typeof causeOrRetry === 'boolean' ? cause : causeOrRetry);
+    const error = new ZLinkFrameworkException_1.ZLinkFrameworkException(INTERNAL_MAPPING.get(kind).publicKind, message, typeof causeOrRetry === 'boolean' ? cause : causeOrRetry);
     INTERNAL_KIND.set(error, kind);
     return error;
 }
@@ -252,44 +470,47 @@ function internalFrameworkErrorCode(error) {
     const kind = INTERNAL_KIND.get(error);
     return kind === undefined ? error.kind : exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES[kind];
 }
+/** Selects a known cause or the public kind's representative for both wire forms. */
+function outgoingFailureMapping(error) {
+    const internal = typeof error === 'string' ? INTERNAL_MAPPING.get(error) : undefined;
+    const publicKind = internal?.publicKind ??
+        (typeof error === 'number' ? error : error.kind);
+    let cause = error;
+    while (cause instanceof ZLinkFrameworkException_1.ZLinkFrameworkException || typeof cause === 'string') {
+        const row = INTERNAL_MAPPING.get(typeof cause === 'string'
+            ? cause
+            : INTERNAL_KIND.get(cause));
+        if (row?.send !== undefined && row.publicKind === publicKind)
+            return row;
+        cause = typeof cause === 'string' ? undefined : cause.cause;
+    }
+    return (PUBLIC_MAPPING.get(publicKind) ?? PUBLIC_MAPPING.get(ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure));
+}
 /** Produces the canonical stateful wire terminal without leaking internal kinds. */
 function internalFrameworkWireReply(error) {
-    const kind = INTERNAL_KIND.get(error);
-    if (kind === ZLinkFrameworkInternalErrorKind.DeadlineExceeded) {
-        return { terminalResult: 101, failureCode: 0 };
-    }
-    if (kind === undefined) {
-        return { terminalResult: 105, failureCode: 17 };
-    }
-    const failureCode = exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES[kind] + 1;
-    const terminalResult = WIRE_TERMINAL_RESULT_BY_FAILURE_CODE.get(failureCode);
-    return terminalResult === undefined
-        ? { terminalResult: 105, failureCode: 17 }
-        : { terminalResult, failureCode };
+    const row = outgoingFailureMapping(error);
+    return {
+        terminalResult: row.sendTerminal ?? WIRE_TERMINAL_RESULT_BY_FAILURE_CODE.get(row.send),
+        failureCode: row.send
+    };
 }
 /** Decodes the stateful reply failureCode convention without exposing wire offsets to callers. */
 function internalFrameworkErrorKindFromWireFailureCode(failureCode) {
-    return INTERNAL_KIND_BY_WIRE_FAILURE_CODE.get(failureCode);
+    return RECEIVE_MAPPING.get(failureCode);
 }
 /** Restores a typed failure only when its wire terminal result is canonical. */
 function internalFrameworkErrorKindFromWireReply(terminalResult, failureCode) {
-    // ServiceStaleGenerationError is emitted as NotFound with the historical
-    // stale-route code, while the same internal code is also used by Conflict
-    // replies from the actor route protocol.
-    if (terminalResult === 102 && failureCode === 21) {
-        return ZLinkFrameworkInternalErrorKind.ActorLocationStale;
-    }
     const kind = internalFrameworkErrorKindFromWireFailureCode(failureCode);
     if (kind === undefined)
         return undefined;
     const expectedTerminalResult = WIRE_TERMINAL_RESULT_BY_FAILURE_CODE.get(failureCode);
     return expectedTerminalResult === terminalResult ? kind : undefined;
 }
-const BOUNDARY_WIRE_TERMINAL_RESULTS = new Set([101, 103, 108, 109, 110, 111, 112, 113]);
+const BOUNDARY_WIRE_TERMINAL_RESULTS = new Set(service_wire_constants_generated_1.ServiceWireBoundaryTerminalResults);
 /** Checks the terminal and failure-code pair before a transport maps it. */
 function isCanonicalWireReplyTerminal(terminalResult, failureCode) {
-    if (terminalResult === 0)
-        return failureCode === 0;
+    if (terminalResult === runtime_values_1.RequestResult.Ok)
+        return failureCode === service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.none;
     if (BOUNDARY_WIRE_TERMINAL_RESULTS.has(terminalResult))
         return failureCode === 0;
     return internalFrameworkErrorKindFromWireReply(terminalResult, failureCode) !== undefined;

package/dist/runtime/handlers/handler-instance-scope.d.ts

@@ -1,5 +1,6 @@
 import type { Type, ZLinkMessageContext } from '../../contracts';
 import type { ZLinkProviderResolver } from '../../contracts/Common/ZLinkProviderResolver';
+import type { ZLinkDetachedTaskRunner } from '../spots/spot-actor-join-dispatch';
 export interface ZLinkHandlerInstanceScope {
     resolve<T>(type: Type<T>): Promise<T>;
     dispose(): Promise<void>;
@@ -7,5 +8,6 @@ export interface ZLinkHandlerInstanceScope {
 export declare function runInHandlerInstanceScope<T>(providerResolver: ZLinkProviderResolver | undefined, context: ZLinkMessageContext | undefined, callback: (scope: ZLinkHandlerInstanceScope) => Promise<T>): Promise<T>;
 export declare function resolveLifecycleHandler<T>(owner: object, type: Type<T>, providerResolver?: ZLinkProviderResolver): Promise<T>;
 export declare function runWithLifecycleHandler<THandler, TResult>(owner: object, type: Type<THandler>, providerResolver: ZLinkProviderResolver | undefined, callback: (handler: THandler) => Promise<TResult>): Promise<TResult>;
-export declare function disposeLifecycleHandlers(owner: object): Promise<void>;
+export declare function disposeLifecycleHandlers(owner: object, detachedTaskRunner: ZLinkDetachedTaskRunner): Promise<void>;
 export declare function disposeOwnedInstance(instance: unknown): Promise<void>;
+export declare function disposeOwnedInstances(instances: readonly unknown[]): Promise<void>;