spacefn-docs 0.0.0-stage → 0.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +200 -0
- package/README.md +15 -2
- package/assets/reader.css +1131 -0
- package/assets/reader.js +324 -0
- package/content/1-getting-started.md +107 -0
- package/content/2-conventions.md +138 -0
- package/content/3-best-practices.md +68 -0
- package/content/4-folders/1-app/1-entry.md +48 -0
- package/content/4-folders/1-app/2-routes.md +92 -0
- package/content/4-folders/1-app/3-db.md +81 -0
- package/content/4-folders/1-app/4-queues.md +46 -0
- package/content/4-folders/1-app/5-crons.md +30 -0
- package/content/4-folders/1-app/6-assets.md +53 -0
- package/content/4-folders/1-app/7-durable-objects.md +60 -0
- package/content/4-folders/1-app/8-workflows.md +46 -0
- package/content/4-folders/1-app/index.md +43 -0
- package/content/4-folders/2-modules.md +71 -0
- package/content/4-folders/3-lib.md +60 -0
- package/content/4-folders/4-public.md +24 -0
- package/content/4-folders/5-docs.md +23 -0
- package/content/4-folders/6-configs.md +57 -0
- package/content/4-folders/7-space.md +34 -0
- package/content/4-folders/8-env.md +35 -0
- package/content/4-folders/9-package-json.md +37 -0
- package/content/4-folders/index.md +50 -0
- package/content/5-deployment/1-cloudflare.md +70 -0
- package/content/5-deployment/2-bun.md +68 -0
- package/content/5-deployment/3-infrastructure.md +67 -0
- package/content/5-deployment/4-ci-cd.md +179 -0
- package/content/5-deployment/index.md +48 -0
- package/content/6-guides/1-entry.md +113 -0
- package/content/6-guides/2-routes.md +162 -0
- package/content/6-guides/3-pages.md +148 -0
- package/content/6-guides/4-frontend.md +232 -0
- package/content/6-guides/5-database.md +178 -0
- package/content/6-guides/6-services.md +125 -0
- package/content/6-guides/7-jobs.md +61 -0
- package/content/6-guides/8-auth.md +111 -0
- package/content/6-guides/9-testing.md +70 -0
- package/content/6-guides/index.md +21 -0
- package/content/7-reference/1-config.md +67 -0
- package/content/7-reference/2-cli.md +45 -0
- package/content/7-reference/3-writing-docs.md +206 -0
- package/content/7-reference/index.md +15 -0
- package/content/index.md +49 -0
- package/content/logo.svg +12 -0
- package/dist/index.d.mts +72 -0
- package/dist/index.mjs +713 -0
- package/examples/README.md +18 -0
- package/examples/datastar/.env.example +2 -0
- package/examples/datastar/README.md +17 -0
- package/examples/datastar/app/assets/main.ts +4 -0
- package/examples/datastar/app/assets/site.css +3 -0
- package/examples/datastar/app/db/main/config.json +5 -0
- package/examples/datastar/app/db/main/migrations/0001_votes.sql +8 -0
- package/examples/datastar/app/db/main/queries/add-vote.sql +3 -0
- package/examples/datastar/app/db/main/queries/tally.sql +1 -0
- package/examples/datastar/app/entry.ts +28 -0
- package/examples/datastar/app/routes/_middleware.ts +4 -0
- package/examples/datastar/app/routes/health.ts +7 -0
- package/examples/datastar/app/routes/index.ts +43 -0
- package/examples/datastar/configs/env.ts +6 -0
- package/examples/datastar/configs/infra.ts +88 -0
- package/examples/datastar/configs/tsconfig.json +15 -0
- package/examples/datastar/configs/vite.ts +4 -0
- package/examples/datastar/configs/vitest.ts +9 -0
- package/examples/datastar/lib/types/rocket.d.ts +30 -0
- package/examples/datastar/lib/ui/base.css +17 -0
- package/examples/datastar/lib/ui/layout.ts +27 -0
- package/examples/datastar/modules/poll/client/poll-meter.ts +39 -0
- package/examples/datastar/modules/poll/poll.css +13 -0
- package/examples/datastar/modules/poll/poll.test.ts +48 -0
- package/examples/datastar/modules/poll/poll.ts +62 -0
- package/examples/datastar/modules/poll/views.ts +52 -0
- package/examples/datastar/package.json +33 -0
- package/examples/datastar/tsconfig.json +4 -0
- package/examples/lightningcss/.env.example +1 -0
- package/examples/lightningcss/README.md +15 -0
- package/examples/lightningcss/app/assets/site.css +3 -0
- package/examples/lightningcss/app/entry.ts +28 -0
- package/examples/lightningcss/app/routes/_middleware.ts +4 -0
- package/examples/lightningcss/app/routes/health.ts +7 -0
- package/examples/lightningcss/app/routes/index.ts +12 -0
- package/examples/lightningcss/configs/Dockerfile +26 -0
- package/examples/lightningcss/configs/Dockerfile.dockerignore +9 -0
- package/examples/lightningcss/configs/env.ts +4 -0
- package/examples/lightningcss/configs/infra.ts +55 -0
- package/examples/lightningcss/configs/tsconfig.json +15 -0
- package/examples/lightningcss/configs/vite.ts +19 -0
- package/examples/lightningcss/configs/vitest.ts +9 -0
- package/examples/lightningcss/lib/ui/layout.ts +17 -0
- package/examples/lightningcss/lib/ui/tokens.css +23 -0
- package/examples/lightningcss/modules/releases/releases.css +20 -0
- package/examples/lightningcss/modules/releases/releases.test.ts +18 -0
- package/examples/lightningcss/modules/releases/releases.ts +21 -0
- package/examples/lightningcss/modules/releases/views.ts +25 -0
- package/examples/lightningcss/package.json +33 -0
- package/examples/lightningcss/tsconfig.json +4 -0
- package/examples/mini-shopify/.env.example +6 -0
- package/examples/mini-shopify/README.md +19 -0
- package/examples/mini-shopify/app/assets/site.css +2 -0
- package/examples/mini-shopify/app/db/platform/config.json +5 -0
- package/examples/mini-shopify/app/db/platform/migrations/0001_shops.sql +10 -0
- package/examples/mini-shopify/app/db/platform/queries/add-shop.sql +4 -0
- package/examples/mini-shopify/app/db/platform/queries/find-shop.sql +3 -0
- package/examples/mini-shopify/app/db/platform/queries/list-shops.sql +1 -0
- package/examples/mini-shopify/app/db/shop/config.json +6 -0
- package/examples/mini-shopify/app/db/shop/migrations/0001_products.sql +11 -0
- package/examples/mini-shopify/app/db/shop/queries/add-product.sql +4 -0
- package/examples/mini-shopify/app/db/shop/queries/list-products.sql +1 -0
- package/examples/mini-shopify/app/db/shop/queries/sell-product.sql +2 -0
- package/examples/mini-shopify/app/entry.ts +25 -0
- package/examples/mini-shopify/app/routes/_middleware.ts +4 -0
- package/examples/mini-shopify/app/routes/health.ts +7 -0
- package/examples/mini-shopify/app/routes/index.ts +26 -0
- package/examples/mini-shopify/app/routes/s/[shop]/_middleware.ts +6 -0
- package/examples/mini-shopify/app/routes/s/[shop]/index.ts +32 -0
- package/examples/mini-shopify/configs/Dockerfile +26 -0
- package/examples/mini-shopify/configs/Dockerfile.dockerignore +9 -0
- package/examples/mini-shopify/configs/env.ts +14 -0
- package/examples/mini-shopify/configs/infra.ts +55 -0
- package/examples/mini-shopify/configs/tsconfig.json +15 -0
- package/examples/mini-shopify/configs/vite.ts +4 -0
- package/examples/mini-shopify/configs/vitest.ts +9 -0
- package/examples/mini-shopify/lib/ui/base.css +19 -0
- package/examples/mini-shopify/lib/ui/layout.ts +17 -0
- package/examples/mini-shopify/modules/catalog/catalog.ts +31 -0
- package/examples/mini-shopify/modules/catalog/views.ts +39 -0
- package/examples/mini-shopify/modules/shops/host.test.ts +38 -0
- package/examples/mini-shopify/modules/shops/host.ts +73 -0
- package/examples/mini-shopify/modules/shops/shops.test.ts +63 -0
- package/examples/mini-shopify/modules/shops/shops.ts +64 -0
- package/examples/mini-shopify/modules/shops/views.ts +28 -0
- package/examples/mini-shopify/package.json +35 -0
- package/examples/mini-shopify/tsconfig.json +4 -0
- package/examples/react/.env.example +2 -0
- package/examples/react/README.md +18 -0
- package/examples/react/app/assets/site.css +3 -0
- package/examples/react/app/entry.ts +28 -0
- package/examples/react/app/routes/_middleware.ts +4 -0
- package/examples/react/app/routes/about.ts +10 -0
- package/examples/react/app/routes/health.ts +7 -0
- package/examples/react/app/routes/index.ts +12 -0
- package/examples/react/configs/Dockerfile +26 -0
- package/examples/react/configs/Dockerfile.dockerignore +9 -0
- package/examples/react/configs/env.ts +6 -0
- package/examples/react/configs/infra.ts +55 -0
- package/examples/react/configs/tsconfig.json +16 -0
- package/examples/react/configs/vite.ts +7 -0
- package/examples/react/configs/vitest.ts +9 -0
- package/examples/react/lib/ui/base.css +12 -0
- package/examples/react/lib/ui/layout.ts +18 -0
- package/examples/react/modules/about/views.ts +8 -0
- package/examples/react/modules/shop/products.ts +18 -0
- package/examples/react/modules/shop/shop.css +13 -0
- package/examples/react/modules/shop/shop.test.ts +28 -0
- package/examples/react/modules/shop/shop.ts +13 -0
- package/examples/react/modules/shop/ui/Cart.island.tsx +31 -0
- package/examples/react/modules/shop/views.ts +16 -0
- package/examples/react/package.json +38 -0
- package/examples/react/tsconfig.json +4 -0
- package/examples/services-bun/README.md +10 -0
- package/examples/services-bun/app/assets/main.ts +4 -0
- package/examples/services-bun/app/assets/style.css +1 -0
- package/examples/services-bun/app/crons/nightly.ts +5 -0
- package/examples/services-bun/app/entry.ts +9 -0
- package/examples/services-bun/app/queues/jobs.ts +5 -0
- package/examples/services-bun/app/routes/index.ts +10 -0
- package/examples/services-bun/app/routes/runtime.ts +5 -0
- package/examples/services-bun/app/routes/send.ts +8 -0
- package/examples/services-bun/app/routes/version.ts +5 -0
- package/examples/services-bun/configs/Dockerfile +10 -0
- package/examples/services-bun/configs/Dockerfile.dockerignore +4 -0
- package/examples/services-bun/configs/infra.ts +28 -0
- package/examples/services-bun/configs/tsconfig.json +15 -0
- package/examples/services-bun/configs/vite.ts +4 -0
- package/examples/services-bun/lib/ui/base.css +3 -0
- package/examples/services-bun/lib/ui/layout.ts +13 -0
- package/examples/services-bun/modules/status/client/ready.ts +4 -0
- package/examples/services-bun/modules/status/status.ts +20 -0
- package/examples/services-bun/modules/status/views.ts +4 -0
- package/examples/services-bun/package.json +30 -0
- package/examples/services-bun/public/robots.txt +1 -0
- package/examples/services-bun/tsconfig.json +4 -0
- package/examples/services-cloudflare/README.md +9 -0
- package/examples/services-cloudflare/app/assets/main.ts +4 -0
- package/examples/services-cloudflare/app/crons/nightly.ts +5 -0
- package/examples/services-cloudflare/app/db/main/config.json +4 -0
- package/examples/services-cloudflare/app/db/main/migrations/0001_notes.sql +2 -0
- package/examples/services-cloudflare/app/db/main/queries/add-note.sql +1 -0
- package/examples/services-cloudflare/app/db/main/queries/count-notes.sql +3 -0
- package/examples/services-cloudflare/app/entry.ts +10 -0
- package/examples/services-cloudflare/app/queues/jobs.ts +5 -0
- package/examples/services-cloudflare/app/routes/files.ts +5 -0
- package/examples/services-cloudflare/app/routes/index.ts +10 -0
- package/examples/services-cloudflare/app/routes/limited.ts +7 -0
- package/examples/services-cloudflare/app/routes/send.ts +8 -0
- package/examples/services-cloudflare/configs/env.ts +3 -0
- package/examples/services-cloudflare/configs/infra.ts +88 -0
- package/examples/services-cloudflare/configs/tsconfig.json +15 -0
- package/examples/services-cloudflare/configs/vite.ts +4 -0
- package/examples/services-cloudflare/lib/ui/layout.ts +12 -0
- package/examples/services-cloudflare/modules/files/files.ts +9 -0
- package/examples/services-cloudflare/modules/status/client/ready.ts +4 -0
- package/examples/services-cloudflare/modules/status/status.ts +27 -0
- package/examples/services-cloudflare/modules/status/views.ts +8 -0
- package/examples/services-cloudflare/package.json +30 -0
- package/examples/services-cloudflare/public/robots.txt +1 -0
- package/examples/services-cloudflare/tsconfig.json +4 -0
- package/examples/solid/.env.example +2 -0
- package/examples/solid/README.md +18 -0
- package/examples/solid/app/assets/site.css +3 -0
- package/examples/solid/app/entry.ts +28 -0
- package/examples/solid/app/routes/_middleware.ts +4 -0
- package/examples/solid/app/routes/about.ts +10 -0
- package/examples/solid/app/routes/health.ts +7 -0
- package/examples/solid/app/routes/index.ts +12 -0
- package/examples/solid/configs/Dockerfile +26 -0
- package/examples/solid/configs/Dockerfile.dockerignore +9 -0
- package/examples/solid/configs/env.ts +6 -0
- package/examples/solid/configs/infra.ts +55 -0
- package/examples/solid/configs/tsconfig.json +17 -0
- package/examples/solid/configs/vite.ts +7 -0
- package/examples/solid/configs/vitest.ts +12 -0
- package/examples/solid/lib/ui/base.css +12 -0
- package/examples/solid/lib/ui/layout.ts +18 -0
- package/examples/solid/modules/about/views.ts +8 -0
- package/examples/solid/modules/shop/products.ts +18 -0
- package/examples/solid/modules/shop/shop.css +13 -0
- package/examples/solid/modules/shop/shop.test.ts +28 -0
- package/examples/solid/modules/shop/shop.ts +13 -0
- package/examples/solid/modules/shop/ui/Cart.island.tsx +31 -0
- package/examples/solid/modules/shop/views.ts +16 -0
- package/examples/solid/package.json +35 -0
- package/examples/solid/tsconfig.json +4 -0
- package/examples/starter-bun/.env.example +2 -0
- package/examples/starter-bun/AGENTS.md +9 -0
- package/examples/starter-bun/README.md +47 -0
- package/examples/starter-bun/app/assets/site.css +3 -0
- package/examples/starter-bun/app/db/main/config.json +5 -0
- package/examples/starter-bun/app/db/main/migrations/0001_todos.sql +9 -0
- package/examples/starter-bun/app/db/main/queries/add-todo.sql +2 -0
- package/examples/starter-bun/app/db/main/queries/list-todos.sql +2 -0
- package/examples/starter-bun/app/db/main/queries/toggle-todo.sql +2 -0
- package/examples/starter-bun/app/entry.ts +28 -0
- package/examples/starter-bun/app/routes/_middleware.ts +4 -0
- package/examples/starter-bun/app/routes/health.ts +7 -0
- package/examples/starter-bun/app/routes/index.ts +44 -0
- package/examples/starter-bun/configs/Dockerfile +26 -0
- package/examples/starter-bun/configs/Dockerfile.dockerignore +9 -0
- package/examples/starter-bun/configs/env.ts +6 -0
- package/examples/starter-bun/configs/infra.ts +55 -0
- package/examples/starter-bun/configs/tsconfig.json +15 -0
- package/examples/starter-bun/configs/vite.ts +4 -0
- package/examples/starter-bun/configs/vitest.ts +9 -0
- package/examples/starter-bun/docs/index.md +5 -0
- package/examples/starter-bun/lib/ui/base.css +17 -0
- package/examples/starter-bun/lib/ui/layout.ts +22 -0
- package/examples/starter-bun/modules/todos/todos.css +16 -0
- package/examples/starter-bun/modules/todos/todos.test.ts +33 -0
- package/examples/starter-bun/modules/todos/todos.ts +31 -0
- package/examples/starter-bun/modules/todos/views.ts +38 -0
- package/examples/starter-bun/package.json +32 -0
- package/examples/starter-bun/public/favicon.svg +1 -0
- package/examples/starter-bun/tsconfig.json +4 -0
- package/examples/starter-cloudflare/.env.example +2 -0
- package/examples/starter-cloudflare/AGENTS.md +9 -0
- package/examples/starter-cloudflare/README.md +47 -0
- package/examples/starter-cloudflare/app/assets/site.css +3 -0
- package/examples/starter-cloudflare/app/db/main/config.json +5 -0
- package/examples/starter-cloudflare/app/db/main/migrations/0001_todos.sql +9 -0
- package/examples/starter-cloudflare/app/db/main/queries/add-todo.sql +2 -0
- package/examples/starter-cloudflare/app/db/main/queries/list-todos.sql +2 -0
- package/examples/starter-cloudflare/app/db/main/queries/toggle-todo.sql +2 -0
- package/examples/starter-cloudflare/app/entry.ts +28 -0
- package/examples/starter-cloudflare/app/routes/_middleware.ts +4 -0
- package/examples/starter-cloudflare/app/routes/health.ts +7 -0
- package/examples/starter-cloudflare/app/routes/index.ts +44 -0
- package/examples/starter-cloudflare/configs/env.ts +6 -0
- package/examples/starter-cloudflare/configs/infra.ts +88 -0
- package/examples/starter-cloudflare/configs/tsconfig.json +15 -0
- package/examples/starter-cloudflare/configs/vite.ts +4 -0
- package/examples/starter-cloudflare/configs/vitest.ts +9 -0
- package/examples/starter-cloudflare/docs/index.md +5 -0
- package/examples/starter-cloudflare/lib/ui/base.css +17 -0
- package/examples/starter-cloudflare/lib/ui/layout.ts +22 -0
- package/examples/starter-cloudflare/modules/todos/todos.css +16 -0
- package/examples/starter-cloudflare/modules/todos/todos.test.ts +33 -0
- package/examples/starter-cloudflare/modules/todos/todos.ts +31 -0
- package/examples/starter-cloudflare/modules/todos/views.ts +38 -0
- package/examples/starter-cloudflare/package.json +35 -0
- package/examples/starter-cloudflare/public/favicon.svg +1 -0
- package/examples/starter-cloudflare/tsconfig.json +4 -0
- package/examples/svelte/.env.example +2 -0
- package/examples/svelte/README.md +18 -0
- package/examples/svelte/app/assets/site.css +3 -0
- package/examples/svelte/app/entry.ts +28 -0
- package/examples/svelte/app/routes/_middleware.ts +4 -0
- package/examples/svelte/app/routes/about.ts +10 -0
- package/examples/svelte/app/routes/health.ts +7 -0
- package/examples/svelte/app/routes/index.ts +12 -0
- package/examples/svelte/configs/env.ts +6 -0
- package/examples/svelte/configs/infra.ts +88 -0
- package/examples/svelte/configs/tsconfig.json +15 -0
- package/examples/svelte/configs/vite.ts +9 -0
- package/examples/svelte/configs/vitest.ts +9 -0
- package/examples/svelte/lib/types/svelte.d.ts +8 -0
- package/examples/svelte/lib/ui/base.css +12 -0
- package/examples/svelte/lib/ui/layout.ts +18 -0
- package/examples/svelte/modules/about/views.ts +8 -0
- package/examples/svelte/modules/shop/products.ts +18 -0
- package/examples/svelte/modules/shop/shop.css +13 -0
- package/examples/svelte/modules/shop/shop.test.ts +28 -0
- package/examples/svelte/modules/shop/shop.ts +13 -0
- package/examples/svelte/modules/shop/ui/Cart.island.svelte +23 -0
- package/examples/svelte/modules/shop/views.ts +16 -0
- package/examples/svelte/package.json +35 -0
- package/examples/svelte/tsconfig.json +4 -0
- package/examples/tailwind/.env.example +2 -0
- package/examples/tailwind/README.md +16 -0
- package/examples/tailwind/app/assets/site.css +2 -0
- package/examples/tailwind/app/entry.ts +28 -0
- package/examples/tailwind/app/routes/_middleware.ts +4 -0
- package/examples/tailwind/app/routes/health.ts +7 -0
- package/examples/tailwind/app/routes/index.ts +30 -0
- package/examples/tailwind/configs/Dockerfile +26 -0
- package/examples/tailwind/configs/Dockerfile.dockerignore +9 -0
- package/examples/tailwind/configs/env.ts +6 -0
- package/examples/tailwind/configs/infra.ts +55 -0
- package/examples/tailwind/configs/tsconfig.json +15 -0
- package/examples/tailwind/configs/vite.ts +7 -0
- package/examples/tailwind/configs/vitest.ts +9 -0
- package/examples/tailwind/lib/ui/components.ts +21 -0
- package/examples/tailwind/lib/ui/layout.ts +21 -0
- package/examples/tailwind/lib/ui/theme.css +10 -0
- package/examples/tailwind/modules/team/team.test.ts +30 -0
- package/examples/tailwind/modules/team/team.ts +34 -0
- package/examples/tailwind/modules/team/views.ts +45 -0
- package/examples/tailwind/package.json +35 -0
- package/examples/tailwind/tsconfig.json +4 -0
- package/examples/vue/.env.example +2 -0
- package/examples/vue/README.md +18 -0
- package/examples/vue/app/assets/site.css +3 -0
- package/examples/vue/app/entry.ts +28 -0
- package/examples/vue/app/routes/_middleware.ts +4 -0
- package/examples/vue/app/routes/about.ts +10 -0
- package/examples/vue/app/routes/health.ts +7 -0
- package/examples/vue/app/routes/index.ts +12 -0
- package/examples/vue/configs/env.ts +6 -0
- package/examples/vue/configs/infra.ts +88 -0
- package/examples/vue/configs/tsconfig.json +15 -0
- package/examples/vue/configs/vite.ts +7 -0
- package/examples/vue/configs/vitest.ts +9 -0
- package/examples/vue/lib/types/vue.d.ts +8 -0
- package/examples/vue/lib/ui/base.css +12 -0
- package/examples/vue/lib/ui/layout.ts +18 -0
- package/examples/vue/modules/about/views.ts +8 -0
- package/examples/vue/modules/shop/products.ts +18 -0
- package/examples/vue/modules/shop/shop.css +13 -0
- package/examples/vue/modules/shop/shop.test.ts +28 -0
- package/examples/vue/modules/shop/shop.ts +13 -0
- package/examples/vue/modules/shop/ui/Cart.island.vue +27 -0
- package/examples/vue/modules/shop/views.ts +16 -0
- package/examples/vue/package.json +35 -0
- package/examples/vue/tsconfig.json +4 -0
- package/package.json +44 -3
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
// The app's infrastructure: a plain Alchemy stack. `space deploy` runs `alchemy deploy configs/infra.ts`.
|
|
2
|
+
import * as Docker from "@alchemy.run/docker";
|
|
3
|
+
import * as Alchemy from "alchemy";
|
|
4
|
+
import { Effect } from "effect";
|
|
5
|
+
import { variables } from "spacefn/infra";
|
|
6
|
+
|
|
7
|
+
import env from "#configs/env.ts";
|
|
8
|
+
// What the file conventions ask for (databases, ...), as plain data from app/.
|
|
9
|
+
import { app } from "#space/infra.ts";
|
|
10
|
+
|
|
11
|
+
export default Alchemy.Stack(
|
|
12
|
+
app.name,
|
|
13
|
+
{
|
|
14
|
+
providers: Docker.providers(),
|
|
15
|
+
// Deploy state on this machine, in .alchemy/. To deploy from CI or several machines, keep it in
|
|
16
|
+
// a shared store instead, such as Cloudflare.state() from @alchemy.run/cloudflare.
|
|
17
|
+
state: Alchemy.localState(),
|
|
18
|
+
},
|
|
19
|
+
Effect.gen(function* () {
|
|
20
|
+
const environment: Record<string, any> = {
|
|
21
|
+
// configs/env.ts's variables, from .env.<stage> or the environment.
|
|
22
|
+
...variables(env),
|
|
23
|
+
...variables({ OTEL_EXPORTER_OTLP_ENDPOINT: "plain", OTEL_EXPORTER_OTLP_HEADERS: "secret" }),
|
|
24
|
+
};
|
|
25
|
+
// app/db/<name>/: a libSQL server reads DB_<NAME>_URL and DB_<NAME>_AUTH_TOKEN; without them, a file in /data.
|
|
26
|
+
for (const db of app.databases)
|
|
27
|
+
Object.assign(
|
|
28
|
+
environment,
|
|
29
|
+
variables({ [`${db.binding}_URL`]: "plain", [`${db.binding}_AUTH_TOKEN`]: "secret" }),
|
|
30
|
+
);
|
|
31
|
+
|
|
32
|
+
// To run it all on another machine, add `context` to each resource below:
|
|
33
|
+
// const context = yield* Docker.Context("Host", { docker: "host=ssh://deploy@example.com" });
|
|
34
|
+
const image = yield* Docker.Image("Image", {
|
|
35
|
+
name: app.name,
|
|
36
|
+
skipPush: true,
|
|
37
|
+
// Built from the source by configs/Dockerfile, which runs vite build.
|
|
38
|
+
build: { context: ".", dockerfile: "configs/Dockerfile" },
|
|
39
|
+
});
|
|
40
|
+
// File databases, the state database and blobs.
|
|
41
|
+
const data = yield* Docker.Volume("Data");
|
|
42
|
+
const port = 3000;
|
|
43
|
+
yield* Docker.Container("App", {
|
|
44
|
+
image,
|
|
45
|
+
start: true,
|
|
46
|
+
restart: "unless-stopped",
|
|
47
|
+
ports: [{ external: port, internal: 3000 }],
|
|
48
|
+
volumes: [{ hostPath: data.name, containerPath: "/data" }],
|
|
49
|
+
environment,
|
|
50
|
+
// SIGTERM lets requests finish and hands queue messages back.
|
|
51
|
+
stopTimeout: "30 seconds",
|
|
52
|
+
});
|
|
53
|
+
return { url: `http://localhost:${port}` };
|
|
54
|
+
}),
|
|
55
|
+
);
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "ES2022",
|
|
4
|
+
"lib": ["ES2022", "ESNext.Disposable", "DOM", "DOM.Iterable"],
|
|
5
|
+
"module": "preserve",
|
|
6
|
+
"moduleResolution": "bundler",
|
|
7
|
+
"allowImportingTsExtensions": true,
|
|
8
|
+
"verbatimModuleSyntax": true,
|
|
9
|
+
"strict": true,
|
|
10
|
+
"noEmit": true,
|
|
11
|
+
"skipLibCheck": true,
|
|
12
|
+
"types": ["bun"]
|
|
13
|
+
},
|
|
14
|
+
"include": ["../app", "../lib", "../modules", "../configs"]
|
|
15
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { defineConfig, mergeConfig } from "vitest/config";
|
|
2
|
+
|
|
3
|
+
import vite from "./vite.ts";
|
|
4
|
+
|
|
5
|
+
// The app's Vite config, so tests get the spacefn plugin (and spacefn/assets) too.
|
|
6
|
+
export default mergeConfig(
|
|
7
|
+
vite,
|
|
8
|
+
defineConfig({ test: { include: ["{app,lib,modules}/**/*.test.ts"] } }),
|
|
9
|
+
);
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/* The base styles every page shares. */
|
|
2
|
+
:root {
|
|
3
|
+
--space: 0.5rem;
|
|
4
|
+
color-scheme: light dark;
|
|
5
|
+
font-family: system-ui, sans-serif;
|
|
6
|
+
}
|
|
7
|
+
body {
|
|
8
|
+
max-width: 40rem;
|
|
9
|
+
margin: calc(var(--space) * 6) auto;
|
|
10
|
+
padding: 0 calc(var(--space) * 2);
|
|
11
|
+
line-height: 1.5;
|
|
12
|
+
}
|
|
13
|
+
form {
|
|
14
|
+
display: flex;
|
|
15
|
+
gap: var(--space);
|
|
16
|
+
}
|
|
17
|
+
td {
|
|
18
|
+
padding-right: calc(var(--space) * 2);
|
|
19
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { html, type HtmlValue } from "spacefn";
|
|
2
|
+
import { assets } from "spacefn/assets";
|
|
3
|
+
|
|
4
|
+
/** The HTML around every page: its title and the site's styles. */
|
|
5
|
+
export const layout = (title: string, body: HtmlValue) =>
|
|
6
|
+
html`<!doctype html>
|
|
7
|
+
<html lang="en">
|
|
8
|
+
<head>
|
|
9
|
+
<meta charset="utf-8" />
|
|
10
|
+
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
11
|
+
<title>${title}</title>
|
|
12
|
+
${assets("site")}
|
|
13
|
+
</head>
|
|
14
|
+
<body>
|
|
15
|
+
${body}
|
|
16
|
+
</body>
|
|
17
|
+
</html>`;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { Schema } from "effect";
|
|
2
|
+
|
|
3
|
+
import ShopDb, { type ListProductsRow } from "#space/db/shop.ts";
|
|
4
|
+
|
|
5
|
+
// Runs on the current shop's database: the request's ShopDb, which the
|
|
6
|
+
// middleware of /s/:shop/ provides.
|
|
7
|
+
|
|
8
|
+
export type Product = ListProductsRow;
|
|
9
|
+
|
|
10
|
+
export const NewProduct = Schema.Struct({
|
|
11
|
+
name: Schema.NonEmptyString,
|
|
12
|
+
/** In dollars, as the form sends it. */
|
|
13
|
+
price: Schema.FiniteFromString,
|
|
14
|
+
stock: Schema.FiniteFromString,
|
|
15
|
+
});
|
|
16
|
+
|
|
17
|
+
export const ProductRef = Schema.Struct({ id: Schema.FiniteFromString });
|
|
18
|
+
|
|
19
|
+
export const products = ShopDb.listProducts();
|
|
20
|
+
|
|
21
|
+
export const add = ({ name, price, stock }: typeof NewProduct.Type) =>
|
|
22
|
+
ShopDb.addProduct({
|
|
23
|
+
name,
|
|
24
|
+
price: Math.round(price * 100),
|
|
25
|
+
stock: Math.max(0, Math.trunc(stock)),
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
/** One sold: one fewer in stock, if there's one left. */
|
|
29
|
+
export const sell = ({ id }: typeof ProductRef.Type) => ShopDb.sellProduct({ id });
|
|
30
|
+
|
|
31
|
+
export const formatPrice = (cents: number) => `$${(cents / 100).toFixed(2)}`;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { html } from "spacefn";
|
|
2
|
+
|
|
3
|
+
import { formatPrice, type Product } from "./catalog.ts";
|
|
4
|
+
|
|
5
|
+
/** A shop's storefront: its products, each with a button to sell one, and a form to add one. */
|
|
6
|
+
export const storefront = (props: {
|
|
7
|
+
readonly name: string;
|
|
8
|
+
readonly products: readonly Product[];
|
|
9
|
+
readonly add: string;
|
|
10
|
+
readonly sell: string;
|
|
11
|
+
}) =>
|
|
12
|
+
html`<main>
|
|
13
|
+
<p><a href="/">All shops</a></p>
|
|
14
|
+
<h1>${props.name}</h1>
|
|
15
|
+
<table>
|
|
16
|
+
<tbody>
|
|
17
|
+
${props.products.map(
|
|
18
|
+
(product) =>
|
|
19
|
+
html`<tr>
|
|
20
|
+
<td>${product.name}</td>
|
|
21
|
+
<td>${formatPrice(product.price)}</td>
|
|
22
|
+
<td>${product.stock} left</td>
|
|
23
|
+
<td>
|
|
24
|
+
<form method="post" action="${props.sell}">
|
|
25
|
+
<input type="hidden" name="id" value="${product.id}" />
|
|
26
|
+
<button ${product.stock === 0 ? "disabled" : ""}>Sell one</button>
|
|
27
|
+
</form>
|
|
28
|
+
</td>
|
|
29
|
+
</tr>`,
|
|
30
|
+
)}
|
|
31
|
+
</tbody>
|
|
32
|
+
</table>
|
|
33
|
+
<form method="post" action="${props.add}">
|
|
34
|
+
<input name="name" placeholder="Product" required />
|
|
35
|
+
<input name="price" placeholder="Price" inputmode="decimal" required />
|
|
36
|
+
<input name="stock" placeholder="Stock" inputmode="numeric" value="1" />
|
|
37
|
+
<button>Add</button>
|
|
38
|
+
</form>
|
|
39
|
+
</main>`;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { Effect, Redacted } from "effect";
|
|
2
|
+
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
3
|
+
|
|
4
|
+
import { DatabaseHost, tursoHost } from "./host.ts";
|
|
5
|
+
|
|
6
|
+
const host = tursoHost({
|
|
7
|
+
org: "acme-org",
|
|
8
|
+
apiToken: Redacted.make("api-token"),
|
|
9
|
+
group: "shops",
|
|
10
|
+
groupToken: Redacted.make("group-token"),
|
|
11
|
+
});
|
|
12
|
+
|
|
13
|
+
const create = (name: string) =>
|
|
14
|
+
Effect.runPromise(DatabaseHost.use((h) => h.create(name)).pipe(Effect.provide(host)));
|
|
15
|
+
|
|
16
|
+
afterEach(() => vi.unstubAllGlobals());
|
|
17
|
+
|
|
18
|
+
// The Platform API, answered here: the test checks the request, not Turso.
|
|
19
|
+
describe("the Turso host", () => {
|
|
20
|
+
it("creates the database in the group, and gives its libsql:// URL", async () => {
|
|
21
|
+
const fetch = vi.fn(async (_url: URL, _init: RequestInit) =>
|
|
22
|
+
Response.json({
|
|
23
|
+
database: { DbId: "1", Name: "shop-acme", Hostname: "shop-acme-org.turso.io" },
|
|
24
|
+
}),
|
|
25
|
+
);
|
|
26
|
+
vi.stubGlobal("fetch", fetch);
|
|
27
|
+
expect(await create("shop-acme")).toBe("libsql://shop-acme-org.turso.io");
|
|
28
|
+
const [url, init] = fetch.mock.calls[0]!;
|
|
29
|
+
expect(String(url)).toBe("https://api.turso.tech/v1/organizations/acme-org/databases");
|
|
30
|
+
expect(new Headers(init.headers).get("authorization")).toBe("Bearer api-token");
|
|
31
|
+
expect(JSON.parse(init.body as string)).toEqual({ name: "shop-acme", group: "shops" });
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
it("fails with HostError when Turso refuses", async () => {
|
|
35
|
+
vi.stubGlobal("fetch", async () => Response.json({ error: "taken" }, { status: 409 }));
|
|
36
|
+
await expect(create("shop-acme")).rejects.toMatchObject({ _tag: "HostError" });
|
|
37
|
+
});
|
|
38
|
+
});
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { createClient } from "@tursodatabase/api";
|
|
2
|
+
import { Context, Data, Effect, Layer, Redacted, type Scope } from "effect";
|
|
3
|
+
import { dataDir, libsqlDatabase } from "spacefn/bun";
|
|
4
|
+
import { libsql, type DbConnection } from "spacefn/libsql";
|
|
5
|
+
|
|
6
|
+
import Env from "#configs/env.ts";
|
|
7
|
+
|
|
8
|
+
export class HostError extends Data.TaggedError("HostError")<{
|
|
9
|
+
readonly message: string;
|
|
10
|
+
readonly cause: unknown;
|
|
11
|
+
}> {}
|
|
12
|
+
|
|
13
|
+
/** Where the shops' databases live: Turso, or local files. */
|
|
14
|
+
export class DatabaseHost extends Context.Service<
|
|
15
|
+
DatabaseHost,
|
|
16
|
+
{
|
|
17
|
+
/** Creates the database `name`, and gives its URL. */
|
|
18
|
+
readonly create: (name: string) => Effect.Effect<string, HostError>;
|
|
19
|
+
/** Opens the database at `url`, until the scope closes. */
|
|
20
|
+
readonly open: (url: string) => Effect.Effect<DbConnection, unknown, Scope.Scope>;
|
|
21
|
+
}
|
|
22
|
+
>()("mini-shopify/DatabaseHost") {}
|
|
23
|
+
|
|
24
|
+
/** Each database a file in `dir`, opened with the native libSQL client (Bun and Node only). */
|
|
25
|
+
export const localHost = (dir: string) =>
|
|
26
|
+
Layer.succeed(DatabaseHost)({
|
|
27
|
+
create: (name) => Effect.succeed(`file:${dir}/${name}.db`),
|
|
28
|
+
open: (url) => libsqlDatabase({ url }),
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Each database created in a Turso group with the Platform API, and opened
|
|
33
|
+
* with the group's token: one token for every shop, so the platform database
|
|
34
|
+
* stores no secrets.
|
|
35
|
+
*/
|
|
36
|
+
export const tursoHost = (options: {
|
|
37
|
+
readonly org: string;
|
|
38
|
+
readonly apiToken: Redacted.Redacted<string>;
|
|
39
|
+
readonly group: string;
|
|
40
|
+
readonly groupToken: Redacted.Redacted<string>;
|
|
41
|
+
}) => {
|
|
42
|
+
const turso = createClient({
|
|
43
|
+
org: options.org,
|
|
44
|
+
token: async () => Redacted.value(options.apiToken),
|
|
45
|
+
});
|
|
46
|
+
return Layer.succeed(DatabaseHost)({
|
|
47
|
+
create: (name) =>
|
|
48
|
+
Effect.tryPromise({
|
|
49
|
+
try: () => turso.databases.create(name, { group: options.group }),
|
|
50
|
+
catch: (cause) => new HostError({ message: `Turso didn't create ${name}`, cause }),
|
|
51
|
+
}).pipe(Effect.map((db) => `libsql://${db.hostname}`)),
|
|
52
|
+
// Over HTTP, so this works on every target, Cloudflare Workers included.
|
|
53
|
+
open: (url) => libsql({ url, authToken: options.groupToken }),
|
|
54
|
+
});
|
|
55
|
+
};
|
|
56
|
+
|
|
57
|
+
/** Turso when `TURSO_API_TOKEN` is set, else local files under the data folder. */
|
|
58
|
+
export const hostLayer = Layer.unwrap(
|
|
59
|
+
Effect.gen(function* () {
|
|
60
|
+
const env = yield* Env;
|
|
61
|
+
if (!env.TURSO_API_TOKEN) return localHost(`${yield* dataDir}/shops`);
|
|
62
|
+
if (!env.TURSO_ORG || !env.TURSO_GROUP_TOKEN)
|
|
63
|
+
return yield* Effect.die(
|
|
64
|
+
new Error("With TURSO_API_TOKEN, set TURSO_ORG and TURSO_GROUP_TOKEN too"),
|
|
65
|
+
);
|
|
66
|
+
return tursoHost({
|
|
67
|
+
org: env.TURSO_ORG,
|
|
68
|
+
apiToken: env.TURSO_API_TOKEN,
|
|
69
|
+
group: env.TURSO_GROUP,
|
|
70
|
+
groupToken: env.TURSO_GROUP_TOKEN,
|
|
71
|
+
});
|
|
72
|
+
}),
|
|
73
|
+
);
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { existsSync, mkdtempSync } from "node:fs";
|
|
2
|
+
import { tmpdir } from "node:os";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
|
|
5
|
+
import { Layer } from "effect";
|
|
6
|
+
import { form, memoryServices, testApp, testDb, testEnv } from "spacefn/testing";
|
|
7
|
+
import { describe, expect, it } from "vitest";
|
|
8
|
+
|
|
9
|
+
import Env from "#configs/env.ts";
|
|
10
|
+
import PlatformDb from "#space/db/platform.ts";
|
|
11
|
+
import { manifest } from "#space/manifest.ts";
|
|
12
|
+
|
|
13
|
+
import { localHost } from "./host.ts";
|
|
14
|
+
import { ShopDatabases } from "./shops.ts";
|
|
15
|
+
|
|
16
|
+
/** The app in memory, with each shop's database a file in a fresh folder. */
|
|
17
|
+
const app = () => {
|
|
18
|
+
const dir = mkdtempSync(join(tmpdir(), "mini-shopify-"));
|
|
19
|
+
const services = Layer.mergeAll(
|
|
20
|
+
memoryServices,
|
|
21
|
+
Env.layer.pipe(Layer.provide(testEnv({}))),
|
|
22
|
+
testDb(PlatformDb),
|
|
23
|
+
localHost(dir),
|
|
24
|
+
);
|
|
25
|
+
return { dir, shops: testApp(manifest, Layer.provideMerge(ShopDatabases.layer, services)) };
|
|
26
|
+
};
|
|
27
|
+
|
|
28
|
+
describe("shops", () => {
|
|
29
|
+
it("gives each shop its own database", async () => {
|
|
30
|
+
const { dir, shops } = app();
|
|
31
|
+
await using _ = shops;
|
|
32
|
+
const created = await shops.fetch("/?__action=create", form({ name: "Acme", slug: "acme" }));
|
|
33
|
+
expect([created.status, created.headers.get("location")]).toEqual([303, "/s/acme"]);
|
|
34
|
+
await shops.fetch("/?__action=create", form({ name: "Globex", slug: "globex" }));
|
|
35
|
+
|
|
36
|
+
await shops.fetch("/s/acme?__action=add", form({ name: "Mug", price: "12.5", stock: "2" }));
|
|
37
|
+
const acme = await (await shops.fetch("/s/acme")).text();
|
|
38
|
+
expect(acme).toContain("<h1>Acme</h1>");
|
|
39
|
+
expect(acme).toContain("<td>$12.50</td>");
|
|
40
|
+
expect(await (await shops.fetch("/s/globex")).text()).not.toContain("Mug");
|
|
41
|
+
expect(await (await shops.fetch("/")).text()).toContain('<a href="/s/globex">Globex</a>');
|
|
42
|
+
// Opened, and migrated, by the first request to each shop.
|
|
43
|
+
expect(existsSync(join(dir, "shop-acme.db"))).toBe(true);
|
|
44
|
+
expect(existsSync(join(dir, "shop-globex.db"))).toBe(true);
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
it("sells from stock, and refuses a taken address or a shop that isn't there", async () => {
|
|
48
|
+
const { shops } = app();
|
|
49
|
+
await using _ = shops;
|
|
50
|
+
await shops.fetch("/?__action=create", form({ name: "Acme", slug: "acme" }));
|
|
51
|
+
await shops.fetch("/s/acme?__action=add", form({ name: "Mug", price: "12", stock: "1" }));
|
|
52
|
+
await shops.fetch("/s/acme?__action=sell", form({ id: "1" }));
|
|
53
|
+
await shops.fetch("/s/acme?__action=sell", form({ id: "1" }));
|
|
54
|
+
expect(await (await shops.fetch("/s/acme")).text()).toContain("<td>0 left</td>");
|
|
55
|
+
|
|
56
|
+
const taken = await shops.fetch("/?__action=create", form({ name: "Again", slug: "acme" }));
|
|
57
|
+
expect(taken.status).toBe(409);
|
|
58
|
+
expect(
|
|
59
|
+
(await shops.fetch("/?__action=create", form({ name: "Bad", slug: "No!" }))).status,
|
|
60
|
+
).toBe(422);
|
|
61
|
+
expect((await shops.fetch("/s/nope")).status).toBe(404);
|
|
62
|
+
});
|
|
63
|
+
});
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { Effect, LayerMap, Option, Schema } from "effect";
|
|
2
|
+
import { Conflict, Input, NotFound, type HttpApp } from "spacefn";
|
|
3
|
+
|
|
4
|
+
import PlatformDb, { type ListShopsRow } from "#space/db/platform.ts";
|
|
5
|
+
import ShopDb from "#space/db/shop.ts";
|
|
6
|
+
|
|
7
|
+
import { DatabaseHost } from "./host.ts";
|
|
8
|
+
|
|
9
|
+
/** A shop's address, `/s/<slug>/`, and its database's name. */
|
|
10
|
+
export const Slug = Schema.String.pipe(Schema.check(Schema.isPattern(/^[a-z0-9][a-z0-9-]{1,30}$/)));
|
|
11
|
+
|
|
12
|
+
export type Shop = ListShopsRow;
|
|
13
|
+
|
|
14
|
+
export const NewShop = Schema.Struct({ slug: Slug, name: Schema.NonEmptyString });
|
|
15
|
+
|
|
16
|
+
/** The path parameters of `/s/:shop/`. */
|
|
17
|
+
export const Params = Schema.Struct({ shop: Slug });
|
|
18
|
+
|
|
19
|
+
/** A shop's storefront. */
|
|
20
|
+
export const url = (slug: string) => `/s/${slug}`;
|
|
21
|
+
|
|
22
|
+
export const list = PlatformDb.listShops();
|
|
23
|
+
|
|
24
|
+
/** Creates the shop's own database, then records where it is. */
|
|
25
|
+
export const create = ({ slug, name }: typeof NewShop.Type) =>
|
|
26
|
+
Effect.gen(function* () {
|
|
27
|
+
if (Option.isSome(yield* PlatformDb.findShop({ slug })))
|
|
28
|
+
return yield* new Conflict({ message: `There's a shop at ${slug} already` });
|
|
29
|
+
const url = yield* (yield* DatabaseHost).create(`shop-${slug}`);
|
|
30
|
+
yield* PlatformDb.addShop({ slug, name, url });
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
export const find = (slug: string) =>
|
|
34
|
+
Effect.flatMap(PlatformDb.findShop({ slug }), (shop) =>
|
|
35
|
+
Option.isSome(shop)
|
|
36
|
+
? Effect.succeed(shop.value)
|
|
37
|
+
: Effect.fail(new NotFound({ message: `No shop ${slug}` })),
|
|
38
|
+
);
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Each shop's `ShopDb`, by slug: opened, and migrated, the first time a
|
|
42
|
+
* request needs it, and closed after a minute without one. Provide it to a
|
|
43
|
+
* request with {@link provideShopDb}.
|
|
44
|
+
*/
|
|
45
|
+
export class ShopDatabases extends LayerMap.Service<ShopDatabases>()("mini-shopify/ShopDatabases", {
|
|
46
|
+
lookup: (slug: string) =>
|
|
47
|
+
ShopDb.layer(
|
|
48
|
+
Effect.gen(function* () {
|
|
49
|
+
const shop = yield* find(slug);
|
|
50
|
+
return yield* (yield* DatabaseHost).open(shop.url);
|
|
51
|
+
}),
|
|
52
|
+
),
|
|
53
|
+
idleTimeToLive: "1 minute",
|
|
54
|
+
}) {}
|
|
55
|
+
|
|
56
|
+
/** The shop the request is under, `/s/:shop/`. */
|
|
57
|
+
export const current = Effect.flatMap(Input.params(Params), ({ shop }) => find(shop));
|
|
58
|
+
|
|
59
|
+
/** The storefront the request is under. */
|
|
60
|
+
export const here = Effect.map(Input.params(Params), ({ shop }) => url(shop));
|
|
61
|
+
|
|
62
|
+
/** Runs `next` on the database of the shop the request is under. */
|
|
63
|
+
export const provideShopDb = (next: HttpApp) =>
|
|
64
|
+
Effect.flatMap(Input.params(Params), ({ shop }) => Effect.provide(next, ShopDatabases.get(shop)));
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { html } from "spacefn";
|
|
2
|
+
|
|
3
|
+
import { type Shop, url } from "./shops.ts";
|
|
4
|
+
|
|
5
|
+
/** The platform's home: every shop, and a form to open one. */
|
|
6
|
+
export const shopsPage = (props: {
|
|
7
|
+
readonly shops: readonly Shop[];
|
|
8
|
+
/** Where the form posts. */
|
|
9
|
+
readonly create: string;
|
|
10
|
+
readonly invalid: boolean;
|
|
11
|
+
}) =>
|
|
12
|
+
html`<main>
|
|
13
|
+
<h1>Shops</h1>
|
|
14
|
+
<ul>
|
|
15
|
+
${props.shops.map((shop) => html`<li><a href="${url(shop.slug)}">${shop.name}</a></li>`)}
|
|
16
|
+
</ul>
|
|
17
|
+
<form method="post" action="${props.create}">
|
|
18
|
+
<input name="name" placeholder="Name" required />
|
|
19
|
+
<input
|
|
20
|
+
name="slug"
|
|
21
|
+
placeholder="address, e.g. acme"
|
|
22
|
+
pattern="[a-z0-9][a-z0-9-]{1,30}"
|
|
23
|
+
required
|
|
24
|
+
/>
|
|
25
|
+
<button>Open a shop</button>
|
|
26
|
+
</form>
|
|
27
|
+
${props.invalid ? html`<p role="alert">Give the shop a name, and an address of lowercase letters, digits and dashes.</p>` : ""}
|
|
28
|
+
</main>`;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "mini-shopify",
|
|
3
|
+
"private": true,
|
|
4
|
+
"description": "Shops that each get their own database: created with the Turso Platform API (or as local files), opened per request with a LayerMap.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"imports": {
|
|
7
|
+
"#configs/*": "./configs/*",
|
|
8
|
+
"#lib/*": "./lib/*",
|
|
9
|
+
"#modules/*": "./modules/*",
|
|
10
|
+
"#space/*": "./.space/*"
|
|
11
|
+
},
|
|
12
|
+
"scripts": {
|
|
13
|
+
"postinstall": "space gen",
|
|
14
|
+
"dev": "space dev",
|
|
15
|
+
"build": "space build",
|
|
16
|
+
"deploy": "space deploy",
|
|
17
|
+
"docs": "space docs",
|
|
18
|
+
"test": "vitest run --config configs/vitest.ts",
|
|
19
|
+
"typecheck": "tsc --noEmit"
|
|
20
|
+
},
|
|
21
|
+
"dependencies": {
|
|
22
|
+
"@tursodatabase/api": "2.0.6",
|
|
23
|
+
"effect": "4.1.4",
|
|
24
|
+
"spacefn": "^0.11.1"
|
|
25
|
+
},
|
|
26
|
+
"devDependencies": {
|
|
27
|
+
"@alchemy.run/docker": "2.0.0-beta.87",
|
|
28
|
+
"@types/bun": "^1.4.4",
|
|
29
|
+
"alchemy": "2.0.0-beta.87",
|
|
30
|
+
"spacefn-docs": "^0.11.1",
|
|
31
|
+
"typescript": "^7.0.2",
|
|
32
|
+
"vite": "8.3.8",
|
|
33
|
+
"vitest": "5.1.1"
|
|
34
|
+
}
|
|
35
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# react
|
|
2
|
+
|
|
3
|
+
A [React](https://react.dev) island on a spacefn app (Bun): the pages are server-rendered `html`, and the cart is a React component that runs only in the browser.
|
|
4
|
+
|
|
5
|
+
```sh
|
|
6
|
+
pnpm dev
|
|
7
|
+
pnpm test
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
How it fits together:
|
|
11
|
+
|
|
12
|
+
- **The plugin** is React's own Vite plugin, beside spacefn's in `configs/vite.ts`.
|
|
13
|
+
- **The shop** is a feature, `modules/shop/`: `shop.ts` gives the page its data, `views.ts` renders it, and the cart is its client component, `modules/shop/ui/Cart.island.tsx`. Its name makes it an island called `Cart`, and its default export is the component. `products.ts` holds what the server and the browser share, so it imports nothing server-only.
|
|
14
|
+
- **The island**: codegen writes `.space/islands/Cart.ts`, which starts the component with React in the browser, and `.space/islands.ts`. The page renders `island("Cart", { products })` from `#space/islands.ts`, with the props typed from the component: the element, the props as JSON, and the script, once however many carts the page has.
|
|
15
|
+
- **The about page** is a feature of its own, `modules/about/`.
|
|
16
|
+
- **Only the shop loads React**: `/about` renders no cart, so it gets no script. The server only imports the component's types, so React never runs there.
|
|
17
|
+
|
|
18
|
+
Rendering the component on the server too isn't supported: an island starts empty, and fills in once its script runs.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { app, databases, errorPage, staticFiles, telemetry } from "spacefn";
|
|
2
|
+
import { platform } from "spacefn/platform";
|
|
3
|
+
|
|
4
|
+
import Env from "#configs/env.ts";
|
|
5
|
+
import { manifest } from "#space/manifest.ts";
|
|
6
|
+
|
|
7
|
+
// The app: the file conventions (manifest) and what runs with them. It's yours to change;
|
|
8
|
+
// spacefn only provides the pieces. The same file runs on Cloudflare and on Bun.
|
|
9
|
+
export default app(manifest, {
|
|
10
|
+
// In order: each can use the ones before it, and routes, pages, queues and crons use them all.
|
|
11
|
+
services: [
|
|
12
|
+
// This target's Kv, Blob, Queue, Bus, RateLimiter, HttpClient and database connections.
|
|
13
|
+
platform(manifest),
|
|
14
|
+
// configs/env.ts, read from the environment.
|
|
15
|
+
Env.layer,
|
|
16
|
+
// app/db/*, migrated as each config.json says.
|
|
17
|
+
databases(manifest),
|
|
18
|
+
// Traces, logs and metrics over OTLP, once OTEL_EXPORTER_OTLP_ENDPOINT is set.
|
|
19
|
+
telemetry(manifest.name),
|
|
20
|
+
],
|
|
21
|
+
// Around every request, before app/routes/_middleware.ts. staticFiles() serves the client
|
|
22
|
+
// build on Bun; Cloudflare serves it as assets before the Worker runs.
|
|
23
|
+
before: [staticFiles()],
|
|
24
|
+
// Effect HttpRouter layers beside the file routes, e.g. an HttpApi.
|
|
25
|
+
routes: [],
|
|
26
|
+
// What a failed request answers: an HTML page for browsers, JSON for the rest.
|
|
27
|
+
onError: errorPage,
|
|
28
|
+
});
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { Effect } from "effect";
|
|
2
|
+
import { page } from "spacefn";
|
|
3
|
+
|
|
4
|
+
import { layout } from "#lib/ui/layout.ts";
|
|
5
|
+
import { aboutPage } from "#modules/about/views.ts";
|
|
6
|
+
|
|
7
|
+
export default page({
|
|
8
|
+
loader: Effect.void,
|
|
9
|
+
render: () => layout("About", aboutPage()),
|
|
10
|
+
});
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { Effect } from "effect";
|
|
2
|
+
import { page } from "spacefn";
|
|
3
|
+
|
|
4
|
+
import { layout } from "#lib/ui/layout.ts";
|
|
5
|
+
import * as Shop from "#modules/shop/shop.ts";
|
|
6
|
+
import { shopPage } from "#modules/shop/views.ts";
|
|
7
|
+
|
|
8
|
+
// The shop at /: the page with the cart, so the only one that loads its script.
|
|
9
|
+
export default page({
|
|
10
|
+
loader: Effect.all({ title: Shop.title, products: Shop.products }),
|
|
11
|
+
render: (ctx) => layout(ctx.data.title, shopPage(ctx.data)),
|
|
12
|
+
});
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# The app's image on Bun, built from its source when `space deploy` runs configs/infra.ts.
|
|
2
|
+
# configs/Dockerfile.dockerignore keeps local files out of it.
|
|
3
|
+
ARG BUN_VERSION=1.4.4
|
|
4
|
+
|
|
5
|
+
FROM oven/bun:${BUN_VERSION} AS build
|
|
6
|
+
WORKDIR /app
|
|
7
|
+
COPY . .
|
|
8
|
+
# Without scripts: vite build generates .space/ itself.
|
|
9
|
+
# The cache mount keeps Bun's downloads between builds, and out of the image.
|
|
10
|
+
RUN --mount=type=cache,target=/root/.bun/install/cache \
|
|
11
|
+
bun install --ignore-scripts && bunx vite build --config configs/vite.ts
|
|
12
|
+
|
|
13
|
+
FROM oven/bun:${BUN_VERSION}-slim
|
|
14
|
+
WORKDIR /app
|
|
15
|
+
COPY --from=build /app/dist .
|
|
16
|
+
# The server bundle is self-contained but for native packages, installed here for the image's platform.
|
|
17
|
+
RUN --mount=type=cache,target=/root/.bun/install/cache \
|
|
18
|
+
cd server && bun install --production --no-save \
|
|
19
|
+
&& mkdir -p /data && chown bun:bun /data
|
|
20
|
+
|
|
21
|
+
ENV NODE_ENV=production PORT=3000 SPACE_DATA_DIR=/data
|
|
22
|
+
VOLUME /data
|
|
23
|
+
EXPOSE 3000
|
|
24
|
+
USER bun
|
|
25
|
+
# One container runs the web server, which starts the queue and cron processes.
|
|
26
|
+
CMD ["bun", "server/index.js"]
|