we hit with image uploads when the cache went cold

We ran into this around image uploads when the cache went cold.

Docs helped humans. Generated types caught the breakages in CI.

Schemas still drift when several repos move at different speeds.

Hand-written wrappers stayed flexible and hid mismatches.

The noisy diffs were worth it once a breaking change never shipped.

We kept the generator and deleted the duplicate sample clients.