Skip to content

docs: fix README version framing, npm badge, and Node requirement#4

Merged
philz3906 merged 1 commit into
mainfrom
docs/readme-v2-npm-badge
Jun 13, 2026
Merged

docs: fix README version framing, npm badge, and Node requirement#4
philz3906 merged 1 commit into
mainfrom
docs/readme-v2-npm-badge

Conversation

@philz3906

Copy link
Copy Markdown
Contributor

What

Three doc-only corrections to README.md, verified against the npm registry and package.json:

Issue Before After
Version framing "v3 is a breaking rewrite … v2 (openapi-ts based)" "v2 is a breaking rewrite … v1 (openapi-ts based)"
npm badge badge.fury.io (deprecated/flaky) img.shields.io/npm/v/@sentio/api
Node requirement "requires Node 20+" "requires Node 24+"

Why

  • npm latest is 2.0.0 — the connect-es / protobuf-es rewrite (deps @bufbuild/protobuf + @connectrpc/connect + @sentio/connect-gateway-es). The openapi-ts client it replaced was the 1.x line (1.0.4 depended on @hey-api/client-fetch). The README's "v3 replaces v2" framing was off-by-one and would mislead anyone who runs npm install @sentio/api and gets 2.0.0.
  • badge.fury.io is effectively unmaintained; shields.io is the standard, reliably-cached source and links to the canonical www.npmjs.com package page.
  • package.json engines requires node >=24 (and CLAUDE.md says Node 24+); the README said 20+.

Notes for reviewer

  • README.md is hand-written (not CI-owned src/gen), so this is safe to edit here.
  • Code examples were spot-checked against the actual exports (createSentioClient/WebService/InsightsService and the @sentio/api/gen/... deep-import for Project) — all resolve; no example changes needed.
  • docs: type does not trigger a semantic-release publish.

🤖 Generated with Claude Code

The connect-es rewrite shipped as v2.0.0 (npm `latest`), replacing the
1.x openapi-ts client — the note incorrectly said "v3 replaces v2".

- Correct the breaking-rewrite note to v2 over v1.
- Swap the deprecated badge.fury.io npm badge for shields.io.
- Node requirement is 24+ (matches package.json `engines`), not 20+.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@philz3906 philz3906 merged commit 73ba82f into main Jun 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant