@actuallab/rpc 12.1.100 → 12.1.115

package/dist/index.d.cts

@@ -302,6 +302,8 @@ declare class RpcSharedObjectTracker {
  * so "json5np" (System.Text.Json, no polymorphism) is the correct match.
  */
 declare const DEFAULT_SERIALIZATION_FORMAT = "json5np";
+/** WebSocket close code sent by the server when the client's serialization format is unsupported. */
+declare const RPC_CLOSE_CODE_UNSUPPORTED_FORMAT = 4001;
 /** Builds the WebSocket connection URL for an RpcClientPeer. */
 type RpcConnectionUrlResolver = (peer: RpcClientPeer) => string;
 /** Default connection URL provider — appends `clientId` and `f` query parameters. */
@@ -384,6 +386,10 @@ declare class RpcClientPeer extends RpcPeer {
     /** Builds the WebSocket URL for this peer. Replace to customize URL construction. */
     connectionUrlResolver: RpcConnectionUrlResolver;
     readonly peerChanged: EventHandlerSet<void>;
+    /** Fired when the server rejects the connection due to an unsupported serialization format (close code 4010). */
+    readonly unsupportedFormat: EventHandlerSet<{
+        reason: string;
+    }>;
     readonly reconnectDelayer: RpcClientPeerReconnectDelayer;
     readonly reconnectsAtChanged: EventHandlerSet<void>;
     get reconnectsAt(): number;
@@ -590,4 +596,4 @@ declare class RpcPeerStateMonitor {
     private _scheduleRecompute;
 }
 
-export { ARG_DELIMITER, DEFAULT_SERIALIZATION_FORMAT, ENVELOPE_DELIMITER, FRAME_DELIMITER, type IRpcObject, type MethodMeta, type RemoteHandshake, type RpcCallOptions, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, type RpcConnectionUrlResolver, type RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, type RpcMessage, RpcMessageChannelConnection, type RpcMethodDef, type RpcMethodDefInput, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, RpcPeerConnectionKind, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, RpcRemoteObjectTracker, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, type RpcStreamRef, RpcStreamSender, RpcSystemCallHandler, RpcSystemCallSender, RpcSystemCalls, RpcType, RpcWebSocketConnection, type ServiceMeta, type WebSocketLike, type WebSocketServer, WebSocketState, createMessageChannelPair, createRpcClient, defaultConnectionUrlResolver, defineRpcService, deserializeMessage, getMethodsMeta, getServiceMeta, getStateDescription, isConnected, likelyConnected, parseStreamRef, resolveStreamRefs, rpcMethod, rpcService, serializeFrame, serializeMessage, splitFrame, wireMethodName };
+export { ARG_DELIMITER, DEFAULT_SERIALIZATION_FORMAT, 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 RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, type RpcMessage, RpcMessageChannelConnection, type RpcMethodDef, type RpcMethodDefInput, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, RpcPeerConnectionKind, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, RpcRemoteObjectTracker, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, type RpcStreamRef, RpcStreamSender, RpcSystemCallHandler, RpcSystemCallSender, RpcSystemCalls, RpcType, RpcWebSocketConnection, type ServiceMeta, type WebSocketLike, type WebSocketServer, WebSocketState, createMessageChannelPair, createRpcClient, defaultConnectionUrlResolver, defineRpcService, deserializeMessage, getMethodsMeta, getServiceMeta, getStateDescription, isConnected, likelyConnected, parseStreamRef, resolveStreamRefs, rpcMethod, rpcService, serializeFrame, serializeMessage, splitFrame, wireMethodName };

package/dist/index.d.ts

@@ -302,6 +302,8 @@ declare class RpcSharedObjectTracker {
  * so "json5np" (System.Text.Json, no polymorphism) is the correct match.
  */
 declare const DEFAULT_SERIALIZATION_FORMAT = "json5np";
+/** WebSocket close code sent by the server when the client's serialization format is unsupported. */
+declare const RPC_CLOSE_CODE_UNSUPPORTED_FORMAT = 4001;
 /** Builds the WebSocket connection URL for an RpcClientPeer. */
 type RpcConnectionUrlResolver = (peer: RpcClientPeer) => string;
 /** Default connection URL provider — appends `clientId` and `f` query parameters. */
@@ -384,6 +386,10 @@ declare class RpcClientPeer extends RpcPeer {
     /** Builds the WebSocket URL for this peer. Replace to customize URL construction. */
     connectionUrlResolver: RpcConnectionUrlResolver;
     readonly peerChanged: EventHandlerSet<void>;
+    /** Fired when the server rejects the connection due to an unsupported serialization format (close code 4010). */
+    readonly unsupportedFormat: EventHandlerSet<{
+        reason: string;
+    }>;
     readonly reconnectDelayer: RpcClientPeerReconnectDelayer;
     readonly reconnectsAtChanged: EventHandlerSet<void>;
     get reconnectsAt(): number;
@@ -590,4 +596,4 @@ declare class RpcPeerStateMonitor {
     private _scheduleRecompute;
 }
 
-export { ARG_DELIMITER, DEFAULT_SERIALIZATION_FORMAT, ENVELOPE_DELIMITER, FRAME_DELIMITER, type IRpcObject, type MethodMeta, type RemoteHandshake, type RpcCallOptions, RpcCallTypeId, RpcClientPeer, RpcClientPeerReconnectDelayer, type RpcConnection, type RpcConnectionUrlResolver, type RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, type RpcMessage, RpcMessageChannelConnection, type RpcMethodDef, type RpcMethodDefInput, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, RpcPeerConnectionKind, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, RpcRemoteObjectTracker, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, type RpcStreamRef, RpcStreamSender, RpcSystemCallHandler, RpcSystemCallSender, RpcSystemCalls, RpcType, RpcWebSocketConnection, type ServiceMeta, type WebSocketLike, type WebSocketServer, WebSocketState, createMessageChannelPair, createRpcClient, defaultConnectionUrlResolver, defineRpcService, deserializeMessage, getMethodsMeta, getServiceMeta, getStateDescription, isConnected, likelyConnected, parseStreamRef, resolveStreamRefs, rpcMethod, rpcService, serializeFrame, serializeMessage, splitFrame, wireMethodName };
+export { ARG_DELIMITER, DEFAULT_SERIALIZATION_FORMAT, 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 RpcDispatchContext, RpcHub, RpcInboundCall, RpcInboundCallTracker, type RpcMessage, RpcMessageChannelConnection, type RpcMethodDef, type RpcMethodDefInput, type RpcObjectId, RpcObjectKind, RpcOutboundCall, RpcOutboundCallTracker, RpcPeer, RpcPeerConnectionKind, type RpcPeerState, RpcPeerStateKind, RpcPeerStateMonitor, RpcRemoteObjectTracker, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, type RpcStreamRef, RpcStreamSender, RpcSystemCallHandler, RpcSystemCallSender, RpcSystemCalls, RpcType, RpcWebSocketConnection, type ServiceMeta, type WebSocketLike, type WebSocketServer, WebSocketState, createMessageChannelPair, createRpcClient, defaultConnectionUrlResolver, defineRpcService, deserializeMessage, getMethodsMeta, getServiceMeta, getStateDescription, isConnected, likelyConnected, parseStreamRef, resolveStreamRefs, rpcMethod, rpcService, serializeFrame, serializeMessage, splitFrame, wireMethodName };

package/dist/index.js

@@ -793,6 +793,7 @@ var RpcClientPeerReconnectDelayer = class extends RetryDelayer {
 
 // src/rpc-peer.ts
 var DEFAULT_SERIALIZATION_FORMAT = "json5np";
+var RPC_CLOSE_CODE_UNSUPPORTED_FORMAT = 4001;
 var defaultConnectionUrlResolver = (peer) => {
   const sep = peer.ref.includes("?") ? "&" : "?";
   return peer.ref + sep + `clientId=${peer.clientId}&f=${peer.serializationFormat}`;
@@ -998,6 +999,8 @@ var RpcClientPeer = class extends RpcPeer {
   /** Builds the WebSocket URL for this peer. Replace to customize URL construction. */
   connectionUrlResolver = defaultConnectionUrlResolver;
   peerChanged = new EventHandlerSet3();
+  /** Fired when the server rejects the connection due to an unsupported serialization format (close code 4010). */
+  unsupportedFormat = new EventHandlerSet3();
   reconnectDelayer = new RpcClientPeerReconnectDelayer();
   reconnectsAtChanged = new EventHandlerSet3();
   get reconnectsAt() {
@@ -1025,10 +1028,16 @@ var RpcClientPeer = class extends RpcPeer {
   async run(wsFactory) {
     const connUrl = this.connectionUrlResolver(this);
     while (!this._disposed) {
+      let lastCloseCode = 0;
+      let lastCloseReason = "";
       try {
         const ws = wsFactory?.(connUrl) ?? new WebSocket(connUrl);
         const conn = new RpcWebSocketConnection(ws);
         this._connectionKind = 1 /* Connecting */;
+        conn.closed.add((ev) => {
+          lastCloseCode = ev.code;
+          lastCloseReason = ev.reason;
+        });
         this._pendingHandshake = new PromiseSource5();
         this.setupConnection(conn);
         this._connection = void 0;
@@ -1061,6 +1070,11 @@ var RpcClientPeer = class extends RpcPeer {
       }
       this._connectionKind = 0 /* Disconnected */;
       if (this._disposed) break;
+      if (lastCloseCode === RPC_CLOSE_CODE_UNSUPPORTED_FORMAT) {
+        this.unsupportedFormat.trigger({ reason: lastCloseReason });
+        this._disposed = true;
+        break;
+      }
       this._tryIndex++;
       const delay = this.reconnectDelayer.getDelay(this._tryIndex);
       if (delay.isLimitExceeded) {
@@ -1531,6 +1545,7 @@ export {
   DEFAULT_SERIALIZATION_FORMAT,
   ENVELOPE_DELIMITER,
   FRAME_DELIMITER,
+  RPC_CLOSE_CODE_UNSUPPORTED_FORMAT,
   RpcCallTypeId,
   RpcClientPeer,
   RpcClientPeerReconnectDelayer,