Saltar al contenido
Framework Ecosystems LabsUn contrato, muchos ecosistemas, la misma prueba.

🔗 tRPC — 2020#

⬅️ Atlas · 🟨 Ecosistema JavaScript · 🗂️ Índice

tRPC elimina la capa de esquema entre cliente y servidor: el tipo del servidor llega al cliente por inferencia de TypeScript, sin generar nada. Es potente y tiene un límite que conviene entender antes de adoptarlo.
Aparición 2020
Clasificación rpc-framework
Ecosistema TypeScript
Licencia MIT
Estado 🟢 Activo
Documentación https://trpc.io/docs

💡 Sin generación de código#

// servidor
export const router = t.router({
  crearTarea: t.procedure.input(esquemaTarea).mutation(({ input }) => crear(input)),
});
export type Router = typeof router;

// cliente
const tarea = await cliente.crearTarea.mutate({ titulo: "Leer el módulo 03" });
//    ^ el tipo de `tarea` viene del servidor, sin paso intermedio

Cambias el servidor y el cliente deja de compilar en el mismo momento. Es lo que el módulo 05 persigue —romper pronto y en voz alta— logrado sin OpenAPI ni GraphQL ni generadores.

⚖️ Dónde se acaba#

Todo eso depende de una condición: cliente y servidor comparten el mismo repositorio y el mismo lenguaje. Fuera de esa condición, tRPC no aplica.

Situación ¿Sirve?
Monorepo TypeScript, un equipo ✅ Encaja perfectamente
Cliente móvil nativo ❌ No hay tipos que compartir
API pública para terceros ❌ Necesitas contrato publicado
Consumidores en otros lenguajes ❌

Por eso el contrato del programa —contracts/taskflow/openapi.yaml— está en OpenAPI y no en tRPC: cinco implementaciones en cinco lenguajes distintos necesitan un contrato independiente del lenguaje [openapi-spec]. Es literalmente el caso que tRPC no cubre.

Y hay un matiz de acoplamiento que Richardson y Amundsen subrayan [richardson-amundsen-restful]: en RPC el cliente llama a procedimientos del servidor; el acoplamiento es de firma, no de recurso. Cuando el servidor cambia, todos los clientes cambian. Dentro de un monorepo eso es una ventaja —lo ves al compilar—; entre organizaciones distintas es un problema.

🎓 Las dos lecciones#

1. Compartir tipos elimina toda una clase de errores sin generar código. Es la integración más estrecha posible, y funciona.

2. Esa estrechez es la condición de uso. Un contrato entre organizaciones tiene que ser independiente del lenguaje.

🔗 Enlaces#

Fuentes#