- group rpc implementation

- update documentation
- added missing grpc module-info

Author: jknack

docs/asciidoc/gRPC.adoc

@@ -1,12 +1,14 @@
-== gRPC
+==== gRPC
 
 The `jooby-grpc` module provides first-class, native support for https://grpc.io/[gRPC].
 
 Unlike traditional setups that require spinning up a separate gRPC server on a different port (often forcing a specific transport like Netty), this module embeds the `grpc-java` engine directly into Jooby.
 
 By using a custom native bridge, it allows you to run strictly-typed gRPC services alongside your standard REST API routes on the **exact same port**. It bypasses the standard HTTP/1.1 pipeline in favor of a highly optimized, native interceptor tailored for HTTP/2 multiplexing, reactive backpressure, and zero-copy byte framing. It works natively across Undertow, Netty, and Jetty.
 
-=== Dependency
+===== Usage
+
+gRPC strictly requires HTTP/2. Before installing the module, ensure your application is configured to use a supported server with HTTP/2 enabled.
 
 [source, xml, role="primary"]
 .Maven
@@ -24,11 +26,8 @@ By using a custom native bridge, it allows you to run strictly-typed gRPC servic
 implementation 'io.jooby:jooby-grpc:${jooby.version}'
 ----
 
-=== Usage
-
-gRPC strictly requires HTTP/2. Before installing the module, ensure your application is configured to use a supported server with HTTP/2 enabled.
-
-[source, java]
+[source, java, role="primary"]
+.Java
 ----
 import io.jooby.Jooby;
 import io.jooby.ServerOptions;
@@ -44,21 +43,37 @@ public class App extends Jooby {
 
     get("/api/health", ctx -> "OK"); // <3>
   }
-
-  public static void main(String[] args) {
-    runApp(args, App::new);
-  }
 }
 ----
+
+[source, kotlin, role="secondary"]
+.Kotlin
+----
+import io.jooby.ServerOptions
+import io.jooby.grpc.GrpcModule
+import io.jooby.kt.Kooby
+
+class App : Kooby({
+  serverOptions = ServerOptions().setHttp2(true) // <1>
+
+  install(GrpcModule( // <2>
+      GreeterService()
+  ))
+
+  get("/api/health") { "OK" } // <3>
+})
+----
+
 <1> Enable HTTP/2 on your server.
 <2> Install the module and explicitly register your services.
 <3> Standard REST routes still work on the exact same port!
 
-=== Dependency Injection
+===== Dependency Injection
 
 If your gRPC services require external dependencies (like database repositories), you can register the service classes instead of pre-instantiated objects. The module will automatically provision them using your active Dependency Injection framework (e.g., Guice, Spring).
 
-[source, java]
+[source, java, role="primary"]
+.Java
 ----
 import io.jooby.Jooby;
 import io.jooby.di.GuiceModule;
@@ -74,19 +89,38 @@ public class App extends Jooby {
   }
 }
 ----
+
+[source, kotlin, role="secondary"]
+.Kotlin
+----
+import io.jooby.di.GuiceModule
+import io.jooby.grpc.GrpcModule
+import io.jooby.kt.Kooby
+
+class App : Kooby({
+  install(GuiceModule())
+
+  install(GrpcModule(
+      GreeterService::class.java // <1>
+  ))
+})
+----
 <1> Pass the class references. The DI framework will instantiate them.
 
 WARNING: gRPC services are registered as **Singletons**. Ensure your service implementations are thread-safe and do not hold request-scoped state in instance variables. Heavy blocking operations will safely run on background workers, protecting the native server's I/O event loops.
 
-=== Server Reflection
+===== Server Reflection
 
 If you want to use tools like `grpcurl` or Postman to interact with your services without providing the `.proto` files, you can easily enable gRPC Server Reflection.
 
 Include the `grpc-services` dependency in your build, and register the v1 reflection service alongside your own:
 
-[source, java]
+[source, java, role="primary"]
+.Java
 ----
 import io.grpc.protobuf.services.ProtoReflectionServiceV1;
+import io.jooby.Jooby;
+import io.jooby.grpc.GrpcModule;
 
 public class App extends Jooby {
   {
@@ -97,9 +131,24 @@ public class App extends Jooby {
   }
 }
 ----
+
+[source, kotlin, role="secondary"]
+.Kotlin
+----
+import io.grpc.protobuf.services.ProtoReflectionServiceV1
+import io.jooby.grpc.GrpcModule
+import io.jooby.kt.Kooby
+
+class App : Kooby({
+  install(GrpcModule(
+      GreeterService(),
+      ProtoReflectionServiceV1.newInstance() // <1>
+  ))
+})
+----
 <1> Enables the modern `v1` reflection protocol for maximum compatibility with gRPC clients.
 
-=== Routing & Fallbacks
+===== Routing & Fallbacks
 
 The gRPC module intercepts requests natively before they reach Jooby's standard router.
 

docs/asciidoc/json-rpc.adoc

@@ -11,7 +11,7 @@ To expose a JSON-RPC endpoint, annotate your controller or service with `@JsonRp
 .JSON-RPC
 [source,java,role="primary"]
 ----
-import io.jooby.jsonrpc.JsonRpc;
+import io.jooby.rpc.jsonrpc.JsonRpc;
 
 @JsonRpc("movies")
 public class MovieService {
@@ -28,7 +28,7 @@ public class MovieService {
 .Kotlin
 [source,kotlin,role="secondary"]
 ----
-import io.jooby.jsonrpc.JsonRpc
+import io.jooby.rpc.jsonrpc.JsonRpc
 
 @JsonRpc("movies")
 class MovieService {
@@ -41,7 +41,7 @@ class MovieService {
 }
 ----
 
-When the Jooby APT detects the `@JsonRpc` annotation, it generates a class ending in `Rpc_` (e.g., `MovieServiceRpc_`) that implements the `io.jooby.jsonrpc.JsonRpcService` interface.
+When the Jooby APT detects the `@JsonRpc` annotation, it generates a class ending in `Rpc_` (e.g., `MovieServiceRpc_`) that implements the `io.jooby.rpc.jsonrpc.JsonRpcService` interface.
 
 The annotation dictates how the protocol methods are named and exposed:
 

docs/asciidoc/rpc.adoc

@@ -1,4 +1,16 @@
-=== RPC
+=== Remote Procedure Calls (RPC)
+
+While standard REST architectures focus on mapping HTTP methods to resources, Remote Procedure Call (RPC) architectures are designed around executing explicit actions or functions. RPC is often the preferred choice for strictly-typed client-server contracts, high-performance microservice communication, and scenarios where a strict resource-based REST model feels overly restrictive.
+
+Jooby provides first-class support for several RPC protocols. You can run any of these seamlessly alongside your standard HTTP routes on the exact same server instance, sharing the same underlying thread pools and I/O event loops.
+
+Depending on your client ecosystem and performance requirements, Jooby supports:
+
+* **gRPC**: A high-performance, strictly-typed protocol utilizing Protocol Buffers and HTTP/2 multiplexing. Ideal for backend-to-backend communication and polyglot microservices.
+* **JSON-RPC**: A lightweight, stateless, and simple JSON-encoded protocol. Excellent for rapid integrations and environments where standard JSON is preferred.
+* **tRPC**: A RPC implementation that provides end-to-end type safety directly between your Java backend and TypeScript clients, without requiring intermediate build steps or code generation.
+
+include::gRPC.adoc[]
 
 include::json-rpc.adoc[]
 

docs/asciidoc/tRPC.adoc

@@ -15,7 +15,7 @@ NOTE: Currently, Jooby only provides the required `TrpcParser` SPI implementatio
 ----
 import io.jooby.Jooby;
 import io.jooby.json.JacksonModule;
-import io.jooby.trpc.TrpcModule;
+import io.jooby.rpc.trpc.TrpcModule;
 
 public class App extends Jooby {
   {
@@ -33,7 +33,7 @@ public class App extends Jooby {
 ----
 import io.jooby.kt.Kooby
 import io.jooby.json.JacksonModule
-import io.jooby.trpc.TrpcModule
+import io.jooby.rpc.trpc.TrpcModule
 
 class App : Kooby({
   install(JacksonModule()) // <1>
@@ -197,7 +197,7 @@ If you throw custom domain exceptions, you can map them directly to tRPC error c
 .Java
 [source,java,role="primary"]
 ----
-import io.jooby.trpc.TrpcErrorCode;
+import io.jooby.rpc.trpc.TrpcErrorCode;
 
 {
   install(new TrpcModule());
@@ -213,8 +213,8 @@ import io.jooby.trpc.TrpcErrorCode;
 [source,kotlin,role="secondary"]
 ----
 import io.jooby.kt.Kooby
-import io.jooby.trpc.TrpcModule
-import io.jooby.trpc.TrpcErrorCode
+import io.jooby.rpc.trpc.TrpcModule
+import io.jooby.rpc.trpc.TrpcErrorCode
 
 class App : Kooby({
   install(TrpcModule())

jooby/src/main/java/io/jooby/Jooby.java

@@ -35,10 +35,10 @@
 import io.jooby.internal.MutedServer;
 import io.jooby.internal.RegistryRef;
 import io.jooby.internal.RouterImpl;
-import io.jooby.jsonrpc.JsonRpcModule;
-import io.jooby.jsonrpc.JsonRpcService;
 import io.jooby.output.OutputFactory;
 import io.jooby.problem.ProblemDetailsHandler;
+import io.jooby.rpc.jsonrpc.JsonRpcModule;
+import io.jooby.rpc.jsonrpc.JsonRpcService;
 import io.jooby.value.ValueFactory;
 
 /**

…src/main/java/io/jooby/GrpcExchange.java …java/io/jooby/rpc/grpc/GrpcExchange.javajooby/src/main/java/io/jooby/GrpcExchange.java renamed to jooby/src/main/java/io/jooby/rpc/grpc/GrpcExchange.java jooby/src/main/java/io/jooby/GrpcExchange.java renamed to jooby/src/main/java/io/jooby/rpc/grpc/GrpcExchange.java

@@ -3,7 +3,7 @@
  * Apache License Version 2.0 https://jooby.io/LICENSE.txt
  * Copyright 2014 Edgar Espina
  */
-package io.jooby;
+package io.jooby.rpc.grpc;
 
 import java.nio.ByteBuffer;
 import java.util.Map;

…rc/main/java/io/jooby/GrpcProcessor.java …ava/io/jooby/rpc/grpc/GrpcProcessor.javajooby/src/main/java/io/jooby/GrpcProcessor.java renamed to jooby/src/main/java/io/jooby/rpc/grpc/GrpcProcessor.java jooby/src/main/java/io/jooby/GrpcProcessor.java renamed to jooby/src/main/java/io/jooby/rpc/grpc/GrpcProcessor.java

@@ -3,7 +3,7 @@
  * Apache License Version 2.0 https://jooby.io/LICENSE.txt
  * Copyright 2014 Edgar Espina
  */
-package io.jooby;
+package io.jooby.rpc.grpc;
 
 import java.nio.ByteBuffer;
 import java.util.concurrent.Flow;

…ava/io/jooby/jsonrpc/JsonRpcDecoder.java …io/jooby/rpc/jsonrpc/JsonRpcDecoder.javajooby/src/main/java/io/jooby/jsonrpc/JsonRpcDecoder.java renamed to jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcDecoder.java jooby/src/main/java/io/jooby/jsonrpc/JsonRpcDecoder.java renamed to jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcDecoder.java

@@ -3,7 +3,7 @@
  * Apache License Version 2.0 https://jooby.io/LICENSE.txt
  * Copyright 2014 Edgar Espina
  */
-package io.jooby.jsonrpc;
+package io.jooby.rpc.jsonrpc;
 
 /**
  * A pre-resolved decoder used at runtime to deserialize JSON-RPC parameter nodes into complex Java

…a/io/jooby/jsonrpc/JsonRpcErrorCode.java …/jooby/rpc/jsonrpc/JsonRpcErrorCode.javajooby/src/main/java/io/jooby/jsonrpc/JsonRpcErrorCode.java renamed to jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcErrorCode.java jooby/src/main/java/io/jooby/jsonrpc/JsonRpcErrorCode.java renamed to jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcErrorCode.java

@@ -3,7 +3,7 @@
  * Apache License Version 2.0 https://jooby.io/LICENSE.txt
  * Copyright 2014 Edgar Espina
  */
-package io.jooby.jsonrpc;
+package io.jooby.rpc.jsonrpc;
 
 import io.jooby.StatusCode;
 

…a/io/jooby/jsonrpc/JsonRpcException.java …/jooby/rpc/jsonrpc/JsonRpcException.javajooby/src/main/java/io/jooby/jsonrpc/JsonRpcException.java renamed to jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcException.java jooby/src/main/java/io/jooby/jsonrpc/JsonRpcException.java renamed to jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcException.java

@@ -3,7 +3,7 @@
  * Apache License Version 2.0 https://jooby.io/LICENSE.txt
  * Copyright 2014 Edgar Espina
  */
-package io.jooby.jsonrpc;
+package io.jooby.rpc.jsonrpc;
 
 /**
  * Exception thrown when a JSON-RPC error occurs during routing, parsing, or execution.