feat(cloudflare): Durable Objects SQL database backend with read replication

.changeset/bookmark-commit-finally.md

@@ -0,0 +1,5 @@
+---
+"emdash": patch
+---
+
+Fixes a read-your-writes gap with database read replication: the session bookmark cookie is now persisted even when page rendering throws after a successful write, so an immediately-following request can't read pre-write state from a lagging replica.

.changeset/do-sql-driver.md

@@ -0,0 +1,5 @@
+---
+"@emdash-cms/cloudflare": minor
+---
+
+Adds a `durableObjects()` database adapter that stores the whole CMS in a single Durable Object's SQLite. With `session: "auto"` (plus the `experimental` and `replica_routing` compatibility flags) reads route to the nearest read replica and writes proxy to the primary, cutting read latency for globally distributed traffic. Register the exported `EmDashDB` class in your worker and add a `new_sqlite_classes` migration.

.changeset/rpc-count-metric.md

@@ -0,0 +1,5 @@
+---
+"emdash": patch
+---
+
+Adds an `rpc.count` Server-Timing metric reporting physical database round trips, distinct from `db.count` (logical queries). Backends that batch (the new Durable Objects SQL driver coalesces same-turn reads into one round trip) can now surface how many round trips a request actually made.

.oxfmtrc.json

@@ -7,6 +7,7 @@
 		"**/*.mdx",
 		"**/package.json",
 		"**/emdash-env.d.ts",
+		"**/worker-configuration.d.ts",
 		"packages/registry-lexicons/src/generated/**",
 		"packages/plugin-cli/schemas/**"
 	]

infra/do-demo/.gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+.astro
+uploads
+data.db

infra/do-demo/AGENTS.md

@@ -0,0 +1,38 @@
+This is an EmDash site -- a CMS built on Astro with a full admin UI.
+
+## Commands
+
+```bash
+npx emdash dev        # Start dev server (runs migrations, seeds, generates types)
+npx emdash types      # Regenerate TypeScript types from schema
+npx emdash seed seed/seed.json --validate  # Validate seed file
+```
+
+The admin UI is at `http://localhost:4321/_emdash/admin`.
+
+## Key Files
+
+| File                     | Purpose                                                                            |
+| ------------------------ | ---------------------------------------------------------------------------------- |
+| `astro.config.mjs`       | Astro config with `emdash()` integration, database, and storage                    |
+| `src/live.config.ts`     | EmDash loader registration (boilerplate -- don't modify)                           |
+| `seed/seed.json`         | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
+| `emdash-env.d.ts`        | Generated types for collections (auto-regenerated on dev server start)             |
+| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions)                 |
+| `src/pages/`             | Astro pages -- all server-rendered                                                 |
+
+## Skills
+
+Agent skills are in `.agents/skills/`. Load them when working on specific tasks:
+
+- **building-emdash-site** -- Querying content, rendering Portable Text, schema design, seed files, site features (menus, widgets, search, SEO, comments, bylines). Start here.
+- **creating-plugins** -- Building EmDash plugins with hooks, storage, admin UI, API routes, and Portable Text block types.
+- **emdash-cli** -- CLI commands for content management, seeding, type generation, and visual editing flow.
+
+## Rules
+
+- All content pages must be server-rendered (`output: "server"`). No `getStaticPaths()` for CMS content.
+- Image fields are objects (`{ src, alt }`), not strings. Use `<Image image={...} />` from `"emdash/ui"`.
+- `entry.id` is the slug (for URLs). `entry.data.id` is the database ULID (for API calls like `getEntryTerms`).
+- Always call `Astro.cache.set(cacheHint)` on pages that query content.
+- Taxonomy names in queries must match the seed's `"name"` field exactly (e.g., `"category"` not `"categories"`).

infra/do-demo/astro.config.mjs

@@ -0,0 +1,46 @@
+import cloudflare from "@astrojs/cloudflare";
+import react from "@astrojs/react";
+import { durableObjects, r2, sandbox } from "@emdash-cms/cloudflare";
+import { formsPlugin } from "@emdash-cms/plugin-forms";
+import webhookNotifier from "@emdash-cms/plugin-webhook-notifier";
+import { defineConfig, fontProviders } from "astro/config";
+import emdash from "emdash/astro";
+
+export default defineConfig({
+	output: "server",
+	adapter: cloudflare(),
+	image: {
+		layout: "constrained",
+		responsiveStyles: true,
+	},
+	integrations: [
+		react(),
+		emdash({
+			database: durableObjects({ binding: "DB_DO", session: "auto" }),
+			storage: r2({ binding: "MEDIA" }),
+			plugins: [formsPlugin()],
+			sandboxed: [webhookNotifier],
+			sandboxRunner: sandbox(),
+			experimental: {
+				registry: "https://registry.emdashcms.com",
+			},
+		}),
+	],
+	fonts: [
+		{
+			provider: fontProviders.google(),
+			name: "Inter",
+			cssVariable: "--font-sans",
+			weights: [400, 500, 600, 700],
+			fallbacks: ["sans-serif"],
+		},
+		{
+			provider: fontProviders.google(),
+			name: "JetBrains Mono",
+			cssVariable: "--font-mono",
+			weights: [400, 500],
+			fallbacks: ["monospace"],
+		},
+	],
+	devToolbar: { enabled: false },
+});

infra/do-demo/emdash-env.d.ts

@@ -0,0 +1,41 @@
+// Generated by EmDash on dev server start
+// Do not edit manually
+
+/// <reference types="emdash/locals" />
+
+import type { ContentBylineCredit, TaxonomyTerm, PortableTextBlock } from "emdash";
+
+export interface Page {
+  id: string;
+  slug: string | null;
+  status: string;
+  title: string;
+  content?: PortableTextBlock[];
+  createdAt: Date;
+  updatedAt: Date;
+  publishedAt: Date | null;
+  bylines?: ContentBylineCredit[];
+  terms?: Record<string, TaxonomyTerm[]>;
+}
+
+export interface Post {
+  id: string;
+  slug: string | null;
+  status: string;
+  title: string;
+  featured_image?: { id: string; src?: string; alt?: string; width?: number; height?: number; provider?: string; previewUrl?: string; meta?: Record<string, unknown> };
+  content?: PortableTextBlock[];
+  excerpt?: string;
+  createdAt: Date;
+  updatedAt: Date;
+  publishedAt: Date | null;
+  bylines?: ContentBylineCredit[];
+  terms?: Record<string, TaxonomyTerm[]>;
+}
+
+declare module "emdash" {
+  interface EmDashCollections {
+    pages: Page;
+    posts: Post;
+  }
+}

infra/do-demo/package.json

@@ -0,0 +1,32 @@
+{
+	"name": "@emdash-cms/do-demo-site",
+	"version": "0.0.18",
+	"private": true,
+	"type": "module",
+	"scripts": {
+		"dev": "astro dev",
+		"build": "astro build",
+		"preview": "astro preview",
+		"deploy": "astro build && wrangler deploy",
+		"typecheck": "astro check",
+		"bootstrap": "emdash init && emdash seed",
+		"seed": "emdash seed"
+	},
+	"dependencies": {
+		"@astrojs/cloudflare": "catalog:",
+		"@astrojs/react": "catalog:",
+		"@emdash-cms/cloudflare": "workspace:*",
+		"@emdash-cms/plugin-forms": "workspace:*",
+		"@emdash-cms/plugin-webhook-notifier": "workspace:*",
+		"@emdash-cms/plugin-cli": "workspace:*",
+		"astro": "catalog:",
+		"emdash": "workspace:*",
+		"react": "catalog:",
+		"react-dom": "catalog:"
+	},
+	"devDependencies": {
+		"@astrojs/check": "catalog:",
+		"@cloudflare/workers-types": "catalog:",
+		"wrangler": "catalog:"
+	}
+}