Skip to content
This repository was archived by the owner on Aug 14, 2026. It is now read-only.

docs: point readers at @opensea/sdk/stream - #528

Merged
ryanio merged 1 commit into
mainfrom
deprecate-notice
Aug 14, 2026
Merged

docs: point readers at @opensea/sdk/stream#528
ryanio merged 1 commit into
mainfrom
deprecate-notice

Conversation

@ryanio

@ryanio ryanio commented Aug 14, 2026

Copy link
Copy Markdown
Collaborator

The Stream client now ships inside @opensea/sdk at the @opensea/sdk/stream subpath. @opensea/stream-js is deprecated, with 0.4.0 as its last published version.

Anyone landing on this repo today gets install instructions for a package that will not be updated again, including npm install ws node-localstorage, which is not needed on Node 22 or newer. This adds a notice at the top of the README with:

  • the uninstall/install commands
  • the two-line import diff
  • the breaking changes, each linked to the migration guide
  • where the maintained code and docs live

It also repoints the Documentation link from /reference/stream-js to /reference/stream-api. The old slug redirects, but this is the last thing a reader here will see, so it may as well be the live URL.

What I deliberately left alone

The rest of the README still describes the 0.4.0 API, because that is what the last published version actually does. Rewriting it to describe @opensea/sdk/stream would misrepresent the package still on npm for anyone pinned to it.

The notice says "deprecated and no longer maintained" rather than "archived", so it reads correctly both now and after this repo is archived.

Context

  • @opensea/sdk 11.9.0 is on npm with the client at @opensea/sdk/stream, verified by streaming live events from the published tarball.
  • ProjectOpenSea/opensea-devtools#620 removed packages/stream from the monorepo, so this mirror will not be synced again.
  • The docs are updated and live at docs.opensea.io/reference/stream-api.
  • npm deprecate @opensea/stream-js is the remaining step.

🤖 Generated with Claude Code

The Stream client now ships inside @opensea/sdk at the @opensea/sdk/stream
subpath, and @opensea/stream-js is deprecated at 0.4.0. Anyone landing here
should be sent to the maintained code rather than following install
instructions for a package that will not be updated again.

Adds a notice at the top with the uninstall/install commands, the two-line
import diff, and the breaking changes, each linked to the migration guide.

Also repoints the Documentation link from /reference/stream-js to
/reference/stream-api. The old slug redirects, but this is the last thing a
reader here will see, so it may as well be the live URL.

Left as is: the rest of the README still describes the 0.4.0 API, which is what
the last published version actually does. Rewriting it would misrepresent the
package that is still on npm.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ryanio
ryanio merged commit 3bd0974 into main Aug 14, 2026
6 checks passed
@ryanio
ryanio deleted the deprecate-notice branch August 14, 2026 18:32
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant