@actuallab/rpc 12.3.4 → 12.3.14

package/dist/index.d.cts

@@ -380,6 +380,19 @@ declare function createMessageChannelPair(): [
     RpcMessageChannelConnection
 ];
 
+/** Controls outbound RPC call behavior regarding connection waiting, reconnection, and resending. */
+declare const RpcRemoteExecutionMode: {
+    /** Wait for connection if disconnected when the call is made. */
+    readonly AwaitForConnection: 1;
+    /** Resend on reconnection to the same peer. */
+    readonly AllowReconnect: 2;
+    /** Resend on reconnection to a different peer (implies AllowReconnect). */
+    readonly AllowResend: 6;
+    /** Default: wait + reconnect + resend. */
+    readonly Default: 7;
+};
+/** Bitfield combination of RpcRemoteExecutionMode flags. */
+type RpcRemoteExecutionMode = number;
 /** Describes a single method on an RPC service. */
 interface RpcMethodDef {
     readonly name: string;
@@ -389,6 +402,7 @@ interface RpcMethodDef {
     readonly callTypeId: number;
     readonly stream: boolean;
     readonly noWait: boolean;
+    readonly remoteExecutionMode: RpcRemoteExecutionMode;
 }
 /** Describes an RPC service — its name and method definitions. */
 interface RpcServiceDef {
@@ -401,6 +415,8 @@ interface RpcMethodDefInput {
     callTypeId?: number;
     /** Override for wireArgCount. Default: args.length + 1 (assumes a CancellationToken slot). */
     wireArgCount?: number;
+    /** Override for remoteExecutionMode. Default: RpcRemoteExecutionMode.Default (7). NoWait methods always use 0. */
+    remoteExecutionMode?: RpcRemoteExecutionMode;
 }
 declare const RpcType: {
     readonly object: symbol;
@@ -417,12 +433,14 @@ declare class RpcOutboundCall {
     readonly callId: number;
     readonly method: string;
     readonly result: PromiseSource<unknown>;
+    /** Bitfield of RpcRemoteExecutionMode flags controlling reconnect/resend behavior. */
+    readonly remoteExecutionMode: number;
     /** Whether to remove this call from the tracker on $sys.Ok. Default: true.
      *  Subclasses (e.g. compute calls) override to false to stay in tracker for invalidation. */
     readonly removeOnOk: boolean;
     /** The serialized wire data — stored for re-sending on reconnect. */
     serializedWireData: string | Uint8Array;
-    constructor(callId: number, method: string);
+    constructor(callId: number, method: string, remoteExecutionMode?: number);
     /** Called when the connection is lost. Subclasses can override to resolve invalidation promises. */
     onDisconnect(): void;
 }
@@ -483,6 +501,8 @@ declare class RpcServiceHost {
 interface MethodMeta {
     argCount: number;
     returns?: symbol;
+    /** Bitfield of RpcRemoteExecutionMode flags. */
+    remoteExecutionMode?: number;
     [key: symbol]: unknown;
 }
 interface ServiceMeta {
@@ -495,9 +515,10 @@ declare function getMethodsMeta(cls: AnyConstructor): Record<string, MethodMeta>
 declare function getServiceMeta(cls: AnyConstructor): ServiceMeta | undefined;
 /** Class decorator — stores the RPC service wire name. */
 declare function rpcService(serviceName: string): <T extends AnyConstructor>(_target: T, context: ClassDecoratorContext<T>) => void;
-/** Method decorator — stores RPC method metadata (argCount, returns). Does NOT wrap the method. */
+/** Method decorator — stores RPC method metadata (argCount, returns, remoteExecutionMode). Does NOT wrap the method. */
 declare function rpcMethod(options?: {
     returns?: symbol;
+    remoteExecutionMode?: number;
 }): <This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => (this: This, ...args: Args) => Return;
 
 /**
@@ -631,6 +652,8 @@ interface RpcCallOptions {
     outboundCallFactory?: (id: number, method: string) => RpcOutboundCall;
     /** AbortSignal for caller-initiated cancellation. */
     signal?: AbortSignal;
+    /** Bitfield of RpcRemoteExecutionMode flags (default: 7 = Default). */
+    remoteExecutionMode?: number;
 }
 /** Data extracted from an inbound $sys.Handshake message. */
 interface RemoteHandshake {
@@ -754,6 +777,13 @@ interface RpcStreamRef {
     readonly allowReconnect: boolean;
     readonly isRealTime: boolean;
 }
+/**
+ * A stream source is either a plain async iterable or a factory function
+ * that receives an AbortSignal and returns an async iterable.
+ * The AbortSignal is aborted when the sender is disconnected, allowing
+ * the source to release resources (e.g., camera, microphone) promptly.
+ */
+type RpcStreamSource<T> = AsyncIterable<T> | ((abortSignal: AbortSignal) => AsyncIterable<T>);
 /** Configuration options for creating a local (origin-side) RpcStream. */
 interface RpcStreamOptions<T> {
     ackPeriod?: number;
@@ -787,7 +817,7 @@ declare class RpcStream<T> implements AsyncIterable<T>, IRpcObject {
     readonly canSkipTo: (item: T) => boolean;
     readonly ackPeriod: number;
     readonly ackAdvance: number;
-    readonly localSource?: AsyncIterable<T>;
+    readonly localSource?: RpcStreamSource<T>;
     readonly peer: RpcPeer;
     private _sender?;
     private _toRefValue?;
@@ -801,8 +831,8 @@ declare class RpcStream<T> implements AsyncIterable<T>, IRpcObject {
     private _started;
     private _iterating;
     private _ackSentUpTo;
-    /** Create a local (origin-side) stream wrapping an async iterable with optional configuration. */
-    constructor(source: AsyncIterable<T>, options?: RpcStreamOptions<T>);
+    /** Create a local (origin-side) stream wrapping an async iterable or source factory with optional configuration. */
+    constructor(source: RpcStreamSource<T>, options?: RpcStreamOptions<T>);
     /** Create a remote (target-side) stream from a parsed stream reference and peer. */
     constructor(ref: RpcStreamRef, peer: RpcPeer);
     /**
@@ -874,7 +904,11 @@ declare class RpcStreamSender<T> implements IRpcObject {
     private _lastAckedIndex;
     private _ackWaiting;
     private _resetRequested;
+    private _abortController;
+    private _iterator;
     constructor(peer: RpcPeer, ackPeriod?: number, ackAdvance?: number, allowReconnect?: boolean, isRealTime?: boolean, canSkipTo?: (item: T) => boolean);
+    /** AbortSignal that is aborted when the sender is disconnected. */
+    get abortSignal(): AbortSignal;
     /** Returns the stream reference string for the $sys.Ok response. */
     toRef(): string;
     /** Called by system call handler when $sys.Ack is received from the client. */
@@ -968,4 +1002,4 @@ declare function xxh3_64str(input: string, seed?: bigint): bigint;
  */
 declare function computeMethodHash(methodName: string): number;
 
-export { ARG_DELIMITER, ENVELOPE_DELIMITER, FRAME_DELIMITER, type IRpcObject, type MethodMeta, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, RpcPeerConnectionKind, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, type RpcReceivedMessage, RpcRemoteObjectTracker, RpcSerializationFormat, RpcSerializationFormatResolver, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, type RpcStreamOptions, type RpcStreamRef, RpcStreamSender, RpcSystemCallHandler, RpcSystemCallSender, RpcSystemCalls, RpcType, RpcWebSocketConnection, type RpcWireData, type ServiceMeta, type WebSocketLike, type WebSocketServer, WebSocketState, computeMethodHash, createBinaryEncoder, createMessageChannelPair, createRpcClient, defaultBinaryDecoder, defaultBinaryEncoder, defaultConnectionUrlResolver, defineRpcService, deserializeBinaryMessage, deserializeCompactBinaryMessage, deserializeMessage, getMethodsMeta, getServiceMeta, getStateDescription, isConnected, likelyConnected, parseStreamRef, resolveStreamRefs, rpcMethod, rpcService, serializeBinaryFrame, serializeBinaryMessage, serializeCompactBinaryMessage, serializeFrame, serializeMessage, splitBinaryFrame, splitCompactBinaryFrame, splitFrame, wireMethodName, xxh3_64, xxh3_64str };
+export { ARG_DELIMITER, ENVELOPE_DELIMITER, FRAME_DELIMITER, type IRpcObject, type MethodMeta, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, RpcPeerConnectionKind, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, type RpcReceivedMessage, RpcRemoteExecutionMode, RpcRemoteObjectTracker, RpcSerializationFormat, RpcSerializationFormatResolver, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, type RpcStreamOptions, type RpcStreamRef, RpcStreamSender, type RpcStreamSource, RpcSystemCallHandler, RpcSystemCallSender, RpcSystemCalls, RpcType, RpcWebSocketConnection, type RpcWireData, type ServiceMeta, type WebSocketLike, type WebSocketServer, WebSocketState, computeMethodHash, createBinaryEncoder, createMessageChannelPair, createRpcClient, defaultBinaryDecoder, defaultBinaryEncoder, defaultConnectionUrlResolver, defineRpcService, deserializeBinaryMessage, deserializeCompactBinaryMessage, deserializeMessage, getMethodsMeta, getServiceMeta, getStateDescription, isConnected, likelyConnected, parseStreamRef, resolveStreamRefs, rpcMethod, rpcService, serializeBinaryFrame, serializeBinaryMessage, serializeCompactBinaryMessage, serializeFrame, serializeMessage, splitBinaryFrame, splitCompactBinaryFrame, splitFrame, wireMethodName, xxh3_64, xxh3_64str };

package/dist/index.d.ts

@@ -380,6 +380,19 @@ declare function createMessageChannelPair(): [
     RpcMessageChannelConnection
 ];
 
+/** Controls outbound RPC call behavior regarding connection waiting, reconnection, and resending. */
+declare const RpcRemoteExecutionMode: {
+    /** Wait for connection if disconnected when the call is made. */
+    readonly AwaitForConnection: 1;
+    /** Resend on reconnection to the same peer. */
+    readonly AllowReconnect: 2;
+    /** Resend on reconnection to a different peer (implies AllowReconnect). */
+    readonly AllowResend: 6;
+    /** Default: wait + reconnect + resend. */
+    readonly Default: 7;
+};
+/** Bitfield combination of RpcRemoteExecutionMode flags. */
+type RpcRemoteExecutionMode = number;
 /** Describes a single method on an RPC service. */
 interface RpcMethodDef {
     readonly name: string;
@@ -389,6 +402,7 @@ interface RpcMethodDef {
     readonly callTypeId: number;
     readonly stream: boolean;
     readonly noWait: boolean;
+    readonly remoteExecutionMode: RpcRemoteExecutionMode;
 }
 /** Describes an RPC service — its name and method definitions. */
 interface RpcServiceDef {
@@ -401,6 +415,8 @@ interface RpcMethodDefInput {
     callTypeId?: number;
     /** Override for wireArgCount. Default: args.length + 1 (assumes a CancellationToken slot). */
     wireArgCount?: number;
+    /** Override for remoteExecutionMode. Default: RpcRemoteExecutionMode.Default (7). NoWait methods always use 0. */
+    remoteExecutionMode?: RpcRemoteExecutionMode;
 }
 declare const RpcType: {
     readonly object: symbol;
@@ -417,12 +433,14 @@ declare class RpcOutboundCall {
     readonly callId: number;
     readonly method: string;
     readonly result: PromiseSource<unknown>;
+    /** Bitfield of RpcRemoteExecutionMode flags controlling reconnect/resend behavior. */
+    readonly remoteExecutionMode: number;
     /** Whether to remove this call from the tracker on $sys.Ok. Default: true.
      *  Subclasses (e.g. compute calls) override to false to stay in tracker for invalidation. */
     readonly removeOnOk: boolean;
     /** The serialized wire data — stored for re-sending on reconnect. */
     serializedWireData: string | Uint8Array;
-    constructor(callId: number, method: string);
+    constructor(callId: number, method: string, remoteExecutionMode?: number);
     /** Called when the connection is lost. Subclasses can override to resolve invalidation promises. */
     onDisconnect(): void;
 }
@@ -483,6 +501,8 @@ declare class RpcServiceHost {
 interface MethodMeta {
     argCount: number;
     returns?: symbol;
+    /** Bitfield of RpcRemoteExecutionMode flags. */
+    remoteExecutionMode?: number;
     [key: symbol]: unknown;
 }
 interface ServiceMeta {
@@ -495,9 +515,10 @@ declare function getMethodsMeta(cls: AnyConstructor): Record<string, MethodMeta>
 declare function getServiceMeta(cls: AnyConstructor): ServiceMeta | undefined;
 /** Class decorator — stores the RPC service wire name. */
 declare function rpcService(serviceName: string): <T extends AnyConstructor>(_target: T, context: ClassDecoratorContext<T>) => void;
-/** Method decorator — stores RPC method metadata (argCount, returns). Does NOT wrap the method. */
+/** Method decorator — stores RPC method metadata (argCount, returns, remoteExecutionMode). Does NOT wrap the method. */
 declare function rpcMethod(options?: {
     returns?: symbol;
+    remoteExecutionMode?: number;
 }): <This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => (this: This, ...args: Args) => Return;
 
 /**
@@ -631,6 +652,8 @@ interface RpcCallOptions {
     outboundCallFactory?: (id: number, method: string) => RpcOutboundCall;
     /** AbortSignal for caller-initiated cancellation. */
     signal?: AbortSignal;
+    /** Bitfield of RpcRemoteExecutionMode flags (default: 7 = Default). */
+    remoteExecutionMode?: number;
 }
 /** Data extracted from an inbound $sys.Handshake message. */
 interface RemoteHandshake {
@@ -754,6 +777,13 @@ interface RpcStreamRef {
     readonly allowReconnect: boolean;
     readonly isRealTime: boolean;
 }
+/**
+ * A stream source is either a plain async iterable or a factory function
+ * that receives an AbortSignal and returns an async iterable.
+ * The AbortSignal is aborted when the sender is disconnected, allowing
+ * the source to release resources (e.g., camera, microphone) promptly.
+ */
+type RpcStreamSource<T> = AsyncIterable<T> | ((abortSignal: AbortSignal) => AsyncIterable<T>);
 /** Configuration options for creating a local (origin-side) RpcStream. */
 interface RpcStreamOptions<T> {
     ackPeriod?: number;
@@ -787,7 +817,7 @@ declare class RpcStream<T> implements AsyncIterable<T>, IRpcObject {
     readonly canSkipTo: (item: T) => boolean;
     readonly ackPeriod: number;
     readonly ackAdvance: number;
-    readonly localSource?: AsyncIterable<T>;
+    readonly localSource?: RpcStreamSource<T>;
     readonly peer: RpcPeer;
     private _sender?;
     private _toRefValue?;
@@ -801,8 +831,8 @@ declare class RpcStream<T> implements AsyncIterable<T>, IRpcObject {
     private _started;
     private _iterating;
     private _ackSentUpTo;
-    /** Create a local (origin-side) stream wrapping an async iterable with optional configuration. */
-    constructor(source: AsyncIterable<T>, options?: RpcStreamOptions<T>);
+    /** Create a local (origin-side) stream wrapping an async iterable or source factory with optional configuration. */
+    constructor(source: RpcStreamSource<T>, options?: RpcStreamOptions<T>);
     /** Create a remote (target-side) stream from a parsed stream reference and peer. */
     constructor(ref: RpcStreamRef, peer: RpcPeer);
     /**
@@ -874,7 +904,11 @@ declare class RpcStreamSender<T> implements IRpcObject {
     private _lastAckedIndex;
     private _ackWaiting;
     private _resetRequested;
+    private _abortController;
+    private _iterator;
     constructor(peer: RpcPeer, ackPeriod?: number, ackAdvance?: number, allowReconnect?: boolean, isRealTime?: boolean, canSkipTo?: (item: T) => boolean);
+    /** AbortSignal that is aborted when the sender is disconnected. */
+    get abortSignal(): AbortSignal;
     /** Returns the stream reference string for the $sys.Ok response. */
     toRef(): string;
     /** Called by system call handler when $sys.Ack is received from the client. */
@@ -968,4 +1002,4 @@ declare function xxh3_64str(input: string, seed?: bigint): bigint;
  */
 declare function computeMethodHash(methodName: string): number;
 
-export { ARG_DELIMITER, ENVELOPE_DELIMITER, FRAME_DELIMITER, type IRpcObject, type MethodMeta, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, RpcPeerConnectionKind, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, type RpcReceivedMessage, RpcRemoteObjectTracker, RpcSerializationFormat, RpcSerializationFormatResolver, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, type RpcStreamOptions, type RpcStreamRef, RpcStreamSender, RpcSystemCallHandler, RpcSystemCallSender, RpcSystemCalls, RpcType, RpcWebSocketConnection, type RpcWireData, type ServiceMeta, type WebSocketLike, type WebSocketServer, WebSocketState, computeMethodHash, createBinaryEncoder, createMessageChannelPair, createRpcClient, defaultBinaryDecoder, defaultBinaryEncoder, defaultConnectionUrlResolver, defineRpcService, deserializeBinaryMessage, deserializeCompactBinaryMessage, deserializeMessage, getMethodsMeta, getServiceMeta, getStateDescription, isConnected, likelyConnected, parseStreamRef, resolveStreamRefs, rpcMethod, rpcService, serializeBinaryFrame, serializeBinaryMessage, serializeCompactBinaryMessage, serializeFrame, serializeMessage, splitBinaryFrame, splitCompactBinaryFrame, splitFrame, wireMethodName, xxh3_64, xxh3_64str };
+export { ARG_DELIMITER, ENVELOPE_DELIMITER, FRAME_DELIMITER, type IRpcObject, type MethodMeta, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, RpcPeerConnectionKind, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, type RpcReceivedMessage, RpcRemoteExecutionMode, RpcRemoteObjectTracker, RpcSerializationFormat, RpcSerializationFormatResolver, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, type RpcStreamOptions, type RpcStreamRef, RpcStreamSender, type RpcStreamSource, RpcSystemCallHandler, RpcSystemCallSender, RpcSystemCalls, RpcType, RpcWebSocketConnection, type RpcWireData, type ServiceMeta, type WebSocketLike, type WebSocketServer, WebSocketState, computeMethodHash, createBinaryEncoder, createMessageChannelPair, createRpcClient, defaultBinaryDecoder, defaultBinaryEncoder, defaultConnectionUrlResolver, defineRpcService, deserializeBinaryMessage, deserializeCompactBinaryMessage, deserializeMessage, getMethodsMeta, getServiceMeta, getStateDescription, isConnected, likelyConnected, parseStreamRef, resolveStreamRefs, rpcMethod, rpcService, serializeBinaryFrame, serializeBinaryMessage, serializeCompactBinaryMessage, serializeFrame, serializeMessage, splitBinaryFrame, splitCompactBinaryFrame, splitFrame, wireMethodName, xxh3_64, xxh3_64str };

package/dist/index.js

@@ -515,6 +515,18 @@ function createMessageChannelPair() {
 }
 
 // src/rpc-service-def.ts
+var RpcRemoteExecutionMode = {
+  /** Wait for connection if disconnected when the call is made. */
+  AwaitForConnection: 1,
+  /** Resend on reconnection to the same peer. */
+  AllowReconnect: 2,
+  /** Resend on reconnection to a different peer (implies AllowReconnect). */
+  AllowResend: 6,
+  // 4 | AllowReconnect
+  /** Default: wait + reconnect + resend. */
+  Default: 7
+  // AwaitForConnection | AllowResend
+};
 var RpcType = {
   object: /* @__PURE__ */ Symbol("object"),
   stream: /* @__PURE__ */ Symbol("stream"),
@@ -531,6 +543,7 @@ function defineRpcService(name, methods) {
     const cleanName = colonIndex >= 0 ? key.substring(0, colonIndex) : key;
     const wireArgCount = input.wireArgCount ?? input.args.length + 1;
     const mapKey = `${cleanName}:${wireArgCount}`;
+    const isNoWait = input.returns === RpcType.noWait;
     map.set(mapKey, {
       name: cleanName,
       serviceName: name,
@@ -538,7 +551,8 @@ function defineRpcService(name, methods) {
       wireArgCount,
       callTypeId: input.callTypeId ?? 0,
       stream: input.returns === RpcType.stream,
-      noWait: input.returns === RpcType.noWait
+      noWait: isNoWait,
+      remoteExecutionMode: isNoWait ? 0 : input.remoteExecutionMode ?? RpcRemoteExecutionMode.Default
     });
   }
   return { name, methods: map };
@@ -550,14 +564,17 @@ var RpcOutboundCall = class {
   callId;
   method;
   result = new PromiseSource2();
+  /** Bitfield of RpcRemoteExecutionMode flags controlling reconnect/resend behavior. */
+  remoteExecutionMode;
   /** Whether to remove this call from the tracker on $sys.Ok. Default: true.
    *  Subclasses (e.g. compute calls) override to false to stay in tracker for invalidation. */
   removeOnOk = true;
   /** The serialized wire data — stored for re-sending on reconnect. */
   serializedWireData = "";
-  constructor(callId, method) {
+  constructor(callId, method, remoteExecutionMode = 7) {
     this.callId = callId;
     this.method = method;
+    this.remoteExecutionMode = remoteExecutionMode;
   }
   /** Called when the connection is lost. Subclasses can override to resolve invalidation promises. */
   onDisconnect() {
@@ -670,6 +687,8 @@ var RpcStreamSender = class _RpcStreamSender {
   _lastAckedIndex = 0;
   _ackWaiting = null;
   _resetRequested = false;
+  _abortController = new AbortController();
+  _iterator = null;
   constructor(peer, ackPeriod = DEFAULT_ACK_PERIOD, ackAdvance = DEFAULT_ACK_ADVANCE, allowReconnect = true, isRealTime = false, canSkipTo = () => true) {
     const localId = peer.sharedObjects.nextId();
     this.id = { hostId: peer.hub.hubId, localId };
@@ -680,6 +699,10 @@ var RpcStreamSender = class _RpcStreamSender {
     this.ackPeriod = ackPeriod;
     this.ackAdvance = ackAdvance;
   }
+  /** AbortSignal that is aborted when the sender is disconnected. */
+  get abortSignal() {
+    return this._abortController.signal;
+  }
   /** Returns the stream reference string for the $sys.Ok response. */
   toRef() {
     return `${this.id.hostId},${this.id.localId},${this.ackPeriod},${this.ackAdvance},${this.allowReconnect ? "1" : "0"},${this.isRealTime ? "1" : "0"}`;
@@ -706,8 +729,7 @@ var RpcStreamSender = class _RpcStreamSender {
   }
   /** Called by system call handler when $sys.AckEnd is received from the client. */
   onAckEnd(_hostId) {
-    this._ended = true;
-    this.peer.sharedObjects.unregister(this);
+    this.disconnect();
   }
   /** Send a single item to the client. */
   sendItem(item) {
@@ -764,6 +786,7 @@ var RpcStreamSender = class _RpcStreamSender {
   async writeFrom(source) {
     await this._started.promise;
     const iterator = source[Symbol.asyncIterator]();
+    this._iterator = iterator;
     try {
       for (; ; ) {
         const next = await iterator.next();
@@ -828,10 +851,20 @@ var RpcStreamSender = class _RpcStreamSender {
   reconnect() {
   }
   disconnect() {
+    if (this._ended) return;
     this._ended = true;
+    this._abortController.abort();
     if (!this._started.isCompleted) {
       this._started.resolve();
     }
+    if (this._ackWaiting) {
+      this._ackWaiting.resolve();
+      this._ackWaiting = null;
+    }
+    if (this._iterator) {
+      void this._iterator.return?.(void 0);
+      this._iterator = null;
+    }
     this.peer.sharedObjects.unregister(this);
   }
 };
@@ -896,7 +929,7 @@ var RpcStream = class _RpcStream {
   _iterating = false;
   _ackSentUpTo = 0;
   constructor(sourceOrRef, optionsOrPeer) {
-    if (_isAsyncIterable(sourceOrRef)) {
+    if (_isStreamSource(sourceOrRef)) {
       const options = optionsOrPeer ?? {};
       this.kind = RpcObjectKind.Local;
       this.localSource = sourceOrRef;
@@ -957,7 +990,8 @@ var RpcStream = class _RpcStream {
     );
     peer.sharedObjects.register(sender);
     this._sender = sender;
-    this._whenSent = sender.writeFrom(this.localSource);
+    const source = typeof this.localSource === "function" ? this.localSource(sender.abortSignal) : this.localSource;
+    this._whenSent = sender.writeFrom(source);
     this._toRefValue = peer.format.isBinary ? {
       SerializedId: [sender.id.hostId, sender.id.localId],
       AckPeriod: sender.ackPeriod,
@@ -1037,7 +1071,10 @@ var RpcStream = class _RpcStream {
     }
   }
   disconnect() {
-    if (this.kind === RpcObjectKind.Local) return;
+    if (this.kind === RpcObjectKind.Local) {
+      this._sender?.disconnect();
+      return;
+    }
     if (this._completed) return;
     this._completed = true;
     this._completionError = new Error("Peer disconnected.");
@@ -1046,7 +1083,8 @@ var RpcStream = class _RpcStream {
   // -- AsyncIterable --
   [Symbol.asyncIterator]() {
     if (this.kind === RpcObjectKind.Local) {
-      return this.localSource[Symbol.asyncIterator]();
+      const source = typeof this.localSource === "function" ? this.localSource(new AbortController().signal) : this.localSource;
+      return source[Symbol.asyncIterator]();
     }
     if (this._iterating)
       throw new Error("RpcStream can only be iterated once.");
@@ -1127,7 +1165,8 @@ var RpcStream = class _RpcStream {
     }
   }
 };
-function _isAsyncIterable(value) {
+function _isStreamSource(value) {
+  if (typeof value === "function") return true;
   return value !== null && typeof value === "object" && Symbol.asyncIterator in value;
 }
 function resolveStreamRefs(value, peer) {
@@ -1662,7 +1701,7 @@ var RpcPeer = class {
   }
   call(method, args, options) {
     const callId = this.outbound.nextId();
-    const outboundCall = options?.outboundCallFactory ? options.outboundCallFactory(callId, method) : new RpcOutboundCall(callId, method);
+    const outboundCall = options?.outboundCallFactory ? options.outboundCallFactory(callId, method) : new RpcOutboundCall(callId, method, options?.remoteExecutionMode ?? 7);
     const envelope = {
       Method: method,
       RelatedId: callId,
@@ -1999,7 +2038,18 @@ var RpcClientPeer = class extends RpcPeer {
     }
     const trackerCalls = [...this.outbound.values()];
     for (const call of trackerCalls) {
-      if (!call.removeOnOk && call.result.isCompleted) {
+      const mode = call.remoteExecutionMode;
+      if (!(mode & 2)) {
+        if (!call.result.isCompleted)
+          call.result.reject(new Error("Outbound call failed: disconnected and AllowReconnect is not set."));
+        call.onDisconnect();
+        this.outbound.remove(call.callId);
+      } else if (_isPeerChanged && !(mode & 4)) {
+        if (!call.result.isCompleted)
+          call.result.reject(new Error("Outbound call failed: reconnected to a different peer and AllowResend is not set."));
+        call.onDisconnect();
+        this.outbound.remove(call.callId);
+      } else if (!call.removeOnOk && call.result.isCompleted) {
         call.onDisconnect();
         this.outbound.remove(call.callId);
       } else {
@@ -2023,6 +2073,9 @@ var RpcServerPeer = class extends RpcPeer {
   /** Accept an incoming connection — sets up message handling and handshake response. */
   accept(conn) {
     this.setupConnection(conn);
+    conn.closed.add(() => {
+      this.sharedObjects.disconnectAll();
+    });
   }
   _onHandshakeReceived(_handshake) {
     if (this._connection !== void 0) {
@@ -2102,7 +2155,8 @@ function rpcMethod(options) {
     methods[methodName] = {
       ...methods[methodName],
       argCount: target.length,
-      returns: options?.returns
+      returns: options?.returns,
+      remoteExecutionMode: options?.remoteExecutionMode
     };
     return target;
   };
@@ -2717,7 +2771,8 @@ var RpcHub = class {
     const methods = /* @__PURE__ */ new Map();
     for (const [name, byArgCount] of overloads) {
       if (byArgCount.size === 1) {
-        methods.set(name, byArgCount.values().next().value);
+        const [[, singleFn]] = byArgCount;
+        methods.set(name, singleFn);
       } else {
         methods.set(name, (...args) => {
           const fn = byArgCount.get(args.length);
@@ -2747,6 +2802,7 @@ var RpcHub = class {
     for (const [name, meta] of Object.entries(methodsMeta)) {
       const wireArgCount = meta.argCount + 1;
       const mapKey = `${name}:${wireArgCount}`;
+      const isNoWait = meta.returns === RpcType.noWait;
       methods.set(mapKey, {
         name,
         serviceName: svcMeta.name,
@@ -2754,7 +2810,8 @@ var RpcHub = class {
         wireArgCount,
         callTypeId: 0,
         stream: meta.returns === RpcType.stream,
-        noWait: meta.returns === RpcType.noWait
+        noWait: isNoWait,
+        remoteExecutionMode: isNoWait ? 0 : meta.remoteExecutionMode ?? RpcRemoteExecutionMode.Default
       });
     }
     return { name: svcMeta.name, methods };
@@ -2772,6 +2829,8 @@ var RpcHub = class {
   /** Create a client method for the given methodDef. Override in FusionHub for custom call types. */
   _createClientMethod(peer, methodDef) {
     const wireName = wireMethodName(methodDef);
+    const mode = methodDef.remoteExecutionMode;
+    const mustCheckConnection = !(mode & RpcRemoteExecutionMode.AwaitForConnection);
     if (methodDef.noWait) {
       return (...args) => {
         const callArgs = args.slice(0, methodDef.argCount);
@@ -2780,6 +2839,8 @@ var RpcHub = class {
     }
     if (methodDef.stream) {
       return async (...args) => {
+        if (mustCheckConnection && !peer.isConnected)
+          throw new Error("Outbound call failed: not connected and AwaitForConnection is not set.");
         const callArgs = args.slice(0, methodDef.argCount);
         const outboundCall = peer.call(wireName, callArgs);
         const result = await outboundCall.result.promise;
@@ -2793,8 +2854,10 @@ var RpcHub = class {
         return stream;
       };
     }
-    const callOptions = methodDef.callTypeId !== 0 ? { callTypeId: methodDef.callTypeId } : void 0;
+    const callOptions = methodDef.callTypeId !== 0 || mode !== RpcRemoteExecutionMode.Default ? { callTypeId: methodDef.callTypeId, remoteExecutionMode: mode } : void 0;
     return async (...args) => {
+      if (mustCheckConnection && !peer.isConnected)
+        throw new Error("Outbound call failed: not connected and AwaitForConnection is not set.");
       const callArgs = args.slice(0, methodDef.argCount);
       const outboundCall = peer.call(wireName, callArgs, callOptions);
       const result = await outboundCall.result.promise;
@@ -2817,7 +2880,7 @@ function createRpcClient(peer, serviceDef) {
   const methods = /* @__PURE__ */ new Map();
   for (const [name, byArgCount] of overloads) {
     if (byArgCount.size === 1) {
-      const methodDef = byArgCount.values().next().value;
+      const [[, methodDef]] = byArgCount;
       methods.set(name, createMethod(peer, methodDef));
     } else {
       const fns = /* @__PURE__ */ new Map();
@@ -2842,10 +2905,14 @@ function createRpcClient(peer, serviceDef) {
   });
 }
 function createMethod(peer, methodDef) {
+  const mode = methodDef.remoteExecutionMode;
+  const mustCheckConnection = !(mode & RpcRemoteExecutionMode.AwaitForConnection);
   return async (...args) => {
+    if (mustCheckConnection && !peer.isConnected)
+      throw new Error("Outbound call failed: not connected and AwaitForConnection is not set.");
     const callArgs = args.slice(0, methodDef.argCount);
     const wireName = wireMethodName(methodDef);
-    const options = methodDef.callTypeId !== 0 ? { callTypeId: methodDef.callTypeId } : void 0;
+    const options = methodDef.callTypeId !== 0 || mode !== RpcRemoteExecutionMode.Default ? { callTypeId: methodDef.callTypeId, remoteExecutionMode: mode } : void 0;
     const outboundCall = peer.call(wireName, callArgs, options);
     return outboundCall.result.promise;
   };
@@ -3059,6 +3126,7 @@ export {
   RpcPeerConnectionKind,
   RpcPeerStateKind,
   RpcPeerStateMonitor,
+  RpcRemoteExecutionMode,
   RpcRemoteObjectTracker,
   RpcSerializationFormat,
   RpcSerializationFormatResolver,