Devsolved
The Symptom
Symptom
The GitHub Actions build step started failing randomly with `JavaScript heap out of memory`. When developers ran `npm run build` locally, their fans would spin up to maximum, and the process would eventually crash with `TS2589: Type instantiation is excessively deep and possibly infinite`.
Root Cause Analysis
Root Cause
A developer created a clever but overly complex recursive utility type to convert database snake_case keys into camelCase keys for the frontend (using Template Literal Types). While it worked fine for simple objects, when it was applied to a massive nested API response interface with recursive relationships, the TypeScript compiler tried to evaluate thousands of permutations, exhausting the V8 engine's memory.
Code
typescript
// The fatal flaw: Recursive template literal types on deep structures
type SnakeToCamelCase<S extends string> = ...
type DeepCamelize<T> = T extends object ? {
[K in keyof T as SnakeToCamelCase<K & string>]: DeepCamelize<T[K]>
} : T;Resolution
Resolution
We removed the runtime-mimicking magic types. Instead of forcing the type system to compute camel casing, we explicitly defined the API response interfaces. We accepted that explicit interfaces are better than overly "clever" types that crash the compiler.
Discussions 0