@vexcms/next 0.1.0-alpha.2 → 0.1.0-alpha.21

package/dist/chunk-L6N3D6L5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/NextAdminPage.tsx"],"sourcesContent":["import type { CollectionSlug, PaginationResult, VexConfig, VexMediaDocument } from \"@vexcms/core\";\n\nimport {\n  livePreviewLayoutCookieName,\n  livePreviewPanelCookieName,\n  readLivePreviewLayoutCookie,\n  readLivePreviewPanelCookie,\n  vexConvexApi,\n} from \"@vexcms/core\";\nimport {\n  CollectionEditView,\n  CollectionListView,\n  DashboardView,\n  GlobalEditView,\n  GlobalsListView,\n  MediaCollectionEditView,\n  MediaCollectionListView,\n} from \"@vexcms/react\";\nimport { fetchQuery } from \"convex/nextjs\";\nimport { cookies } from \"next/headers\";\n\n/**\n * VexCMS admin page server component for Next.js.\n *\n * An `async` server component that routes by the `[[...slug]]` catch-all\n * params, prefetches Convex data via `fetchQuery`, and renders the correct\n * view component. Does **not** include a layout wrapper — `NextAdminLayout`\n * in `app/admin/layout.tsx` owns the persistent shell.\n *\n * **Route mapping:**\n * | `path` array | View |\n * |---|---|\n * | `[]` or undefined | `DashboardView` |\n * | `[collectionSlug]` | `CollectionListView` with preloaded docs |\n * | `[collectionSlug, \"new\"]` | `CollectionEditView` (empty form) |\n * | `[collectionSlug, documentId]` | `CollectionEditView` with preloaded doc |\n *\n * @param props - Component props\n * @param props.config - The resolved server `VexConfig`, typically the default export of\n *   `vex.config.server.ts` — not the client-safe `vex.config.ts`.\n * @param props.params - Next.js 15 async params `{ path?: string[] }`\n * @param props.token - Optional session token forwarded to `fetchQuery` for authenticated reads.\n * @returns The appropriate admin view for the current URL path.\n *\n * @example\n * ```tsx\n * // app/admin/[[...slug]]/page.tsx\n * import { NextAdminPage } from \"@vexcms/next/server\";\n * import config from \"../../../../vex.config.server\";\n *\n * export default function AdminPage({\n *   params,\n * }: {\n *   params: Promise<{ path?: string[] }>;\n * }) {\n *   return <NextAdminPage config={config} params={params} />;\n * }\n * ```\n */\nexport async function NextAdminPage(props: {\n  config: VexConfig;\n  params: Promise<{ path?: string[] }>;\n  token?: string;\n}) {\n  const { path = [] } = await props.params;\n  const [collectionSlug, documentId] = path;\n  const cookieStore = await cookies();\n\n  if (!collectionSlug) {\n    return <DashboardView />;\n  }\n\n  if (collectionSlug === \"globals\") {\n    if (!documentId) {\n      return <GlobalsListView />;\n    }\n    const globalConfig = props.config.globals.find((g) => g.slug === documentId);\n    if (!globalConfig) {\n      return (\n        <div>\n          <p className=\"text-muted-foreground p-6\">Global &quot;{documentId}&quot; not found.</p>\n          <p>TODO: add not found view</p>\n        </div>\n      );\n    }\n    const global = await fetchQuery(\n      vexConvexApi.globals.get,\n      { slug: globalConfig.slug },\n      props.token ? { token: props.token } : undefined,\n    );\n    return (\n      <GlobalEditView\n        global={globalConfig.slug}\n        initialData={global}\n        initialPreviewPanelOpen={readLivePreviewPanelCookie({\n          cookieValue: cookieStore.get(livePreviewPanelCookieName({ slug: globalConfig.slug }))\n            ?.value,\n          defaultOpen: globalConfig.admin.livePreview?.defaultOpen ?? false,\n        })}\n        initialPreviewPanelSize={readLivePreviewLayoutCookie({\n          cookieValue: cookieStore.get(livePreviewLayoutCookieName({ slug: globalConfig.slug }))\n            ?.value,\n        })}\n      />\n    );\n  }\n\n  const collection = props.config.collections.find((c) => c.slug === collectionSlug);\n  const mediaCollection = props.config.mediaCollections.find((mc) => mc.slug === collectionSlug);\n\n  if (!collection && !mediaCollection) {\n    return (\n      <div>\n        <p className=\"text-muted-foreground p-6\">\n          Collection &quot;{collectionSlug}&quot; not found.\n        </p>\n        <p>TODO: add not found view</p>\n      </div>\n    );\n  }\n\n  if (mediaCollection && documentId) {\n    const initialData = await fetchQuery(\n      vexConvexApi.get,\n      { id: documentId, collection: mediaCollection.slug },\n      props.token ? { token: props.token } : undefined,\n    );\n    return (\n      <MediaCollectionEditView\n        collection={mediaCollection.slug}\n        documentId={documentId}\n        initialData={initialData as null | VexMediaDocument}\n      />\n    );\n  }\n\n  if (mediaCollection) {\n    const numItems = Math.max(\n      mediaCollection.admin.table.serverPageSize,\n      mediaCollection.admin.table.defaultPageSize,\n    );\n    const initialData = await fetchQuery(\n      vexConvexApi.find,\n      {\n        collection: collectionSlug as CollectionSlug,\n        paginationOpts: { numItems, totalDocs: true, cursor: null },\n      },\n      props.token ? { token: props.token } : undefined,\n    );\n    return (\n      <MediaCollectionListView\n        collection={mediaCollection.slug}\n        initialData={initialData as PaginationResult<VexMediaDocument>}\n      />\n    );\n  }\n\n  if (collection && documentId) {\n    const initialData = await fetchQuery(\n      vexConvexApi.get,\n      { id: documentId, collection: collection.slug },\n      props.token ? { token: props.token } : undefined,\n    );\n    return (\n      <CollectionEditView\n        collection={collection.slug}\n        documentId={documentId}\n        initialData={initialData}\n        initialPreviewPanelOpen={readLivePreviewPanelCookie({\n          cookieValue: cookieStore.get(livePreviewPanelCookieName({ slug: collection.slug }))\n            ?.value,\n          defaultOpen: collection.admin.livePreview?.defaultOpen ?? false,\n        })}\n        initialPreviewPanelSize={readLivePreviewLayoutCookie({\n          cookieValue: cookieStore.get(livePreviewLayoutCookieName({ slug: collection.slug }))\n            ?.value,\n        })}\n      />\n    );\n  }\n\n  if (!collection) {\n    throw new Error(\"invalid collection slug\");\n  }\n\n  const numItems = Math.max(\n    collection.admin.table.serverPageSize,\n    collection.admin.table.defaultPageSize,\n  );\n  const initialData = await fetchQuery(\n    vexConvexApi.findPaginated,\n    {\n      collection: collectionSlug as CollectionSlug,\n      depth: 1,\n      paginationOpts: { cursor: null, numItems, totalDocs: true },\n    },\n    props.token ? { token: props.token } : undefined,\n  );\n  return <CollectionListView collection={collection.slug} initialData={initialData} />;\n}\n"],"mappings":"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","names":["initialData","numItems"]}

package/dist/index.d.ts

@@ -2,6 +2,15 @@ export * from "./NextAdminPage";
 export * from "./NextAdminLayout";
 export { relationship, defineCollection } from "@vexcms/react";
 export { text, number, select, date, url, checkbox, defineConfig, } from "@vexcms/react";
-export type { AdminUser, RelationshipFieldInput, RelationshipField, AdminCollectionConfigInput, CollectionConfigInput, CollectionConfig, TextField, NumberField, SelectField, DateField, UrlField, CheckboxField, AdminField, CollectionSlug, VexDocument, VexConfig, VexConfigInput, RelationshipPreviewProps, } from "@vexcms/react";
+export type { AdminUser, RelationshipFieldInput, RelationshipField, AdminCollectionConfigInput, CollectionConfigInput, CollectionConfig, TextField, NumberField, SelectField, DateField, UrlField, CheckboxField, AdminField, CollectionSlug, VexDocument, VexConfig, VexClientConfig, VexClientConfigInput, VexServerConfigInput, RelationshipPreviewProps, } from "@vexcms/react";
 export type { RelationshipKeysOf, TextKeysOf, SortableKeysOf, RelationshipTargetOf, Populated, PopulateShape, } from "@vexcms/core";
+export { createVexServerClient } from "./cache/createVexServerClient";
+export type { VexServerClientOptions, VexServerClient } from "./cache/types";
+export { createVexRobots } from "./seo/createVexRobots";
+export { createVexSitemap } from "./seo/createVexSitemap";
+export { vexMetadata } from "./seo/vexMetadata";
+export { vexStaticParams } from "./seo/vexStaticParams";
+export { createVexRevalidateRoute } from "./cache/createVexRevalidateRoute";
+export type { CreateVexRevalidateRouteProps } from "./cache/createVexRevalidateRoute";
+export type {} from "./cache/types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG/D,OAAO,EACL,IAAI,EACJ,MAAM,EACN,MAAM,EACN,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,YAAY,GACb,MAAM,eAAe,CAAC;AAMvB,YAAY,EACV,SAAS,EAET,sBAAsB,EACtB,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAEhB,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,aAAa,EAEb,UAAU,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,cAAc,EACd,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAYvB,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,aAAa,GACd,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG/D,OAAO,EACL,IAAI,EACJ,MAAM,EACN,MAAM,EACN,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,YAAY,GACb,MAAM,eAAe,CAAC;AAMvB,YAAY,EACV,SAAS,EAET,sBAAsB,EACtB,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAEhB,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,aAAa,EAEb,UAAU,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAYvB,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,aAAa,GACd,MAAM,cAAc,CAAC;AAKtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACtF,YAAY,EACX,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,48 @@
+import {
+  NextAdminPage
+} from "./chunk-L6N3D6L5.js";
+import {
+  NextAdminLayout
+} from "./chunk-K4AAS5B5.js";
+import {
+  createVexRevalidateRoute,
+  createVexServerClient
+} from "./chunk-3J7LCKFC.js";
+import {
+  createVexRobots,
+  createVexSitemap,
+  vexMetadata,
+  vexStaticParams
+} from "./chunk-KIRSFMPI.js";
+
+// src/index.ts
+import { relationship, defineCollection } from "@vexcms/react";
+import {
+  text,
+  number,
+  select,
+  date,
+  url,
+  checkbox,
+  defineConfig
+} from "@vexcms/react";
+export {
+  NextAdminLayout,
+  NextAdminPage,
+  checkbox,
+  createVexRevalidateRoute,
+  createVexRobots,
+  createVexServerClient,
+  createVexSitemap,
+  date,
+  defineCollection,
+  defineConfig,
+  number,
+  relationship,
+  select,
+  text,
+  url,
+  vexMetadata,
+  vexStaticParams
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @vexcms/next v0.1.0-alpha.1\n//\n// Two distinct export surfaces:\n//\n// 1. Server / client component entries (sub-path imports — required because\n//    \"use client\" can't be mixed with async server components in one bundle):\n//      import { NextAdminPage } from \"@vexcms/next/server\"   ← async server component\n//      import { NextAdminLayout } from \"@vexcms/next/client\" ← \"use client\" component\n//\n// 2. Config / type re-exports (everything below). Re-exports `@vexcms/react`'s\n//    HKT-bound config functions and types transitively so Next consumers can\n//    import every config function from a single package:\n//\n//      import {\n//        defineConfig,\n//        defineCollection,\n//        relationship,\n//        text, number, select, date, url, checkbox,\n//      } from \"@vexcms/next\";\n//\n//    `admin.components.preview` slots remain typed as React `ComponentType<P>`\n//    via `ReactHKT` because @vexcms/react bound it before re-exporting. See\n//    spec 22 Decision 15 for the architectural rationale.\n\n// Server / client surface\nexport * from \"./NextAdminPage\";\nexport * from \"./NextAdminLayout\";\n\n// Config functions — HKT-bound wrappers from @vexcms/react\nexport { relationship, defineCollection } from \"@vexcms/react\";\n\n// Field config functions without component slots (pure pass-through)\nexport {\n  text,\n  number,\n  select,\n  date,\n  url,\n  checkbox,\n  defineConfig,\n} from \"@vexcms/react\";\n\n// Public types — HKT-bound where applicable.\n// `*FieldInput` core config types intentionally not re-exported (they collide\n// with React `*FieldInput` component names; users get them via inference\n// through the config functions).\nexport type {\n  AdminUser,\n  // HKT-bound (admin.components.preview = React ComponentType)\n  RelationshipFieldInput,\n  RelationshipField,\n  AdminCollectionConfigInput,\n  CollectionConfigInput,\n  CollectionConfig,\n  // Resolved field types\n  TextField,\n  NumberField,\n  SelectField,\n  DateField,\n  UrlField,\n  CheckboxField,\n  // Shared types\n  AdminField,\n  CollectionSlug,\n  VexDocument,\n  VexConfig,\n  VexClientConfig,\n  VexClientConfigInput,\n  VexServerConfigInput,\n  RelationshipPreviewProps,\n} from \"@vexcms/react\";\n\n// API functions are NOT re-exported from this barrel because @vexcms/next's\n// root index.ts is imported by server components (NextAdminPage). Pulling\n// @vexcms/core/client here would transitively import @convex-dev/react-query\n// which uses createContext — crashing RSC.\n//\n// Import directly from the correct environment-specific path instead:\n//\n//   import { find, get, search } from \"@vexcms/core/client\";  ← React components\n//   import { find, get, search } from \"@vexcms/core/server\";  ← Convex handlers\n\nexport type {\n  RelationshipKeysOf,\n  TextKeysOf,\n  SortableKeysOf,\n  RelationshipTargetOf,\n  Populated,\n  PopulateShape,\n} from \"@vexcms/core\";\n\n// Cache / SEO surface — server-only, no client context, so these are safe in\n// this RSC-imported root barrel. Also reachable via the \"@vexcms/next/cache\"\n// and \"@vexcms/next/seo\" subpaths.\nexport { createVexServerClient } from \"./cache/createVexServerClient\";\nexport type { VexServerClientOptions, VexServerClient } from \"./cache/types\";\nexport { createVexRobots } from \"./seo/createVexRobots\";\nexport { createVexSitemap } from \"./seo/createVexSitemap\";\nexport { vexMetadata } from \"./seo/vexMetadata\";\nexport { vexStaticParams } from \"./seo/vexStaticParams\";\nexport { createVexRevalidateRoute } from \"./cache/createVexRevalidateRoute\";\nexport type { CreateVexRevalidateRouteProps } from \"./cache/createVexRevalidateRoute\";\nexport type {\n} from \"./cache/types\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AA6BA,SAAS,cAAc,wBAAwB;AAG/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/seo/createVexRobots.d.ts

@@ -0,0 +1,22 @@
+import type { MetadataRoute } from "next";
+/**
+ * Creates a Next.js `robots.ts` default export that allows crawlers across the
+ * site and points them at the generated sitemap.
+ *
+ * @param props - Robots configuration.
+ * @returns A `robots()` function suitable as `app/robots.ts`'s default export.
+ */
+export declare function createVexRobots(props: {
+    /**
+     * Paths to disallow. Every vexcms template passes `["/admin", "/api"]` — the
+     * admin panel is authenticated and neither belongs in an index. Omitted
+     * entirely when absent or empty, rather than emitted as an empty array.
+     */
+    disallow?: string[];
+    /**
+     * The site's absolute origin, no trailing slash (e.g. `https://example.com`).
+     * The sitemap URL is derived as `${siteUrl}/sitemap.xml`.
+     */
+    siteUrl: string;
+}): () => MetadataRoute.Robots;
+//# sourceMappingURL=createVexRobots.d.ts.map

package/dist/seo/createVexRobots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVexRobots.d.ts","sourceRoot":"","sources":["../../src/seo/createVexRobots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,aAAa,CAAC,MAAM,CAY7B"}

package/dist/seo/createVexSitemap.d.ts

@@ -0,0 +1,41 @@
+import type { FunctionReference, FunctionReturnType, OptionalRestArgs } from "convex/server";
+import type { MetadataRoute } from "next";
+import type { VexServerClient } from "../cache/types";
+type ArrayItem<T> = T extends (infer Item)[] ? Item : never;
+/**
+ * Creates a Next.js `sitemap.ts` default export from a Convex published-slugs
+ * query (`packages/core/src/api/publishedSlugs/server.ts`).
+ *
+ * Tolerates an unreachable Convex deployment (P-020): a read failure returns
+ * `[]` — an empty sitemap — rather than failing the build.
+ *
+ * @param props - Sitemap configuration.
+ * @returns A `sitemap()` function suitable as `app/sitemap.ts`'s default export.
+ */
+export declare function createVexSitemap<Query extends FunctionReference<"query">>(props: {
+    args?: OptionalRestArgs<Query>[0];
+    client: VexServerClient;
+    getSlug: (item: ArrayItem<FunctionReturnType<Query>>) => string;
+    /**
+     * Optional last-modified extractor. Omit it when the collection carries no
+     * modification timestamp — Convex's `_creationTime` is set at insert and
+     * never moves, so reporting it as `lastModified` would be a lie.
+     * `lastModified` is optional in the sitemap protocol; an absent value is
+     * correct, a wrong one costs crawl budget.
+     *
+     * May return `undefined` for an individual item, and that is the common
+     * case: `defineCollection` injects `updatedAt` on every content collection,
+     * but only a write through `create`/`update` populates it — a seeded or
+     * imported row has none. Those entries are emitted with no `lastModified`
+     * rather than an `Invalid Date`.
+     */
+    getUpdatedAt?: (item: ArrayItem<FunctionReturnType<Query>>) => number | undefined;
+    /**
+     * Maps one item's slug to its absolute public URL — the route mapper, so URL
+     * shape (e.g. `/blog/[slug]` vs `/[slug]`) is the caller's choice.
+     */
+    toUrl: (slug: string) => string;
+    query: Query;
+}): () => Promise<MetadataRoute.Sitemap>;
+export {};
+//# sourceMappingURL=createVexSitemap.d.ts.map

package/dist/seo/createVexSitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVexSitemap.d.ts","sourceRoot":"","sources":["../../src/seo/createVexSitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC;AAE5D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE;IAChF,IAAI,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC;IAChE;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAClF;;;OAGG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC;CACd,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CA6BvC"}

package/dist/seo/index.d.ts

@@ -0,0 +1,5 @@
+export { createVexRobots } from "./createVexRobots";
+export { createVexSitemap } from "./createVexSitemap";
+export { vexMetadata } from "./vexMetadata";
+export { vexStaticParams } from "./vexStaticParams";
+//# sourceMappingURL=index.d.ts.map

package/dist/seo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/seo/index.js

@@ -0,0 +1,13 @@
+import {
+  createVexRobots,
+  createVexSitemap,
+  vexMetadata,
+  vexStaticParams
+} from "../chunk-KIRSFMPI.js";
+export {
+  createVexRobots,
+  createVexSitemap,
+  vexMetadata,
+  vexStaticParams
+};
+//# sourceMappingURL=index.js.map

package/dist/seo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/seo/vexMetadata.d.ts

@@ -0,0 +1,30 @@
+import type { Metadata } from "next";
+/**
+ * Builds a Next.js `Metadata` object with unconditional title/description, a
+ * conditional OG image, `metadataBase`, and a canonical link.
+ *
+ * Generalizes what Step 1 fixed by hand in `apps/www/src/lib/metadata.ts`:
+ * title and description are set regardless of whether an OG image resolved —
+ * only the `openGraph.images` entry is conditional on `props.imageUrl`. The
+ * original gated the whole `openGraph` block on the image, so a page without
+ * one published no OG title or description at all.
+ *
+ * This FORMATS metadata; it does not read Convex. Resolving which title and
+ * description win is the caller's job, because only the caller knows the
+ * page/site precedence rules.
+ *
+ * @param props - Metadata inputs.
+ * @returns A `Metadata` object for a page's `generateMetadata` or static
+ *   `metadata` export.
+ */
+export declare function vexMetadata(props: {
+    description?: string;
+    /** Absolute OG image URL. Omit to emit `openGraph` without an image. */
+    imageUrl?: string;
+    /** The page's path (e.g. `/about`), used for the canonical link. */
+    path: string;
+    /** The site's absolute origin, used for `metadataBase`. */
+    siteUrl: string;
+    title: string;
+}): Metadata;
+//# sourceMappingURL=vexMetadata.d.ts.map

package/dist/seo/vexMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vexMetadata.d.ts","sourceRoot":"","sources":["../../src/seo/vexMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,QAAQ,CAkBX"}

package/dist/seo/vexStaticParams.d.ts

@@ -0,0 +1,25 @@
+import type { FunctionReference, FunctionReturnType, OptionalRestArgs } from "convex/server";
+import type { VexServerClient } from "../cache/types";
+type ArrayItem<T> = T extends (infer Item)[] ? Item : never;
+/**
+ * Builds Next.js `generateStaticParams` output for a slug-driven route from a
+ * Convex query.
+ *
+ * Returns `[]` when the read fails — including an unreachable Convex
+ * deployment, which every CI build hits because it supplies placeholder env
+ * rather than skipping validation (P-020). A route with no static params still
+ * renders correctly on demand; it is simply not prerendered until the next
+ * build.
+ *
+ * @param props - Static params configuration.
+ * @returns `{ [paramName]: string }[]`, or `[]` if the read fails.
+ */
+export declare function vexStaticParams<Query extends FunctionReference<"query">>(props: {
+    args?: OptionalRestArgs<Query>[0];
+    client: VexServerClient;
+    getSlug: (item: ArrayItem<FunctionReturnType<Query>>) => string;
+    paramName: string;
+    query: Query;
+}): Promise<Record<string, string>[]>;
+export {};
+//# sourceMappingURL=vexStaticParams.d.ts.map

package/dist/seo/vexStaticParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vexStaticParams.d.ts","sourceRoot":"","sources":["../../src/seo/vexStaticParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CAAC,KAAK,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE;IACrF,IAAI,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAiBpC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@vexcms/react/testing";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAKA,cAAc,uBAAuB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,3 @@
+// src/testing/index.ts
+export * from "@vexcms/react/testing";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["// Re-exports the full public surface of `@vexcms/react/testing` so Next.js\n// consumers can import the entire VexCMS test kit from `@vexcms/next`\n// without also depending on `@vexcms/react` directly. A wildcard re-export\n// (rather than an enumerated list) keeps this file in sync automatically as\n// `@vexcms/react/testing`'s own surface grows.\nexport * from \"@vexcms/react/testing\";\n"],"mappings":";AAKA,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vexcms/next",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.21",
   "description": "Next.js adapter and admin routes for VexCMS",
   "keywords": [
     "cms",
@@ -43,6 +43,21 @@
       "import": "./dist/NextAdminLayout.js",
       "types": "./dist/NextAdminLayout.d.ts"
     },
+    "./cache": {
+      "source": "./src/cache/index.ts",
+      "import": "./dist/cache/index.js",
+      "types": "./dist/cache/index.d.ts"
+    },
+    "./seo": {
+      "source": "./src/seo/index.ts",
+      "import": "./dist/seo/index.js",
+      "types": "./dist/seo/index.d.ts"
+    },
+    "./testing": {
+      "source": "./src/testing/index.ts",
+      "import": "./dist/testing/index.js",
+      "types": "./dist/testing/index.d.ts"
+    },
     "./styles": "./styles.css"
   },
   "publishConfig": {
@@ -51,8 +66,8 @@
   },
   "dependencies": {
     "lucide-react": "0.577.0",
-    "@vexcms/core": "0.1.0-alpha.2",
-    "@vexcms/react": "0.1.0-alpha.2"
+    "@vexcms/core": "0.1.0-alpha.21",
+    "@vexcms/react": "0.1.0-alpha.21"
   },
   "devDependencies": {
     "@convex-dev/react-query": "0.1.0",
@@ -62,6 +77,7 @@
     "@types/node": "20.19.43",
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
+    "@vitest/coverage-v8": "4.1.10",
     "convex": "1.44.0",
     "next": "16.3.3",
     "nuqs": "2.9.0",
@@ -70,6 +86,7 @@
     "tailwindcss": "4.3.2",
     "tsup": "8.5.1",
     "typescript": "6.0.3",
+    "vitest": "4.1.10",
     "zod": "4.4.3",
     "@vexcms/tsconfig": "0.0.0"
   },
@@ -87,8 +104,11 @@
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",
-    "dev": "tsup --watch --no-clean",
+    "dev": "tsup --watch src --no-clean",
     "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit -p tsconfig.check.json"
+    "typecheck": "tsc --noEmit -p tsconfig.check.json",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage",
+    "test:watch": "vitest"
   }
 }