Back to work

2024 · Principal engineer

Typebridge API

End-to-end type safety from Zod to OpenAPI to clients

Circuit board traces representing API connectivity

Context

A developer-tools company shipped three client SDKs from a hand-maintained OpenAPI document that routinely drifted from runtime validators.

Problem

Contract mismatches caused 23 production incidents in six months. SDK releases lagged API changes by an average of nine days.

Architecture

Made Zod schemas the single source of truth. Generated OpenAPI 3.1, TypeScript clients, and contract tests from the same definitions.

Result

Contract-related incidents fell 78%. SDK lag dropped from nine days to same-day.

Stack

ZodOpenAPINode.jsGitHub Actions