@actuallab/rpc 12.3.2 → 12.3.4

package/dist/index.d.cts

@@ -125,10 +125,10 @@ declare function deserializeBinaryMessage(data: Uint8Array, offset: number, deco
  * Accepts an optional `Decoder` for reuse across calls on the same
  * connection — forwarded to `deserializeBinaryMessage`.
  */
-declare function splitBinaryFrame(frame: Uint8Array, decoder?: Decoder): Array<{
+declare function splitBinaryFrame(frame: Uint8Array, decoder?: Decoder): {
     message: RpcMessage;
     args: unknown[];
-}>;
+}[];
 /**
  * Serializes multiple binary messages into a single WebSocket frame.
  * Simply concatenates the already size-prefixed messages.
@@ -158,10 +158,10 @@ declare function deserializeCompactBinaryMessage(data: Uint8Array, offset: numbe
 /**
  * Splits a compact binary frame into individual deserialized messages.
  */
-declare function splitCompactBinaryFrame(frame: Uint8Array, registry?: RpcMethodRegistry, decoder?: Decoder): Array<{
+declare function splitCompactBinaryFrame(frame: Uint8Array, registry?: RpcMethodRegistry, decoder?: Decoder): {
     message: RpcMessage;
     args: unknown[];
-}>;
+}[];
 
 /** Parsed inbound message — result of deserialization. */
 interface RpcDeserializedMessage {
@@ -465,7 +465,7 @@ declare class RpcClientPeerReconnectDelayer extends RetryDelayer {
     constructor();
 }
 
-type RpcServiceImpl = Record<string, (...args: unknown[]) => unknown>;
+type RpcServiceImpl = Record<string, ((...args: unknown[]) => unknown) | undefined>;
 /** Context passed to service dispatch — carries callId and connection for compute tracking. */
 interface RpcDispatchContext {
     __rpcDispatch: true;
@@ -480,6 +480,26 @@ declare class RpcServiceHost {
     getMethodDef(wireMethod: string): RpcMethodDef | undefined;
 }
 
+interface MethodMeta {
+    argCount: number;
+    returns?: symbol;
+    [key: symbol]: unknown;
+}
+interface ServiceMeta {
+    name: string;
+}
+type AnyConstructor = abstract new (...args: any[]) => any;
+/** Read method metadata from a decorated class. */
+declare function getMethodsMeta(cls: AnyConstructor): Record<string, MethodMeta> | undefined;
+/** Read service metadata from a decorated class. */
+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. */
+declare function rpcMethod(options?: {
+    returns?: symbol;
+}): <This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => (this: This, ...args: Args) => Return;
+
 /**
  * Sends system RPC messages — like .NET's RpcSystemCallSender.
  *
@@ -545,14 +565,14 @@ declare class RpcHub {
     /** Get or create a server peer for the given ref. */
     getServerPeer(ref: string): RpcServerPeer;
     /** Register a service with optional server method wrapping for custom call types. */
-    addService(defOrContract: RpcServiceDef | (abstract new (...args: any[]) => any), impl: RpcServiceImpl): void;
+    addService(defOrContract: RpcServiceDef | (AnyConstructor), impl: RpcServiceImpl): void;
     /** Create a typed client proxy for a service on a remote peer. */
-    addClient<T extends object>(peer: RpcPeer, defOrContract: RpcServiceDef | (abstract new (...args: any[]) => any)): T;
+    addClient<T extends object>(peer: RpcPeer, defOrContract: RpcServiceDef | (AnyConstructor)): T;
     close(): void;
     /** Build an RpcServiceDef from decorator metadata on a contract class. Override in FusionHub for compute support. */
-    protected _buildServiceDef(cls: abstract new (...args: any[]) => any): RpcServiceDef;
+    protected _buildServiceDef(cls: AnyConstructor): RpcServiceDef;
     /** Resolve a service def from either a plain RpcServiceDef or a contract class. */
-    protected _resolveServiceDef(defOrContract: RpcServiceDef | (abstract new (...args: any[]) => any)): RpcServiceDef;
+    protected _resolveServiceDef(defOrContract: RpcServiceDef | (AnyConstructor)): RpcServiceDef;
     /** Override in FusionHub — default is pass-through (for methods with callTypeId !== 0). */
     protected _wrapServerMethod(_methodDef: RpcMethodDef, fn: (...args: unknown[]) => unknown, _impl: object): (...args: unknown[]) => unknown;
     /** Create a client method for the given methodDef. Override in FusionHub for custom call types. */
@@ -892,25 +912,6 @@ interface WebSocketServer {
     close(): void;
 }
 
-interface MethodMeta {
-    argCount: number;
-    returns?: symbol;
-    [key: symbol]: unknown;
-}
-interface ServiceMeta {
-    name: string;
-}
-/** Read method metadata from a decorated class. */
-declare function getMethodsMeta(cls: abstract new (...args: any[]) => any): Record<string, MethodMeta> | undefined;
-/** Read service metadata from a decorated class. */
-declare function getServiceMeta(cls: abstract new (...args: any[]) => any): ServiceMeta | undefined;
-/** Class decorator — stores the RPC service wire name. */
-declare function rpcService(serviceName: string): <T extends abstract new (...args: any[]) => any>(_target: T, context: ClassDecoratorContext<T>) => void;
-/** Method decorator — stores RPC method metadata (argCount, returns). Does NOT wrap the method. */
-declare function rpcMethod(options?: {
-    returns?: symbol;
-}): <This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => (this: This, ...args: Args) => Return;
-
 declare const enum RpcPeerStateKind {
     Connected = 0,
     JustDisconnected = 1,

package/dist/index.d.ts

@@ -125,10 +125,10 @@ declare function deserializeBinaryMessage(data: Uint8Array, offset: number, deco
  * Accepts an optional `Decoder` for reuse across calls on the same
  * connection — forwarded to `deserializeBinaryMessage`.
  */
-declare function splitBinaryFrame(frame: Uint8Array, decoder?: Decoder): Array<{
+declare function splitBinaryFrame(frame: Uint8Array, decoder?: Decoder): {
     message: RpcMessage;
     args: unknown[];
-}>;
+}[];
 /**
  * Serializes multiple binary messages into a single WebSocket frame.
  * Simply concatenates the already size-prefixed messages.
@@ -158,10 +158,10 @@ declare function deserializeCompactBinaryMessage(data: Uint8Array, offset: numbe
 /**
  * Splits a compact binary frame into individual deserialized messages.
  */
-declare function splitCompactBinaryFrame(frame: Uint8Array, registry?: RpcMethodRegistry, decoder?: Decoder): Array<{
+declare function splitCompactBinaryFrame(frame: Uint8Array, registry?: RpcMethodRegistry, decoder?: Decoder): {
     message: RpcMessage;
     args: unknown[];
-}>;
+}[];
 
 /** Parsed inbound message — result of deserialization. */
 interface RpcDeserializedMessage {
@@ -465,7 +465,7 @@ declare class RpcClientPeerReconnectDelayer extends RetryDelayer {
     constructor();
 }
 
-type RpcServiceImpl = Record<string, (...args: unknown[]) => unknown>;
+type RpcServiceImpl = Record<string, ((...args: unknown[]) => unknown) | undefined>;
 /** Context passed to service dispatch — carries callId and connection for compute tracking. */
 interface RpcDispatchContext {
     __rpcDispatch: true;
@@ -480,6 +480,26 @@ declare class RpcServiceHost {
     getMethodDef(wireMethod: string): RpcMethodDef | undefined;
 }
 
+interface MethodMeta {
+    argCount: number;
+    returns?: symbol;
+    [key: symbol]: unknown;
+}
+interface ServiceMeta {
+    name: string;
+}
+type AnyConstructor = abstract new (...args: any[]) => any;
+/** Read method metadata from a decorated class. */
+declare function getMethodsMeta(cls: AnyConstructor): Record<string, MethodMeta> | undefined;
+/** Read service metadata from a decorated class. */
+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. */
+declare function rpcMethod(options?: {
+    returns?: symbol;
+}): <This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => (this: This, ...args: Args) => Return;
+
 /**
  * Sends system RPC messages — like .NET's RpcSystemCallSender.
  *
@@ -545,14 +565,14 @@ declare class RpcHub {
     /** Get or create a server peer for the given ref. */
     getServerPeer(ref: string): RpcServerPeer;
     /** Register a service with optional server method wrapping for custom call types. */
-    addService(defOrContract: RpcServiceDef | (abstract new (...args: any[]) => any), impl: RpcServiceImpl): void;
+    addService(defOrContract: RpcServiceDef | (AnyConstructor), impl: RpcServiceImpl): void;
     /** Create a typed client proxy for a service on a remote peer. */
-    addClient<T extends object>(peer: RpcPeer, defOrContract: RpcServiceDef | (abstract new (...args: any[]) => any)): T;
+    addClient<T extends object>(peer: RpcPeer, defOrContract: RpcServiceDef | (AnyConstructor)): T;
     close(): void;
     /** Build an RpcServiceDef from decorator metadata on a contract class. Override in FusionHub for compute support. */
-    protected _buildServiceDef(cls: abstract new (...args: any[]) => any): RpcServiceDef;
+    protected _buildServiceDef(cls: AnyConstructor): RpcServiceDef;
     /** Resolve a service def from either a plain RpcServiceDef or a contract class. */
-    protected _resolveServiceDef(defOrContract: RpcServiceDef | (abstract new (...args: any[]) => any)): RpcServiceDef;
+    protected _resolveServiceDef(defOrContract: RpcServiceDef | (AnyConstructor)): RpcServiceDef;
     /** Override in FusionHub — default is pass-through (for methods with callTypeId !== 0). */
     protected _wrapServerMethod(_methodDef: RpcMethodDef, fn: (...args: unknown[]) => unknown, _impl: object): (...args: unknown[]) => unknown;
     /** Create a client method for the given methodDef. Override in FusionHub for custom call types. */
@@ -892,25 +912,6 @@ interface WebSocketServer {
     close(): void;
 }
 
-interface MethodMeta {
-    argCount: number;
-    returns?: symbol;
-    [key: symbol]: unknown;
-}
-interface ServiceMeta {
-    name: string;
-}
-/** Read method metadata from a decorated class. */
-declare function getMethodsMeta(cls: abstract new (...args: any[]) => any): Record<string, MethodMeta> | undefined;
-/** Read service metadata from a decorated class. */
-declare function getServiceMeta(cls: abstract new (...args: any[]) => any): ServiceMeta | undefined;
-/** Class decorator — stores the RPC service wire name. */
-declare function rpcService(serviceName: string): <T extends abstract new (...args: any[]) => any>(_target: T, context: ClassDecoratorContext<T>) => void;
-/** Method decorator — stores RPC method metadata (argCount, returns). Does NOT wrap the method. */
-declare function rpcMethod(options?: {
-    returns?: symbol;
-}): <This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => (this: This, ...args: Args) => Return;
-
 declare const enum RpcPeerStateKind {
     Connected = 0,
     JustDisconnected = 1,

package/dist/index.js

@@ -765,7 +765,7 @@ var RpcStreamSender = class _RpcStreamSender {
     await this._started.promise;
     const iterator = source[Symbol.asyncIterator]();
     try {
-      while (true) {
+      for (; ; ) {
         const next = await iterator.next();
         if (next.done || this._ended) break;
         const item = next.value;
@@ -1051,30 +1051,29 @@ var RpcStream = class _RpcStream {
     if (this._iterating)
       throw new Error("RpcStream can only be iterated once.");
     this._iterating = true;
-    const self = this;
     return {
-      async next() {
-        if (!self._started) {
-          self._started = true;
-          self._sendAck(0, true);
+      next: async () => {
+        if (!this._started) {
+          this._started = true;
+          this._sendAck(0, true);
         }
-        while (true) {
-          if (!self._buffer.isEmpty()) {
-            const value = self._buffer.shift();
+        for (; ; ) {
+          if (!this._buffer.isEmpty()) {
+            const value = this._buffer.shift();
             return { value, done: false };
           }
-          if (self._completed) {
-            if (self._completionError) throw self._completionError;
+          if (this._completed) {
+            if (this._completionError) throw this._completionError;
             return { value: void 0, done: true };
           }
-          self._consumerWaiting = new PromiseSource4();
-          await self._consumerWaiting.promise;
+          this._consumerWaiting = new PromiseSource4();
+          await this._consumerWaiting.promise;
         }
       },
-      async return() {
-        self._sendAckEnd();
-        self.dispose();
-        return { value: void 0, done: true };
+      return: () => {
+        this._sendAckEnd();
+        this.dispose();
+        return Promise.resolve({ value: void 0, done: true });
       }
     };
   }
@@ -1683,21 +1682,18 @@ var RpcPeer = class {
     }
     const signal = options?.signal;
     if (signal !== void 0) {
-      const peer = this;
-      const hub = this._hub;
-      const tracker = this.outbound;
       const onAbort = () => {
-        if (tracker.remove(callId) !== void 0) {
+        if (this.outbound.remove(callId) !== void 0) {
           outboundCall.result.reject(new Error("Call cancelled."));
           outboundCall.onDisconnect();
-          if (peer._connection !== void 0)
-            hub.systemCallSender.cancel(peer._connection, peer.format, callId);
+          if (this._connection !== void 0)
+            this._hub.systemCallSender.cancel(this._connection, this.format, callId);
         } else {
-          const idx = peer._pendingSends.findIndex(
+          const idx = this._pendingSends.findIndex(
             (c) => c.callId === callId
           );
           if (idx !== -1) {
-            peer._pendingSends.splice(idx, 1);
+            this._pendingSends.splice(idx, 1);
             outboundCall.result.reject(
               new Error("Call cancelled.")
             );
@@ -1791,51 +1787,49 @@ var RpcPeer = class {
       this.inbound.register(call);
     }
     const serviceHost = this._hub.serviceHost;
-    if (serviceHost !== void 0) {
-      void (async () => {
-        try {
-          const context = this._connection !== void 0 ? {
-            __rpcDispatch: true,
-            callId: relatedId,
-            connection: this._connection
-          } : void 0;
-          const result = await serviceHost.dispatch(
-            method,
-            args,
-            context
+    void (async () => {
+      try {
+        const context = this._connection !== void 0 ? {
+          __rpcDispatch: true,
+          callId: relatedId,
+          connection: this._connection
+        } : void 0;
+        const result = await serviceHost.dispatch(
+          method,
+          args,
+          context
+        );
+        if (methodDef?.stream === true && this._connection !== void 0) {
+          const stream = result instanceof RpcStream ? result : new RpcStream(result);
+          this._hub.systemCallSender.ok(
+            this._connection,
+            this.format,
+            relatedId,
+            stream.toRef(this)
+          );
+        } else if (!isNoWait && this._connection !== void 0) {
+          this._hub.systemCallSender.ok(
+            this._connection,
+            this.format,
+            relatedId,
+            result
           );
-          if (methodDef?.stream === true && this._connection !== void 0) {
-            const stream = result instanceof RpcStream ? result : new RpcStream(result);
-            this._hub.systemCallSender.ok(
-              this._connection,
-              this.format,
-              relatedId,
-              stream.toRef(this)
-            );
-          } else if (!isNoWait && this._connection !== void 0) {
-            this._hub.systemCallSender.ok(
-              this._connection,
-              this.format,
-              relatedId,
-              result
-            );
-          }
-        } catch (e) {
-          if (!isNoWait && this._connection !== void 0) {
-            this._hub.systemCallSender.error(
-              this._connection,
-              this.format,
-              relatedId,
-              e
-            );
-          }
-        } finally {
-          if (!isNoWait) {
-            this.inbound.remove(relatedId);
-          }
         }
-      })();
-    }
+      } catch (e) {
+        if (!isNoWait && this._connection !== void 0) {
+          this._hub.systemCallSender.error(
+            this._connection,
+            this.format,
+            relatedId,
+            e
+          );
+        }
+      } finally {
+        if (!isNoWait) {
+          this.inbound.remove(relatedId);
+        }
+      }
+    })();
   }
   _startKeepAlive() {
     this._keepAliveTimer = setInterval(() => {
@@ -2704,6 +2698,7 @@ var RpcHub = class {
     this.registry.registerService(def.name, def.methods);
   }
   /** Create a typed client proxy for a service on a remote peer. */
+  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- T is used for caller-specified proxy type
   addClient(peer, defOrContract) {
     const def = this._resolveServiceDef(defOrContract);
     this.registry.registerService(def.name, def.methods);