@replit/river 0.215.0 → 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-BXCk-dmy.d.ts

@@ -0,0 +1,29 @@
+import { O as OpaqueTransportMessage, E as EncodedTransportMessage } from './message-CpXWqmJw.js';
+import { C as Codec } from './types-BGGvYIJM.js';
+
+type SessionApiResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    reason: string;
+};
+type SendResult = SessionApiResult<string>;
+type SendBufferResult = SessionApiResult<undefined>;
+type EncodeResult = SessionApiResult<EncodedTransportMessage>;
+type SerializeResult = SessionApiResult<Uint8Array>;
+type DeserializeResult = SessionApiResult<OpaqueTransportMessage>;
+
+/**
+ * Adapts a {@link Codec} to the {@link OpaqueTransportMessage} format,
+ * accounting for fallibility of toBuffer and fromBuffer and wrapping
+ * it with a Result type.
+ */
+declare class CodecMessageAdapter {
+    private readonly codec;
+    constructor(codec: Codec);
+    toBuffer(msg: OpaqueTransportMessage): SerializeResult;
+    fromBuffer(buf: Uint8Array): DeserializeResult;
+}
+
+export { CodecMessageAdapter as C, type EncodeResult as E, type SendResult as S, type SendBufferResult as a };

package/dist/adapter-D5X11kmP.d.cts

@@ -0,0 +1,29 @@
+import { O as OpaqueTransportMessage, E as EncodedTransportMessage } from './message-CpXWqmJw.cjs';
+import { C as Codec } from './types-BGGvYIJM.cjs';
+
+type SessionApiResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    reason: string;
+};
+type SendResult = SessionApiResult<string>;
+type SendBufferResult = SessionApiResult<undefined>;
+type EncodeResult = SessionApiResult<EncodedTransportMessage>;
+type SerializeResult = SessionApiResult<Uint8Array>;
+type DeserializeResult = SessionApiResult<OpaqueTransportMessage>;
+
+/**
+ * Adapts a {@link Codec} to the {@link OpaqueTransportMessage} format,
+ * accounting for fallibility of toBuffer and fromBuffer and wrapping
+ * it with a Result type.
+ */
+declare class CodecMessageAdapter {
+    private readonly codec;
+    constructor(codec: Codec);
+    toBuffer(msg: OpaqueTransportMessage): SerializeResult;
+    fromBuffer(buf: Uint8Array): DeserializeResult;
+}
+
+export { CodecMessageAdapter as C, type EncodeResult as E, type SendResult as S, type SendBufferResult as a };

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

@@ -20,7 +20,7 @@ import {
   handshakeResponseMessage,
   isAcceptedProtocolVersion,
   isAck
-} from "./chunk-RDTQZ7HO.js";
+} from "./chunk-ZLMQQI43.js";
 
 // transport/events.ts
 var ProtocolError = {
@@ -1469,6 +1469,10 @@ var LeakyBucketRateLimit = class {
     clearInterval(this.intervalHandle);
     this.intervalHandle = void 0;
   }
+  resetBudget() {
+    this.stopLeak();
+    this.budgetConsumed = 0;
+  }
   close() {
     this.stopLeak();
   }
@@ -2120,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;
       }
@@ -2469,4 +2489,4 @@ export {
   WebSocketConnection,
   CodecMessageAdapter
 };
-//# sourceMappingURL=chunk-VXRAFUA3.js.map
+//# sourceMappingURL=chunk-75ZMPCKC.js.map