feat: add @auth/astro framework library with example & docs

[TheOtterlord]

NOTE:

• It's a good idea to open an issue first to discuss potential changes.
• Please make sure that you are NOT opening a PR to fix a potential security vulnerability. Instead, please follow the Security guidelines to disclose the issue to us confidentially.

☕️ Reasoning

Supersedes #6425

🚀 Introduces an Astro framework package, with documentation & an example. The package exposes Astro components in addition to the methods.

Thanks to @tajkirkpatrick and @nowaythatworked who've helped out with building, debugging & documenting this package.

I've deployed the included example application to https://auth-astro-example.vercel.app/ feel free to take a look.

🧢 Checklist

• Documentation
• Tests
• Ready to be merged

🎫 Affected issues

Please scout and link issues that might be solved by this PR.

Fixes: INSERT_ISSUE_LINK_HERE

📌 Resources

• Security guidelines
• Contributing guidelines
• Code of conduct
• Contributing to Open Source

[TheOtterlord]

Only a day late 😅

This latest change turns the package into an Astro integration and removes a large portion of the installation process, as well as remove some annoying bugs & DX decisions. I've also updated the documentation to rely on a components.d.ts file removing any definitions outside the package.

[tony-sull]

Just came across this PR when looking into adding Astro support to Auth.js, great work here!

@TheOtterlord let me know if I can help at all! It'd be amazing to see @auth/astro support for an easy auth solution in SSR!

The idea of routing this through Astro's integrations API is really interesting to avoid boilerplate - I wonder if there's something we can do to make it easier to access environment variables when configuring auth providers without reaching for Vite's loadEnv helper 🤔

[nowaythatworked]

@tony-sull We are actually developing this further on this repo https://github.com/nowaythatworked/auth-astro and merge the results in here periodically. Feel free to PR or join the Discussion on the Astro Discord

[ChrisSki]

Any update on this? Waiting for this bad boy so I can get Auth working with Astro 🙏

[Dezaku]

Any update on this? Waiting for this bad boy so I can get Auth working with Astro 🙏

Same!

[TheOtterlord]

The current version of this PR is behind auth-astro, but if there's still interest, I'd be happy to update it when I get the time!

[AsyncBanana]

I have fixed some things (monorepo functionality, weird edge bugs, consistent formatting) and added some stuff (defineConfig helper) in my fork, if you want to take some or all of it. I have submitted some changes as PRs already, and would be happy to submit other changes or the whole thing as a PR.

[martincolladodev]

Any update on this? Waiting for this bad boy so I can get Auth working with Astro 🙏

Same!

[Dezaku]

We need an update asap!!

[Ayfri]

Any update ?

[brunocascio]

Really looking for this to be merged <3

[nathandaly]

I'm using this for commercial purposes but let's get this officially supported. Astro is huge.

[DarioPanada]

Hello, any updates on this? :)

[Gradlon]

Would be really could to get this merged!

[podbasico]

Hello, any update on this PR?

[blainehill2001]

+1 for Astro with Auth!!

[ndom91]

@TheOtterlord can you take a look at the merge conflicts? Thanks!

[Dezaku]

any news? Hopefully not ded

[TheOtterlord]

@ndom91 this PR fell behind both auth-astro and this repo, so I've re-implemented using the latest version of @auth/core and the docs in a new PR: #9856

Hope to continue the conversation over there! Excited to pick this up again! (and while everyone is waiting, auth-astro is the unofficial astro package to try in the meantime!)