BBC Consumer Contracts vs oasdiff

BBC Consumer Contracts is a free JavaScript package for executable consumer-driven API contracts. It describes the requests a consumer makes and the responses expected in return. Every contract requires consumer, name, request, and response properties. The package uses the request HTTP client and Joi schemas to check response status codes, headers, and JSON bodies. Optional before and after functions support setup and cleanup, using callbacks or asynchronous functions. Retry behavior accepts numeric or custom settings; the documented default maximum is zero. The consumer-contracts run command validates contracts recursively in a contracts directory or runs one named file. Programmatic callers can pass an array to validateContracts, which runs every contract instead of stopping at the first failure. Installation instructions cover global CLI use and local pnpm development dependencies. It requires Node.js 18 or later and pnpm 10 or later, and supports API and self-hosted use under Apache License 2.0.

oasdiff compares OpenAPI specifications, produces changelogs, and identifies breaking changes before release. It supports OpenAPI 3.0, 3.1, and 3.2, and detects 755 distinct breaking and non-breaking API changes. The CLI is available through Homebrew, a shell installer, Docker, and pre-built Linux, macOS, and Windows binaries. Output formats include text, JSON, YAML, HTML, Markdown, and GitHub Actions annotations. Its GitHub Action compares pull-request and base-branch specifications, adding inline annotations for breaking changes. A browser diff tool compares OpenAPI or Swagger specifications without installation or sign-up. Specs and changelogs are encrypted client-side before upload, and servers retain ciphertext they cannot read. The open-source engine, CLI, and GitHub Action use the Apache 2.0 license. A free plan includes CLI diffing, changelogs, GitHub Action annotations, side-by-side review, and encrypted spec storage. Pro costs $100/month and adds approval workflow, audit trail, merge gate, and up to five reviewers across five repositories. Free review links expire after seven days; Enterprise can load specs from GitHub without uploading or storing them.