create-vexcms 0.1.0-alpha.12 → 0.1.0-alpha.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vexcms",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.13",
   "description": "Scaffold a new VexCMS project",
   "keywords": [
     "cms",

package/templates/base-nextjs/convex/vex.schema.ts

@@ -130,6 +130,7 @@ export const images = defineTable({
   src: v.string(),
   width: v.optional(v.number()),
   height: v.optional(v.number()),
+  updatedAt: v.optional(v.number()),
 })
   .index("by_deleted", ["deleted"])
   .searchIndex("search_filename", {

package/templates/base-nextjs/package.json

@@ -24,11 +24,11 @@
     "@t3-oss/env-nextjs": "0.13.11",
     "@tanstack/react-form": "1.33.1",
     "@tanstack/react-query": "5.101.2",
-    "@vexcms/better-auth": "~0.1.0-alpha.12",
-    "@vexcms/core": "~0.1.0-alpha.12",
-    "@vexcms/file-storage-convex": "~0.1.0-alpha.12",
-    "@vexcms/next": "~0.1.0-alpha.12",
-    "@vexcms/react": "~0.1.0-alpha.12",
+    "@vexcms/better-auth": "~0.1.0-alpha.13",
+    "@vexcms/core": "~0.1.0-alpha.13",
+    "@vexcms/file-storage-convex": "~0.1.0-alpha.13",
+    "@vexcms/next": "~0.1.0-alpha.13",
+    "@vexcms/react": "~0.1.0-alpha.13",
     "better-auth": "1.6.23",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
@@ -52,7 +52,7 @@
     "@types/node": "20.19.43",
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
-    "@vexcms/cli": "~0.1.0-alpha.12",
+    "@vexcms/cli": "~0.1.0-alpha.13",
     "babel-plugin-react-compiler": "1.0.0",
     "eslint": "9.39.5",
     "eslint-config-next": "15.5.9",
@@ -63,5 +63,17 @@
     "tailwindcss": "4.3.2",
     "typescript": "6.0.3",
     "typescript-eslint": "8.63.0"
+  },
+  "pnpm": {
+    "overrides": {
+      "@better-auth/passkey": "1.6.23"
+    },
+    "peerDependencyRules": {
+      "allowedVersions": {
+        "@convex-dev/better-auth>better-auth": "1.6.23",
+        "better-call": "2",
+        "typescript": "6"
+      }
+    }
   }
 }

package/templates/base-nextjs/src/app/(vexcms)/admin/layout.tsx

@@ -2,6 +2,7 @@ import type { ReactNode } from "react"
 
 import { NextAdminLayout } from "@vexcms/next/client"
 
+import { AuthServerProvider } from "~/components/providers/auth"
 import { getCurrentUser } from "~/auth/serverUtils"
 import config from "~/vex.config"
 
@@ -10,10 +11,12 @@ import { ClientProviders } from "./clientProviders"
 export default async function AdminLayout({ children }: { children: ReactNode }) {
   const user = await getCurrentUser()
   return (
-    <ClientProviders>
-      <NextAdminLayout config={config} user={user ?? undefined}>
-        {children}
-      </NextAdminLayout>
-    </ClientProviders>
+    <AuthServerProvider>
+      <ClientProviders>
+        <NextAdminLayout config={config} user={user ?? undefined}>
+          {children}
+        </NextAdminLayout>
+      </ClientProviders>
+    </AuthServerProvider>
   )
 }

package/templates/base-nextjs/src/app/api/vex/revalidate/route.ts

@@ -0,0 +1,19 @@
+import { api } from "@convex/_generated/api"
+import { createVexRevalidateRoute } from "@vexcms/next/cache"
+
+import { fetchAuthQuery, getToken } from "~/auth/server"
+import config from "~/vex.config"
+
+/**
+ * `POST /api/vex/revalidate` — session-authorized path purge.
+ *
+ * Called by `useVexMutation` after every admin-panel write, same origin, and
+ * by the admin panel's Revalidate control over the same session. Never
+ * secret-authorized: the caller must hold a real session with write
+ * permission on the affected collection.
+ */
+export const { POST } = createVexRevalidateRoute({
+  config,
+  getToken,
+  getAuth: () => fetchAuthQuery(api.auth.api.getUserOrg, {}),
+})

package/templates/base-nextjs/src/components/providers/server.tsx

@@ -2,10 +2,12 @@ import { ThemeProvider } from "@vexcms/react";
 import { NuqsAdapter } from "nuqs/adapters/next/app";
 import { type PropsWithChildren } from "react";
 
-import { AuthServerProvider } from "./auth";
-
 /**
- * Server-side provider shell.
+ * Server-side provider shell: theme context + the nuqs URL-state adapter.
+ *
+ * `AuthServerProvider` used to wrap `NuqsAdapter` here, putting a `getToken()`
+ * cookie read on every route's render path. It now mounts directly in
+ * `app/(vexcms)/admin/layout.tsx`, the only route group that needs it.
  *
  * Deliberately does **not** mount `ConvexClientProvider` — `ClientProviders`
  * renders it, and `ClientProviders` is nested inside this component, so its
@@ -14,18 +16,11 @@ import { AuthServerProvider } from "./auth";
  * render (`providers/convex.tsx` intentionally creates fresh clients per call
  * server-side to avoid cross-request leaks) whose only consumer was the
  * discarded outer subtree.
- *
- * Nothing between here and `ClientProviders` needs Convex: `AuthServerProvider`
- * is a server component that calls `getToken()`/`fetchAuthQuery` directly, and
- * `NuqsAdapter` is unrelated. React context is unreadable from server
- * components regardless.
  */
 export default function ServerProviders({ children }: PropsWithChildren) {
   return (
     <ThemeProvider defaultTheme="system">
-      <AuthServerProvider>
-        <NuqsAdapter>{children}</NuqsAdapter>
-      </AuthServerProvider>
+      <NuqsAdapter>{children}</NuqsAdapter>
     </ThemeProvider>
   );
 }

package/templates/base-nextjs/src/vex.types.ts

@@ -135,6 +135,7 @@ export interface Image extends VexDocument {
   src: string
   width?: number
   height?: number
+  updatedAt?: number
 }
 
 export type CollectionSlug =
@@ -263,7 +264,7 @@ declare module "@vexcms/core" {
       }
       images: {
         text: "filename" | "alt" | "mimeType" | "storageId" | "src"
-        number: "size" | "width" | "height"
+        number: "size" | "width" | "height" | "updatedAt"
         checkbox: "deleted"
       }
     }

package/templates/marketing-site/convex/pages.ts

@@ -1,7 +1,7 @@
 import { v } from "convex/values"
 
 import { TABLE_SLUG_PAGES } from "~/db/constants"
-import { find } from "~/vexcms/api"
+import { find, publishedSlugs as readPublishedSlugs } from "~/vexcms/api"
 
 import { query } from "./_generated/server"
 
@@ -29,3 +29,22 @@ export const getBySlug = query({
     })
   },
 })
+
+/**
+ * Returns `{ slug, createdAt, updatedAt? }` for every page document.
+ *
+ * Consumed by `app/sitemap.ts` and `[slug]/page.tsx`'s `generateStaticParams`.
+ * Access is bypassed for the same reason `getBySlug` bypasses it: both are
+ * read at build time and by anonymous crawlers, neither of which carries a
+ * session.
+ */
+export const publishedSlugs = query({
+  args: {},
+  handler: async (ctx) => {
+    return await readPublishedSlugs({
+      access: { bypass: true },
+      collection: TABLE_SLUG_PAGES,
+      ctx,
+    })
+  },
+})

package/templates/marketing-site/convex/vex.schema.ts

@@ -160,6 +160,7 @@ export const pages = defineTable({
   metaTitle: v.optional(v.string()),
   metaDescription: v.optional(v.string()),
   ogImage: v.optional(v.array(v.id("images"))),
+  updatedAt: v.optional(v.number()),
 }).index("by_slug", ["slug"])
 
 export const headers = defineTable({
@@ -188,6 +189,7 @@ export const headers = defineTable({
       })
     )
   ),
+  updatedAt: v.optional(v.number()),
 }).index("by_name", ["name"])
 
 export const footers = defineTable({
@@ -210,6 +212,7 @@ export const footers = defineTable({
       })
     )
   ),
+  updatedAt: v.optional(v.number()),
 }).index("by_name", ["name"])
 
 export const themes = defineTable({
@@ -288,6 +291,7 @@ export const themes = defineTable({
       sidebarRing: v.optional(v.string()),
     })
   ),
+  updatedAt: v.optional(v.number()),
 }).index("by_name", ["name"])
 
 export const session = defineTable({
@@ -370,6 +374,7 @@ export const images = defineTable({
   src: v.string(),
   width: v.optional(v.number()),
   height: v.optional(v.number()),
+  updatedAt: v.optional(v.number()),
 })
   .index("by_deleted", ["deleted"])
   .searchIndex("search_filename", {

package/templates/marketing-site/src/app/(frontend)/(site)/[slug]/page.tsx

@@ -1,12 +1,30 @@
 import { api } from "@convex/_generated/api"
-import { fetchQuery } from "convex/nextjs"
+import { vexStaticParams } from "@vexcms/next/seo"
+import { notFound } from "next/navigation"
 
 import type { PagesDocument } from "~/vex.types"
 
 import { generatePageMetadata } from "~/lib/metadata"
+import { vex } from "~/lib/vex"
 
 import { PageContent } from "../PageContent"
 
+// Next requires this to be an inline literal — it is read by static analysis
+// before any module executes, so neither `vexConfig.revalidate.revalidateSeconds`
+// nor an imported constant is accepted ("Invalid segment configuration export").
+export const revalidate = 3600
+
+export async function generateStaticParams() {
+  const entries = await vexStaticParams({
+    client: vex,
+    query: api.pages.publishedSlugs,
+    paramName: "slug",
+    getSlug: (item) => item.slug,
+  })
+
+  return entries.filter((entry) => entry.slug !== "home")
+}
+
 export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
   const { slug } = await params
   return generatePageMetadata({ slug: slug && slug.length > 0 ? slug : "home" })
@@ -16,11 +34,24 @@ export default async function PublicPage({ params }: { params: Promise<{ slug: s
   const { slug } = await params
   const normalized = slug && slug.length > 0 ? slug : "home"
 
+  // The two failure modes are deliberately NOT the same:
+  //
+  // - The query THROWS: the deployment is unreachable. A scaffold builds with
+  //   placeholder env, so throwing here would fail `next build` outright.
+  //   Render with no seed and let the client's live subscription hydrate.
+  // - The query SUCCEEDS and returns `[]`: the deployment answered, and this
+  //   page genuinely does not exist. That must be a real 404, not an empty
+  //   200 — an empty 200 gets the URL indexed as a live, blank page.
   let initialData: PagesDocument[] | undefined
+  let reachable = true
   try {
-    initialData = await fetchQuery(api.pages.getBySlug, { slug: normalized })
+    initialData = await vex.query(api.pages.getBySlug, { slug: normalized })
   } catch {
-    // Fall back to client-only fetch
+    reachable = false
+  }
+
+  if (reachable && (!initialData || initialData.length === 0)) {
+    notFound()
   }
 
   return <PageContent initialData={initialData} slug={normalized} />

package/templates/marketing-site/src/app/(frontend)/(site)/layout.tsx

@@ -1,12 +1,13 @@
 import type { ReactNode } from "react"
 
 import { api } from "@convex/_generated/api"
-import { fetchQuery } from "convex/nextjs"
 
 import type { FootersDocument, HeadersDocument } from "~/vex.types"
 
 import { SiteFooter } from "~/components/SiteFooter"
 import { SiteHeader } from "~/components/SiteHeader"
+import { ThemeStyle } from "~/components/ThemeStyle"
+import { vex } from "~/lib/vex"
 
 /**
  * Marketing chrome: header + footer around every site page. Auth routes live
@@ -22,8 +23,8 @@ export default async function SiteLayout({
 
   try {
     ;[headerData, footerData] = await Promise.all([
-      fetchQuery(api.headers.getFirst),
-      fetchQuery(api.footers.getFirst),
+      vex.query(api.headers.getFirst),
+      vex.query(api.footers.getFirst),
     ])
   } catch {
     // Convex not available — fall back to client-only fetch
@@ -31,6 +32,7 @@ export default async function SiteLayout({
 
   return (
     <>
+      <ThemeStyle />
       {/* Sits above the sticky header so it is the first tab stop on every
           page. Visually hidden until focused. */}
       <a

package/templates/marketing-site/src/app/(frontend)/(site)/page.tsx

@@ -1,12 +1,17 @@
 import { api } from "@convex/_generated/api"
-import { fetchQuery } from "convex/nextjs"
 
 import type { PagesDocument } from "~/vex.types"
 
 import { generatePageMetadata } from "~/lib/metadata"
+import { vex } from "~/lib/vex"
 
 import { PageContent } from "./PageContent"
 
+// Next requires this to be an inline literal — it is read by static analysis
+// before any module executes, so neither `vexConfig.revalidate.revalidateSeconds`
+// nor an imported constant is accepted ("Invalid segment configuration export").
+export const revalidate = 3600
+
 export async function generateMetadata() {
   return generatePageMetadata({ slug: "home" })
 }
@@ -14,7 +19,7 @@ export async function generateMetadata() {
 export default async function HomePage() {
   let initialData: PagesDocument[] | undefined
   try {
-    initialData = await fetchQuery(api.pages.getBySlug, { slug: "home" })
+    initialData = await vex.query(api.pages.getBySlug, { slug: "home" })
   } catch {
     // Fall back to client-only fetch
   }

package/templates/marketing-site/src/app/(vexcms)/admin/layout.tsx

@@ -2,6 +2,7 @@ import type { ReactNode } from "react";
 
 import { NextAdminLayout } from "@vexcms/next/client";
 
+import { AuthServerProvider } from "~/components/providers/auth";
 import { getCurrentUser } from "~/auth/serverUtils";
 import { ThemeLive } from "~/components/ThemeLive";
 import { ThemeStyle } from "~/components/ThemeStyle";
@@ -21,12 +22,14 @@ import { ClientProviders } from "./clientProviders";
 export default async function AdminLayout({ children }: { children: ReactNode }) {
   const user = await getCurrentUser();
   return (
-    <ClientProviders>
-      <ThemeStyle scope="admin" />
-      <ThemeLive scope="admin" />
-      <NextAdminLayout config={config} user={user ?? undefined}>
-        {children}
-      </NextAdminLayout>
-    </ClientProviders>
+    <AuthServerProvider>
+      <ClientProviders>
+        <ThemeStyle scope="admin" />
+        <ThemeLive scope="admin" />
+        <NextAdminLayout config={config} user={user ?? undefined}>
+          {children}
+        </NextAdminLayout>
+      </ClientProviders>
+    </AuthServerProvider>
   );
 }

package/templates/marketing-site/src/app/layout.tsx

@@ -8,7 +8,6 @@ import { Geist, Geist_Mono } from "next/font/google"
 import ClientProviders from "~/components/providers/client"
 import ServerProviders from "~/components/providers/server"
 import { ThemeLive } from "~/components/ThemeLive"
-import { ThemeStyle } from "~/components/ThemeStyle"
 
 /**
  * Geist carries the whole type system — display through body — so weight is
@@ -68,12 +67,10 @@ export default function RootLayout({
       suppressHydrationWarning
     >
       <head>
-        {/* ThemeScript applies the persisted light/dark class before first
-            paint (no flash); ThemeStyle server-renders the active site theme
-            once for the whole app — the admin layout re-emits its own scope
-            at higher specificity, so `siteSettings.adminTheme` opts out. */}
+        {/* Applies the persisted light/dark class before first paint (no
+            flash). Site theming now renders in `(frontend)/(site)/layout.tsx`
+            — the admin layout re-emits its own scope for `/admin`. */}
         <ThemeScript />
-        <ThemeStyle />
       </head>
       <body>
         <ServerProviders>

package/templates/marketing-site/src/app/robots.ts

@@ -0,0 +1,13 @@
+import { createVexRobots } from "@vexcms/next/seo"
+
+import { env } from "~/env.mjs"
+
+/**
+ * Generates `/robots.txt`. Allows all crawlers on the public site and points
+ * them at the generated sitemap; disallows the authenticated `/admin` tree
+ * and its `/api` routes.
+ */
+export default createVexRobots({
+  siteUrl: env.NEXT_PUBLIC_SITE_URL,
+  disallow: ["/admin", "/api"],
+})

package/templates/marketing-site/src/app/sitemap.ts

@@ -0,0 +1,18 @@
+import { api } from "@convex/_generated/api"
+import { createVexSitemap } from "@vexcms/next/seo"
+
+import { env } from "~/env.mjs"
+import { vex } from "~/lib/vex"
+
+/**
+ * Generates `/sitemap.xml` from every published `pages` document plus the
+ * site root. Degrades to `[]` (no page entries) when Convex is unreachable —
+ * the packed-tarball scaffold this template ships into has no live
+ * deployment and builds against placeholder env (P-020).
+ */
+export default createVexSitemap({
+  client: vex,
+  query: api.pages.publishedSlugs,
+  toUrl: (slug) => (slug === "home" ? env.NEXT_PUBLIC_SITE_URL : `${env.NEXT_PUBLIC_SITE_URL}/${slug}`),
+  getSlug: (item) => item.slug,
+})

package/templates/marketing-site/src/components/ThemeStyle.tsx

@@ -1,6 +1,7 @@
 import { api } from "@convex/_generated/api"
 import { buildThemeCss, type ThemeScope } from "@vexcms/core"
-import { fetchQuery } from "convex/nextjs"
+
+import { vex } from "~/lib/vex"
 
 /**
  * Server component that inlines a theme's CSS custom properties.
@@ -37,7 +38,7 @@ export async function ThemeStyle(props: { scope?: ThemeScope }) {
 
   let theme: null | Record<string, unknown> = null
   try {
-    theme = await fetchQuery(scope === "admin" ? api.theme.getAdmin : api.theme.getActive)
+    theme = await vex.query(scope === "admin" ? api.theme.getAdmin : api.theme.getActive)
   } catch {
     // No deployment reachable at build time — fall back to globals.css.
     return null

package/templates/marketing-site/src/lib/metadata.ts

@@ -1,41 +1,61 @@
 import type { Metadata } from "next"
 
 import { api } from "@convex/_generated/api"
-import { fetchQuery } from "convex/nextjs"
+import { vexMetadata } from "@vexcms/next/seo"
+
+import { env } from "~/env.mjs"
+import { vex } from "~/lib/vex"
 
 const TITLE_SUFFIX = " | Vex CMS"
 
+/**
+ * Returns the first candidate that is a non-blank string.
+ *
+ * Optional text fields in a vexcms collection seed as `""` rather than being
+ * absent, so `??` chains cannot express "fall back to the site default" — an
+ * empty override would win. Mirrors `apps/www/src/lib/metadata.ts`'s helper
+ * of the same name.
+ */
+function firstNonBlank(...candidates: unknown[]): string | undefined {
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim().length > 0) {
+      return candidate
+    }
+  }
+  return undefined
+}
+
 /**
  * Generate Next.js Metadata for a page.
  *
  * Fetches site settings and, when a slug is given, the matching page
  * document, then merges them — page-level `metaTitle`/`metaDescription`/
- * `ogImage` win over the site's defaults from `siteSettings`.
+ * `ogImage` win over the site's defaults from `siteSettings` — and delegates
+ * the `Metadata` shape (title, description, `metadataBase`, canonical,
+ * conditional OG image) to `vexMetadata` (`@vexcms/next/seo`).
  *
  * @param props.slug - Optional page slug to fetch per-page SEO overrides
  */
 export async function generatePageMetadata(props: { slug?: string }): Promise<Metadata> {
   try {
-    const settings = (await fetchQuery(api.siteSettings.get)) as null | Record<string, unknown>
+    const settings = (await vex.query(api.siteSettings.get)) as null | Record<string, unknown>
     if (!settings) {
       return { title: "Untitled" }
     }
 
     let pageData: Record<string, unknown> | undefined
     if (props.slug) {
-      const pages = (await fetchQuery(api.pages.getBySlug, { slug: props.slug })) as
+      const pages = (await vex.query(api.pages.getBySlug, { slug: props.slug })) as
         | Record<string, unknown>[]
         | undefined
       pageData = pages?.[0]
     }
 
-    const pageTitle = (pageData?.metaTitle as string | undefined) ?? (pageData?.title as string | undefined)
-    const siteName = settings.name as string | undefined
-    const title = (pageTitle ?? (settings.metaTitle as string | undefined) ?? siteName ?? "Untitled") + TITLE_SUFFIX
-    const description =
-      (pageData?.metaDescription as string | undefined) ??
-      (settings.metaDescription as string | undefined) ??
-      (settings.description as string | undefined)
+    const pageTitle = firstNonBlank(pageData?.metaTitle, pageData?.title)
+    const siteName = firstNonBlank(settings.name)
+    const title =
+      (firstNonBlank(pageTitle, settings.metaTitle, siteName) ?? "Untitled") + TITLE_SUFFIX
+    const description = firstNonBlank(pageData?.metaDescription, settings.metaDescription, settings.description)
 
     // `upload()` fields always store an array of media ids — the first entry
     // is the selection. Page-level ogImage wins over the site default.
@@ -44,13 +64,16 @@ export async function generatePageMetadata(props: { slug?: string }): Promise<Me
     const ogImageId = pageOgImageId ?? siteOgImageId
     const ogImageUrl = ogImageId ? await resolveMediaUrl(ogImageId) : undefined
 
-    const twitterHandle = settings.twitterHandle as string | undefined
+    const twitterHandle = firstNonBlank(settings.twitterHandle)
+    const canonicalPath = props.slug && props.slug !== "home" ? `/${props.slug}` : "/"
 
-    const metadata: Metadata = { title, description }
-
-    if (ogImageUrl) {
-      metadata.openGraph = { title, description, images: [{ url: ogImageUrl }] }
-    }
+    const metadata = vexMetadata({
+      title,
+      description,
+      siteUrl: env.NEXT_PUBLIC_SITE_URL,
+      path: canonicalPath,
+      imageUrl: ogImageUrl,
+    })
 
     if (twitterHandle) {
       metadata.twitter = { card: "summary_large_image", site: twitterHandle }
@@ -70,10 +93,10 @@ export async function generatePageMetadata(props: { slug?: string }): Promise<Me
  */
 async function resolveMediaUrl(mediaId: string): Promise<string | undefined> {
   try {
-    const result = (await fetchQuery(api.vex.media.getUrl, {
+    const result = (await vex.query(api.vex.media.getUrl, {
       adapter: "convex",
       mediaId,
-    })) as { error?: string; url?: string; }
+    })) as { error?: string; url?: string }
     return result.url
   } catch {
     return undefined

package/templates/marketing-site/src/lib/vex.ts

@@ -0,0 +1,18 @@
+import { createVexServerClient } from "@vexcms/next/cache"
+
+import { env } from "~/env.mjs"
+
+/**
+ * The single shared Convex read client for every server component and route
+ * in this project.
+ *
+ * `createVexServerClient` (`@vexcms/next/cache`) wraps its `query` method in
+ * a `React.cache` created fresh on every call — so two files that each call
+ * `createVexServerClient()` themselves get two independent caches and never
+ * share a round trip, no matter how identical their reads are. Importing
+ * this one instance everywhere is what lets `generatePageMetadata`
+ * (`~/lib/metadata`) and the page calling it collapse their identical
+ * `pages.getBySlug` read into a single Convex call within one request,
+ * instead of two.
+ */
+export const vex = createVexServerClient({ url: env.NEXT_PUBLIC_CONVEX_URL })

package/templates/marketing-site/src/vex.config.ts

@@ -29,6 +29,14 @@ const vexConfig = defineConfig({
   },
   collections: [users, pages, headers, footers, themes],
   globals: [siteSettings],
+  routes: {
+    map: ({ collection, doc }) => {
+      if (collection !== pages.slug) return []
+      const { slug } = doc
+      if (typeof slug !== "string") return []
+      return [slug === "home" ? "/" : `/${slug}`]
+    },
+  },
 })
 
 export default vexConfig

package/templates/marketing-site/src/vex.types.ts

@@ -202,6 +202,7 @@ export interface PagesDocument extends VexDocument {
    */
   metaDescription?: string
   ogImage?: Id<"images">[]
+  updatedAt?: number
 }
 export type HeaderBlock = {
   blockType: "header"
@@ -225,6 +226,7 @@ export interface HeadersDocument extends VexDocument {
   _id: Id<"headers">
   name: string
   content?: HeaderBlock[]
+  updatedAt?: number
 }
 export type FooterBlock = {
   blockType: "footer"
@@ -251,6 +253,7 @@ export interface FootersDocument extends VexDocument {
   _id: Id<"footers">
   name: string
   content?: FooterBlock[]
+  updatedAt?: number
 }
 
 export interface Theme extends VexDocument {
@@ -343,6 +346,7 @@ export interface Theme extends VexDocument {
     sidebarBorder?: string
     sidebarRing?: string
   }
+  updatedAt?: number
 }
 
 export interface SessionDocument extends VexDocument {
@@ -426,6 +430,7 @@ export interface Image extends VexDocument {
   src: string
   width?: number
   height?: number
+  updatedAt?: number
 }
 
 export interface SiteSettingsGlobal extends VexDocumentGlobal<"siteSettings"> {
@@ -549,18 +554,22 @@ declare module "@vexcms/core" {
         text: "title" | "slug" | "metaTitle" | "metaDescription"
         blocks: "blocks"
         upload: "ogImage"
+        number: "updatedAt"
       }
       headers: {
         text: "name"
         blocks: "content"
+        number: "updatedAt"
       }
       footers: {
         text: "name"
         blocks: "content"
+        number: "updatedAt"
       }
       themes: {
         text: "name" | "fontFamily" | "radius"
         group: "light" | "dark"
+        number: "updatedAt"
       }
       session: {
         date: "expiresAt" | "createdAt" | "updatedAt"
@@ -608,7 +617,7 @@ declare module "@vexcms/core" {
       }
       images: {
         text: "filename" | "alt" | "mimeType" | "storageId" | "src"
-        number: "size" | "width" | "height"
+        number: "size" | "width" | "height" | "updatedAt"
         checkbox: "deleted"
       }
     }

package/templates/marketing-site/src/vexcms/api.ts

@@ -12,7 +12,7 @@ import config from "~/vex.config"
  *
  * Mirrors `apps/test/src/vexcms/api.ts`'s `vexServerApi` binding.
  */
-export const { get, find, search, create, remove, update, globals } = vexServerApi<DataModel>({
+export const { get, find, search, create, remove, update, globals, publishedSlugs } = vexServerApi<DataModel>({
   config,
   getAuth: createGetAuth({
     orgCollectionSlug: TABLE_SLUG_ORGANIZATIONS,