@actuallab/rpc 12.3.79 → 12.3.83

package/dist/index.d.cts

@@ -523,6 +523,12 @@ declare const RpcCallStage: {
 };
 type RpcCallStage = number;
 
+/** Error thrown for a failed remote RPC call — carries the remote exception's type name when available. */
+declare class RpcError extends Error {
+    readonly typeName?: string;
+    constructor(message: string, typeName?: string);
+}
+
 /**
  * Compresses and decompresses monotonically increasing sequences of
  * integers using variable-length LEB128 encoding of successive deltas.
@@ -1056,6 +1062,7 @@ declare class RpcStream<T> implements AsyncIterable<T>, IRpcObject {
     private _started;
     private _iterating;
     private _ackSentUpTo;
+    private _nextConsumedIndex;
     /** 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. */
@@ -1288,4 +1295,4 @@ declare function xxh3_64str(input: string, seed?: bigint): bigint;
  */
 declare function computeMethodHash(methodName: string): number;
 
-export { ARG_DELIMITER, ENVELOPE_DELIMITER, FRAME_DELIMITER, HANDSHAKE_TIMEOUT_MS, type IRpcObject, IncreasingSeqCompressor, type MethodMeta, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallStage, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, RpcConnectionState, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, type RpcLogScope, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, type RpcPeerFactory, RpcPeerRefBuilder, 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, getLogs, 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, HANDSHAKE_TIMEOUT_MS, type IRpcObject, IncreasingSeqCompressor, type MethodMeta, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallStage, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, RpcConnectionState, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcError, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, type RpcLogScope, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, type RpcPeerFactory, RpcPeerRefBuilder, 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, getLogs, 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

@@ -523,6 +523,12 @@ declare const RpcCallStage: {
 };
 type RpcCallStage = number;
 
+/** Error thrown for a failed remote RPC call — carries the remote exception's type name when available. */
+declare class RpcError extends Error {
+    readonly typeName?: string;
+    constructor(message: string, typeName?: string);
+}
+
 /**
  * Compresses and decompresses monotonically increasing sequences of
  * integers using variable-length LEB128 encoding of successive deltas.
@@ -1056,6 +1062,7 @@ declare class RpcStream<T> implements AsyncIterable<T>, IRpcObject {
     private _started;
     private _iterating;
     private _ackSentUpTo;
+    private _nextConsumedIndex;
     /** 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. */
@@ -1288,4 +1295,4 @@ declare function xxh3_64str(input: string, seed?: bigint): bigint;
  */
 declare function computeMethodHash(methodName: string): number;
 
-export { ARG_DELIMITER, ENVELOPE_DELIMITER, FRAME_DELIMITER, HANDSHAKE_TIMEOUT_MS, type IRpcObject, IncreasingSeqCompressor, type MethodMeta, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallStage, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, RpcConnectionState, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, type RpcLogScope, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, type RpcPeerFactory, RpcPeerRefBuilder, 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, getLogs, 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, HANDSHAKE_TIMEOUT_MS, type IRpcObject, IncreasingSeqCompressor, type MethodMeta, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallStage, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, RpcConnectionState, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcError, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, type RpcLogScope, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, type RpcPeerFactory, RpcPeerRefBuilder, 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, getLogs, 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

@@ -757,6 +757,17 @@ var RpcInboundCallTracker = class {
   }
 };
 
+// src/rpc-error.ts
+var RpcError = class extends Error {
+  typeName;
+  constructor(message, typeName) {
+    super(message);
+    this.name = "RpcError";
+    if (typeName !== void 0)
+      this.typeName = typeName;
+  }
+};
+
 // src/increasing-seq-compressor.ts
 var IncreasingSeqCompressor = {
   /**
@@ -1366,6 +1377,7 @@ var RpcStream = class _RpcStream {
   _started = false;
   _iterating = false;
   _ackSentUpTo = 0;
+  _nextConsumedIndex = 0;
   constructor(sourceOrRef, optionsOrPeer) {
     if (_isStreamSource(sourceOrRef)) {
       const options = optionsOrPeer ?? {};
@@ -1457,12 +1469,11 @@ var RpcStream = class _RpcStream {
       return;
     }
     if (index < this._nextExpectedIndex) {
-      this._maybeSendAck(index + 1);
+      this._maybeSendAck(Math.min(index + 1, this._nextConsumedIndex));
       return;
     }
     this._buffer.push(item);
     this._nextExpectedIndex = index + 1;
-    this._maybeSendAck(this._nextExpectedIndex);
     this._notifyConsumer();
   }
   /** Called by system call handler when a batch arrives ($sys.B). */
@@ -1482,12 +1493,11 @@ var RpcStream = class _RpcStream {
       return;
     }
     if (index < this._nextExpectedIndex) {
-      this._maybeSendAck(index + items.length);
+      this._maybeSendAck(Math.min(index + items.length, this._nextConsumedIndex));
       return;
     }
     for (const item of items) this._buffer.push(item);
     this._nextExpectedIndex = index + items.length;
-    this._maybeSendAck(this._nextExpectedIndex);
     this._notifyConsumer();
   }
   /** Called by system call handler when the stream ends ($sys.End). */
@@ -1531,9 +1541,11 @@ var RpcStream = class _RpcStream {
           this._started = true;
           this._sendAck(0, true);
         }
+        this._maybeSendAck(this._nextConsumedIndex);
         for (; ; ) {
           if (!this._buffer.isEmpty()) {
             const value = this._buffer.shift();
+            this._nextConsumedIndex++;
             return { value, done: false };
           }
           if (this._completed) {
@@ -1683,12 +1695,17 @@ var RpcSystemCallHandler = class {
           const errorInfo = args[0];
           const msg = errorInfo?.Message ?? errorInfo?.message ?? "RPC error";
           const errorType = errorInfo?.TypeRef ?? errorInfo?.typeRef;
-          if (errorType !== null && typeof errorType === "object") {
+          let typeName;
+          if (typeof errorType === "string") {
+            const commaIdx = errorType.indexOf(",");
+            typeName = commaIdx >= 0 ? errorType.slice(0, commaIdx) : errorType;
+          } else if (errorType !== null && typeof errorType === "object") {
             const t = errorType;
-            if (t.TypeName === "RpcRerouteException" || t.typeName === "RpcRerouteException")
-              warnLog5?.log("Got RpcRerouteException from remote peer:", msg);
+            typeName = t.TypeName ?? t.typeName;
           }
-          call.result.reject(new Error(msg));
+          if (typeName === "ActualLab.Rpc.RpcRerouteException")
+            warnLog5?.log("Got RpcRerouteException from remote peer:", msg);
+          call.result.reject(new RpcError(msg, typeName));
         }
         break;
       }
@@ -3992,6 +4009,7 @@ export {
   RpcClientPeer,
   RpcClientPeerReconnectDelayer,
   RpcConnectionState,
+  RpcError,
   RpcHub,
   RpcInboundCall,
   RpcInboundCallTracker,