Skip to content

SpecDock v0.5.0

Latest
Latest

Choose a tag to compare

View all tags
@dev-ik dev-ik released this 19 Jun 14:28
· 4 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.5.0
041903c

SpecDock v0.5.0 adds explicit contract diff workflows and self-hosted mock response generation for local and CI-assisted API contract work.

Highlights

  • Compare any two OpenAPI specs from saved projects, files, or raw text.
  • Filter contract diff findings by severity, method, path, and tag.
  • Export contract diff reports as GitHub/GitLab-friendly Markdown or stable JSON.
  • Detect breaking required request/response property additions.
  • Generate self-hosted mock responses from OpenAPI examples first, then schema examples.
  • Use the Mock Server panel to pick an endpoint/status, preview the generated response body, edit it, and copy a live-route cURL command.
  • Save generated responses as live in-memory routes under /mock/... for external local calls while the API process is running.
  • Generate selected 4xx/5xx mock responses from OpenAPI response schemas when described, with explicit fallback error bodies when they are not.
  • Run contract diff from the CLI with optional --fail-on-breaking CI behavior.

Security

  • Mock routes are disabled by default and are not registered in public demo mode.
  • Diff exports include metadata, counts, and findings only; they do not include specs, request bodies, response bodies, auth headers, cookies, or API keys.
  • Mock response bodies are size-limited.
  • Imported specs are not persisted by the mock endpoint.
  • Saved mock routes are process-local in memory.

Docker

docker run --rm -p 3000:3000 \
  -e PUBLIC_DEMO=true \
  -e PROXY_ENABLED=false \
  -e MOCK_SERVER_ENABLED=false \
  docker.io/d8vik/specdock:v0.5.0

For trusted self-hosted mock responses:

PUBLIC_DEMO=false
MOCK_SERVER_ENABLED=true
MOCK_MAX_RESPONSE_BYTES=10485760

Artifacts

  • Git tag: v0.5.0
  • Docker image: docker.io/d8vik/specdock:v0.5.0
  • Docker manifest digest: sha256:39635b6577cfade585fa0a0f9be205ff7816dcb5bc0b3664aa4d275482e50f54
  • Platforms: linux/amd64, linux/arm64

Verification

Validated before release:

nvm use
npm ci
npm run typecheck
npm run lint
npm run test
npm run test:sdk-smoke
npm run build
npm audit --audit-level=moderate

Docker smoke test passed:

  • /api/health returns version 0.5.0.
  • Bundled OpenAPI example is served.
  • /mock/* is closed in public demo mode.
Assets 3
Loading