@actuallab/rpc 13.0.167 → 14.1.5

package/dist/index.d.cts

@@ -790,7 +790,7 @@ declare class RpcSystemCallSender {
 }
 
 /** Factory signature shared by all peer lookup/creation methods. Serialization
- *  format is encoded in the URL via `?f=...` (see {@link RpcPeerRefBuilder}),
+ *  format is encoded in the URL via `?f=...` (see {@link RpcRefBuilder}),
  *  so the factory doesn't need an extra parameter for it. `getClientPeer` /
  *  `getServerPeer` cast the result, so the factory returns RpcPeer. */
 type RpcPeerFactory = (hub: RpcHub, ref: string) => RpcPeer;
@@ -1097,7 +1097,7 @@ declare class RpcClientPeer extends RpcPeer {
      * @param url Full WebSocket URL — the serialization format is taken from
      *            the `f=` query parameter (e.g. `wss://host/rpc/ws?f=msgpack6`);
      *            falls back to the resolver's default when absent. Use
-     *            {@link RpcPeerRefBuilder.forClient} to compose URLs with a format.
+     *            {@link RpcRefBuilder.forClient} to compose URLs with a format.
      * @param mustStart Kick off the reconnect loop automatically at the end of
      *            construction (default `true`). Pass `false` if you need to
      *            tweak `reconnectDelayer`, `handshakeTimeoutMs`, or similar
@@ -1332,7 +1332,10 @@ declare class RpcStreamSender<T> implements IRpcObject {
      * in-flight window — real-time mode uses the extra space to pre-buffer.
      */
     private _run;
-    /** Drain all queued ACKs, returning the most recent one (or null if none). */
+    /** Drain all queued ACKs, returning the most recent one (or null if none).
+     *  A reconnect's reset ACK may be drained in one batch with regular
+     *  consumption ACKs the client sends right after it, so `mustReset` is
+     *  OR-ed over the whole batch — the last ACK alone can't represent it. */
     private _tryProcessAcks;
     /** Wait for the ACK queue to have at least one entry (or `_ended`). */
     private _waitAckReady;
@@ -1481,7 +1484,7 @@ declare class RpcStream<T> implements AsyncIterable<T>, IRpcObject {
  */
 declare function resolveStreamRefs(value: unknown, peer: RpcPeer): unknown;
 
-declare class RpcPeerRefBuilder {
+declare class RpcRefBuilder {
     /** Build a client peer ref from a WebSocket URL, optionally baking in the
      *  serialization format as a `f=` query parameter.
      *  @param url Base WebSocket URL, e.g. `wss://host/rpc/ws`.
@@ -1556,4 +1559,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, IncreasingSeqCompressor, type MethodMeta, REMOTE_EXCEPTION_TYPE_REF, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallStage, RpcCallTimeouts, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, RpcConnectionState, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcError, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, RpcLimits, 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, readPolymorphismMarker, resolveStreamRefs, rpcMethod, rpcService, serializeBinaryFrame, serializeBinaryMessage, serializeCompactBinaryMessage, serializeFrame, serializeMessage, splitBinaryFrame, splitCompactBinaryFrame, splitFrame, toExceptionInfo, wireMethodName, xxh3_64, xxh3_64str };
+export { ARG_DELIMITER, ENVELOPE_DELIMITER, FRAME_DELIMITER, type IRpcObject, IncreasingSeqCompressor, type MethodMeta, REMOTE_EXCEPTION_TYPE_REF, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallStage, RpcCallTimeouts, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, RpcConnectionState, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcError, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, RpcLimits, type RpcLogScope, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, type RpcPeerFactory, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, type RpcReceivedMessage, RpcRefBuilder, 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, readPolymorphismMarker, resolveStreamRefs, rpcMethod, rpcService, serializeBinaryFrame, serializeBinaryMessage, serializeCompactBinaryMessage, serializeFrame, serializeMessage, splitBinaryFrame, splitCompactBinaryFrame, splitFrame, toExceptionInfo, wireMethodName, xxh3_64, xxh3_64str };

package/dist/index.d.ts

@@ -790,7 +790,7 @@ declare class RpcSystemCallSender {
 }
 
 /** Factory signature shared by all peer lookup/creation methods. Serialization
- *  format is encoded in the URL via `?f=...` (see {@link RpcPeerRefBuilder}),
+ *  format is encoded in the URL via `?f=...` (see {@link RpcRefBuilder}),
  *  so the factory doesn't need an extra parameter for it. `getClientPeer` /
  *  `getServerPeer` cast the result, so the factory returns RpcPeer. */
 type RpcPeerFactory = (hub: RpcHub, ref: string) => RpcPeer;
@@ -1097,7 +1097,7 @@ declare class RpcClientPeer extends RpcPeer {
      * @param url Full WebSocket URL — the serialization format is taken from
      *            the `f=` query parameter (e.g. `wss://host/rpc/ws?f=msgpack6`);
      *            falls back to the resolver's default when absent. Use
-     *            {@link RpcPeerRefBuilder.forClient} to compose URLs with a format.
+     *            {@link RpcRefBuilder.forClient} to compose URLs with a format.
      * @param mustStart Kick off the reconnect loop automatically at the end of
      *            construction (default `true`). Pass `false` if you need to
      *            tweak `reconnectDelayer`, `handshakeTimeoutMs`, or similar
@@ -1332,7 +1332,10 @@ declare class RpcStreamSender<T> implements IRpcObject {
      * in-flight window — real-time mode uses the extra space to pre-buffer.
      */
     private _run;
-    /** Drain all queued ACKs, returning the most recent one (or null if none). */
+    /** Drain all queued ACKs, returning the most recent one (or null if none).
+     *  A reconnect's reset ACK may be drained in one batch with regular
+     *  consumption ACKs the client sends right after it, so `mustReset` is
+     *  OR-ed over the whole batch — the last ACK alone can't represent it. */
     private _tryProcessAcks;
     /** Wait for the ACK queue to have at least one entry (or `_ended`). */
     private _waitAckReady;
@@ -1481,7 +1484,7 @@ declare class RpcStream<T> implements AsyncIterable<T>, IRpcObject {
  */
 declare function resolveStreamRefs(value: unknown, peer: RpcPeer): unknown;
 
-declare class RpcPeerRefBuilder {
+declare class RpcRefBuilder {
     /** Build a client peer ref from a WebSocket URL, optionally baking in the
      *  serialization format as a `f=` query parameter.
      *  @param url Base WebSocket URL, e.g. `wss://host/rpc/ws`.
@@ -1556,4 +1559,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, IncreasingSeqCompressor, type MethodMeta, REMOTE_EXCEPTION_TYPE_REF, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallStage, RpcCallTimeouts, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, RpcConnectionState, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcError, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, RpcLimits, 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, readPolymorphismMarker, resolveStreamRefs, rpcMethod, rpcService, serializeBinaryFrame, serializeBinaryMessage, serializeCompactBinaryMessage, serializeFrame, serializeMessage, splitBinaryFrame, splitCompactBinaryFrame, splitFrame, toExceptionInfo, wireMethodName, xxh3_64, xxh3_64str };
+export { ARG_DELIMITER, ENVELOPE_DELIMITER, FRAME_DELIMITER, type IRpcObject, IncreasingSeqCompressor, type MethodMeta, REMOTE_EXCEPTION_TYPE_REF, RPC_CLOSE_CODE_UNSUPPORTED_FORMAT, type RemoteHandshake, type RpcCallOptions, RpcCallStage, RpcCallTimeouts, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, RpcConnectionState, type RpcConnectionUrlResolver, type RpcDeserializedMessage, type RpcDispatchContext, RpcError, RpcHub, RpcInboundCall, RpcInboundCallTracker, RpcJsonSerializationFormat, RpcLimits, type RpcLogScope, type RpcMessage, RpcMessageChannelConnection, RpcMessagePackCompactSerializationFormat, RpcMessagePackSerializationFormat, type RpcMethodDef, type RpcMethodDefInput, RpcMethodRegistry, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, type RpcPeerFactory, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, type RpcReceivedMessage, RpcRefBuilder, 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, readPolymorphismMarker, resolveStreamRefs, rpcMethod, rpcService, serializeBinaryFrame, serializeBinaryMessage, serializeCompactBinaryMessage, serializeFrame, serializeMessage, splitBinaryFrame, splitCompactBinaryFrame, splitFrame, toExceptionInfo, wireMethodName, xxh3_64, xxh3_64str };

package/dist/index.js

@@ -1362,13 +1362,18 @@ var RpcStreamSender = class _RpcStreamSender {
     }
   }
   /* eslint-enable @typescript-eslint/no-unnecessary-condition */
-  /** Drain all queued ACKs, returning the most recent one (or null if none). */
+  /** Drain all queued ACKs, returning the most recent one (or null if none).
+   *  A reconnect's reset ACK may be drained in one batch with regular
+   *  consumption ACKs the client sends right after it, so `mustReset` is
+   *  OR-ed over the whole batch — the last ACK alone can't represent it. */
   _tryProcessAcks() {
     if (this._acks.length === 0) return null;
-    let last = null;
+    let nextIndex = 0;
+    let mustReset = false;
     while (this._acks.length > 0) {
       const a = this._acks.shift();
-      last = a;
+      nextIndex = a.nextIndex;
+      mustReset ||= a.mustReset;
       if (a.mustReset || this._nextIndex < a.nextIndex) {
         this._nextIndex = a.nextIndex;
       }
@@ -1377,7 +1382,7 @@ var RpcStreamSender = class _RpcStreamSender {
       this.onAckProcessed?.();
     } catch {
     }
-    return last;
+    return { nextIndex, mustReset };
   }
   /** Wait for the ACK queue to have at least one entry (or `_ended`). */
   async _waitAckReady() {
@@ -2957,7 +2962,7 @@ var RpcClientPeer = class extends RpcPeer {
    * @param url Full WebSocket URL — the serialization format is taken from
    *            the `f=` query parameter (e.g. `wss://host/rpc/ws?f=msgpack6`);
    *            falls back to the resolver's default when absent. Use
-   *            {@link RpcPeerRefBuilder.forClient} to compose URLs with a format.
+   *            {@link RpcRefBuilder.forClient} to compose URLs with a format.
    * @param mustStart Kick off the reconnect loop automatically at the end of
    *            construction (default `true`). Pass `false` if you need to
    *            tweak `reconnectDelayer`, `handshakeTimeoutMs`, or similar
@@ -4277,8 +4282,8 @@ function isSameWireMethod(a, b) {
   return a.wireArgCount === b.wireArgCount && a.callTypeId === b.callTypeId && a.stream === b.stream && a.noWait === b.noWait && a.remoteExecutionMode === b.remoteExecutionMode;
 }
 
-// src/rpc-peer-ref-builder.ts
-var RpcPeerRefBuilder = class {
+// src/rpc-ref-builder.ts
+var RpcRefBuilder = class {
   /** Build a client peer ref from a WebSocket URL, optionally baking in the
    *  serialization format as a `f=` query parameter.
    *  @param url Base WebSocket URL, e.g. `wss://host/rpc/ws`.
@@ -4559,9 +4564,9 @@ export {
   RpcOutboundCall,
   RpcOutboundCallTracker,
   RpcPeer,
-  RpcPeerRefBuilder,
   RpcPeerStateKind,
   RpcPeerStateMonitor,
+  RpcRefBuilder,
   RpcRemoteExecutionMode,
   RpcRemoteObjectTracker,
   RpcSerializationFormat,