Problem
The committed packages/katana-client/src/generated/** is out of date relative
to the current docs/katana-openapi.yaml + @hey-api/openapi-ts version. A fresh
npm run generate produces a large content diff (~2,900 lines even ignoring
whitespace: index.ts +1842, sdk.gen.ts +1155, etc.) — new SDK methods/types that
exist in the spec but not in the committed client.
Why CI doesn't catch it
The typescript-client job regenerates fresh and typechecks, but never diffs the
committed output (unlike the Python generated-files job, which fails on any drift).
This is intentional — the TS generator shells out to per-platform native binaries so
its output isn't byte-stable macOS↔Linux, so a drift check would false-positive. The
side effect is that committed staleness is invisible.
Proposed work
Notes
- Consumers read the committed client without building, so staleness is user-visible
(missing endpoints/types). Worth doing but not urgent.
- Keep this PR only the regeneration so the diff is reviewable as "codegen output,"
not mixed with logic changes.
Problem
The committed
packages/katana-client/src/generated/**is out of date relativeto the current
docs/katana-openapi.yaml+@hey-api/openapi-tsversion. A freshnpm run generateproduces a large content diff (~2,900 lines even ignoringwhitespace:
index.ts+1842,sdk.gen.ts+1155, etc.) — new SDK methods/types thatexist in the spec but not in the committed client.
Why CI doesn't catch it
The
typescript-clientjob regenerates fresh and typechecks, but never diffs thecommitted output (unlike the Python
generated-filesjob, which fails on any drift).This is intentional — the TS generator shells out to per-platform native binaries so
its output isn't byte-stable macOS↔Linux, so a drift check would false-positive. The
side effect is that committed staleness is invisible.
Proposed work
npm run generateand commit the refreshedsrc/generated/**.npm run typecheck+npm teststay green.regenerated output is reproducible.
Notes
(missing endpoints/types). Worth doing but not urgent.
not mixed with logic changes.