@replit/river 0.215.1 → 0.216.0

package/README.md

@@ -713,6 +713,53 @@ async handler(ctx, ...args) {
 }
 ```
 
+## Protobuf Services (Experimental)
+
+River also supports defining services using Protocol Buffers. Instead of TypeBox schemas, you define your service in a `.proto` file and use the generated descriptors directly.
+
+```protobuf
+// greeter.proto
+syntax = "proto3";
+package myapp;
+
+service Greeter {
+  rpc SayHello(HelloRequest) returns (HelloResponse);
+  rpc ServerStream(HelloRequest) returns (stream HelloResponse);
+}
+
+message HelloRequest { string name = 1; }
+message HelloResponse { string message = 1; }
+```
+
+```ts
+import {
+  createProtoService,
+  createServer,
+  createClient,
+  Ok,
+  ProtoCodec,
+} from '@replit/river/protobuf';
+import { Greeter } from './gen/greeter_pb';
+
+const ProtoService = createProtoService();
+
+const greeterSvc = ProtoService.define(Greeter, {
+  sayHello: (request, ctx) => Ok({ message: `Hello, ${request.name}!` }),
+  // serverStream left unimplemented → returns UNIMPLEMENTED at runtime
+});
+
+// server
+const server = createServer(transport, [greeterSvc]);
+
+// client
+const client = createClient(Greeter, clientTransport, serverId);
+const result = await client.sayHello({ name: 'World' });
+```
+
+The protobuf router uses `ProtoCodec` for wire encoding (protobuf envelopes with msgpack fallback for control payloads) and supports the same features as the TypeBox router: context, disposable state, middleware, handshakes, and OpenTelemetry tracing.
+
+> **Note:** The protobuf router is experimental and its API may change.
+
 ### Further examples
 
 We've also provided an end-to-end testing environment using `Next.js`, and a simple backend connected with the WebSocket transport that you can [play with on Replit](https://replit.com/@jzhao-replit/riverbed).

package/dist/{adapter-Dtt4bYL-.d.ts → adapter-BXCk-dmy.d.ts}

@@ -1,23 +1,5 @@
-import { O as OpaqueTransportMessage, E as EncodedTransportMessage } from './message-DL74OqsX.js';
-
-/**
- * Codec interface for encoding and decoding objects to and from Uint8 buffers.
- * Used to prepare messages for use by the transport layer.
- */
-interface Codec {
-    /**
-     * Encodes an object to a Uint8 buffer.
-     * @param obj - The object to encode.
-     * @returns The encoded Uint8 buffer.
-     */
-    toBuffer(obj: object): Uint8Array;
-    /**
-     * Decodes an object from a Uint8 buffer.
-     * @param buf - The Uint8 buffer to decode.
-     * @returns The decoded object, or null if decoding failed.
-     */
-    fromBuffer(buf: Uint8Array): object;
-}
+import { O as OpaqueTransportMessage, E as EncodedTransportMessage } from './message-CpXWqmJw.js';
+import { C as Codec } from './types-BGGvYIJM.js';
 
 type SessionApiResult<T> = {
     ok: true;
@@ -44,4 +26,4 @@ declare class CodecMessageAdapter {
     fromBuffer(buf: Uint8Array): DeserializeResult;
 }
 
-export { type Codec as C, type EncodeResult as E, type SendResult as S, CodecMessageAdapter as a, type SendBufferResult as b };
+export { CodecMessageAdapter as C, type EncodeResult as E, type SendResult as S, type SendBufferResult as a };

package/dist/{adapter-CjgmjtUJ.d.cts → adapter-D5X11kmP.d.cts}

@@ -1,23 +1,5 @@
-import { O as OpaqueTransportMessage, E as EncodedTransportMessage } from './message-DL74OqsX.cjs';
-
-/**
- * Codec interface for encoding and decoding objects to and from Uint8 buffers.
- * Used to prepare messages for use by the transport layer.
- */
-interface Codec {
-    /**
-     * Encodes an object to a Uint8 buffer.
-     * @param obj - The object to encode.
-     * @returns The encoded Uint8 buffer.
-     */
-    toBuffer(obj: object): Uint8Array;
-    /**
-     * Decodes an object from a Uint8 buffer.
-     * @param buf - The Uint8 buffer to decode.
-     * @returns The decoded object, or null if decoding failed.
-     */
-    fromBuffer(buf: Uint8Array): object;
-}
+import { O as OpaqueTransportMessage, E as EncodedTransportMessage } from './message-CpXWqmJw.cjs';
+import { C as Codec } from './types-BGGvYIJM.cjs';
 
 type SessionApiResult<T> = {
     ok: true;
@@ -44,4 +26,4 @@ declare class CodecMessageAdapter {
     fromBuffer(buf: Uint8Array): DeserializeResult;
 }
 
-export { type Codec as C, type EncodeResult as E, type SendResult as S, CodecMessageAdapter as a, type SendBufferResult as b };
+export { CodecMessageAdapter as C, type EncodeResult as E, type SendResult as S, type SendBufferResult as a };

package/dist/{chunk-3DDZCLJM.js → chunk-75ZMPCKC.js}

@@ -20,7 +20,7 @@ import {
   handshakeResponseMessage,
   isAcceptedProtocolVersion,
   isAck
-} from "./chunk-NUGV5QWU.js";
+} from "./chunk-ZLMQQI43.js";
 
 // transport/events.ts
 var ProtocolError = {
@@ -2124,10 +2124,26 @@ var ServerTransport = class extends Transport {
       const previousParsedMetadata = this.sessionHandshakeMetadata.get(
         msg.from
       );
-      const parsedMetadataOrFailureCode = await this.handshakeExtensions.validate(
-        msg.payload.metadata,
-        previousParsedMetadata
-      );
+      let parsedMetadataOrFailureCode;
+      try {
+        parsedMetadataOrFailureCode = await this.handshakeExtensions.validate(
+          msg.payload.metadata,
+          previousParsedMetadata
+        );
+      } catch (err) {
+        this.rejectHandshakeRequest(
+          session,
+          msg.from,
+          `handshake validation threw: ${coerceErrorString(err)}`,
+          "REJECTED_BY_CUSTOM_HANDLER",
+          {
+            ...session.loggingMetadata,
+            connectedTo: msg.from,
+            clientId: this.clientId
+          }
+        );
+        return;
+      }
       if (session._isConsumed) {
         return;
       }
@@ -2473,4 +2489,4 @@ export {
   WebSocketConnection,
   CodecMessageAdapter
 };
-//# sourceMappingURL=chunk-3DDZCLJM.js.map
+//# sourceMappingURL=chunk-75ZMPCKC.js.map