added fully working astro example

examples/astro/.gitignore

@@ -0,0 +1,24 @@
+# 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
+
+# jetbrains setting folder
+.idea/

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).

examples/astro/astro.config.mjs

@@ -0,0 +1,10 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+
+import react from "@astrojs/react";
+
+// https://astro.build/config
+export default defineConfig({
+   output: "hybrid",
+   integrations: [react()]
+});

examples/astro/package.json

@@ -0,0 +1,23 @@
+{
+  "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.9.4",
+    "@astrojs/react": "^3.6.3",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "astro": "^4.16.16",
+    "bknd": "workspace:*",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^5.7.2"
+  }
+}

examples/astro/public/favicon.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 128 128">
+    <path d="M50.4 78.5a75.1 75.1 0 0 0-28.5 6.9l24.2-65.7c.7-2 1.9-3.2 3.4-3.2h29c1.5 0 2.7 1.2 3.4 3.2l24.2 65.7s-11.6-7-28.5-7L67 45.5c-.4-1.7-1.6-2.8-2.9-2.8-1.3 0-2.5 1.1-2.9 2.7L50.4 78.5Zm-1.1 28.2Zm-4.2-20.2c-2 6.6-.6 15.8 4.2 20.2a17.5 17.5 0 0 1 .2-.7 5.5 5.5 0 0 1 5.7-4.5c2.8.1 4.3 1.5 4.7 4.7.2 1.1.2 2.3.2 3.5v.4c0 2.7.7 5.2 2.2 7.4a13 13 0 0 0 5.7 4.9v-.3l-.2-.3c-1.8-5.6-.5-9.5 4.4-12.8l1.5-1a73 73 0 0 0 3.2-2.2 16 16 0 0 0 6.8-11.4c.3-2 .1-4-.6-6l-.8.6-1.6 1a37 37 0 0 1-22.4 2.7c-5-.7-9.7-2-13.2-6.2Z" />
+    <style>
+        path { fill: #000; }
+        @media (prefers-color-scheme: dark) {
+            path { fill: #FFF; }
+        }
+    </style>
+</svg>

examples/astro/src/env.d.ts

@@ -0,0 +1 @@
+/// <reference path="../.astro/types.d.ts" />

examples/astro/src/pages/admin/[...admin].astro

@@ -0,0 +1,18 @@
+---
+import { Api } from "bknd";
+import { Admin } from "bknd/ui";
+import "bknd/dist/styles.css";
+
+export const prerender = false;
+const api = new Api({
+   host: new URL(Astro.request.url).origin,
+   headers: Astro.request.headers
+});
+const user = api.getUser();
+---
+
+<html>
+   <body>
+      <Admin withProvider={{ user }} client:load />
+   </body>
+</html>

examples/astro/src/pages/api/[...api].ts

@@ -0,0 +1,18 @@
+import type { APIRoute } from "astro";
+import { App } from "bknd";
+
+export const prerender = false;
+
+export const ALL: APIRoute = async ({ request }) => {
+   const app = App.create({
+      connection: {
+         type: "libsql",
+         config: {
+            url: "http://127.0.0.1:8080"
+         }
+      }
+   });
+
+   await app.build();
+   return app.fetch(request);
+};

examples/astro/src/pages/index.astro

@@ -0,0 +1,16 @@
+---
+import { Api } from "bknd";
+const api = new Api({
+   host: new URL(Astro.request.url).origin
+});
+const { data } = await api.data.readMany("todos");
+---
+
+
+<h1>Home (static)</h1>
+<h2>Data</h2>
+<pre>{JSON.stringify(data, null, 2)}</pre>
+
+<a href="/admin">Admin</a> -
+<a href="/ssr">SSR (with auth)</a> -
+<a href="/">Home (static)</a>

examples/astro/src/pages/ssr.astro

@@ -0,0 +1,23 @@
+---
+import { Api } from "bknd";
+const api = new Api({
+   host: new URL(Astro.request.url).origin,
+   headers: Astro.request.headers
+});
+const { data } = await api.data.readMany("todos");
+const user = api.getUser();
+console.log("user", user);
+
+export const prerender = false;
+---
+
+<h1>SSR</h1>
+<h2>Data</h1>
+<pre>{JSON.stringify(data, null, 2)}</pre>
+
+<h2>User</h1>
+<pre>{JSON.stringify(user, null, 2)}</pre>
+
+<a href="/admin">Admin</a> -
+<a href="/ssr">SSR (with auth)</a> -
+<a href="/">Home (static)</a>

examples/astro/tsconfig.json

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