@zlink-systems/framework 0.26.0 → 0.27.0

package/src/runtime/foundation/service-runtime-contracts.ts

@@ -1,16 +1,39 @@
+import type { RoutingId } from '../../contracts';
 import type { Message } from '../../contracts/Common/Message';
+import type { ApplicationJobPermitPort } from '../application-jobs/contracts';
 import type {
+  ZLinkBackendMessageLike as MessageLike,
   RequestResult,
-  SubmitResult,
-  ZLinkBackendMessageLike as MessageLike
+  SubmitResult
 } from '../backend/runtime-values';
-import type { RoutingId } from '../../contracts';
-import type { ApplicationJobPermitPort } from '../application-jobs/contracts';
 import type { ServiceActorRef } from './service-stateful-registry';
 import type {
   ServiceDirectSpotRouteFence,
   ServiceRetiredBoundSessionRouteFence
 } from './service-stateful-wire-codec';
+export enum StreamSessionRuntimeState {
+  Created = 1,
+  Started = 2,
+  Closed = 5
+}
+
+export enum MeshNodeRuntimeState {
+  Preparing = 1,
+  Serving = 2,
+  Retiring = 3,
+  Draining = 4,
+  Stopped = 5,
+  Error = 6
+}
+
+export enum MeshPeerRuntimeState {
+  Connecting = 1,
+  Preparing = 2,
+  Serving = 3,
+  Draining = 4,
+  Closed = 5,
+  NotRequired = 6
+}
 
 export interface MeshOperationId {
   readonly high: bigint;
@@ -167,6 +190,18 @@ export interface ActorTransferControlPayload {
   readonly failureErrno: number;
 }
 
+/** The Session owner's registry view of one Session binding (Session–Actor binding §5-2). */
+export interface ServiceStreamSessionBinding {
+  readonly sessionRid: RoutingId;
+  readonly actor: ServiceActorRef;
+  readonly sessionOwnerNodeRid: RoutingId;
+  readonly sessionOwnerNodeGeneration: bigint;
+  readonly sessionOwnerId: string;
+  readonly sessionOwnerLeaseGeneration: bigint;
+  readonly bindingGeneration: bigint;
+  readonly membershipEpoch: bigint;
+}
+
 export interface ActorBindingControlPayload {
   readonly kind: 'actorBinding';
   readonly transition: 'active' | 'tombstone';
@@ -235,8 +270,14 @@ export interface ReceiveRecord {
   readonly isPending?: () => boolean;
   /** Absolute deadline used by the local lifecycle dispatch fence. */
   readonly deadlineUnixMs?: bigint;
+  readonly activationRecord?: Extract<
+    import('./service-stateful-wire-codec').ServiceStatefulWireRecord,
+    { readonly kind: 'instanceSpot' }
+  >;
   readonly messageFollowOrigin?: ZLinkMessageFollowOrigin;
   readonly onTerminalCompletion?: () => void | Promise<void>;
+  /** Marks the start of the first handler turn whose terminal record a Close waits for. */
+  readonly onHandlerTurnStarted?: () => void;
   readonly applicationJobPermit?: ApplicationJobPermitPort;
   readonly releaseRetainedIngress?: () => void;
   reply(parts: MessageLike | readonly MessageLike[], flags?: number): SubmitResult;
@@ -344,12 +385,7 @@ export interface StreamSessionService {
     expectedBindingGeneration: bigint,
     timeoutMs?: number
   ): MeshOperationId;
-  bindings(sessionRid: RoutingId): ReadonlyArray<{
-    readonly sessionRid: RoutingId;
-    readonly actor: ServiceActorRef;
-    readonly bindingGeneration: bigint;
-    readonly membershipEpoch: bigint;
-  }>;
+  bindings(sessionRid: RoutingId): ReadonlyArray<ServiceStreamSessionBinding>;
   sendToActor(
     sessionRid: RoutingId,
     actor: ServiceActorRef,

package/src/runtime/foundation/service-session-binding-ingress-port.ts

@@ -1,22 +1,5 @@
-export interface ServiceSessionBindingRetainedDelivery {
-  deliver(): Promise<boolean>;
-  fail(error: unknown): void;
-}
-
-export type ServiceSessionBindingAdmissionResult = 'passThrough' | 'retained' | 'rejected';
-
 export interface ServiceSessionBindingIngressPort {
   actorSlot(actorId: string, sessionRid: string): Promise<number | undefined>;
-  /**
-   * Holds a current-binding push while its relocation seal is open
-   * (Session–Actor binding §8.1). The caller has already decided that the push
-   * names the current binding.
-   */
-  retainOutbound(
-    actorId: string,
-    delivery: ServiceSessionBindingRetainedDelivery
-  ): Promise<ServiceSessionBindingAdmissionResult>;
-  clearOutbound(actorId: string, error: unknown): Promise<void>;
 }
 
 const ports = new WeakMap<object, ServiceSessionBindingIngressPort>();

package/src/runtime/foundation/service-stateful-registry.ts

@@ -1,3 +1,4 @@
+import { ZLINK_MAX_IDENTITY_TEXT_BYTES } from '../../contracts/Common/CoreTypes';
 import { OperationRegistry, type PendingOperation } from './operation-registry';
 
 export type ServiceSpotKind = 'entry' | 'user' | 'instance';
@@ -325,6 +326,7 @@ export class ServiceStatefulRegistry {
     );
     this.actorTypes.set(actor.actorId, stableType);
     this.actors.set(actor.actorId, restored);
+    this.updateBindingMembership(restored);
     return restored;
   }
 
@@ -649,6 +651,14 @@ export class ServiceTerminalOperationRegistry<T> {
     return this.operations.isPending(id);
   }
 
+  get size(): number {
+    return this.operations.size;
+  }
+
+  expire(nowMs: number, turnDeadlineMs: number): number {
+    return this.operations.expire(nowMs, turnDeadlineMs);
+  }
+
   close(): void {
     this.operations.close('Stateful runtime closed.');
   }
@@ -660,8 +670,10 @@ function actorKey(actor: ServiceActorRef): string {
 
 function requireText(value: string, name: string): void {
   const bytes = Buffer.byteLength(value);
-  if (bytes < 1 || bytes > 255 || value.includes('\0')) {
-    throw new RangeError(`${name} must be 1..255 UTF-8 bytes without NUL.`);
+  if (bytes < 1 || bytes > ZLINK_MAX_IDENTITY_TEXT_BYTES || value.includes('\0')) {
+    throw new RangeError(
+      `${name} must be 1..${ZLINK_MAX_IDENTITY_TEXT_BYTES} UTF-8 bytes without NUL.`
+    );
   }
 }