gateway

Documentation

Overview

Command gateway is the Doorbell server: a raw TCP control port plus an HTTP ingress, in one process.

It is the piece that cannot exist on Vercel, Netlify, Cloudflare Workers or Lambda — not because it is hard there, but because those platforms terminate HTTP and sleep between requests, and this process must hold a TCP socket open for hours. Zerops' lack of scale-to-zero is what makes it possible.

Request path:

internet -> :3000 /t/<id>/... -> lookup tunnel -> open a yamux stream on the
tunnel's existing socket -> ReverseProxy writes the HTTP request into the
stream -> the CLI on the developer's laptop pipes it to localhost.

Using httputil.ReverseProxy with a Transport that dials yamux, instead of hand-rolling HTTP framing, buys correct handling of chunked bodies, keep-alive and WebSocket upgrades for free.