RPC con WorkerEntrypoint

Reenviar un Request a otro Worker funciona, pero es una conversación de bajo nivel: serializas todo en una petición y descifras una respuesta, como si el otro Worker fuera un servidor anónimo. Los service bindings modernos ofrecen un registro mucho más expresivo: RPC. Extiendes una clase, WorkerEntrypoint, expones métodos públicos, y desde el otro Worker los llamas por su nombre —con argumentos tipados y valores de retorno tipados— como si invocaras un método local. La ceremonia de construir peticiones a mano desaparece.

De hablar HTTP a llamar métodos

El modelo fetch trata al otro Worker como una caja negra a la que le hablas HTTP: metes tus datos en la URL, las cabeceras o el cuerpo, y luego los sacas del Response. Ese empaquetado y desempaquetado manual es puro ruido cuando los dos Workers son tuyos y comparten el mismo lenguaje. RPC —llamada a procedimiento remoto— elimina el ruido: en lugar de una petición, invocas un método; en lugar de un Response, recibes el valor que el método devolvió, ya reconstruido como objeto de JavaScript.

Exponer métodos con WorkerEntrypoint

El Worker que ofrece el servicio deja de exportar solo un fetch. Ahora exporta una clase que extiende WorkerEntrypoint, y cada método público de esa clase se vuelve invocable desde fuera. Dentro de la clase tienes this.env y this.ctx, igual que en un handler normal.

import { WorkerEntrypoint } from "cloudflare:workers";

export class AuthService extends WorkerEntrypoint<Env> {
  async verificar(token: string): Promise<{ valido: boolean; usuario?: string }> {
    const fila = await this.env.DB
      .prepare("SELECT usuario FROM sesiones WHERE token = ?")
      .bind(token)
      .first<{ usuario: string }>();
    return fila ? { valido: true, usuario: fila.usuario } : { valido: false };
  }
}

export default {
  fetch() {
    return new Response("auth service");
  },
} satisfies ExportedHandler<Env>;

En la configuración del Worker que llama, el service binding apunta ahora a esa clase concreta con el campo entrypoint, no solo al Worker:

{
  "services": [
    { "binding": "AUTH", "service": "auth-worker", "entrypoint": "AuthService" }
  ]
}

Invocar como si fuera local

Desde el Worker que consume, env.AUTH ya no es algo a lo que reenviar un Request: es un objeto cuyos métodos son los que declaraste en la clase. Los llamas y esperas su promesa como cualquier función asíncrona.

export default {
  async fetch(request, env): Promise<Response> {
    const token = request.headers.get("authorization") ?? "";
    const { valido, usuario } = await env.AUTH.verificar(token);
    if (!valido) return new Response("no autorizado", { status: 401 });
    return Response.json({ hola: usuario });
  },
} satisfies ExportedHandler<Env>;

La firma del método viaja con los tipos: wrangler types genera la definición del binding a partir de la clase, de modo que env.AUTH.verificar sabe que espera un string y devuelve una forma concreta. Si cambias la firma en el servicio y no en la llamada, el compilador te avisa —una red de seguridad que una llamada por HTTP, donde todo es texto sin tipo, jamás te da—.

Qué puede cruzar la frontera

La comodidad tiene un límite físico que conviene ver con claridad: aunque la llamada parezca local, los argumentos y el valor de retorno se serializan para cruzar de un isolate a otro. No pasa cualquier cosa. Cruzan sin problema los datos estructurados —números, cadenas, objetos, arrays, Map, Set, Date, ArrayBuffer— mediante el algoritmo de clonación estructurada.

Pero RPC va más lejos que un simple clon. Puedes pasar funciones como callbacks y devolver objetos con métodos si extienden RpcTarget: en ese caso no se copia el objeto, sino que el otro lado recibe un stub, una referencia remota sobre la que seguir llamando métodos. Incluso puedes encadenar llamadas sin esperar cada salto —promise pipelining—, y la plataforma resuelve la cadena en un solo viaje.

flowchart LR
C[Worker consumidor] -->|verificar token| BND[binding AUTH]
BND --> S[WorkerEntrypoint AuthService]
S -->|consulta| DB[D1 sesiones]
S -->|valor tipado| C
style BND fill:#89b4fa,color:#11111b
style S fill:#a6e3a1,color:#11111b