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

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.20",
   "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.20",
+    "@vexcms/react": "0.1.0-alpha.20"
   },
   "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"
   },
@@ -89,6 +106,9 @@
     "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",
     "dev": "tsup --watch --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"
   }
 }