feat: add @auth/astro framework library

.github/pr-labeler.yml

@@ -1,4 +1,5 @@
 # https://github.com/actions/labeler#create-githublabeleryml
+astro: ["packages/frameworks-astro/**/*"]
 adapters: ["packages/core/src/adapters.ts", "packages/adapter-*/**/*"]
 core: ["packages/core/src/**/*"]
 azure-tables: ["packages/adapter-azure-tables/**/*"]

.gitignore

@@ -103,6 +103,8 @@ docs/docs/reference/sveltekit
 # SolidStart
 docs/docs/reference/solidstart
 
+# Astro
+docs/docs/reference/astro
 
 # Express
 docs/docs/reference/express

apps/dev/astro/.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

apps/dev/astro/.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

apps/dev/astro/.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

apps/dev/astro/README.md

@@ -0,0 +1,47 @@
+# Astro Starter Kit: Minimal
+
+```sh
+npm create astro@latest -- --template minimal
+```
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/minimal)
+[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/astro/tree/latest/examples/minimal)
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/withastro/astro?devcontainer_path=.devcontainer/minimal/devcontainer.json)
+
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+
+## 🚀 Project Structure
+
+Inside of your Astro project, you'll see the following folders and files:
+
+```text
+/
+├── public/
+├── src/
+│   └── pages/
+│       └── index.astro
+└── package.json
+```
+
+Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+
+There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+
+Any static assets, like images, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `npm install`             | Installs dependencies                            |
+| `npm run dev`             | Starts local dev server at `localhost:4321`      |
+| `npm run build`           | Build your production site to `./dist/`          |
+| `npm run preview`         | Preview your build locally, before deploying     |
+| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `npm run astro -- --help` | Get help using the Astro CLI                     |
+
+## 👀 Want to learn more?
+
+Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).

apps/dev/astro/astro.config.mjs

@@ -0,0 +1,13 @@
+import { defineConfig } from 'astro/config';
+import auth from '@auth/astro';
+
+import node from "@astrojs/node";
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [auth()],
+  output: "server",
+  adapter: node({
+    mode: "standalone"
+  })
+});

apps/dev/astro/auth.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from '@auth/astro/config'
+import type { Provider } from '@auth/core/providers'
+import GitHub from '@auth/core/providers/github'
+
+export default defineConfig({
+  providers: [
+    GitHub({
+      clientId: import.meta.env.GITHUB_CLIENT_ID,
+      clientSecret: import.meta.env.GITHUB_CLIENT_SECRET,
+    }) as Provider,
+  ]
+})

apps/dev/astro/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "astro",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro check && astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/check": "^0.4.1",
+    "@astrojs/node": "^8.1.0",
+    "@auth/astro": "workspace:*",
+    "@auth/core": "workspace:*",
+    "astro": "^4.2.5",
+    "typescript": "^5.3.3"
+  }
+}

apps/dev/astro/src/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="astro/client" />

apps/dev/astro/src/pages/index.astro

@@ -0,0 +1,35 @@
+---
+const { session } = Astro.locals
+---
+
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+		<meta name="viewport" content="width=device-width" />
+		<meta name="generator" content={Astro.generator} />
+		<title>Astro</title>
+	</head>
+	<body>
+		<h1>Astro</h1>
+    {
+      session ? (
+        <p>Hi {session?.user?.name}!</p>
+        <button class="signout">Sign out</button>
+      ) : (
+        <button class="signin">Sign in</button>
+      )
+    }
+
+    <p>
+      <a href="/protected">Go to protected page</a>
+    </p>
+
+    <script>
+      import { signIn, signOut } from '@auth/astro/client'
+
+      document.querySelector('.signin')?.addEventListener('click', () => signIn('github'))
+      document.querySelector('.signout')?.addEventListener('click', () => signOut())
+    </script>
+	</body>
+</html>

apps/dev/astro/src/pages/protected.astro

@@ -0,0 +1,41 @@
+---
+const { session } = Astro.locals
+---
+
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+		<meta name="viewport" content="width=device-width" />
+		<meta name="generator" content={Astro.generator} />
+		<title>Astro</title>
+	</head>
+	<body>
+    {
+      session ? (
+        <h1>Protected page</h1>
+        <p>
+          This is a protected content. You can access this content because you are signed in.
+        </p>
+        <p>
+          <a href="/">Go to home</a>
+        </p>
+      ) : (
+        <h1>Access Denied</h1>
+        <p>
+          <a href="/api/auth/signin">You must be signed in to view this page</a>
+        </p>
+        <p>
+          <a href="/">Go to home</a>
+        </p>
+      )
+    }
+
+    <script>
+      import { signIn, signOut } from '@auth/astro/client'
+
+      document.querySelector('.signin')?.addEventListener('click', () => signIn('github'))
+      document.querySelector('.signout')?.addEventListener('click', () => signOut())
+    </script>
+	</body>
+</html>

apps/dev/astro/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "astro/tsconfigs/strict"
+}

apps/examples/astro/.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

apps/examples/astro/.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

apps/examples/astro/.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

apps/examples/astro/README.md

@@ -0,0 +1,47 @@
+# Astro Starter Kit: Minimal
+
+```sh
+npm create astro@latest -- --template minimal
+```
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/minimal)
+[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/astro/tree/latest/examples/minimal)
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/withastro/astro?devcontainer_path=.devcontainer/minimal/devcontainer.json)
+
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+
+## 🚀 Project Structure
+
+Inside of your Astro project, you'll see the following folders and files:
+
+```text
+/
+├── public/
+├── src/
+│   └── pages/
+│       └── index.astro
+└── package.json
+```
+
+Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+
+There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+
+Any static assets, like images, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `npm install`             | Installs dependencies                            |
+| `npm run dev`             | Starts local dev server at `localhost:4321`      |
+| `npm run build`           | Build your production site to `./dist/`          |
+| `npm run preview`         | Preview your build locally, before deploying     |
+| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `npm run astro -- --help` | Get help using the Astro CLI                     |
+
+## 👀 Want to learn more?
+
+Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).

apps/examples/astro/astro.config.mjs

@@ -0,0 +1,13 @@
+import { defineConfig } from 'astro/config';
+import auth from '@auth/astro';
+
+import node from "@astrojs/node";
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [auth()],
+  output: "server",
+  adapter: node({
+    mode: "standalone"
+  })
+});

apps/examples/astro/auth.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from '@auth/astro/config'
+import type { Provider } from '@auth/core/providers'
+import GitHub from '@auth/core/providers/github'
+
+export default defineConfig({
+  providers: [
+    GitHub({
+      clientId: import.meta.env.GITHUB_CLIENT_ID,
+      clientSecret: import.meta.env.GITHUB_CLIENT_SECRET,
+    }) as Provider,
+  ]
+})

apps/examples/astro/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "astro",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro check && astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/check": "^0.4.1",
+    "@astrojs/node": "^8.1.0",
+    "@auth/astro": "^0.1.0",
+    "@auth/core": "^0.24.0",
+    "astro": "^4.2.5",
+    "typescript": "^5.3.3"
+  }
+}

apps/examples/astro/src/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="astro/client" />