dsh-api-contract

OpenAPI specs are the one document every team touches and the one most likely to quietly rot: a path gets renamed, a parameter flips from optional to required, a response field vanishes, and downstream clients keep calling the old contract until something 500s at 2 a.m. dsh-api-contract turns that pain into a single local command: it parses your OpenAPI 3.x specification (JSON or YAML) and generates fully typed clients in TypeScript (fetch-based) or Python (requests-based), eliminating the repetitive work of hand-writing interfaces and keeping type hints in sync automatically.

It also ships a diff_spec tool that compares two spec versions side by side and classifies every change into breaking (removed paths or methods, dropped required parameters, parameter type changes, removed 2xx responses, restructured response bodies) versus non-breaking, so you can catch downstream-impacting regressions in a single code-review pass. The entire pipeline runs on Node with no network calls and no external services, keeping your specification files entirely local.

If your team maintains API clients in multiple languages, or you are standardising OpenAPI as the single source of truth driving your development workflow, dsh-api-contract shortens the distance from spec to runnable code and adds a low-cost regression check before every release. It is especially useful for small teams who want typed clients without adding heavyweight code-generation tooling to their build.