feat: publish SSR under deprecated auth-helpers package names #127
+95
−11
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What kind of change does this PR introduce?
Feature - Package consolidation and multi-package publishing
What is the current behavior?
Currently,
@supabase/ssr
is only published under its own package name. Meanwhile, the deprecated@supabase/auth-helpers-*
packages continue to receive thousands of weekly downloads, probably due to LLMs recommending them in code suggestions despite being deprecated for a long time.The deprecated packages:
@supabase/auth-helpers-nextjs
(159k weekly downloads)@supabase/auth-helpers-react
@supabase/auth-helpers-remix
@supabase/auth-helpers-sveltekit
What is the new behavior?
This PR enables
@supabase/ssr
to be published under multiple package names simultaneously:Multi-package publishing: The release workflow now publishes the same codebase under 5 different npm package names:
@supabase/ssr
(primary package)@supabase/auth-helpers-nextjs
@supabase/auth-helpers-react
@supabase/auth-helpers-remix
@supabase/auth-helpers-sveltekit
Console warnings: When imported as a deprecated auth-helpers package, users see a prominent warning.
Updated documentation: README clearly explains the package consolidation and lists all deprecated packages.
Additional context
Users of the old auth-helpers packages will experience breaking changes when updating, as the APIs are not backward compatible. This is intentional - as discussed internally, we want to "break it loudly" to force users to notice and migrate.
Why this approach?
Related: supabase/auth-helpers#811