Deprecate clerk set session

[dimkl]

Description

Since we are deprecation the setSession hook from @clerk/clerk-react and there is a @experimental directive on Clerk.setActive which indicates that it's gonna replace the Clerk.setSession, I deprecated the Clerk.setSession.

Checklist

• npm test runs as expected.
• npm run build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

Packages affected

• @clerk/clerk-js
• @clerk/clerk-react
• @clerk/nextjs
• @clerk/remix
• @clerk/types
• @clerk/themes
• @clerk/localizations
• @clerk/clerk-expo
• @clerk/backend
• @clerk/clerk-sdk-node
• @clerk/shared
• @clerk/fastify
• @clerk/chrome-extension
• gatsby-plugin-clerk
• build/tooling/chore

[changeset-bot]

🦋 Changeset detected

Latest commit: 9e97285

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[panteliselef]

😎

[sytpb]

https://clerk.com/docs/custom-flows/embedded-magic-links , setSession in this document should be deprecated , how to use setActive to accept magic links?

[dimkl]

@sytpb thank you for your feedback. We will update the docs soon. Until then:

const { setActive } = useSignIn();

setActive({
  session: 'sessionOrSessionId',
  beforeEmit: () => optionalNavigationOrCallbackFn()
});