sailfork / t3code-github / .repos/ alchemy-effect/ packages/ cloudflare/ src/ Workers/ RpcAsync.ts

import type { Rpc } from "alchemy/Rpc";
import type * as Effect from "effect/Effect";
import type * as Stream from "effect/Stream";
import { isRpcErrorEnvelope, isRpcStreamEnvelope } from "./Rpc.ts";

export type RpcAsync<Shape> = {
  [K in keyof Shape as K extends "fetch" ? never : K]: Shape[K] extends (
    ...args: infer A
  ) => Effect.Effect<infer T, any, any>
    ? (...args: A) => Promise<T>
    : Shape[K] extends (...args: infer A) => Stream.Stream<any, any, any>
      ? (...args: A) => Promise<ReadableStream<Uint8Array>>
      : Shape[K] extends Effect.Effect<infer T, any, any>
        ? Promise<T>
        : Shape[K] extends Stream.Stream<any, any, any>
          ? Promise<ReadableStream<Uint8Array>>
          : Shape[K] extends (...args: infer A) => infer R
            ? (...args: A) => Promise<Awaited<R>>
            : Promise<Shape[K]>;
};

/**
 * Wrap a Cloudflare Worker RPC stub in a `Promise<T>`-shaped proxy so callers
 * outside the Effect runtime (TanStack Start route handlers, plain Workers,
 * test code) can `await` RPC methods directly.
 *
 * The proxy:
 * - leaves `fetch` / `connect` / `Symbol.dispose` and other non-string keys
 *   passing through to the underlying binding unchanged,
 * - turns each `Effect<T>` / `Stream<T>` method into a `Promise<T>` /
 *   `Promise<ReadableStream<Uint8Array>>`,
 * - unwraps the wire envelopes produced by the Effect-side RPC bridge:
 *   `RpcErrorEnvelope` is rethrown via {@link decodeRpcThrowable} so
 *   `try/catch` sees an `Error` (or a tagged error object), and
 *   `RpcStreamEnvelope` is flattened to its `ReadableStream` body.
 *
 * @example Three ways to reach a value from a plain Worker — direct binding, fetch, RPC
 * ```ts
 * import { toRpcAsync } from "@alchemy.run/cloudflare/Bridge";
 * import type Backend from "./backend.ts";
 *
 * interface Env {
 *   BUCKET: Bucket;
 *   BACKEND: Service<Backend>;
 * }
 *
 * export default {
 *   async fetch(request: Request, env: Env): Promise<Response> {
 *     const url = new URL(request.url);
 *     const key = url.searchParams.get("key");
 *     const via = url.searchParams.get("via") ?? "binding";
 *     if (!key) return new Response("Missing 'key'", { status: 400 });
 *
 *     // option 1 — use the async binding directly
 *     if (via === "binding") {
 *       const object = await env.BUCKET.get(key);
 *       if (!object) return new Response("Not found", { status: 404 });
 *       return new Response(object.body);
 *     }
 *
 *     // option 2 — call the Effect worker's fetch handler
 *     if (via === "fetch") {
 *       return env.BACKEND.fetch(
 *         `https://backend/?key=${encodeURIComponent(key)}`,
 *       );
 *     }
 *
 *     // option 3 — call an Effect worker RPC method as a Promise
 *     const backend = toRpcAsync<Backend>(env.BACKEND);
 *     const value = await backend.hello(key);
 *     if (value === null) return new Response("Not found", { status: 404 });
 *     return new Response(value);
 *   },
 * };
 * ```
 */
export const toRpcAsync = <W>(stub: any): RpcAsync<Rpc.Shape<W>> & Service =>
  new Proxy(stub, {
    get: (target, prop) => {
      // `Service` methods (fetch/connect) and any non-string keys (Symbol.dispose, etc.)
      // pass through to the underlying Cloudflare binding unchanged.
      if (typeof prop !== "string" || prop === "fetch" || prop === "connect") {
        const value = (target as any)[prop];
        return typeof value === "function" ? value.bind(target) : value;
      }
      // Every other string key becomes an RPC method, so the runtime's own
      // protocol probes must be answered with `undefined`: a `then` method
      // makes the view a thenable, and `await view` (or returning it from an
      // async function) then calls `then` as an RPC and never settles.
      // `toJSON` likewise must not turn `JSON.stringify(view)` into a call.
      if (prop === "then" || prop === "toJSON") {
        return undefined;
      }

      return async (...args: unknown[]) => {
        const result = await (target as any)[prop](...args);
        if (isRpcErrorEnvelope(result)) {
          throw decodeRpcThrowable(result.error);
        }
        if (isRpcStreamEnvelope(result)) {
          return result.body;
        }
        return result;
      };
    },
  }) as any;

/**
 * Reconstruct a throwable from {@link encodeRpcError}'s wire form. Plain
 * `Error` payloads are rebuilt as `Error` instances so `.message`/`.name`/
 * `.stack` survive. Tagged errors (anything with a `_tag`) and primitives
 * are thrown as-is so `try { ... } catch (e) { if (e._tag === ...) }` keeps
 * working.
 */
const decodeRpcThrowable = (error: unknown): unknown => {
  if (error === null || typeof error !== "object") return error;
  const obj = error as Record<string, unknown>;
  if ("_tag" in obj) return obj;
  if (typeof obj.message === "string" || typeof obj.name === "string") {
    const e = new Error(typeof obj.message === "string" ? obj.message : "");
    if (typeof obj.name === "string") e.name = obj.name;
    if (typeof obj.stack === "string") e.stack = obj.stack;
    return e;
  }
  return error;
};