@actuallab/rpc 12.2.21 → 12.2.23

package/dist/index.d.cts

@@ -192,9 +192,18 @@ declare abstract class RpcSerializationFormat {
     createEncoder(): Encoder | undefined;
     /** Create a reusable binary decoder for this format. Returns undefined for text formats. */
     createDecoder(): Decoder | undefined;
-    private static _all;
-    static register(format: RpcSerializationFormat): void;
+    static SystemJsonV5: RpcSerializationFormat;
+    static SystemJsonV5NP: RpcSerializationFormat;
+    static NewtonsoftJsonV5: RpcSerializationFormat;
+    static NewtonsoftJsonV5NP: RpcSerializationFormat;
+    static MessagePackV6: RpcSerializationFormat;
+    static MemoryPackV6: RpcSerializationFormat;
+    static MessagePackV6C: RpcSerializationFormat;
+    static MemoryPackV6C: RpcSerializationFormat;
+    static All: readonly RpcSerializationFormat[];
+    /** Convenience shortcut for RpcSerializationFormatResolver.Default.get(key). */
     static get(key: string): RpcSerializationFormat;
+    /** Convenience shortcut for RpcSerializationFormatResolver.Default.tryGet(key). */
     static tryGet(key: string): RpcSerializationFormat | undefined;
 }
 /**
@@ -242,6 +251,20 @@ declare class RpcMessagePackCompactSerializationFormat extends RpcSerializationF
     createEncoder(): Encoder;
     createDecoder(): Decoder;
 }
+/**
+ * Resolves RpcSerializationFormat instances by key, with a configurable default.
+ * Mirrors .NET RpcSerializationFormatResolver.
+ */
+declare class RpcSerializationFormatResolver {
+    static DefaultFormats: readonly RpcSerializationFormat[];
+    static Default: RpcSerializationFormatResolver;
+    readonly defaultFormatKey: string;
+    readonly formats: ReadonlyMap<string, RpcSerializationFormat>;
+    get defaultFormat(): RpcSerializationFormat;
+    constructor(defaultFormatKey: string, formats?: Iterable<RpcSerializationFormat>);
+    get(key: string): RpcSerializationFormat;
+    tryGet(key: string): RpcSerializationFormat | undefined;
+}
 
 /** Abstract WebSocket interface — works with both browser WebSocket and Node.js ws. */
 interface WebSocketLike {
@@ -574,12 +597,6 @@ declare class RpcSharedObjectTracker {
     disconnectAll(): void;
 }
 
-/**
- * Default serialization format for RpcClientPeer connections.
- * TS uses plain JSON.stringify without polymorphic type wrapping,
- * 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. */
@@ -913,4 +930,4 @@ declare function xxh3_64str(input: string, seed?: bigint): bigint;
  */
 declare function computeMethodHash(methodName: string): number;
 
-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 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, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, 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, RpcRemoteObjectTracker, RpcSerializationFormat, RpcSerializationFormatResolver, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, 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 };

package/dist/index.d.ts

@@ -192,9 +192,18 @@ declare abstract class RpcSerializationFormat {
     createEncoder(): Encoder | undefined;
     /** Create a reusable binary decoder for this format. Returns undefined for text formats. */
     createDecoder(): Decoder | undefined;
-    private static _all;
-    static register(format: RpcSerializationFormat): void;
+    static SystemJsonV5: RpcSerializationFormat;
+    static SystemJsonV5NP: RpcSerializationFormat;
+    static NewtonsoftJsonV5: RpcSerializationFormat;
+    static NewtonsoftJsonV5NP: RpcSerializationFormat;
+    static MessagePackV6: RpcSerializationFormat;
+    static MemoryPackV6: RpcSerializationFormat;
+    static MessagePackV6C: RpcSerializationFormat;
+    static MemoryPackV6C: RpcSerializationFormat;
+    static All: readonly RpcSerializationFormat[];
+    /** Convenience shortcut for RpcSerializationFormatResolver.Default.get(key). */
     static get(key: string): RpcSerializationFormat;
+    /** Convenience shortcut for RpcSerializationFormatResolver.Default.tryGet(key). */
     static tryGet(key: string): RpcSerializationFormat | undefined;
 }
 /**
@@ -242,6 +251,20 @@ declare class RpcMessagePackCompactSerializationFormat extends RpcSerializationF
     createEncoder(): Encoder;
     createDecoder(): Decoder;
 }
+/**
+ * Resolves RpcSerializationFormat instances by key, with a configurable default.
+ * Mirrors .NET RpcSerializationFormatResolver.
+ */
+declare class RpcSerializationFormatResolver {
+    static DefaultFormats: readonly RpcSerializationFormat[];
+    static Default: RpcSerializationFormatResolver;
+    readonly defaultFormatKey: string;
+    readonly formats: ReadonlyMap<string, RpcSerializationFormat>;
+    get defaultFormat(): RpcSerializationFormat;
+    constructor(defaultFormatKey: string, formats?: Iterable<RpcSerializationFormat>);
+    get(key: string): RpcSerializationFormat;
+    tryGet(key: string): RpcSerializationFormat | undefined;
+}
 
 /** Abstract WebSocket interface — works with both browser WebSocket and Node.js ws. */
 interface WebSocketLike {
@@ -574,12 +597,6 @@ declare class RpcSharedObjectTracker {
     disconnectAll(): void;
 }
 
-/**
- * Default serialization format for RpcClientPeer connections.
- * TS uses plain JSON.stringify without polymorphic type wrapping,
- * 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. */
@@ -913,4 +930,4 @@ declare function xxh3_64str(input: string, seed?: bigint): bigint;
  */
 declare function computeMethodHash(methodName: string): number;
 
-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 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, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, 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, RpcRemoteObjectTracker, RpcSerializationFormat, RpcSerializationFormatResolver, RpcServerPeer, type RpcServiceDef, RpcServiceHost, type RpcServiceImpl, RpcSharedObjectTracker, RpcStream, 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 };

package/dist/index.js

@@ -1360,7 +1360,7 @@ var RpcClientPeerReconnectDelayer = class extends RetryDelayer {
 
 // src/rpc-serialization-format.ts
 import { Decoder as Decoder3 } from "@msgpack/msgpack";
-var RpcSerializationFormat = class _RpcSerializationFormat {
+var RpcSerializationFormat = class {
   /** Create a reusable binary encoder for this format. Returns undefined for text formats. */
   createEncoder() {
     return void 0;
@@ -1369,19 +1369,23 @@ var RpcSerializationFormat = class _RpcSerializationFormat {
   createDecoder() {
     return void 0;
   }
-  // --- Static registry ---
-  static _all = /* @__PURE__ */ new Map();
-  static register(format) {
-    _RpcSerializationFormat._all.set(format.key, format);
-  }
+  // Named format instances — initialized in initFormats() below (after subclasses are defined)
+  static SystemJsonV5;
+  static SystemJsonV5NP;
+  static NewtonsoftJsonV5;
+  static NewtonsoftJsonV5NP;
+  static MessagePackV6;
+  static MemoryPackV6;
+  static MessagePackV6C;
+  static MemoryPackV6C;
+  static All;
+  /** Convenience shortcut for RpcSerializationFormatResolver.Default.get(key). */
   static get(key) {
-    const format = _RpcSerializationFormat._all.get(key);
-    if (!format)
-      throw new Error(`Unknown RPC serialization format: "${key}"`);
-    return format;
+    return RpcSerializationFormatResolver.Default.get(key);
   }
+  /** Convenience shortcut for RpcSerializationFormatResolver.Default.tryGet(key). */
   static tryGet(key) {
-    return _RpcSerializationFormat._all.get(key);
+    return RpcSerializationFormatResolver.Default.tryGet(key);
   }
 };
 var RpcJsonSerializationFormat = class extends RpcSerializationFormat {
@@ -1464,25 +1468,54 @@ var RpcMessagePackCompactSerializationFormat = class extends RpcSerializationFor
     return new Decoder3();
   }
 };
-RpcSerializationFormat.register(new RpcJsonSerializationFormat("json5"));
-RpcSerializationFormat.register(new RpcJsonSerializationFormat("json5np"));
-RpcSerializationFormat.register(new RpcJsonSerializationFormat("njson5"));
-RpcSerializationFormat.register(new RpcJsonSerializationFormat("njson5np"));
-RpcSerializationFormat.register(
-  new RpcMessagePackSerializationFormat("msgpack6")
-);
-RpcSerializationFormat.register(
-  new RpcMessagePackSerializationFormat("mempack6")
-);
-RpcSerializationFormat.register(
-  new RpcMessagePackCompactSerializationFormat("msgpack6c")
-);
-RpcSerializationFormat.register(
-  new RpcMessagePackCompactSerializationFormat("mempack6c")
-);
+RpcSerializationFormat.SystemJsonV5 = new RpcJsonSerializationFormat("json5");
+RpcSerializationFormat.SystemJsonV5NP = new RpcJsonSerializationFormat("json5np");
+RpcSerializationFormat.NewtonsoftJsonV5 = new RpcJsonSerializationFormat("njson5");
+RpcSerializationFormat.NewtonsoftJsonV5NP = new RpcJsonSerializationFormat("njson5np");
+RpcSerializationFormat.MessagePackV6 = new RpcMessagePackSerializationFormat("msgpack6");
+RpcSerializationFormat.MemoryPackV6 = new RpcMessagePackSerializationFormat("mempack6");
+RpcSerializationFormat.MessagePackV6C = new RpcMessagePackCompactSerializationFormat("msgpack6c");
+RpcSerializationFormat.MemoryPackV6C = new RpcMessagePackCompactSerializationFormat("mempack6c");
+RpcSerializationFormat.All = [
+  RpcSerializationFormat.SystemJsonV5,
+  RpcSerializationFormat.SystemJsonV5NP,
+  RpcSerializationFormat.NewtonsoftJsonV5,
+  RpcSerializationFormat.NewtonsoftJsonV5NP,
+  RpcSerializationFormat.MessagePackV6,
+  RpcSerializationFormat.MemoryPackV6,
+  RpcSerializationFormat.MessagePackV6C,
+  RpcSerializationFormat.MemoryPackV6C
+];
+var RpcSerializationFormatResolver = class _RpcSerializationFormatResolver {
+  static DefaultFormats = RpcSerializationFormat.All;
+  static Default = new _RpcSerializationFormatResolver("json5np");
+  defaultFormatKey;
+  formats;
+  get defaultFormat() {
+    return this.get(this.defaultFormatKey);
+  }
+  constructor(defaultFormatKey, formats) {
+    const map = /* @__PURE__ */ new Map();
+    for (const f of formats ?? _RpcSerializationFormatResolver.DefaultFormats)
+      map.set(f.key, f);
+    if (!map.has(defaultFormatKey))
+      throw new Error(`No format with key '${defaultFormatKey}'.`);
+    this.defaultFormatKey = defaultFormatKey;
+    this.formats = map;
+  }
+  get(key) {
+    const format = this.tryGet(key);
+    if (!format)
+      throw new Error(`No format with key '${key}'.`);
+    return format;
+  }
+  tryGet(key) {
+    if (!key) key = this.defaultFormatKey;
+    return this.formats.get(key);
+  }
+};
 
 // src/rpc-peer.ts
-var DEFAULT_SERIALIZATION_FORMAT = "json5np";
 var RPC_CLOSE_CODE_UNSUPPORTED_FORMAT = 4001;
 var defaultConnectionUrlResolver = (peer) => {
   const sep = peer.ref.includes("?") ? "&" : "?";
@@ -1531,7 +1564,7 @@ var RpcPeer = class {
   }
   /** The serialization format used by this peer. Override in subclasses. */
   get format() {
-    return RpcSerializationFormat.get("json5np");
+    return RpcSerializationFormatResolver.Default.defaultFormat;
   }
   call(method, args, options) {
     const callId = this.outbound.nextId();
@@ -1768,8 +1801,9 @@ var RpcClientPeer = class extends RpcPeer {
   constructor(hub, url, serializationFormat) {
     super(url, hub);
     this.clientId = guidToBase64Url(this.id);
-    this.serializationFormat = serializationFormat ?? DEFAULT_SERIALIZATION_FORMAT;
-    this._format = RpcSerializationFormat.get(this.serializationFormat);
+    const resolver = RpcSerializationFormatResolver.Default;
+    this.serializationFormat = serializationFormat ?? resolver.defaultFormatKey;
+    this._format = resolver.get(this.serializationFormat);
   }
   get format() {
     return this._format;
@@ -2916,7 +2950,6 @@ var RpcPeerStateMonitor = class {
 };
 export {
   ARG_DELIMITER,
-  DEFAULT_SERIALIZATION_FORMAT,
   ENVELOPE_DELIMITER,
   FRAME_DELIMITER,
   RPC_CLOSE_CODE_UNSUPPORTED_FORMAT,
@@ -2940,6 +2973,7 @@ export {
   RpcPeerStateMonitor,
   RpcRemoteObjectTracker,
   RpcSerializationFormat,
+  RpcSerializationFormatResolver,
   RpcServerPeer,
   RpcServiceHost,
   RpcSharedObjectTracker,