@zlink-systems/framework 0.30.0 → 0.30.2

package/dist/runtime/protocol/service_wire_codec.generated.js

@@ -137,6 +137,9 @@ exports.encodeRelocationPhase = encodeRelocationPhase;
 exports.enumWireSourceCleanupState = enumWireSourceCleanupState;
 exports.decodeSourceCleanupState = decodeSourceCleanupState;
 exports.encodeSourceCleanupState = encodeSourceCleanupState;
+exports.enumWireSessionSealResult = enumWireSessionSealResult;
+exports.decodeSessionSealResult = decodeSessionSealResult;
+exports.encodeSessionSealResult = encodeSessionSealResult;
 exports.enumWireReplyRelayAckStatus = enumWireReplyRelayAckStatus;
 exports.decodeReplyRelayAckStatus = decodeReplyRelayAckStatus;
 exports.encodeReplyRelayAckStatus = encodeReplyRelayAckStatus;
@@ -351,6 +354,10 @@ exports.decodeRelocationPendingTimerTick = decodeRelocationPendingTimerTick;
 exports.encodeRelocationPendingTimerTick = encodeRelocationPendingTimerTick;
 exports.decodeRelocationPendingTimerTickVector = decodeRelocationPendingTimerTickVector;
 exports.encodeRelocationPendingTimerTickVector = encodeRelocationPendingTimerTickVector;
+exports.decodeRelocationSessionBinding = decodeRelocationSessionBinding;
+exports.encodeRelocationSessionBinding = encodeRelocationSessionBinding;
+exports.decodeRelocationSessionBindingVector = decodeRelocationSessionBindingVector;
+exports.encodeRelocationSessionBindingVector = encodeRelocationSessionBindingVector;
 exports.decodeRelocationEnvelopeV1 = decodeRelocationEnvelopeV1;
 exports.encodeRelocationEnvelopeV1 = encodeRelocationEnvelopeV1;
 exports.decodeHelloCommand = decodeHelloCommand;
@@ -473,6 +480,9 @@ exports.validateRelocationStateCommandRuntimePredicates = validateRelocationStat
 exports.decodeRelocationFailedCommand = decodeRelocationFailedCommand;
 exports.encodeRelocationFailedCommand = encodeRelocationFailedCommand;
 exports.validateRelocationFailedCommandRuntimePredicates = validateRelocationFailedCommandRuntimePredicates;
+exports.decodeBoundSessionCloseCommand = decodeBoundSessionCloseCommand;
+exports.encodeBoundSessionCloseCommand = encodeBoundSessionCloseCommand;
+exports.validateBoundSessionCloseCommandRuntimePredicates = validateBoundSessionCloseCommandRuntimePredicates;
 exports.decodeAuthorityPayloadV1DurableFormat = decodeAuthorityPayloadV1DurableFormat;
 exports.encodeAuthorityPayloadV1DurableFormat = encodeAuthorityPayloadV1DurableFormat;
 exports.decodeInstanceActivationRecoveryV1DurableFormat = decodeInstanceActivationRecoveryV1DurableFormat;
@@ -2717,6 +2727,32 @@ function writeSourceCleanupState(input, writer, context, enclosing, flags) {
 }
 function decodeSourceCleanupState(bytes, context) { const reader = new Reader(bytes); const value = readSourceCleanupState(reader, context, {}, 0); reader.done("source-cleanup-state"); return value; }
 function encodeSourceCleanupState(value, context) { const writer = new Writer(); writeSourceCleanupState(value, writer, context, {}, 0); return writer.result(); }
+function enumWireSessionSealResult(value) {
+    switch (value) {
+        case "sealed": return 1;
+        case "bindingAbsent": return 2;
+    }
+}
+function readSessionSealResult(reader, context, enclosing, flags) {
+    void context;
+    void enclosing;
+    void flags;
+    const raw = reader.u(1);
+    switch (Number(raw)) {
+        case 1: return "sealed";
+        case 2: return "bindingAbsent";
+        default: fail("session-seal-result enum");
+    }
+}
+function writeSessionSealResult(input, writer, context, enclosing, flags) {
+    void context;
+    void enclosing;
+    void flags;
+    const value = input;
+    writer.u(numeric(enumWireSessionSealResult(value)), 1);
+}
+function decodeSessionSealResult(bytes, context) { const reader = new Reader(bytes); const value = readSessionSealResult(reader, context, {}, 0); reader.done("session-seal-result"); return value; }
+function encodeSessionSealResult(value, context) { const writer = new Writer(); writeSessionSealResult(value, writer, context, {}, 0); return writer.result(); }
 function enumWireReplyRelayAckStatus(value) {
     switch (value) {
         case "terminalReceived": return 1;
@@ -8487,6 +8523,141 @@ function writeRelocationPendingTimerTickVector(input, writer, context, enclosing
 }
 function decodeRelocationPendingTimerTickVector(bytes, context) { const reader = new Reader(bytes); const value = readRelocationPendingTimerTickVector(reader, context, {}, 0); reader.done("relocation-pending-timer-tick-vector"); return value; }
 function encodeRelocationPendingTimerTickVector(value, context) { const writer = new Writer(); writeRelocationPendingTimerTickVector(value, writer, context, {}, 0); return writer.result(); }
+function readRelocationSessionBinding(reader, context, enclosing, flags) {
+    void context;
+    void enclosing;
+    void flags;
+    const value = {};
+    value["participantId"] = readNonzeroU64(reader, context, value, flags);
+    value["sessionOwnerNodeRid"] = readRid(reader, context, value, flags);
+    value["sessionOwnerNodeGeneration"] = readNonzeroU64(reader, context, value, flags);
+    value["sessionOwnerId"] = readText8(reader, context, value, flags);
+    value["sessionOwnerLeaseGeneration"] = readNonzeroU64(reader, context, value, flags);
+    value["sessionRid"] = readRid(reader, context, value, flags);
+    value["bindingGeneration"] = readNonzeroU64(reader, context, value, flags);
+    return value;
+}
+function* readIncrementalRelocationSessionBinding(reader, context, enclosing, flags) {
+    void context;
+    void enclosing;
+    void flags;
+    const value = {};
+    value["participantId"] = yield* readIncrementalNonzeroU64(reader, context, value, flags);
+    value["sessionOwnerNodeRid"] = yield* readIncrementalRid(reader, context, value, flags);
+    value["sessionOwnerNodeGeneration"] = yield* readIncrementalNonzeroU64(reader, context, value, flags);
+    value["sessionOwnerId"] = yield* readIncrementalText8(reader, context, value, flags);
+    value["sessionOwnerLeaseGeneration"] = yield* readIncrementalNonzeroU64(reader, context, value, flags);
+    value["sessionRid"] = yield* readIncrementalRid(reader, context, value, flags);
+    value["bindingGeneration"] = yield* readIncrementalNonzeroU64(reader, context, value, flags);
+    return value;
+}
+function writeRelocationSessionBinding(input, writer, context, enclosing, flags) {
+    void context;
+    void enclosing;
+    void flags;
+    const value = input;
+    if (value["participantId"] === undefined)
+        fail("participantId required");
+    writeNonzeroU64(numeric(value["participantId"]), writer, context, value, flags);
+    if (value["sessionOwnerNodeRid"] === undefined)
+        fail("sessionOwnerNodeRid required");
+    writeRid(value["sessionOwnerNodeRid"], writer, context, value, flags);
+    if (value["sessionOwnerNodeGeneration"] === undefined)
+        fail("sessionOwnerNodeGeneration required");
+    writeNonzeroU64(numeric(value["sessionOwnerNodeGeneration"]), writer, context, value, flags);
+    if (value["sessionOwnerId"] === undefined)
+        fail("sessionOwnerId required");
+    writeText8(value["sessionOwnerId"], writer, context, value, flags);
+    if (value["sessionOwnerLeaseGeneration"] === undefined)
+        fail("sessionOwnerLeaseGeneration required");
+    writeNonzeroU64(numeric(value["sessionOwnerLeaseGeneration"]), writer, context, value, flags);
+    if (value["sessionRid"] === undefined)
+        fail("sessionRid required");
+    writeRid(value["sessionRid"], writer, context, value, flags);
+    if (value["bindingGeneration"] === undefined)
+        fail("bindingGeneration required");
+    writeNonzeroU64(numeric(value["bindingGeneration"]), writer, context, value, flags);
+}
+function decodeRelocationSessionBinding(bytes, context) { const reader = new Reader(bytes); const value = readRelocationSessionBinding(reader, context, {}, 0); reader.done("relocation-session-binding"); return value; }
+function encodeRelocationSessionBinding(value, context) { const writer = new Writer(); writeRelocationSessionBinding(value, writer, context, {}, 0); return writer.result(); }
+function readRelocationSessionBindingVector(reader, context, enclosing, flags) {
+    void context;
+    void enclosing;
+    void flags;
+    const count = Number(readU32(reader, context, enclosing, flags));
+    if (count > 1024)
+        fail("relocation-session-binding-vector count");
+    const value = Array.from({ length: count }, () => readRelocationSessionBinding(reader, context, enclosing, flags));
+    try {
+        for (let index = 1; index < value.length; ++index)
+            if (compareResults([compareBigint(numeric(value[index - 1]["participantId"]), numeric(value[index]["participantId"]))]) >= 0)
+                fail("relocation-session-binding-vector sorted");
+    }
+    catch (error) {
+        if (error instanceof ServiceWireProtocolError || error instanceof ServiceWireCapacityError)
+            throw error;
+        if (error instanceof RangeError)
+            capacityFail("relocation-session-binding-vector constraint capacity");
+        throw error;
+    }
+    return value;
+}
+function* readIncrementalRelocationSessionBindingVector(reader, context, enclosing, flags) {
+    void context;
+    void enclosing;
+    void flags;
+    const count = Number(yield* readIncrementalU32(reader, context, enclosing, flags));
+    if (count > 1024)
+        fail("relocation-session-binding-vector count");
+    const value = [];
+    for (let index = 0; index < count; ++index) {
+        const item = yield* readIncrementalRelocationSessionBinding(reader, context, enclosing, flags);
+        try {
+            value.push(item);
+        }
+        catch {
+            capacityFail("relocation-session-binding-vector capacity");
+        }
+    }
+    try {
+        for (let index = 1; index < value.length; ++index)
+            if (compareResults([compareBigint(numeric(value[index - 1]["participantId"]), numeric(value[index]["participantId"]))]) >= 0)
+                fail("relocation-session-binding-vector sorted");
+    }
+    catch (error) {
+        if (error instanceof ServiceWireProtocolError || error instanceof ServiceWireCapacityError)
+            throw error;
+        if (error instanceof RangeError)
+            capacityFail("relocation-session-binding-vector constraint capacity");
+        throw error;
+    }
+    return value;
+}
+function writeRelocationSessionBindingVector(input, writer, context, enclosing, flags) {
+    void context;
+    void enclosing;
+    void flags;
+    const value = input;
+    if (!Array.isArray(value) || value.length > 1024)
+        fail("relocation-session-binding-vector count");
+    try {
+        for (let index = 1; index < value.length; ++index)
+            if (compareResults([compareBigint(numeric(value[index - 1]["participantId"]), numeric(value[index]["participantId"]))]) >= 0)
+                fail("relocation-session-binding-vector sorted");
+    }
+    catch (error) {
+        if (error instanceof ServiceWireProtocolError || error instanceof ServiceWireCapacityError)
+            throw error;
+        if (error instanceof RangeError)
+            capacityFail("relocation-session-binding-vector constraint capacity");
+        throw error;
+    }
+    writeU32(value.length, writer, context, enclosing, flags);
+    for (const item of value)
+        writeRelocationSessionBinding(item, writer, context, enclosing, flags);
+}
+function decodeRelocationSessionBindingVector(bytes, context) { const reader = new Reader(bytes); const value = readRelocationSessionBindingVector(reader, context, {}, 0); reader.done("relocation-session-binding-vector"); return value; }
+function encodeRelocationSessionBindingVector(value, context) { const writer = new Writer(); writeRelocationSessionBindingVector(value, writer, context, {}, 0); return writer.result(); }
 function readRelocationEnvelopeV1(reader, context, enclosing, flags) {
     void context;
     void enclosing;
@@ -8499,6 +8670,7 @@ function readRelocationEnvelopeV1(reader, context, enclosing, flags) {
     value["savedWork"] = readSavedWorkVector(reader, context, value, flags);
     value["timerRegistrations"] = readRelocationTimerRegistrationVector(reader, context, value, flags);
     value["pendingTimerTicks"] = readRelocationPendingTimerTickVector(reader, context, value, flags);
+    value["sessionBindings"] = readRelocationSessionBindingVector(reader, context, value, flags);
     return value;
 }
 function* readIncrementalRelocationEnvelopeV1(reader, context, enclosing, flags) {
@@ -8513,6 +8685,7 @@ function* readIncrementalRelocationEnvelopeV1(reader, context, enclosing, flags)
     value["savedWork"] = yield* readIncrementalSavedWorkVector(reader, context, value, flags);
     value["timerRegistrations"] = yield* readIncrementalRelocationTimerRegistrationVector(reader, context, value, flags);
     value["pendingTimerTicks"] = yield* readIncrementalRelocationPendingTimerTickVector(reader, context, value, flags);
+    value["sessionBindings"] = yield* readIncrementalRelocationSessionBindingVector(reader, context, value, flags);
     return value;
 }
 function writeRelocationEnvelopeV1(input, writer, context, enclosing, flags) {
@@ -8541,6 +8714,9 @@ function writeRelocationEnvelopeV1(input, writer, context, enclosing, flags) {
     if (value["pendingTimerTicks"] === undefined)
         fail("pendingTimerTicks required");
     writeRelocationPendingTimerTickVector(value["pendingTimerTicks"], writer, context, value, flags);
+    if (value["sessionBindings"] === undefined)
+        fail("sessionBindings required");
+    writeRelocationSessionBindingVector(value["sessionBindings"], writer, context, value, flags);
 }
 function decodeRelocationEnvelopeV1(bytes, context) { const reader = new Reader(bytes); const value = readRelocationEnvelopeV1(reader, context, {}, 0); reader.done("relocation-envelope-v1"); return value; }
 function encodeRelocationEnvelopeV1(value, context) { const writer = new Writer(); writeRelocationEnvelopeV1(value, writer, context, {}, 0); return writer.result(); }
@@ -9880,6 +10056,7 @@ function decodeRelocationPrepareCommand(frames, context) {
     value["payloadChunkCount"] = readRelocationChunkCount(reader, context, value, flags);
     value["payloadChecksumCrc32c"] = readU32(reader, context, value, flags);
     value["applicationVersion"] = readApplicationVersion(reader, context, value, flags);
+    value["deadlineUnixMs"] = readNonzeroU64(reader, context, value, flags);
     reader.done("relocationPrepare");
     let frameIndex = 1;
     if (frameIndex !== frames.length)
@@ -9927,6 +10104,9 @@ function encodeRelocationPrepareCommand(value, context) {
     if (value["applicationVersion"] === undefined)
         fail("applicationVersion required");
     writeApplicationVersion(numeric(value["applicationVersion"]), writer, context, value, value.flags);
+    if (value["deadlineUnixMs"] === undefined)
+        fail("deadlineUnixMs required");
+    writeNonzeroU64(numeric(value["deadlineUnixMs"]), writer, context, value, value.flags);
     const frames = [writer.result()];
     return frames;
 }
@@ -9951,6 +10131,8 @@ function decodeSessionRelocationSealCommand(frames, context) {
     value["sessionOwnerLeaseGeneration"] = readNonzeroU64(reader, context, value, flags);
     value["sessionRid"] = readRid(reader, context, value, flags);
     value["bindingGeneration"] = readNonzeroU64(reader, context, value, flags);
+    value["targetNodeRid"] = readRid(reader, context, value, flags);
+    value["targetNodeGeneration"] = readNonzeroU64(reader, context, value, flags);
     reader.done("sessionRelocationSeal");
     let frameIndex = 1;
     if (frameIndex !== frames.length)
@@ -9992,6 +10174,12 @@ function encodeSessionRelocationSealCommand(value, context) {
     if (value["bindingGeneration"] === undefined)
         fail("bindingGeneration required");
     writeNonzeroU64(numeric(value["bindingGeneration"]), writer, context, value, value.flags);
+    if (value["targetNodeRid"] === undefined)
+        fail("targetNodeRid required");
+    writeRid(value["targetNodeRid"], writer, context, value, value.flags);
+    if (value["targetNodeGeneration"] === undefined)
+        fail("targetNodeGeneration required");
+    writeNonzeroU64(numeric(value["targetNodeGeneration"]), writer, context, value, value.flags);
     const frames = [writer.result()];
     return frames;
 }
@@ -10015,6 +10203,7 @@ function decodeSessionRelocationSealedCommand(frames, context) {
     value["sessionOwnerLeaseGeneration"] = readNonzeroU64(reader, context, value, flags);
     value["sessionRid"] = readRid(reader, context, value, flags);
     value["bindingGeneration"] = readNonzeroU64(reader, context, value, flags);
+    value["sealResult"] = readSessionSealResult(reader, context, value, flags);
     reader.done("sessionRelocationSealed");
     let frameIndex = 1;
     if (frameIndex !== frames.length)
@@ -10053,6 +10242,9 @@ function encodeSessionRelocationSealedCommand(value, context) {
     if (value["bindingGeneration"] === undefined)
         fail("bindingGeneration required");
     writeNonzeroU64(numeric(value["bindingGeneration"]), writer, context, value, value.flags);
+    if (value["sealResult"] === undefined)
+        fail("sealResult required");
+    writeSessionSealResult(value["sealResult"], writer, context, value, value.flags);
     const frames = [writer.result()];
     return frames;
 }
@@ -10506,6 +10698,43 @@ function encodeRelocationFailedCommand(value, context) {
     return frames;
 }
 function validateRelocationFailedCommandRuntimePredicates(value, context) { void value; void context; }
+function decodeBoundSessionCloseCommand(frames, context) {
+    if (!frames.length)
+        fail("boundSessionClose frames");
+    const reader = new Reader(frames[0]);
+    if (Number(reader.u(1)) !== 90 || Number(reader.u(1)) !== 77 || Number(reader.u(1)) !== 1 || Number(reader.u(1)) !== 54)
+        fail("boundSessionClose header");
+    const flags = Number(reader.u(1));
+    if ((flags & ~0) !== 0 || (flags & 0) !== 0)
+        fail("boundSessionClose flags");
+    const value = { command: "boundSessionClose", flags };
+    value["correlation"] = readNonzeroU64(reader, context, value, flags);
+    value["actor"] = readActorRef(reader, context, value, flags);
+    value["session"] = readRetiredBoundSessionRouteFence(reader, context, value, flags);
+    reader.done("boundSessionClose");
+    let frameIndex = 1;
+    if (frameIndex !== frames.length)
+        fail("boundSessionClose frames");
+    return value;
+}
+function encodeBoundSessionCloseCommand(value, context) {
+    if ((value.flags & ~0) !== 0 || (value.flags & 0) !== 0)
+        fail("boundSessionClose flags");
+    const writer = new Writer();
+    writer.put([90, 77, 1, 54, value.flags]);
+    if (value["correlation"] === undefined)
+        fail("correlation required");
+    writeNonzeroU64(numeric(value["correlation"]), writer, context, value, value.flags);
+    if (value["actor"] === undefined)
+        fail("actor required");
+    writeActorRef(value["actor"], writer, context, value, value.flags);
+    if (value["session"] === undefined)
+        fail("session required");
+    writeRetiredBoundSessionRouteFence(value["session"], writer, context, value, value.flags);
+    const frames = [writer.result()];
+    return frames;
+}
+function validateBoundSessionCloseCommandRuntimePredicates(value, context) { void value; void context; }
 function decodeAuthorityPayloadV1DurableFormat(bytes, context) { if (bytes.length > 1048576)
     fail("authority-payload-v1 maximum"); const reader = new Reader(bytes); if (Number(reader.u(1)) !== 90 || Number(reader.u(1)) !== 76 || Number(reader.u(1)) !== 65 || Number(reader.u(1)) !== 85 || Number(reader.u(1)) !== 1)
     fail("authority-payload-v1 header"); const flags = readU16(reader, context, {}, 0); if (!same(flags, 0))

package/dist/runtime/protocol/service_wire_pilot_codec.generated.d.ts

@@ -72,6 +72,15 @@ export interface RelocationEnvelopeV1 {
         readonly scheduledAtUnixMilliseconds: bigint;
         readonly skippedTicks: bigint;
     }[];
+    readonly sessionBindings: readonly {
+        readonly participantId: bigint;
+        readonly sessionOwnerNodeRid: Uint8Array;
+        readonly sessionOwnerNodeGeneration: bigint;
+        readonly sessionOwnerId: string;
+        readonly sessionOwnerLeaseGeneration: bigint;
+        readonly sessionRid: Uint8Array;
+        readonly bindingGeneration: bigint;
+    }[];
 }
 export interface RelocationDataChunkV1 {
     readonly order: number;
@@ -259,6 +268,7 @@ export interface RelocationPrepare40 {
     readonly payloadChunkCount: number;
     readonly payloadChecksumCrc32c: number;
     readonly applicationVersion: bigint;
+    readonly deadlineUnixMs: bigint;
 }
 export interface SessionRelocationSeal42 {
     readonly relocation: ServiceWireRelocationId;
@@ -271,8 +281,13 @@ export interface SessionRelocationSeal42 {
     readonly sessionOwnerLeaseGeneration: bigint;
     readonly sessionRid: Uint8Array;
     readonly bindingGeneration: bigint;
+    readonly targetNodeRid: Uint8Array;
+    readonly targetNodeGeneration: bigint;
 }
-export type SessionRelocationSealed43 = Omit<SessionRelocationSeal42, "senderRole">;
+export type ServiceWireSessionSealResult = "sealed" | "bindingAbsent";
+export type SessionRelocationSealed43 = Omit<SessionRelocationSeal42, "senderRole" | "targetNodeRid" | "targetNodeGeneration"> & {
+    readonly sealResult: ServiceWireSessionSealResult;
+};
 export interface SessionRelocationRoute44 {
     readonly relocation: ServiceWireRelocationId;
     readonly coordinator: ServiceWireCoordinatorFence;

package/dist/runtime/protocol/service_wire_pilot_codec.generated.js

@@ -331,6 +331,17 @@ function encodeRelocationEnvelopeV1(value) { const out = []; if (value.relocatio
     u64(out, p.scheduledIndex);
     u64(out, p.scheduledAtUnixMilliseconds);
     u64(out, p.skippedTicks);
+} sorted(value.sessionBindings, (a, b) => a.participantId < b.participantId ? -1 : a.participantId > b.participantId ? 1 : 0, "sessionBindings"); if (value.sessionBindings.length > 1024)
+    throw new RangeError("bindings count"); u32(out, value.sessionBindings.length); for (const b of value.sessionBindings) {
+    if (b.participantId === 0n || b.sessionOwnerNodeGeneration === 0n || b.sessionOwnerLeaseGeneration === 0n || b.bindingGeneration === 0n)
+        throw new RangeError("binding");
+    u64(out, b.participantId);
+    rid(out, b.sessionOwnerNodeRid);
+    u64(out, b.sessionOwnerNodeGeneration);
+    text8(out, b.sessionOwnerId);
+    u64(out, b.sessionOwnerLeaseGeneration);
+    rid(out, b.sessionRid);
+    u64(out, b.bindingGeneration);
 } if (out.length > 274877906944)
     throw new RangeError("relocation logical bytes"); return Uint8Array.from(out); }
 function decodeRelocationEnvelopeV1(chunks) { const n = chunks.reduce((s, c) => s + c.length, 0); if (n > 274877906944)
@@ -381,7 +392,9 @@ function decodeRelocationEnvelopeV1(chunks) { const n = chunks.reduce((s, c) =>
     if (registeredTimerNames.get(participantId)?.has(timerName) !== true)
         throw new RangeError("pending timer registration");
     pendingTimerTicks.push({ participantId, order, timerName, deliveryIndex: nonzero64(bytes, at, "delivery"), scheduledIndex: nonzero64(bytes, at, "scheduled"), scheduledAtUnixMilliseconds: read64(bytes, at), skippedTicks: read64(bytes, at) });
-} exactEnd(at, bytes.length, "relocation envelope"); sorted(applicationStates, (a, b) => a.participantId < b.participantId ? -1 : a.participantId > b.participantId ? 1 : 0, "applicationStates"); sorted(savedWork, (a, b) => a.participantId === b.participantId ? (a.order < b.order ? -1 : a.order > b.order ? 1 : 0) : (a.participantId < b.participantId ? -1 : 1), "savedWork"); sorted(timerRegistrations, (a, b) => a.participantId === b.participantId ? compareUtf8(a.name, b.name) : a.participantId < b.participantId ? -1 : 1, "timerRegistrations"); sorted(pendingTimerTicks, (a, b) => a.participantId === b.participantId ? (a.order < b.order ? -1 : a.order > b.order ? 1 : 0) : (a.participantId < b.participantId ? -1 : 1), "pendingTimerTicks"); return { relocationHigh, relocationLow, object, applicationVersion, applicationStates, savedWork, timerRegistrations, pendingTimerTicks }; }
+} const sessionBindings = []; const bindingCount = read32(bytes, at); if (bindingCount > 1024)
+    throw new RangeError("bindings count"); for (let n = 0; n < bindingCount; n++)
+    sessionBindings.push({ participantId: nonzero64(bytes, at, "participant"), sessionOwnerNodeRid: readRid(bytes, at), sessionOwnerNodeGeneration: nonzero64(bytes, at, "session node"), sessionOwnerId: readText8(bytes, at), sessionOwnerLeaseGeneration: nonzero64(bytes, at, "session lease"), sessionRid: readRid(bytes, at), bindingGeneration: nonzero64(bytes, at, "binding") }); sorted(sessionBindings, (a, b) => a.participantId < b.participantId ? -1 : a.participantId > b.participantId ? 1 : 0, "sessionBindings"); exactEnd(at, bytes.length, "relocation envelope"); sorted(applicationStates, (a, b) => a.participantId < b.participantId ? -1 : a.participantId > b.participantId ? 1 : 0, "applicationStates"); sorted(savedWork, (a, b) => a.participantId === b.participantId ? (a.order < b.order ? -1 : a.order > b.order ? 1 : 0) : (a.participantId < b.participantId ? -1 : 1), "savedWork"); sorted(timerRegistrations, (a, b) => a.participantId === b.participantId ? compareUtf8(a.name, b.name) : a.participantId < b.participantId ? -1 : 1, "timerRegistrations"); sorted(pendingTimerTicks, (a, b) => a.participantId === b.participantId ? (a.order < b.order ? -1 : a.order > b.order ? 1 : 0) : (a.participantId < b.participantId ? -1 : 1), "pendingTimerTicks"); return { relocationHigh, relocationLow, object, applicationVersion, applicationStates, savedWork, timerRegistrations, pendingTimerTicks, sessionBindings }; }
 function crc32c(bytes) { let crc = 0xffffffff; for (const octet of bytes) {
     crc ^= octet;
     for (let bit = 0; bit < 8; bit++)
@@ -459,6 +472,20 @@ function decodeActorDestroy27(bytes) { const at = { value: 0 }; if (bytes.length
     throw new RangeError("actorDestroy header"); const correlation = read64(bytes, at); if (correlation === 0n)
     throw new RangeError("correlation"); const actor = readFence(bytes, at); if (at.value !== bytes.length)
     throw new RangeError("actorDestroy trailing"); return { correlation, actor }; }
+function b3WriteSealResult(o, v) { switch (v) {
+    case "sealed":
+        o.push(1);
+        return;
+    case "bindingAbsent":
+        o.push(2);
+        return;
+    default: throw new RangeError("sealResult");
+} }
+function b3ReadSealResult(bytes, at) { switch (read8(bytes, at)) {
+    case 1: return "sealed";
+    case 2: return "bindingAbsent";
+    default: throw new RangeError("sealResult");
+} }
 function b3Header(id) { return [90, 77, 1, id, 0]; }
 function b3ReadHeader(bytes, id, name) { const at = { value: 0 }; if (bytes.length < 5 || bytes[at.value++] !== 90 || bytes[at.value++] !== 77 || bytes[at.value++] !== 1 || bytes[at.value++] !== id || bytes[at.value++] !== 0)
     throw new RangeError(name + " header"); return at; }
@@ -584,10 +611,11 @@ function decodeRelocationState52(bytes) { const at = b3ReadHeader(bytes, 52, "re
 function encodeRelocationPrepare40(v) { const o = b3Header(40); b3WriteId(o, v.relocation, "relocation"); if (v.targetAttemptGeneration === 0n || v.sourceNodeGeneration === 0n)
     throw new RangeError("prepare"); u64(o, v.targetAttemptGeneration); b3WriteCoordinator(o, v.coordinator); b3WriteTarget(o, v.target); b3WriteRole(o, v.initiatorRole); if (v.initiatorRole !== "source")
     throw new RangeError("initiator role"); writeRelocationObject(o, v.object); rid(o, v.sourceNodeRid); u64(o, v.sourceNodeGeneration); if (v.payloadTotalLength < 0n || v.payloadTotalLength > 274877906944n || v.payloadChunkCount > 4096 || v.applicationVersion < 0n || v.applicationVersion > 9223372036854775807n)
-    throw new RangeError("prepare bounds"); u64(o, v.payloadTotalLength); u32(o, v.payloadChunkCount); u32(o, v.payloadChecksumCrc32c); u64(o, v.applicationVersion); return Uint8Array.from(o); }
+    throw new RangeError("prepare bounds"); u64(o, v.payloadTotalLength); u32(o, v.payloadChunkCount); u32(o, v.payloadChecksumCrc32c); u64(o, v.applicationVersion); if (v.deadlineUnixMs === 0n)
+    throw new RangeError("deadline"); u64(o, v.deadlineUnixMs); return Uint8Array.from(o); }
 function decodeRelocationPrepare40(bytes) { const at = b3ReadHeader(bytes, 40, "relocationPrepare"), relocation = b3ReadId(bytes, at, "relocation"), targetAttemptGeneration = nonzero64(bytes, at, "target attempt"), coordinator = b3ReadCoordinator(bytes, at), target = b3ReadTarget(bytes, at), initiatorRole = b3ReadRole(bytes, at); if (initiatorRole !== "source")
-    throw new RangeError("initiator role"); const object = readRelocationObject(bytes, at), sourceNodeRid = readRid(bytes, at), sourceNodeGeneration = nonzero64(bytes, at, "source node"), payloadTotalLength = read64(bytes, at), payloadChunkCount = read32(bytes, at), payloadChecksumCrc32c = read32(bytes, at), applicationVersion = read64(bytes, at); if (payloadTotalLength > 274877906944n || payloadChunkCount > 4096 || applicationVersion > 9223372036854775807n)
-    throw new RangeError("prepare bounds"); b3Finish(at, bytes, "relocationPrepare"); return { relocation, targetAttemptGeneration, coordinator, target, initiatorRole, object, sourceNodeRid, sourceNodeGeneration, payloadTotalLength, payloadChunkCount, payloadChecksumCrc32c, applicationVersion }; }
+    throw new RangeError("initiator role"); const object = readRelocationObject(bytes, at), sourceNodeRid = readRid(bytes, at), sourceNodeGeneration = nonzero64(bytes, at, "source node"), payloadTotalLength = read64(bytes, at), payloadChunkCount = read32(bytes, at), payloadChecksumCrc32c = read32(bytes, at), applicationVersion = read64(bytes, at), deadlineUnixMs = nonzero64(bytes, at, "deadline"); if (payloadTotalLength > 274877906944n || payloadChunkCount > 4096 || applicationVersion > 9223372036854775807n)
+    throw new RangeError("prepare bounds"); b3Finish(at, bytes, "relocationPrepare"); return { relocation, targetAttemptGeneration, coordinator, target, initiatorRole, object, sourceNodeRid, sourceNodeGeneration, payloadTotalLength, payloadChunkCount, payloadChecksumCrc32c, applicationVersion, deadlineUnixMs }; }
 function b3WriteSealBase(o, v, includeRole) { b3WriteId(o, v.relocation, "relocation"); b3WriteCoordinator(o, v.coordinator); if (includeRole) {
     const role = v.senderRole;
     b3WriteRole(o, role);
@@ -599,10 +627,11 @@ function b3ReadSealBase(bytes, at, includeRole) { const relocation = b3ReadId(by
     if (senderRole !== "source")
         throw new RangeError("sender role");
 } const actor = readFence(bytes, at), session = b3ReadSession(bytes, at); return senderRole === undefined ? { relocation, coordinator, actor, ...session } : { relocation, coordinator, senderRole, actor, ...session }; }
-function encodeSessionRelocationSeal42(v) { const o = b3Header(42); b3WriteSealBase(o, v, true); return Uint8Array.from(o); }
-function decodeSessionRelocationSeal42(bytes) { const at = b3ReadHeader(bytes, 42, "sessionRelocationSeal"), v = b3ReadSealBase(bytes, at, true); b3Finish(at, bytes, "sessionRelocationSeal"); return v; }
-function encodeSessionRelocationSealed43(v) { const o = b3Header(43); b3WriteSealBase(o, v, false); return Uint8Array.from(o); }
-function decodeSessionRelocationSealed43(bytes) { const at = b3ReadHeader(bytes, 43, "sessionRelocationSealed"), v = b3ReadSealBase(bytes, at, false); b3Finish(at, bytes, "sessionRelocationSealed"); return v; }
+function encodeSessionRelocationSeal42(v) { const o = b3Header(42); b3WriteSealBase(o, v, true); rid(o, v.targetNodeRid); if (v.targetNodeGeneration === 0n)
+    throw new RangeError("target node"); u64(o, v.targetNodeGeneration); return Uint8Array.from(o); }
+function decodeSessionRelocationSeal42(bytes) { const at = b3ReadHeader(bytes, 42, "sessionRelocationSeal"), v = b3ReadSealBase(bytes, at, true); const targetNodeRid = readRid(bytes, at), targetNodeGeneration = nonzero64(bytes, at, "target node"); b3Finish(at, bytes, "sessionRelocationSeal"); return { ...v, targetNodeRid, targetNodeGeneration }; }
+function encodeSessionRelocationSealed43(v) { const o = b3Header(43); b3WriteSealBase(o, v, false); b3WriteSealResult(o, v.sealResult); return Uint8Array.from(o); }
+function decodeSessionRelocationSealed43(bytes) { const at = b3ReadHeader(bytes, 43, "sessionRelocationSealed"), v = { ...b3ReadSealBase(bytes, at, false), sealResult: b3ReadSealResult(bytes, at) }; b3Finish(at, bytes, "sessionRelocationSealed"); return v; }
 function encodeSessionRelocationRoute44(v) { const o = b3Header(44); b3WriteId(o, v.relocation, "relocation"); b3WriteCoordinator(o, v.coordinator); b3WriteRole(o, v.senderRole); if ((v.route.action === "commit" && v.senderRole !== "target") || (v.route.action === "abort" && v.senderRole !== "source"))
     throw new RangeError("route sender"); b3WriteActorRef(o, v.actor); b3WriteSession(o, v); b3WriteRoute(o, v.route); return Uint8Array.from(o); }
 function decodeSessionRelocationRoute44(bytes) { const at = b3ReadHeader(bytes, 44, "sessionRelocationRoute"), relocation = b3ReadId(bytes, at, "relocation"), coordinator = b3ReadCoordinator(bytes, at), senderRole = b3ReadRole(bytes, at), actor = b3ReadActorRef(bytes, at), session = b3ReadSession(bytes, at), route = b3ReadRoute(bytes, at); if ((route.action === "commit" && senderRole !== "target") || (route.action === "abort" && senderRole !== "source"))

package/dist/runtime/spots/formal-remote-actor-admission-registry.d.ts

@@ -22,7 +22,7 @@ export interface ZLinkParkedActorArrival {
     readonly reject: (reason: unknown) => void;
 }
 export type ZLinkActorJoinIngressRoute = 'parked' | 'not-found';
-export type ZLinkFormalRemoteActorAdmissionState = 'provisional' | 'admitting' | 'admitted' | 'rejected' | 'committed' | 'aborted' | 'failed';
+export type ZLinkFormalRemoteActorAdmissionState = 'provisional' | 'admitting' | 'admitted' | 'restoring' | 'rejected' | 'committed' | 'aborted' | 'failed';
 export interface ZLinkFormalRemoteActorAdmission {
     readonly actorId: string;
     readonly actorType: string;
@@ -56,7 +56,7 @@ export interface ZLinkFormalRemoteActorAdmissionRecord {
     readonly resultTask: Promise<ZLinkFormalRemoteActorAdmissionResult>;
 }
 interface ZLinkFormalRemoteActorAdmissionEntry extends ZLinkFormalRemoteActorAdmissionRecord {
-    readonly timer: ReturnType<typeof setTimeout>;
+    timer: ReturnType<typeof setTimeout>;
     readonly resolveResult: (result: ZLinkFormalRemoteActorAdmissionResult) => void;
     admission: ZLinkFormalRemoteActorAdmission;
     state: ZLinkFormalRemoteActorAdmissionState;
@@ -70,6 +70,11 @@ export declare class ZLinkFormalRemoteActorAdmissionRegistry {
     private readonly admissions;
     private readonly byObject;
     get(transferId: string): ZLinkFormalRemoteActorAdmissionEntry | undefined;
+    /** PREPARE transfers prepared resources to the target attempt until its terminal. */
+    beginRestore(transferId: string): void;
+    /** Retains successful commit replay; unsuccessful attempts release their resources now. */
+    finishRestore(transferId: string): void;
+    private scheduleExpiry;
     begin(input: ZLinkFormalRemoteActorAdmission): {
         readonly record: ZLinkFormalRemoteActorAdmissionEntry;
         readonly created: boolean;

package/dist/runtime/spots/formal-remote-actor-admission-registry.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkFormalRemoteActorAdmissionRegistry = void 0;
+const routing_id_1 = require("../routing-id");
 const ADMISSION_RETENTION_MS = 30_000;
 /** Identifies the object one admission attempt belongs to. */
 function objectKey(actorId, objectGeneration) {
@@ -17,6 +18,34 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
     get(transferId) {
         return this.admissions.get(transferId);
     }
+    /** PREPARE transfers prepared resources to the target attempt until its terminal. */
+    beginRestore(transferId) {
+        const entry = this.admissions.get(transferId);
+        if (entry === undefined || (entry.state !== 'admitted' && entry.state !== 'restoring')) {
+            throw new Error(`Remote actor admission '${transferId}' is not ready to restore.`);
+        }
+        clearTimeout(entry.timer);
+        entry.state = 'restoring';
+    }
+    /** Retains successful commit replay; unsuccessful attempts release their resources now. */
+    finishRestore(transferId) {
+        const entry = this.admissions.get(transferId);
+        if (entry === undefined)
+            return;
+        if (entry.state === 'committed') {
+            clearTimeout(entry.timer);
+            entry.timer = this.scheduleExpiry(transferId);
+        }
+        else {
+            this.abort(transferId);
+            this.delete(transferId);
+        }
+    }
+    scheduleExpiry(transferId) {
+        const timer = setTimeout(() => this.delete(transferId), ADMISSION_RETENTION_MS);
+        timer.unref();
+        return timer;
+    }
     begin(input) {
         const existing = this.admissions.get(input.transferId);
         if (existing !== undefined) {
@@ -71,10 +100,7 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
         const resultTask = new Promise((resolve) => {
             resolveResult = resolve;
         });
-        const timer = setTimeout(() => {
-            this.delete(input.transferId);
-        }, ADMISSION_RETENTION_MS);
-        timer.unref();
+        const timer = this.scheduleExpiry(input.transferId);
         const entry = {
             admission: input,
             state,
@@ -186,7 +212,7 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
         const entry = this.admissions.get(transferId);
         if (entry === undefined)
             return;
-        if (entry.state !== 'admitted' && entry.state !== 'committed') {
+        if (entry.state !== 'admitted' && entry.state !== 'restoring' && entry.state !== 'committed') {
             throw new Error(`Remote actor admission '${transferId}' is not ready to commit.`);
         }
         entry.state = 'committed';
@@ -195,7 +221,7 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
     attachDeferredJoinCompletion(transferId, root) {
         const entry = this.admissions.get(transferId);
         if (entry === undefined ||
-            entry.state !== 'admitted' ||
+            (entry.state !== 'admitted' && entry.state !== 'restoring') ||
             entry.result === undefined ||
             'error' in entry.result ||
             !entry.result.accepted) {
@@ -227,7 +253,7 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
      */
     delete(transferId) {
         const pending = this.admissions.get(transferId);
-        if (pending === undefined)
+        if (pending === undefined || pending.state === 'restoring')
             return;
         clearTimeout(pending.timer);
         this.admissions.delete(transferId);
@@ -240,18 +266,7 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
 }
 exports.ZLinkFormalRemoteActorAdmissionRegistry = ZLinkFormalRemoteActorAdmissionRegistry;
 function sameAdmission(left, right) {
-    return (left.actorId === right.actorId &&
-        left.actorType === right.actorType &&
-        String(left.spotId) === String(right.spotId) &&
-        left.targetSpotGeneration === right.targetSpotGeneration &&
-        left.expectedMembershipEpoch === right.expectedMembershipEpoch &&
-        left.requestFingerprint === right.requestFingerprint &&
-        sameOperationId(left.completionOperationId, right.completionOperationId) &&
-        String(left.sourceSpotId ?? '') === String(right.sourceSpotId ?? '') &&
-        String(left.sourceActorNodeRid ?? '') === String(right.sourceActorNodeRid ?? '') &&
-        left.actorRef.actorId === right.actorRef.actorId &&
-        String(left.actorRef.nodeRid) === String(right.actorRef.nodeRid) &&
-        left.actorRef.objectGeneration === right.actorRef.objectGeneration);
+    return left.actorType === right.actorType && sameProvisionalAdmission(left, right);
 }
 function sameProvisionalAdmission(left, right) {
     return (left.actorId === right.actorId &&
@@ -261,9 +276,9 @@ function sameProvisionalAdmission(left, right) {
         left.requestFingerprint === right.requestFingerprint &&
         sameOperationId(left.completionOperationId, right.completionOperationId) &&
         String(left.sourceSpotId ?? '') === String(right.sourceSpotId ?? '') &&
-        String(left.sourceActorNodeRid ?? '') === String(right.sourceActorNodeRid ?? '') &&
+        (0, routing_id_1.routingIdsEqual)(left.sourceActorNodeRid, right.sourceActorNodeRid) &&
         left.actorRef.actorId === right.actorRef.actorId &&
-        String(left.actorRef.nodeRid) === String(right.actorRef.nodeRid) &&
+        (0, routing_id_1.routingIdsEqual)(left.actorRef.nodeRid, right.actorRef.nodeRid) &&
         left.actorRef.objectGeneration === right.actorRef.objectGeneration);
 }
 function sameOperationId(left, right) {