docs(auth): correct @auth/qwik documentation and add migration guide

[cwoolum]

fixes #6729

Overview

What is it?

• Feature / enhancement
• Bug
• Docs / tests / types / typos

Description

The new @auth/qwik package has different routes than the original @builder.io/qwik-auth package. In the new package, the routes are no longer prefixed with /api. This can lead to confusion when the user tries to gate pages and gets redirected to a 404.

Use cases and why

• 1. Applies to any users that use Auth and are attempting to migrate to the new @auth/qwik package.

Checklist:

• My code follows the developer guidelines of this project
• I have performed a self-review of my own code
• I have made corresponding changes to the documentation
• [N/A] Added new tests to cover the fix / functionality

[changeset-bot]

⚠️ No Changeset found

Latest commit: ad91e9f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

[cwoolum]

@gioboa , should I also add an alert or warning that notifies users that are upgrading that the routes changed? I think this change might be easy to miss.

[gioboa]

👍 that's a great idea. You can add a note for the users that are upgrading

[gioboa]

Thanks @cwoolum

[cwoolum]

@gioboa , I added some guidance as well as a couple diffs to help others easily migrate 🙂

[gioboa]

Thanks it looks great to me