starpc 0.18.2 → 0.19.0

package/e2e/mock/mock.pb.go

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // versions:
-// 	protoc-gen-go v1.28.1-devel
+// 	protoc-gen-go v1.30.0-devel
 // 	protoc        v3.21.9
 // source: github.com/aperturerobotics/starpc/e2e/mock/mock.proto
 

package/e2e/mock/mock.pb.ts

@@ -25,19 +25,25 @@ export const MockMsg = {
   },
 
   decode(input: _m0.Reader | Uint8Array, length?: number): MockMsg {
-    const reader = input instanceof _m0.Reader ? input : new _m0.Reader(input)
+    const reader =
+      input instanceof _m0.Reader ? input : _m0.Reader.create(input)
     let end = length === undefined ? reader.len : reader.pos + length
     const message = createBaseMockMsg()
     while (reader.pos < end) {
       const tag = reader.uint32()
       switch (tag >>> 3) {
         case 1:
+          if (tag != 10) {
+            break
+          }
+
           message.body = reader.string()
-          break
-        default:
-          reader.skipType(tag & 7)
-          break
+          continue
+      }
+      if ((tag & 7) == 4 || tag == 0) {
+        break
       }
+      reader.skipType(tag & 7)
     }
     return message
   },
@@ -119,7 +125,7 @@ export class MockClientImpl implements Mock {
       data,
       abortSignal || undefined
     )
-    return promise.then((data) => MockMsg.decode(new _m0.Reader(data)))
+    return promise.then((data) => MockMsg.decode(_m0.Reader.create(data)))
   }
 }
 

package/e2e/mock/mock_srpc.pb.go

@@ -1,5 +1,5 @@
 // Code generated by protoc-gen-srpc. DO NOT EDIT.
-// protoc-gen-srpc version: v0.16.1
+// protoc-gen-srpc version: v0.18.1
 // source: github.com/aperturerobotics/starpc/e2e/mock/mock.proto
 
 package e2e_mock

package/e2e/mock/mock_vtproto.pb.go

@@ -1,5 +1,5 @@
 // Code generated by protoc-gen-go-vtproto. DO NOT EDIT.
-// protoc-gen-go-vtproto version: v0.3.1-0.20220817155510-0ae748fd2007
+// protoc-gen-go-vtproto version: v0.4.0
 // source: github.com/aperturerobotics/starpc/e2e/mock/mock.proto
 
 package e2e_mock
@@ -34,14 +34,14 @@ func (m *MockMsg) CloneVT() *MockMsg {
 	return r
 }
 
-func (m *MockMsg) CloneGenericVT() proto.Message {
+func (m *MockMsg) CloneMessageVT() proto.Message {
 	return m.CloneVT()
 }
 
 func (this *MockMsg) EqualVT(that *MockMsg) bool {
-	if this == nil {
-		return that == nil
-	} else if that == nil {
+	if this == that {
+		return true
+	} else if this == nil || that == nil {
 		return false
 	}
 	if this.Body != that.Body {
@@ -50,6 +50,13 @@ func (this *MockMsg) EqualVT(that *MockMsg) bool {
 	return string(this.unknownFields) == string(that.unknownFields)
 }
 
+func (this *MockMsg) EqualMessageVT(thatMsg proto.Message) bool {
+	that, ok := thatMsg.(*MockMsg)
+	if !ok {
+		return false
+	}
+	return this.EqualVT(that)
+}
 func (m *MockMsg) MarshalVT() (dAtA []byte, err error) {
 	if m == nil {
 		return nil, nil
@@ -204,6 +211,7 @@ func (m *MockMsg) UnmarshalVT(dAtA []byte) error {
 	}
 	return nil
 }
+
 func skip(dAtA []byte) (n int, err error) {
 	l := len(dAtA)
 	iNdEx := 0

package/echo/echo.pb.go

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // versions:
-// 	protoc-gen-go v1.28.1-devel
+// 	protoc-gen-go v1.30.0-devel
 // 	protoc        v3.21.9
 // source: github.com/aperturerobotics/starpc/echo/echo.proto
 

package/echo/echo.pb.ts

@@ -26,19 +26,25 @@ export const EchoMsg = {
   },
 
   decode(input: _m0.Reader | Uint8Array, length?: number): EchoMsg {
-    const reader = input instanceof _m0.Reader ? input : new _m0.Reader(input)
+    const reader =
+      input instanceof _m0.Reader ? input : _m0.Reader.create(input)
     let end = length === undefined ? reader.len : reader.pos + length
     const message = createBaseEchoMsg()
     while (reader.pos < end) {
       const tag = reader.uint32()
       switch (tag >>> 3) {
         case 1:
+          if (tag != 10) {
+            break
+          }
+
           message.body = reader.string()
-          break
-        default:
-          reader.skipType(tag & 7)
-          break
+          continue
+      }
+      if ((tag & 7) == 4 || tag == 0) {
+        break
       }
+      reader.skipType(tag & 7)
     }
     return message
   },
@@ -144,7 +150,7 @@ export class EchoerClientImpl implements Echoer {
       data,
       abortSignal || undefined
     )
-    return promise.then((data) => EchoMsg.decode(new _m0.Reader(data)))
+    return promise.then((data) => EchoMsg.decode(_m0.Reader.create(data)))
   }
 
   EchoServerStream(
@@ -172,7 +178,7 @@ export class EchoerClientImpl implements Echoer {
       data,
       abortSignal || undefined
     )
-    return promise.then((data) => EchoMsg.decode(new _m0.Reader(data)))
+    return promise.then((data) => EchoMsg.decode(_m0.Reader.create(data)))
   }
 
   EchoBidiStream(

package/echo/echo_srpc.pb.go

@@ -1,5 +1,5 @@
 // Code generated by protoc-gen-srpc. DO NOT EDIT.
-// protoc-gen-srpc version: v0.16.1
+// protoc-gen-srpc version: v0.18.1
 // source: github.com/aperturerobotics/starpc/echo/echo.proto
 
 package echo

package/echo/echo_vtproto.pb.go

@@ -1,5 +1,5 @@
 // Code generated by protoc-gen-go-vtproto. DO NOT EDIT.
-// protoc-gen-go-vtproto version: v0.3.1-0.20220817155510-0ae748fd2007
+// protoc-gen-go-vtproto version: v0.4.0
 // source: github.com/aperturerobotics/starpc/echo/echo.proto
 
 package echo
@@ -34,14 +34,14 @@ func (m *EchoMsg) CloneVT() *EchoMsg {
 	return r
 }
 
-func (m *EchoMsg) CloneGenericVT() proto.Message {
+func (m *EchoMsg) CloneMessageVT() proto.Message {
 	return m.CloneVT()
 }
 
 func (this *EchoMsg) EqualVT(that *EchoMsg) bool {
-	if this == nil {
-		return that == nil
-	} else if that == nil {
+	if this == that {
+		return true
+	} else if this == nil || that == nil {
 		return false
 	}
 	if this.Body != that.Body {
@@ -50,6 +50,13 @@ func (this *EchoMsg) EqualVT(that *EchoMsg) bool {
 	return string(this.unknownFields) == string(that.unknownFields)
 }
 
+func (this *EchoMsg) EqualMessageVT(thatMsg proto.Message) bool {
+	that, ok := thatMsg.(*EchoMsg)
+	if !ok {
+		return false
+	}
+	return this.EqualVT(that)
+}
 func (m *EchoMsg) MarshalVT() (dAtA []byte, err error) {
 	if m == nil {
 		return nil, nil
@@ -204,6 +211,7 @@ func (m *EchoMsg) UnmarshalVT(dAtA []byte) error {
 	}
 	return nil
 }
+
 func skip(dAtA []byte) (n int, err error) {
 	l := len(dAtA)
 	iNdEx := 0

package/go.mod

@@ -4,13 +4,13 @@ go 1.18
 
 require (
 	github.com/pkg/errors v0.9.1 // latest
-	google.golang.org/protobuf v1.28.1 // latest
+	google.golang.org/protobuf v1.30.0 // latest
 	nhooyr.io/websocket v1.8.8-0.20221213223501-14fb98eba64e // master
 )
 
 require (
-	github.com/aperturerobotics/util v1.0.5 // latest
-	github.com/libp2p/go-libp2p v0.26.1 // latest
+	github.com/aperturerobotics/util v1.0.6-0.20230323123147-d1b8fef6a782 // latest
+	github.com/libp2p/go-libp2p v0.26.1-0.20230320233358-9e208249b588 // latest
 	github.com/libp2p/go-yamux/v4 v4.0.1-0.20220919134236-1c09f2ab3ec1 // master
 	github.com/sirupsen/logrus v1.9.0 // latest
 )

package/go.sum

@@ -1,5 +1,5 @@
-github.com/aperturerobotics/util v1.0.5 h1:gxDjQ31MHXthwkiRuG6LiwwU2g+E1neIuuBGI71QsP0=
-github.com/aperturerobotics/util v1.0.5/go.mod h1:45zfYCir2T5/KE+O9CyYdZPrsXZtOEAuA4UU79rRMN4=
+github.com/aperturerobotics/util v1.0.6-0.20230323123147-d1b8fef6a782 h1:kKuKxMVd1N+aT9+hQQaIc5n2AkD6smFTSw6/Jl4N8NA=
+github.com/aperturerobotics/util v1.0.6-0.20230323123147-d1b8fef6a782/go.mod h1:VB5a5FURpm7EujJsErIY8UZrhrLPN/bj84H8FxN0gD4=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
@@ -48,8 +48,8 @@ github.com/leodido/go-urn v1.2.0 h1:hpXL4XnriNwQ/ABnpepYM/1vCLWNDfUNts8dX3xTG6Y=
 github.com/leodido/go-urn v1.2.0/go.mod h1:+8+nEpDfqqsY+g338gtMEUOtuK+4dEMhiQEgxpxOKII=
 github.com/libp2p/go-buffer-pool v0.1.0 h1:oK4mSFcQz7cTQIfqbe4MIj9gLW+mnanjyFtc6cdF0Y8=
 github.com/libp2p/go-buffer-pool v0.1.0/go.mod h1:N+vh8gMqimBzdKkSMVuydVDq+UV5QTWy5HSiZacSbPg=
-github.com/libp2p/go-libp2p v0.26.1 h1:I9bHj5KteIB1tsBWLT25TTttx5xSjun3ph/q/8Xax/k=
-github.com/libp2p/go-libp2p v0.26.1/go.mod h1:HKQUKIQ5NhzabNMWq9Wczcs5Ksdx4LQ/ISAq4MRqBHQ=
+github.com/libp2p/go-libp2p v0.26.1-0.20230320233358-9e208249b588 h1:hY4aHvA59tTkxKZxSyHWnhbQ+/ULgYwaNW1GLqJy2YU=
+github.com/libp2p/go-libp2p v0.26.1-0.20230320233358-9e208249b588/go.mod h1:HKQUKIQ5NhzabNMWq9Wczcs5Ksdx4LQ/ISAq4MRqBHQ=
 github.com/libp2p/go-libp2p-testing v0.12.0 h1:EPvBb4kKMWO29qP4mZGyhVzUyR25dvfUIK5WDu6iPUA=
 github.com/libp2p/go-yamux/v4 v4.0.1-0.20220919134236-1c09f2ab3ec1 h1:fxyHejZvFIBqlznQDuHUkw9BThYKyoT3DclP/C2g8Wc=
 github.com/libp2p/go-yamux/v4 v4.0.1-0.20220919134236-1c09f2ab3ec1/go.mod h1:NWjl8ZTLOGlozrXSOZ/HlfG++39iKNnM5wwmtQP1YB4=
@@ -110,8 +110,8 @@ golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8T
 golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE=
 golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
 google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=
-google.golang.org/protobuf v1.28.1 h1:d0NfwRgPtno5B1Wa6L2DAG+KivqkdutMf1UhdNx175w=
-google.golang.org/protobuf v1.28.1/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
+google.golang.org/protobuf v1.30.0 h1:kPPoIgf3TsEvrm0PFe15JQ+570QVxYzEvvHqChK+cng=
+google.golang.org/protobuf v1.30.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.2.8 h1:obN1ZagJSUGI0Ek/LBmuj4SNLPfIny3KsKFopxRdj10=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starpc",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "description": "Streaming protobuf RPC service protocol over any two-way channel.",
   "license": "MIT",
   "author": {
@@ -60,38 +60,38 @@
     "singleQuote": true
   },
   "devDependencies": {
-    "@aperturerobotics/ts-common": "^0.3.1",
-    "@typescript-eslint/eslint-plugin": "^5.54.0",
-    "@typescript-eslint/parser": "^5.54.0",
+    "@aperturerobotics/ts-common": "^0.4.2",
+    "@typescript-eslint/eslint-plugin": "^5.57.0",
+    "@typescript-eslint/parser": "^5.57.0",
     "bufferutil": "^4.0.7",
     "depcheck": "^1.4.3",
-    "esbuild": "^0.17.1",
-    "eslint": "^8.35.0",
-    "eslint-config-prettier": "^8.6.0",
-    "prettier": "^2.8.3",
-    "rimraf": "^4.1.0",
-    "ts-proto": "^1.138.0",
-    "typescript": "^4.9.5",
+    "esbuild": "^0.17.15",
+    "eslint": "^8.37.0",
+    "eslint-config-prettier": "^8.8.0",
+    "prettier": "^2.8.7",
+    "rimraf": "^4.4.0",
+    "ts-proto": "^1.146.0",
+    "typescript": "^5.0.3",
     "utf-8-validate": "^6.0.3"
   },
   "dependencies": {
-    "@chainsafe/libp2p-yamux": "^3.0.6",
-    "@libp2p/interface-connection": "^3.0.7",
+    "@chainsafe/libp2p-yamux": "^3.0.7",
+    "@libp2p/interface-connection": "^3.1.1",
     "@libp2p/interface-stream-muxer": "^3.0.4",
     "event-iterator": "^2.0.0",
     "is-promise": "^4.0.0",
     "isomorphic-ws": "^5.0.0",
-    "it-first": "^2.0.0",
-    "it-length-prefixed": "^8.0.4",
-    "it-pipe": "^2.0.5",
+    "it-first": "^2.0.1",
+    "it-length-prefixed": "^8.0.0",
+    "it-pipe": "^2.0.0",
     "it-pushable": "^3.1.2",
     "it-stream-types": "^1.0.5",
     "it-ws": "^5.0.6",
     "long": "^5.2.1",
     "memoize-one": "^6.0.0",
     "patch-package": "^6.5.1",
-    "protobufjs": "^7.1.2",
+    "protobufjs": "^7.2.0",
     "uint8arraylist": "^2.4.3",
-    "ws": "^8.12.0"
+    "ws": "^8.13.0"
   }
 }

package/srpc/client-prefix.go

@@ -54,5 +54,12 @@ func (i *PrefixClient) stripCheckServiceIDPrefix(service string) (string, error)
 	return service, nil
 }
 
+// NewRawStream opens a new raw stream with the remote.
+// Implements OpenStreamFunc.
+// msgHandler must not be called concurrently.
+func (i *PrefixClient) NewRawStream(ctx context.Context, msgHandler PacketDataHandler, closeHandler CloseHandler) (Writer, error) {
+	return i.client.NewRawStream(ctx, msgHandler, closeHandler)
+}
+
 // _ is a type assertion
 var _ Client = ((*PrefixClient)(nil))

package/srpc/client-set.go

@@ -2,8 +2,6 @@ package srpc
 
 import (
 	"context"
-
-	"github.com/pkg/errors"
 )
 
 // ClientSet wraps a list of clients into one Client.
@@ -43,6 +41,23 @@ func (c *ClientSet) NewStream(
 	return strm, err
 }
 
+// NewRawStream opens a new raw stream with the remote.
+// Implements OpenStreamFunc.
+// msgHandler must not be called concurrently.
+func (c *ClientSet) NewRawStream(
+	ctx context.Context,
+	msgHandler PacketDataHandler,
+	closeHandler CloseHandler,
+) (Writer, error) {
+	for _, client := range c.clients {
+		if client == nil {
+			continue
+		}
+		return client.NewRawStream(ctx, msgHandler, closeHandler)
+	}
+	return nil, ErrNoAvailableClients
+}
+
 // execCall executes the call conditionally retrying against subsequent client handles.
 func (c *ClientSet) execCall(ctx context.Context, doCall func(client Client) error) error {
 	var any bool
@@ -70,7 +85,7 @@ func (c *ClientSet) execCall(ctx context.Context, doCall func(client Client) err
 	}
 
 	if !any {
-		return errors.New("no available rpc clients")
+		return ErrNoAvailableClients
 	}
 
 	return ErrUnimplemented

package/srpc/client.go

@@ -14,13 +14,18 @@ type Client interface {
 	// NewStream starts a streaming RPC with the remote & returns the stream.
 	// firstMsg is optional.
 	NewStream(ctx context.Context, service, method string, firstMsg Message) (Stream, error)
+
+	// NewRawStream opens a new raw stream with the remote.
+	// Implements OpenStreamFunc.
+	// msgHandler must not be called concurrently.
+	NewRawStream(ctx context.Context, msgHandler PacketDataHandler, closeHandler CloseHandler) (Writer, error)
 }
 
 // OpenStreamFunc opens a stream with a remote.
 // msgHandler must not be called concurrently.
 type OpenStreamFunc = func(
 	ctx context.Context,
-	msgHandler PacketHandler,
+	msgHandler PacketDataHandler,
 	closeHandler CloseHandler,
 ) (Writer, error)
 
@@ -47,7 +52,7 @@ func (c *client) ExecCall(ctx context.Context, service, method string, in, out M
 	clientRPC := NewClientRPC(ctx, service, method)
 	defer clientRPC.Close()
 
-	writer, err := c.openStream(ctx, clientRPC.HandlePacket, clientRPC.HandleStreamClose)
+	writer, err := c.openStream(ctx, clientRPC.HandlePacketData, clientRPC.HandleStreamClose)
 	if err != nil {
 		return err
 	}
@@ -79,7 +84,7 @@ func (c *client) NewStream(ctx context.Context, service, method string, firstMsg
 	}
 
 	clientRPC := NewClientRPC(ctx, service, method)
-	writer, err := c.openStream(ctx, clientRPC.HandlePacket, clientRPC.HandleStreamClose)
+	writer, err := c.openStream(ctx, clientRPC.HandlePacketData, clientRPC.HandleStreamClose)
 	if err != nil {
 		return nil, err
 	}
@@ -90,5 +95,16 @@ func (c *client) NewStream(ctx context.Context, service, method string, firstMsg
 	return NewMsgStream(ctx, clientRPC, clientRPC.ctxCancel), nil
 }
 
+// NewRawStream opens a new raw stream with the remote.
+// Implements OpenStreamFunc.
+// msgHandler must not be called concurrently.
+func (c *client) NewRawStream(
+	ctx context.Context,
+	msgHandler PacketDataHandler,
+	closeHandler CloseHandler,
+) (Writer, error) {
+	return c.openStream(ctx, msgHandler, closeHandler)
+}
+
 // _ is a type assertion
 var _ Client = ((*client)(nil))

package/srpc/client.ts

@@ -9,10 +9,7 @@ import { writeToPushable } from './pushable.js'
 import {
   decodePacketSource,
   encodePacketSource,
-  parseLengthPrefixTransform,
-  prependLengthPrefixTransform,
 } from './packet.js'
-import { combineUint8ArrayListTransform } from './array-list.js'
 import { OpenStreamCtr } from './open-stream-ctr.js'
 
 // Client implements the ts-proto Rpc interface with the drpcproto protocol.
@@ -117,20 +114,17 @@ export class Client implements TsProtoRpc {
       throw new Error(ERR_RPC_ABORT)
     }
     const openStreamFn = await this.openStreamCtr.wait()
-    const conn = await openStreamFn()
+    const stream = await openStreamFn()
     const call = new ClientRPC(rpcService, rpcMethod)
     abortSignal?.addEventListener('abort', () => {
       call.close(new Error(ERR_RPC_ABORT))
     })
     pipe(
-      conn,
-      parseLengthPrefixTransform(),
-      combineUint8ArrayListTransform(),
+      stream,
       decodePacketSource,
       call,
       encodePacketSource,
-      prependLengthPrefixTransform(),
-      conn
+      stream
     )
     await call.writeCallStart(data || undefined)
     return call

package/srpc/common-rpc.ts

@@ -113,7 +113,7 @@ export class CommonRPC {
         asError = new Error('error handling packet')
       }
       this.close(asError)
-      throw asError
+      // throw asError
     }
   }
 

package/srpc/conn.ts

@@ -8,10 +8,13 @@ import type { Duplex } from 'it-stream-types'
 import { yamux } from '@chainsafe/libp2p-yamux'
 import { Uint8ArrayList } from 'uint8arraylist'
 import isPromise from 'is-promise'
+import { pushable, Pushable } from 'it-pushable'
 
 import type { OpenStreamFunc, Stream as SRPCStream } from './stream.js'
 import { Client } from './client.js'
 import { combineUint8ArrayListTransform } from './array-list.js'
+import { parseLengthPrefixTransform, prependLengthPrefixTransform } from './packet.js'
+import { buildPushableSink } from './pushable.js'
 
 // ConnParams are parameters that can be passed to the Conn constructor.
 export interface ConnParams {
@@ -25,17 +28,25 @@ export interface ConnParams {
 // StreamHandler handles incoming streams.
 // Implemented by Server.
 export interface StreamHandler {
-  // handleStream handles an incoming stream.
-  handleStream(strm: SRPCStream): void
+  // handlePacketStream handles an incoming Uint8Array duplex.
+  // the stream has one Uint8Array per packet w/o length prefix.
+  handlePacketStream(strm: SRPCStream): void
 }
 
 // streamToSRPCStream converts a Stream to a SRPCStream.
+// uses length-prefix for packet framing
 export function streamToSRPCStream(
   stream: Duplex<Uint8ArrayList, Uint8ArrayList | Uint8Array>
 ): SRPCStream {
+  const pushSink: Pushable<Uint8Array> = pushable({ objectMode: true })
+  pipe(pushSink, prependLengthPrefixTransform(), stream.sink)
   return {
-    source: pipe(stream, combineUint8ArrayListTransform()),
-    sink: stream.sink,
+    source: pipe(
+      stream,
+      parseLengthPrefixTransform(),
+      combineUint8ArrayListTransform(),
+    ),
+    sink: buildPushableSink(pushSink),
   }
 }
 
@@ -85,9 +96,12 @@ export class Conn implements Duplex<Uint8Array> {
 
   // openStream implements the client open stream function.
   public async openStream(): Promise<SRPCStream> {
-    const stream = this.muxer.newStream()
-    if (isPromise(stream)) {
-      return streamToSRPCStream(await stream)
+    const streamPromise = this.muxer.newStream()
+    let stream: Stream
+    if (isPromise(streamPromise)) {
+      stream = await streamPromise
+    } else {
+      stream = streamPromise
     }
     return streamToSRPCStream(stream)
   }
@@ -103,6 +117,6 @@ export class Conn implements Duplex<Uint8Array> {
     if (!server) {
       return strm.abort(new Error('server not implemented'))
     }
-    server.handleStream(streamToSRPCStream(strm))
+    server.handlePacketStream(streamToSRPCStream(strm))
   }
 }

package/srpc/errors.go

@@ -17,4 +17,6 @@ var (
 	ErrEmptyMethodID = errors.New("method id empty")
 	// ErrEmptyServiceID is returned if the service id was empty.
 	ErrEmptyServiceID = errors.New("service id empty")
+	// ErrNoAvailableClients is returned if no clients were available.
+	ErrNoAvailableClients = errors.New("no available rpc clients")
 )

package/srpc/errors.ts

@@ -9,3 +9,27 @@ export function isAbortError(err: unknown): boolean {
   const message = (err as Error).message
   return message === ERR_RPC_ABORT
 }
+
+// castToError casts an object to an Error.
+// if err is a string, uses it as the message.
+// if err is undefined, returns new Error(defaultMsg)
+export function castToError(err: any, defaultMsg?: string): Error {
+  defaultMsg = defaultMsg || 'error'
+  if (!err) {
+    return new Error(defaultMsg)
+  }
+  if (typeof err === 'string') {
+    return new Error(err)
+  }
+  const asError = err as Error
+  if (asError.message) {
+    return asError
+  }
+  if (err.toString) {
+    const errString = err.toString()
+    if (errString) {
+      return new Error(errString)
+    }
+  }
+  return new Error(defaultMsg)
+}

package/srpc/index.ts

@@ -1,5 +1,5 @@
 export type { PacketHandler, Stream, OpenStreamFunc } from './stream.js'
-export { ERR_RPC_ABORT, isAbortError } from './errors.js'
+export { ERR_RPC_ABORT, isAbortError, castToError } from './errors.js'
 export { Client } from './client.js'
 export { Server } from './server.js'
 export { Conn, ConnParams } from './conn.js'
@@ -25,6 +25,13 @@ export {
   memoProto,
   memoProtoDecode,
 } from './message.js'
+export {
+  parseLengthPrefixTransform,
+  prependLengthPrefixTransform,
+  decodePacketSource,
+  encodePacketSource,
+} from './packet.js'
+export { combineUint8ArrayListTransform } from './array-list.js'
 export { ValueCtr } from './value-ctr.js'
 export { OpenStreamCtr } from './open-stream-ctr.js'
-export { writeToPushable } from './pushable'
+export { writeToPushable, buildPushableSink } from './pushable.js'

package/srpc/message.go

@@ -7,6 +7,8 @@ type Message interface {
 }
 
 // RawMessage is a raw protobuf message container.
+//
+// The empty value is valid with copy=false.
 type RawMessage struct {
 	data []byte
 	copy bool
@@ -41,6 +43,16 @@ func (m *RawMessage) SetData(data []byte) {
 	}
 }
 
+// Clear sets the length of the data buffer to 0 without releasing it.
+func (m *RawMessage) Clear() {
+	m.data = m.data[:0]
+}
+
+// Reset releases the data buffer.
+func (m *RawMessage) Reset() {
+	m.data = nil
+}
+
 func (m *RawMessage) MarshalVT() ([]byte, error) {
 	if !m.copy {
 		return m.data, nil

package/srpc/muxed-conn.go

@@ -72,7 +72,7 @@ func NewClientWithMuxedConn(conn network.MuxedConn) Client {
 
 // NewOpenStreamWithMuxedConn constructs a OpenStream func with a MuxedConn.
 func NewOpenStreamWithMuxedConn(conn network.MuxedConn) OpenStreamFunc {
-	return func(ctx context.Context, msgHandler PacketHandler, closeHandler CloseHandler) (Writer, error) {
+	return func(ctx context.Context, msgHandler PacketDataHandler, closeHandler CloseHandler) (Writer, error) {
 		mstrm, err := conn.OpenStream(ctx)
 		if err != nil {
 			return nil, err